Skip to content

Simplify fixtures for a large Rails application which is split into multiple engines.

Notifications You must be signed in to change notification settings

appfolio/inheritable_fixtures

Repository files navigation

InheritableFixtures

GitHub version Build Status

Allows Rails engines to contain fixtures for their models and for those fixtures to be automatically used in the downstream engines. This is very much in line with Rails engines containing db migrations for their models and for those migrations to be automatically used by the downstream engines.

Installation

Add this line to your application's Gemfile:

gem 'inheritable_fixtures'

And then execute:

$ bundle install

Usage

This gem introduces a configuration option called Rails.application.config.fixtures_paths, which is by default empty. The list of fixtures is determined by traversing all the fixtures_paths looking for fixture files. Rails.root.join('test/fixtures') is always prepended to the list, thus it has the highest precedence.

When the application initializes, each engine adds lib/fixtures to the list (if that path exists).

fixtures :all

Tests use fixtures :all or something like fixtures :users, :addresses to initial the database with necessary test data. It will now search for the fixtures in all fixtures_paths.

fixture_file_upload

The fixture_file_upload is a handy utility provided by Rails for creating Rack::Test::UploadedFile out of a fixture file. It will now look for the fixture in all fixtures_paths.

rake db:fixtures:load

The db:fixtures:load task is used to populate a database with the fixtures. It will now load all fixtures from fixtures_paths.

Contributing

  1. Fork it ( https://github.com/[my-github-username]/inheritable_fixtures/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

About

Simplify fixtures for a large Rails application which is split into multiple engines.

Resources

Stars

Watchers

Forks

Packages

No packages published