enviro 0.0.2

Usage

Simply import enviro and call conf(). By default it reads .env:

import enviro
enviro.conf()  # Load contents of .env into os.environ

A different file may be specified:

enviro.conf('production.env')

IPython Extension

enviro also provides an IPython extension so that it is always easily available as a line magic function without the need to import:

$ ipython
In [1]: %enviro

As above, it reads .env in the current directory by default, but an alternate file can be specified on the line:

In [1]: %enviro production.env

Example

.env in the current directory has the following contents:

SERVICE_API_KEY = abc123
SERVICE_API_SECRET = def456
DATABASE_URI = postgres://user:password@host/dbname

>>> import enviro
>>> import os

>>> enviro.conf()
>>> os.environ['SERVICE_API_KEY']
'abc123'
>>> os.environ['SERVICE_API_SECRET']
'def456'
>>> os.environ['DATABASE_URI']
'postgres://user:password@host/dbname'

Installation

The easiest way to install is to use pip.

pip install enviro

To load the IPython extension every time IPython starts, add ‘enviro_ipy_ext’ to the extensions in your IPython config file (usually ~/.ipython/profile_default/ipython_config.py):

c.InteractiveShellApp.extensions = [
    'enviro_ipy_ext',
]

and

c.TerminalIPythonApp.extensions = [
    'enviro_ipy_ext',
]

To load the IPython extension without modifying your ipython_config.py you can run %load_ext enviro_ipy_ext to expose the %enviro magic function, although that’s just as easy as importing it directly so best to add it to your config and avoid this step.

See also

• The Twelve-Factor App (particularly the Config section)

• Using IPython extensions

• heroku-config plugin

• autoenv