Suzanne

A striped-down fork of Figaro, allowing env variables to be managed through YAML files.

Currently meant to be used within a Rails project. Currently, like Figaro, we assume that the config file is in config/application.yml.

Place you configuration file in config/application.yml. (Make sure it is not tracked by git.)

Add this line to your application's Gemfile:

# Gemfile
gem 'suzanne', '~> 0.1', require: false

At the very bottom of config/application.rb:

require 'suzanne'
Suzanne.env

Within your app:

Suzanne.env.super_secret_key

(just like you would with Figaro.)

• Follow instructions in the section above (except you probably have a config file already).
• Make sure you have a section named development (see section below).
• Substitute "Suzanne" for "Figaro" everywhere in your code base. Hopefully this is safe.
• Test

It should have a section for each environment (except production). There is no default section.

development:
  my_aws_key: 'abcdef'

test:
  my_aws_key: 'fedcba'

Define a YAML file:

development:
  super_secret_key: abcdef

test:
  super_secret_key: fedcba

Initialize Suzanne:

require 'suzanne'

Rails.env
=> 'development'
Suzanne.env.super_secret_key
=> 'abcdef'
Suzanne.env.no_such_key
=> nil

To be explained

To be tested

Run bundle exec rake test to run the tests.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

In case you are wondering about the gem name => The_Marriage_of_Figaro.

Bug reports and pull requests are welcome on GitHub at https://github.com/Facilecomm/suzanne. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the Suzanne project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.