Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A simple implementation of a file-based database.
Branch: master

This branch is 1 commit behind dyoder:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


= Warning

This code is alpha quality. Do not use in production.

= Introduction

Filebase is a very simple implementation for file-based databases. It comes with one built-in store that uses YAML, where each record is an individual file, but you can implement different storage classes if you like. It also provides a model class that allows you to treat your records (files) like classes, including a very basic associations implementation.

= Example

Assuming we have the file '' in the 'db/person' directory and it looks like this:

	name: Joe Smith

Then the code for accessing this "database" looks like this:

	class Person
	  include Filebase::Model[ :db / :person ]
	  has_one :organization
	class Organization
	  include Filebase::Model[ :verify / :db / :organization ]
	  has_many :members, :class => Person

	joe = Person.find( '' )                                      # => 'Joe Smith'	                        # => 'Acme, Inc.'
You can create and delete records much like a normal database. You find an object using it's "key" which is actually the filename (typically with an extension like '.yml') and can be accessed using the "key" attribute. Note that changing an object's key will not remove the original value - you have to explicitly delete it. So, in effect, you can copy a value by changing the key and saving it.

Also, a note on the associations - they are not automatically bi-directional. Putting a has_one in one place and a complementary has_many in another does not mean that if you change one, the other will change. This will be fixed in a later version, but for now, remember, these are files, and the data is synchronized between them in anyway.

Another limitation is that there is no real query language. You can access all of the records for a given model using #all, and then filter them as you would any array. But obviously if you find yourself need complex queries spanning several different classes, you should probably use a relational database.

Something went wrong with that request. Please try again.