README.md in combustion-0.5.0 vs README.md in combustion-0.5.1

- old
+ new

@@ -8,14 +8,14 @@ Get the gem into either your gemspec or your Gemfile, depending on how you manage your engine's dependencies: ```ruby # gemspec -gem.add_development_dependency 'combustion', '~> 0.4.0' +gem.add_development_dependency 'combustion', '~> 0.5.1' # Gemfile -gem 'combustion', '~> 0.4.0', :group => :test +gem 'combustion', '~> 0.5.1', :group => :test ``` In your `spec_helper.rb`, get Combustion to set itself up - which has to happen before you introduce `rspec/rails` and - if being used - `capybara/rails`. Here's an example within context: ```ruby @@ -124,9 +124,23 @@ resources :pages end ``` Just like in a standard Rails app, if you have a mounted engine, then its routes are accessible through whatever it has been loaded as. + +### Customizing Rails application settings + +If you would like to specify any Rails configuration parameter, you can do it without creating any environment file, simply passing a block to Combustion.initialize! like this: + +```ruby +Combustion.initialize! :all do + config.active_record.whitelist_attributes = false +end +``` + +Values given through the initialize! block will be set during Rails initialization proccess, exactly before the corresponding environment file inside `spec/internals/config/enviroments` is loaded (when that file exists), overriding Combustion's defaults. + +Parameters defined in, for instance, `spec/internals/config/environments/test.rb`, would override Combustion's defaults and also config settings passed to initialize!. ### Using other Rails-focused libraries Be aware that other gems may require parts of Rails when they're loaded, and this could cause some issues with Combustion's own setup. You may need to manage the loading yourself by setting `:require` to false in your Gemfile for the gem in question, and then requiring it manually in your spec_helper. View [issue #33](https://github.com/pat/combustion/issues/33) for an example with FactoryGirl.