Contents

# dotenv

Loads environment variables from `.env` into `ENV`, automagically.

Read more about the [motivation for dotenv at opensoul.org](http://opensoul.org/blog/archives/2012/07/24/dotenv/).

## Installation

### Rails

Add this line to your application's Gemfile:

    gem 'dotenv', :groups => [:development, :test]

And then execute:

    $ bundle

### Sinatra or Plain ol' Ruby

Install the gem:

    $ gem install dotenv

As early as possible in your application bootstrap process, load `.env`:

    require 'dotenv'
    Dotenv.load

To ensure `.env` is loaded in rake, load the tasks:

    require 'dotenv/tasks'

    task :mytask => :dotenv do
      # things that require .env
    end

## Usage

Add your application configuration to `.env`.

    S3_BUCKET=dotenv
    SECRET_KEY=sssshhh!

You can also create files per environment, such as `.env.test`:

    S3_BUCKET=test
    SECRET_KEY=test

Whenever your application loads, these variables will be available in `ENV`:

    config.fog_directory  = ENV['S3_BUCKET']

## Contributing

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

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
dotenv-0.4.0	README.md
dotenv-0.3.0	README.md