=== About === Fixtures is Merb plugin which provides fixture system for Merb.

1. Fixtures are written in Ruby, not in YAML, so it's more powerful than YAML one. For example it's much easier to add HABTM relationships.
2. Fixtures aren't just for testing, but they are useful for development and even for migrations

=== Setup === git clone git://github.com/botanicus/merb-fixtures.git cd merb-fixtures rake install

config/init.rb

dependency 'merb-fixtures'

By default, fixtures folder is app/fixtures. If you like to puts your fixtures on other place, feel free to change it in your init.rb:

config/init.rb

Merb::Plugins.config[:fixtures] = { :directory => Merb.root / "app" / "fixtures" }

=== Writing fixtures === First you must write a fixture:

app/fixtures/author.rb

fixture_for(Author, :botanicus) do self.first_name = "Jakub" self.last_name = "Šťastný" self.nickname = "Botanicus" self.homepage = "http://botablog.cz" self.posts = [ ... ] end

=== Usage from merb console or specs === Now you can use it - from your specs or just from merb console:

Get fixture named :botanicus

Author.fixture(:botanicus) => #<Author last_name="Šťastný" homepage="http://botablog.cz" first_name="Jakub" nickname="Botanicus">

Get all the author's fixtures

Author.fixtures => [#<Author last_name="Šťastný" homepage="http://botablog.cz" first_name="Jakub" nickname="Botanicus">]

=== Usage in migrations ===

Usage in migrations

migration 1, "Add default author" do up do Author.fixture(:botanicus).save end down do # foo end end

=== FAQ ===

== HABTM ==

TODO: describe different types of associations

class ModelOne has 0..n, :model_two end

class ModelTwo belongs_to :model_one

model_one_id

end

fixture_for(ModelOne, :one) do

foo bar

end

require_fixtures :model_one fixture_for(ModelTwo, :two) do self.model_one = ModelOne.fixture(:model_one) end

1. save ModelOne