Project

environs

0.01
No commit activity in last 3 years
No release in over 3 years
A simple wrapper around the ENV hash that by default raises an error when value requested is not set.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
 Project Readme

Environs

Code Climate Build Status Coverage Status Dependency Status Gem Version

A simple wrapper around the ENV hash that by default raises an error when value requested is not set.

Installation

Add this line to your application's Gemfile:

gem 'environs'

And then execute:

$ bundle

Or install it yourself as:

$ gem install environs

Usage

This gem provides an Env class that dynamically retrieves environment variables based on the name of the method called on the Env class object. Method names are converted to SCREAMING_SNAKE_CASE, e.g. Env.foo_bar tries to retrieve ENV['FOO_BAR']. If a non-nil value is not returned for the key, then an error is raised. Nil values can be allowed by passing a Hash with the allow_nil key set to true.

require 'environs'

ENV['FOO'] = nil

Env.foo
# => 'MissingEnvVarError "The FOO environment variable is not set."'

Env.foo(allow_nil: true)
# => nil

Alternatives

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request