Climate Control
Easily manage your environment.
Installation
Add this line to your application's Gemfile:
gem 'climate_control'
And then execute:
$ bundle
Or install it yourself as:
$ gem install climate_control
Usage
ClimateControl
can be used to temporarily assign environment variables
within a block:
ClimateControl.modify CONFIRMATION_INSTRUCTIONS_BCC: '[email protected]' do
sign_up_as '[email protected]'
confirm_account_for_email '[email protected]'
current_email.should bcc_to('[email protected]')
end
To use with RSpec, you could define this in your spec:
def with_modified_env(, &block)
ClimateControl.modify(, &block)
end
This would allow for more straightforward way to modify the environment:
require 'spec_helper'
describe Thing, 'name' do
it 'appends ADDITIONAL_NAME' do
with_modified_env ADDITIONAL_NAME: 'bar' do
expect(Thing.new.name).to eq('John Doe Bar')
end
end
def with_modified_env(, &block)
ClimateControl.modify(, &block)
end
end
To modify the environment for an entire set of tests in RSpec, use an around
block:
describe Thing, 'name' do
# ... tests
around do |example|
ClimateControl.modify FOO: 'bar' do
example.run
end
end
end
Environment variables assigned within the block will be preserved;
essentially, the code should behave exactly the same with and without the
block, except for the overrides. Transparency is crucial because the code
executed within the block is not for ClimateControl
to manage or modify. See
the tests for more detail about the specific behaviors.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
License
climate_control is copyright 2012 Joshua Clayton and thoughtbot, inc. It is free software and may be redistributed under the terms specified in the LICENSE.txt file.