Configuration

There are two ways to configure blueprints. First is using yielded configuration object in Blueprints.enable:

Blueprints.enable do |config|
  config.file = 'data/blueprints.rb'
end

Another way is by calling Blueprints.config directly:

Blueprints.config.file = 'data/blueprints.rb'

Configuration options

There are several things Blueprints allows configuring:

root

Blueprints tries it's best to determine the root directory of your application. It will use Rails.root if it's available or assume current dir otherwise. However you may want to customize it to any other dir you want. Root accepts String or Pathname objects.

Blueprints.enable do |config|
  config.root = Pathname.new(__FILE__).dirname
end

filename

Allows setting custom patterns of files that contain your blueprints (in case one of automatic ones doesn't fit your needs). This can either be a single pattern or array of patterns. By default these patterns are used:

• blueprint.rb
• blueprint/*.rb
• spec/blueprint.rb
• spec/blueprint/*.rb
• test/blueprint.rb
• test/blueprint/*.rb

Blueprints.enable do |config|
  config.filename = 'data/blueprints.rb'
end

transactions

By default Blueprints runs in transactional mode. This means that before each test/spec transaction is opened. Then you create, manipulate and destroy data using methods provided by Blueprints or any other means. After each test transaction is dropped thus returning your database state to the one before transaction was started. However in some cases transactions need to be turned off (eg. using non transactional database or running using cucumber with selenium). This option allows you to do that. Note that turning off transactions will usually slow your tests severely.

Blueprints.enable do |config|
  config.transactions = false
end

prebuild

By default blueprints starts transactions on an empty database. This option allows you to specify blueprints that are built before starting transaction. This means that data for them will be available in all tests and they will need to be built only once (not once before each test case but once before test suite). Note that if you're not using transactions this option should not be used as it will not speedup your test suite.

Blueprints.enable do |config|
  config.prebuild = :user, :post
end

default_attributes

This option allows you configure what attributes are used when trying to infer name of blueprint.

Blueprints.enable do |config|
  config.default_attributes = :name, :nickname
end