tox-envfile 0.0.2

No project description provided

tox-envfile

A tox plugin that loads environment variables from env files into your tox envs.

Reads environment variables from a file named .devdata.env in the same directory as your tox.ini file and adds them to the environment that tox runs your commands in.

This is a pretty dumb plugin for now: all of the environment variables in .devdata.env will be loaded into the environment for every tox env that you run, unconditionally. Any existing envvars with conflicting names will be overwritten.

TODO:

• Support env file names other than .devdata.env (which just happens to be the filename I'm using in my projects)
• Support some kind of conditional loading where you can specify in the tox.ini file which tox envs the env file should be loaded for, and which not. And load different env files for different tox envs. Something like: env = {toxinidir}/.env (or readenv) in tox.ini.

Usage

Just add this to your tox.ini file:

requires = tox-envfile

env File Format

python-dotenv is used for the env file parsing.

The .devdata.env file should be an env file with contents that look like this:

# a comment that will be ignored.
REDIS_ADDRESS=localhost:6379
MEANING_OF_LIFE=42
MULTILINE_VAR="hello\nworld"

Or like this:

export S3_BUCKET=YOURS3BUCKET
export SECRET_KEY=YOURSECRETKEYGOESHERE

POSIX variable expansion works, using variables from the environment or from earlier lines in the env file:

CONFIG_PATH=${HOME}/.config/foo
DOMAIN=example.org
EMAIL=admin@${DOMAIN}