django-environ-alt 0.4.6

Feature Support

• Fast and easy multi environment for deploy

• Fill os.environ with .env file variables

• Variables casting (see supported_types below)

• Url variables exploded to django specific package settings

Django-environ officially supports Django 1.8 ~ 2.0.

Installation

$ pip install django-environ

NOTE: No need to add it to INSTALLED_APPS.

Then create a .env file:

DEBUG=on
SECRET_KEY=your-secret-key
DATABASE_URL=psql://urser:un-githubbedpassword@127.0.0.1:8458/database
SQLITE_URL=sqlite:///my-local-sqlite.db
CACHE_URL=memcache://127.0.0.1:11211,127.0.0.1:11212,127.0.0.1:11213
REDIS_URL=rediscache://127.0.0.1:6379/1?client_class=django_redis.client.DefaultClient&password=ungithubbed-secret

And use it with settings.py above. Don’t forget to add .env in your .gitignore (tip: add .env.example with a template of your variables).

Documentation

Documentation is available at RTFD.

Supported types

• str

• bool

• int

• float

• json

• list (FOO=a,b,c)

• tuple (FOO=(a,b,c))

• dict (BAR=key=val,foo=bar) #environ.Env(BAR=(dict, {}))

• dict (BAR=key=val;foo=1.1;baz=True) #environ.Env(BAR=(dict(value=unicode, cast=dict(foo=float,baz=bool)), {}))

• url

• path (environ.Path)

• db_url

  • PostgreSQL: postgres://, pgsql://, psql:// or postgresql://

  • PostGIS: postgis://

  • MySQL: mysql:// or mysql2://

  • MySQL for GeoDjango: mysqlgis://

  • SQLITE: sqlite://

  • SQLITE with SPATIALITE for GeoDjango: spatialite://

  • Oracle: oracle://

  • MSSQL: mssql://

  • PyODBC: pyodbc://

  • Redshift: redshift://

  • LDAP: ldap://

• cache_url

  • Database: dbcache://

  • Dummy: dummycache://

  • File: filecache://

  • Memory: locmemcache://

  • Memcached: memcache://

  • Python memory: pymemcache://

  • Redis: rediscache://

• search_url

  • ElasticSearch: elasticsearch://

  • Solr: solr://

  • Whoosh: whoosh://

  • Xapian: xapian://

  • Simple cache: simple://

• email_url

  • SMTP: smtp://

  • SMTP+SSL: smtp+ssl://

  • SMTP+TLS: smtp+tls://

  • Console mail: consolemail://

  • File mail: filemail://

  • LocMem mail: memorymail://

  • Dummy mail: dummymail://

Tips

DATABASE_URL=mysql://user:%23password@127.0.0.1:3306/dbname

CACHE_URL='rediscache://master:6379,slave1:6379,slave2:6379/1'

EMAIL_CONFIG = env.email_url(
    'EMAIL_URL', default='smtp://user@:password@localhost:25')

vars().update(EMAIL_CONFIG)

Nested lists

Some settings such as Django’s ADMINS make use of nested lists. You can use something like this to handle similar cases.

# DJANGO_ADMINS=John:john@admin.com,Jane:jane@admin.com
ADMINS = [x.split(':') for x in env.list('DJANGO_ADMINS')]

# or use more specific function

from email.utils import getaddresses

# DJANGO_ADMINS=Full Name <email-with-name@example.com>,anotheremailwithoutname@example.com
ADMINS = getaddresses([env('DJANGO_ADMINS')])

Multiline value

You can set a multiline variable value:

# MULTILINE_TEXT=Hello\\nWorld
>>> print env.str('MULTILINE_TEXT', multiline=True)
Hello
World

Proxy value

You can set a value prefixed by $ to use as a proxy to another variable value:

# BAR=FOO
# PROXY=$BAR
>>> print env.str('PROXY')
FOO

Multiple env files

It is possible to have multiple env files and select one using environment variables.

env = environ.Env()
env.read_env(env.str('ENV_PATH', '.env'))

Now ENV_PATH=other-env ./manage.py runserver uses other-env while ./manage.py runserver uses .env.

How to Contribute

1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug. There is a Contributor Friendly tag for issues that should be ideal for people who are not very familiar with the codebase yet.

2. Fork the repository on GitHub to start making your changes to the develop branch (or branch off of it).

3. Write a test which shows that the bug was fixed or that the feature works as expected.

4. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to Authors file.

License

This project is licensed under the MIT License - see the License file file for details

Changelog

See the Changelog file which format is inspired by Keep a Changelog.

Credits

• See Authors file

• 12factor

• 12factor-django

• Two Scoops of Django

• rconradharris / envparse

• kennethreitz / dj-database-url

• migonzalvar / dj-email-url

• ghickman / django-cache-url

• dstufft / dj-search-url

• julianwachholz / dj-config-url

• nickstenning / honcho

• rconradharris / envparse

• Distribute

• modern-package-template