richardcalahan/exportr

Export environment variables sanely

Exportr: An environment manager for Ruby

Description

Exportr is a simple environment variable manager for Ruby applications. It reads key-value pairs from a yaml file and merges these pairs into Ruby's ENV hash when the ruby process initializes.

Basic Usage

Install the gem.

$ gem install exportr

Create an exportr.yml file in one of two locations relative to your project root.

/exportr.yml
/config/exportr.yml

Rails

Exportr comes with an optional rails generator that will create config/exportr.yml and add it to your .gitignore file.

Add the gem to your Gemfile

gem 'exportr'

Run bundle install.

$ bundle install

Create an exportr.yml file in config/exportr.yml

bundle exec rails g exportr

Start your app server.

$ rails server

Notes

You will need to restart your server/ruby process after changing the yaml file. You can optionally manually load additions to the yaml file by calling Exportr.export.