python-dotenv 0.8.2

In-memory filelikes

It is possible to not rely on the filesystem to parse filelikes from other sources (e.g. from a network storage). load_dotenv and dotenv_values accepts a filelike stream. Just be sure to rewind it before passing.

>>> fromioimport StringIO # Python2: from StringIO import StringIO>>> fromdotenvimport dotenv_values>>> filelike = StringIO('SPAM=EGSS\n')>>> filelike.seek(0)>>> parsed = dotenv_values(stream=filelike)>>> parsed['SPAM']'EGSS'

The returned value is dictionary with key value pair.

dotenv_values could be useful if you need to consume the envfile but not apply it directly into the system environment.

Django

If you are using django you should add the above loader script at the top of wsgi.py and manage.py.

iPython Support

You can use dotenv with iPython. You can either let the dotenv search for .env with %dotenv or provide the path to .env file explicitly, see below for usages.

%load_ext dotenv

# Use find_dotenv to locate the file
%dotenv

# Specify a particular file
%dotenv relative/or/absolute/path/to/.env

# Use '-o' to indicate override of existing variables
%dotenv -o

# Use '-v' to turn verbose mode on
%dotenv -v

Setting config on remote servers

We make use of excellent Fabric to acomplish this. Add a config task to your local fabfile, dotenv_path is the location of the absolute path of .env file on the remote server.

# fabfile.pyimportdotenvfromfabric.apiimport task, run, env# absolute path to the location of .env on remote server.env.dotenv_path = '/opt/myapp/.env'@taskdefconfig(action=None, key=None, value=None):'''Manage project configuration via .env

 e.g: fab config:set,<key>,<value>
 fab config:get,<key>
 fab config:unset,<key>
 fab config:list
 ''' run('touch %(dotenv_path)s' % env) command = dotenv.get_cli_string(env.dotenv_path, action, key, value) run(command)

Usage is designed to mirror the heroku config api very closely.

Get all your remote config info with fab config

$ fab config
foo="bar"

Set remote config variables with fab config:set,<key>,<value>

$ fab config:set,hello,world

Get a single remote config variables with fab config:get,<key>

$ fab config:get,hello

Delete a remote config variables with fab config:unset,<key>

$ fab config:unset,hello

Thanks entirely to fabric and not one bit to this project, you can chain commands like so fab config:set,<key1>,<value1> config:set,<key2>,<value2>

$ fab config:set,hello,world config:set,foo,bar config:set,fizz=buzz

0.8.1

• Add tests for docs ([@Flimm])

• Make ‘cli’ support optional. Use pip install python-dotnev[cli]. ([@theskumar])

0.8.0

• set_key and unset_key only modified the affected file instead of parsing and re-writing file, this causes comments and other file entact as it is.

• Add support for export prefix in the line.

• Internal refractoring ([@theskumar])

• Allow load_dotenv and dotenv_values to work with StringIO()) ([@alanjds])([@theskumar])(#78)

0.7.1

• Remove hard dependency on iPython ([@theskumar])

0.7.0

• Add support to override system environment variable via .env. ([@milonimrod](https://github.com/milonimrod)) (#63)

• Disable “.env not found” warning by default ([@maxkoryukov](https://github.com/maxkoryukov)) (#57)

0.6.5

• Add support for special characters \. ([@pjona](https://github.com/pjona)) (#60)

0.6.4

• Fix issue with single quotes ([@Flimm]) (#52)

0.6.3

• Handle unicode exception in setup.py (#46)

0.6.2

• Fix dotenv list command ([@ticosax](https://github.com/ticosax))

• Add iPython Suport ([@tillahoffmann](https://github.com/tillahoffmann))

0.6.0

• Drop support for Python 2.6

• Handle escaped charaters and newlines in quoted values. (Thanks [@iameugenejo](https://github.com/iameugenejo))

• Remove any spaces around unquoted key/value. (Thanks [@paulochf](https://github.com/paulochf))

• Added POSIX variable expansion. (Thanks [@hugochinchilla](https://github.com/hugochinchilla))

0.5.1

• Fix find_dotenv - it now start search from the file where this function is called from.

0.5.0

• Add find_dotenv method that will try to find a .env file. (Thanks [@isms](https://github.com/isms))

0.4.0

• cli: Added -q/--quote option to control the behaviour of quotes around values in .env. (Thanks [@hugochinchilla](https://github.com/hugochinchilla)).

• Improved test coverage.