envdir 0.3

What?

envdir runs another program with a modified environment according to files in a specified directory.

So for example, imagine a software you want to run on a server but don’t want to leave certain configuration variables embedded in the program’s source code. A common pattern to solve this problem is to use environment variables to separate configuration from code.

envdir allows you to set a series of environment variables at once to simplify maintaing complicated environments, for example in which you have multiple sets of those configuration variables depending on the infrastructure you run your program on (e.g. Windows vs. Linux, Staging vs. Production, Old system vs. New system etc).

Let’s have a look at a typical envdir:

$ tree mysite_env/
mysite_env/
├── DJANGO_SETTINGS_MODULE
├── MYSITE_DEBUG
├── MYSITE_DEPLOY_DIR
├── MYSITE_SECRET_KEY
└── PYTHONSTARTUP

0 directories, 3 files
$ cat mysite_env/DJANGO_SETTINGS_MODULE
mysite.settings
$

As you can see each file has a capitalized name and contains the value of the environment variable to set when running your program. To use it, simply prefix the call to your program with envdir:

$ envdir mysite_env python manage.py runserver

That’s it, nothing more and nothing less. The way you structure your envdir is left to you but can easily match your configuration requirements and integrate with other configuration systems. envdirs contain just files after all.

An interesting summary about why it’s good to store configuration values in environment variables can be found on the 12factor site.

Why?

Because envdir is small enough that it shouldn’t be tied to a bigger software distribution like daemontools that requires a compiler.

Also, this Python port can easily be used on Windows, not only UNIX systems.

Installation

pip install envdir

or:

easy_install envdir

Usage

import envdir
envdir.read()

import os
import envdir

envdir.read('/etc/mysite/envdir')

Feedback

Feel free to open tickets at https://github.com/jezdez/envdir/issues. Say thanks at https://www.gittip.com/jezdez/.

Changelog