[Python-modules-commits] [django-environ] 01/09: import python-django-environ_0.4.0.orig.tar.gz
Brian May
bam at moszumanska.debian.org
Thu Jan 7 02:43:38 UTC 2016
This is an automated email from the git hooks/post-receive script.
bam pushed a commit to branch master
in repository django-environ.
commit 9520c121f4db5a3d2bc32cde71ac10a4289d040f
Author: Brian May <brian at linuxpenguins.xyz>
Date: Wed Jan 6 18:19:50 2016 +1100
import python-django-environ_0.4.0.orig.tar.gz
---
LICENSE.txt | 19 +
MANIFEST.in | 2 +
PKG-INFO | 341 +++++++++++++
README.rst | 321 ++++++++++++
django_environ.egg-info/PKG-INFO | 341 +++++++++++++
django_environ.egg-info/SOURCES.txt | 14 +
django_environ.egg-info/dependency_links.txt | 1 +
django_environ.egg-info/not-zip-safe | 1 +
django_environ.egg-info/requires.txt | 2 +
django_environ.egg-info/top_level.txt | 1 +
environ/__init__.py | 1 +
environ/environ.py | 737 +++++++++++++++++++++++++++
environ/test.py | 605 ++++++++++++++++++++++
setup.cfg | 11 +
setup.py | 42 ++
15 files changed, 2439 insertions(+)
diff --git a/LICENSE.txt b/LICENSE.txt
new file mode 100644
index 0000000..5901005
--- /dev/null
+++ b/LICENSE.txt
@@ -0,0 +1,19 @@
+Copyright (c) 2013-2015, Daniele Faraglia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file
diff --git a/MANIFEST.in b/MANIFEST.in
new file mode 100644
index 0000000..60cf76f
--- /dev/null
+++ b/MANIFEST.in
@@ -0,0 +1,2 @@
+include *.rst
+include *.txt
\ No newline at end of file
diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..e4744e8
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,341 @@
+Metadata-Version: 1.1
+Name: django-environ
+Version: 0.4.0
+Summary: Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.
+Home-page: http://github.com/joke2k/django-environ
+Author: joke2k
+Author-email: joke2k at gmail.com
+License: MIT License
+Description: ==============
+ Django-environ
+ ==============
+
+ Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.
+
+ |pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+
+
+ This module is a merge of:
+
+ * `envparse`_
+ * `honcho`_
+ * `dj-database-url`_
+ * `dj-search-url`_
+ * `dj-config-url`_
+ * `django-cache-url`_
+
+ and inspired by:
+
+ * `12factor`_
+ * `12factor-django`_
+ * `Two Scoops of Django`_
+
+ This is your `settings.py` file before you have installed **django-environ**
+
+ ::
+
+ import os
+ SITE_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
+
+ DEBUG = True
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': {
+ 'ENGINE': 'django.db.backends.postgresql_psycopg2',
+ 'NAME': 'database',
+ 'USER': 'user',
+ 'PASSWORD': 'githubbedpassword',
+ 'HOST': '127.0.0.1',
+ 'PORT': '8458',
+ }
+ 'extra': {
+ 'ENGINE': 'django.db.backends.sqlite3',
+ 'NAME': os.path.join(SITE_ROOT, 'database.sqlite')
+ }
+ }
+
+ MEDIA_ROOT = os.path.join(SITE_ROOT, 'assets')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = os.path.join(SITE_ROOT, 'static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = '...im incredibly still here...'
+
+ CACHES = {
+ 'default': {
+ 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
+ 'LOCATION': [
+ '127.0.0.1:11211', '127.0.0.1:11212', '127.0.0.1:11213',
+ ]
+ },
+ 'redis': {
+ 'BACKEND': 'django_redis.cache.RedisCache',
+ 'LOCATION': '127.0.0.1:6379:1',
+ 'OPTIONS': {
+ 'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+ 'PASSWORD': 'redis-githubbed-password',
+ }
+ }
+ }
+
+ After::
+
+ import environ
+ root = environ.Path(__file__) - 3 # three folder back (/a/b/c/ - 3 = /)
+ env = environ.Env(DEBUG=(bool, False),) # set default values and casting
+ environ.Env.read_env() # reading .env file
+
+ SITE_ROOT = root()
+
+ DEBUG = env('DEBUG') # False if not in os.environ
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': env.db(), # Raises ImproperlyConfigured exception if DATABASE_URL not in os.environ
+ 'extra': env.db('SQLITE_URL', default='sqlite:////tmp/my-tmp-sqlite.db')
+ }
+
+ public_root = root.path('public/')
+
+ MEDIA_ROOT = public_root('media')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = public_root('static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = env('SECRET_KEY') # Raises ImproperlyConfigured exception if SECRET_KEY not in os.environ
+
+ CACHES = {
+ 'default': env.cache(),
+ 'redis': env.cache('REDIS_URL')
+ }
+
+ You can also pass `read_env()` an explicit path to the .env file.
+ Create a `.env` file::
+
+ DEBUG=on
+ # DJANGO_SETTINGS_MODULE=myapp.settings.dev
+ 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=redis-un-githubbed-password
+
+
+ How to install
+ ==============
+
+ ::
+
+ $ pip install django-environ
+
+
+ How to use
+ ==========
+
+ There are only two classes, `environ.Env` and `environ.Path`
+
+ ::
+
+ >>> import environ
+ >>> env = environ.Env(
+ DEBUG=(bool, False),
+ )
+ >>> env('DEBUG')
+ False
+ >>> env('DEBUG', default=True)
+ True
+
+ >>> open('.myenv', 'a').write('DEBUG=on')
+ >>> environ.Env.read_env('.myenv') # or env.read_env('.myenv')
+ >>> env('DEBUG')
+ True
+
+ >>> open('.myenv', 'a').write('\nINT_VAR=1010')
+ >>> env.int('INT_VAR'), env.str('INT_VAR')
+ 1010, '1010'
+
+ >>> open('.myenv', 'a').write('\nDATABASE_URL=sqlite:///my-local-sqlite.db')
+ >>> env.read_env('.myenv')
+ >>> env.db()
+ {'ENGINE': 'django.db.backends.sqlite3', 'NAME': 'my-local-sqlite.db', 'HOST': '', 'USER': '', 'PASSWORD': '', 'PORT': ''}
+
+ >>> root = env.path('/home/myproject/')
+ >>> root('static')
+ '/home/myproject/static'
+
+
+ Supported Types
+ ===============
+
+ - str
+ - bool
+ - int
+ - float
+ - json
+ - list (FOO=a,b,c)
+ - tuple (FOO=(a,b,c))
+ - dict (BAR=key=val,foo=bar)
+ - 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://
+ - 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://
+
+ Tests
+ =====
+
+ ::
+
+ $ git clone git at github.com:joke2k/django-environ.git
+ $ cd django-environ/
+ $ python setup.py test
+
+
+ License
+ =======
+
+ Django-environ is licensed under the MIT License - see the `LICENSE`_ file for details
+
+ Changelog
+ =========
+
+ `0.4.0 - 23-September-2015 <http://github.com/joke2k/django-environ/compare/v0.3...v0.4>`__
+ -------------------------------------------------------------------------------------------
+ - Fix non-ascii values (broken in Python 2.x)
+ - New email schemes - smtp+ssl and smtp+tls (smtps would be deprecated)
+ - redis_cache replaced by django_redis
+ - Add tuple support. Thanks to @anonymouzz
+ - Add LDAP url support for database (django-ldapdb)
+ - Fix psql/pgsql url
+
+ `0.3 - 03-June-2014 <http://github.com/joke2k/django-environ/compare/v0.2.1...v0.3>`__
+ --------------------------------------------------------------------------------------
+ - Add cache url support
+ - Add email url support
+ - Add search url support
+ - Rewriting README.rst
+
+ 0.2.1 19-April-2013
+ -------------------
+ - environ/environ.py: Env.__call__ now uses Env.get_value instance method
+
+ 0.2 16-April-2013
+ -----------------
+ - environ/environ.py, environ/test.py, environ/test_env.txt: add advanced
+ float parsing (comma and dot symbols to separate thousands and decimals)
+ - README.rst, docs/index.rst: fix TYPO in documentation
+
+ 0.1 02-April-2013
+ -----------------
+ - initial release
+
+ Credits
+ =======
+
+ - `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`_
+ - `envparse`_
+ - `Distribute`_
+ - `modern-package-template`_
+
+ .. _rconradharris: https://github.com/rconradharris
+ .. _envparse: https://github.com/rconradharris/envparse
+
+ .. _kennethreitz: https://github.com/kennethreitz
+ .. _dj-database-url: https://github.com/kennethreitz/dj-database-url
+
+ .. _migonzalvar: https://github.com/migonzalvar
+ .. _dj-email-url: https://github.com/migonzalvar/dj-email-url
+
+ .. _ghickman: https://github.com/ghickman
+ .. _django-cache-url: https://github.com/ghickman/django-cache-url
+
+ .. _julianwachholz: https://github.com/julianwachholz
+ .. _dj-config-url: https://github.com/julianwachholz/dj-config-url
+
+ .. _dstufft: https://github.com/dstufft
+ .. _dj-search-url: https://github.com/dstufft/dj-search-url
+
+ .. _nickstenning: https://github.com/nickstenning
+ .. _honcho: https://github.com/nickstenning/honcho
+
+ .. _12factor: http://www.12factor.net/
+ .. _12factor-django: http://www.wellfireinteractive.com/blog/easier-12-factor-django/
+ .. _`Two Scoops of Django`: http://twoscoopspress.org/
+
+ .. _Distribute: http://pypi.python.org/pypi/distribute
+ .. _`modern-package-template`: http://pypi.python.org/pypi/modern-package-template
+
+ .. |pypi| image:: https://img.shields.io/pypi/v/django-environ.svg?style=flat-square&label=version
+ :target: https://pypi.python.org/pypi/django-environ
+ :alt: Latest version released on PyPi
+
+ .. |coverage| image:: https://img.shields.io/coveralls/joke2k/django-environ/master.svg?style=flat-square
+ :target: https://coveralls.io/r/joke2k/django-environ?branch=master
+ :alt: Test coverage
+
+ .. |unix_build| image:: https://img.shields.io/travis/joke2k/django-environ/master.svg?style=flat-square&label=unix%20build
+ :target: http://travis-ci.org/joke2k/django-environ
+ :alt: Build status of the master branch on Mac/Linux
+
+ .. |windows_build| image:: https://img.shields.io/appveyor/ci/joke2k/django-environ.svg?style=flat-square&label=windows%20build
+ :target: https://ci.appveyor.com/project/joke2k/django-environ
+ :alt: Build status of the master branch on Windows
+
+ .. |downloads| image:: https://img.shields.io/pypi/dm/django-environ.svg?style=flat-square
+ :target: https://pypi.python.org/pypi/django-environ
+ :alt: Monthly downloads
+
+ .. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
+ :target: https://raw.githubusercontent.com/joke2k/django-environ/master/LICENSE.txt
+ :alt: Package license
+
+ .. _LICENSE: https://github.com/joke2k/django-environ/blob/master/LICENSE.txt
+
+Keywords: d,j,a,n,g,o, ,e,n,v,i,r,o,n,m,e,n,t, ,v,a,r,i,a,b,l,e,s, ,1,2,f,a,c,t,o,r
+Platform: any
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Information Technology
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Framework :: Django
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..151f8d7
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,321 @@
+==============
+Django-environ
+==============
+
+Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.
+
+|pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+
+
+This module is a merge of:
+
+* `envparse`_
+* `honcho`_
+* `dj-database-url`_
+* `dj-search-url`_
+* `dj-config-url`_
+* `django-cache-url`_
+
+and inspired by:
+
+* `12factor`_
+* `12factor-django`_
+* `Two Scoops of Django`_
+
+This is your `settings.py` file before you have installed **django-environ**
+
+::
+
+ import os
+ SITE_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
+
+ DEBUG = True
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': {
+ 'ENGINE': 'django.db.backends.postgresql_psycopg2',
+ 'NAME': 'database',
+ 'USER': 'user',
+ 'PASSWORD': 'githubbedpassword',
+ 'HOST': '127.0.0.1',
+ 'PORT': '8458',
+ }
+ 'extra': {
+ 'ENGINE': 'django.db.backends.sqlite3',
+ 'NAME': os.path.join(SITE_ROOT, 'database.sqlite')
+ }
+ }
+
+ MEDIA_ROOT = os.path.join(SITE_ROOT, 'assets')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = os.path.join(SITE_ROOT, 'static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = '...im incredibly still here...'
+
+ CACHES = {
+ 'default': {
+ 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
+ 'LOCATION': [
+ '127.0.0.1:11211', '127.0.0.1:11212', '127.0.0.1:11213',
+ ]
+ },
+ 'redis': {
+ 'BACKEND': 'django_redis.cache.RedisCache',
+ 'LOCATION': '127.0.0.1:6379:1',
+ 'OPTIONS': {
+ 'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+ 'PASSWORD': 'redis-githubbed-password',
+ }
+ }
+ }
+
+After::
+
+ import environ
+ root = environ.Path(__file__) - 3 # three folder back (/a/b/c/ - 3 = /)
+ env = environ.Env(DEBUG=(bool, False),) # set default values and casting
+ environ.Env.read_env() # reading .env file
+
+ SITE_ROOT = root()
+
+ DEBUG = env('DEBUG') # False if not in os.environ
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': env.db(), # Raises ImproperlyConfigured exception if DATABASE_URL not in os.environ
+ 'extra': env.db('SQLITE_URL', default='sqlite:////tmp/my-tmp-sqlite.db')
+ }
+
+ public_root = root.path('public/')
+
+ MEDIA_ROOT = public_root('media')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = public_root('static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = env('SECRET_KEY') # Raises ImproperlyConfigured exception if SECRET_KEY not in os.environ
+
+ CACHES = {
+ 'default': env.cache(),
+ 'redis': env.cache('REDIS_URL')
+ }
+
+You can also pass `read_env()` an explicit path to the .env file.
+Create a `.env` file::
+
+ DEBUG=on
+ # DJANGO_SETTINGS_MODULE=myapp.settings.dev
+ 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=redis-un-githubbed-password
+
+
+How to install
+==============
+
+::
+
+ $ pip install django-environ
+
+
+How to use
+==========
+
+There are only two classes, `environ.Env` and `environ.Path`
+
+::
+
+ >>> import environ
+ >>> env = environ.Env(
+ DEBUG=(bool, False),
+ )
+ >>> env('DEBUG')
+ False
+ >>> env('DEBUG', default=True)
+ True
+
+ >>> open('.myenv', 'a').write('DEBUG=on')
+ >>> environ.Env.read_env('.myenv') # or env.read_env('.myenv')
+ >>> env('DEBUG')
+ True
+
+ >>> open('.myenv', 'a').write('\nINT_VAR=1010')
+ >>> env.int('INT_VAR'), env.str('INT_VAR')
+ 1010, '1010'
+
+ >>> open('.myenv', 'a').write('\nDATABASE_URL=sqlite:///my-local-sqlite.db')
+ >>> env.read_env('.myenv')
+ >>> env.db()
+ {'ENGINE': 'django.db.backends.sqlite3', 'NAME': 'my-local-sqlite.db', 'HOST': '', 'USER': '', 'PASSWORD': '', 'PORT': ''}
+
+ >>> root = env.path('/home/myproject/')
+ >>> root('static')
+ '/home/myproject/static'
+
+
+Supported Types
+===============
+
+- str
+- bool
+- int
+- float
+- json
+- list (FOO=a,b,c)
+- tuple (FOO=(a,b,c))
+- dict (BAR=key=val,foo=bar)
+- 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://
+ - 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://
+
+Tests
+=====
+
+::
+
+ $ git clone git at github.com:joke2k/django-environ.git
+ $ cd django-environ/
+ $ python setup.py test
+
+
+License
+=======
+
+Django-environ is licensed under the MIT License - see the `LICENSE`_ file for details
+
+Changelog
+=========
+
+`0.4.0 - 23-September-2015 <http://github.com/joke2k/django-environ/compare/v0.3...v0.4>`__
+-------------------------------------------------------------------------------------------
+ - Fix non-ascii values (broken in Python 2.x)
+ - New email schemes - smtp+ssl and smtp+tls (smtps would be deprecated)
+ - redis_cache replaced by django_redis
+ - Add tuple support. Thanks to @anonymouzz
+ - Add LDAP url support for database (django-ldapdb)
+ - Fix psql/pgsql url
+
+`0.3 - 03-June-2014 <http://github.com/joke2k/django-environ/compare/v0.2.1...v0.3>`__
+--------------------------------------------------------------------------------------
+ - Add cache url support
+ - Add email url support
+ - Add search url support
+ - Rewriting README.rst
+
+0.2.1 19-April-2013
+-------------------
+ - environ/environ.py: Env.__call__ now uses Env.get_value instance method
+
+0.2 16-April-2013
+-----------------
+ - environ/environ.py, environ/test.py, environ/test_env.txt: add advanced
+ float parsing (comma and dot symbols to separate thousands and decimals)
+ - README.rst, docs/index.rst: fix TYPO in documentation
+
+0.1 02-April-2013
+-----------------
+ - initial release
+
+Credits
+=======
+
+- `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`_
+- `envparse`_
+- `Distribute`_
+- `modern-package-template`_
+
+.. _rconradharris: https://github.com/rconradharris
+.. _envparse: https://github.com/rconradharris/envparse
+
+.. _kennethreitz: https://github.com/kennethreitz
+.. _dj-database-url: https://github.com/kennethreitz/dj-database-url
+
+.. _migonzalvar: https://github.com/migonzalvar
+.. _dj-email-url: https://github.com/migonzalvar/dj-email-url
+
+.. _ghickman: https://github.com/ghickman
+.. _django-cache-url: https://github.com/ghickman/django-cache-url
+
+.. _julianwachholz: https://github.com/julianwachholz
+.. _dj-config-url: https://github.com/julianwachholz/dj-config-url
+
+.. _dstufft: https://github.com/dstufft
+.. _dj-search-url: https://github.com/dstufft/dj-search-url
+
+.. _nickstenning: https://github.com/nickstenning
+.. _honcho: https://github.com/nickstenning/honcho
+
+.. _12factor: http://www.12factor.net/
+.. _12factor-django: http://www.wellfireinteractive.com/blog/easier-12-factor-django/
+.. _`Two Scoops of Django`: http://twoscoopspress.org/
+
+.. _Distribute: http://pypi.python.org/pypi/distribute
+.. _`modern-package-template`: http://pypi.python.org/pypi/modern-package-template
+
+.. |pypi| image:: https://img.shields.io/pypi/v/django-environ.svg?style=flat-square&label=version
+ :target: https://pypi.python.org/pypi/django-environ
+ :alt: Latest version released on PyPi
+
+.. |coverage| image:: https://img.shields.io/coveralls/joke2k/django-environ/master.svg?style=flat-square
+ :target: https://coveralls.io/r/joke2k/django-environ?branch=master
+ :alt: Test coverage
+
+.. |unix_build| image:: https://img.shields.io/travis/joke2k/django-environ/master.svg?style=flat-square&label=unix%20build
+ :target: http://travis-ci.org/joke2k/django-environ
+ :alt: Build status of the master branch on Mac/Linux
+
+.. |windows_build| image:: https://img.shields.io/appveyor/ci/joke2k/django-environ.svg?style=flat-square&label=windows%20build
+ :target: https://ci.appveyor.com/project/joke2k/django-environ
+ :alt: Build status of the master branch on Windows
+
+.. |downloads| image:: https://img.shields.io/pypi/dm/django-environ.svg?style=flat-square
+ :target: https://pypi.python.org/pypi/django-environ
+ :alt: Monthly downloads
+
+.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square
+ :target: https://raw.githubusercontent.com/joke2k/django-environ/master/LICENSE.txt
+ :alt: Package license
+
+.. _LICENSE: https://github.com/joke2k/django-environ/blob/master/LICENSE.txt
diff --git a/django_environ.egg-info/PKG-INFO b/django_environ.egg-info/PKG-INFO
new file mode 100644
index 0000000..e4744e8
--- /dev/null
+++ b/django_environ.egg-info/PKG-INFO
@@ -0,0 +1,341 @@
+Metadata-Version: 1.1
+Name: django-environ
+Version: 0.4.0
+Summary: Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.
+Home-page: http://github.com/joke2k/django-environ
+Author: joke2k
+Author-email: joke2k at gmail.com
+License: MIT License
+Description: ==============
+ Django-environ
+ ==============
+
+ Django-environ allows you to utilize 12factor inspired environment variables to configure your Django application.
+
+ |pypi| |unix_build| |windows_build| |coverage| |downloads| |license|
+
+
+ This module is a merge of:
+
+ * `envparse`_
+ * `honcho`_
+ * `dj-database-url`_
+ * `dj-search-url`_
+ * `dj-config-url`_
+ * `django-cache-url`_
+
+ and inspired by:
+
+ * `12factor`_
+ * `12factor-django`_
+ * `Two Scoops of Django`_
+
+ This is your `settings.py` file before you have installed **django-environ**
+
+ ::
+
+ import os
+ SITE_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
+
+ DEBUG = True
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': {
+ 'ENGINE': 'django.db.backends.postgresql_psycopg2',
+ 'NAME': 'database',
+ 'USER': 'user',
+ 'PASSWORD': 'githubbedpassword',
+ 'HOST': '127.0.0.1',
+ 'PORT': '8458',
+ }
+ 'extra': {
+ 'ENGINE': 'django.db.backends.sqlite3',
+ 'NAME': os.path.join(SITE_ROOT, 'database.sqlite')
+ }
+ }
+
+ MEDIA_ROOT = os.path.join(SITE_ROOT, 'assets')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = os.path.join(SITE_ROOT, 'static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = '...im incredibly still here...'
+
+ CACHES = {
+ 'default': {
+ 'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
+ 'LOCATION': [
+ '127.0.0.1:11211', '127.0.0.1:11212', '127.0.0.1:11213',
+ ]
+ },
+ 'redis': {
+ 'BACKEND': 'django_redis.cache.RedisCache',
+ 'LOCATION': '127.0.0.1:6379:1',
+ 'OPTIONS': {
+ 'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+ 'PASSWORD': 'redis-githubbed-password',
+ }
+ }
+ }
+
+ After::
+
+ import environ
+ root = environ.Path(__file__) - 3 # three folder back (/a/b/c/ - 3 = /)
+ env = environ.Env(DEBUG=(bool, False),) # set default values and casting
+ environ.Env.read_env() # reading .env file
+
+ SITE_ROOT = root()
+
+ DEBUG = env('DEBUG') # False if not in os.environ
+ TEMPLATE_DEBUG = DEBUG
+
+ DATABASES = {
+ 'default': env.db(), # Raises ImproperlyConfigured exception if DATABASE_URL not in os.environ
+ 'extra': env.db('SQLITE_URL', default='sqlite:////tmp/my-tmp-sqlite.db')
+ }
+
+ public_root = root.path('public/')
+
+ MEDIA_ROOT = public_root('media')
+ MEDIA_URL = 'media/'
+ STATIC_ROOT = public_root('static')
+ STATIC_URL = 'static/'
+
+ SECRET_KEY = env('SECRET_KEY') # Raises ImproperlyConfigured exception if SECRET_KEY not in os.environ
+
+ CACHES = {
+ 'default': env.cache(),
+ 'redis': env.cache('REDIS_URL')
+ }
+
+ You can also pass `read_env()` an explicit path to the .env file.
+ Create a `.env` file::
+
+ DEBUG=on
+ # DJANGO_SETTINGS_MODULE=myapp.settings.dev
+ 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=redis-un-githubbed-password
+
+
+ How to install
+ ==============
+
+ ::
+
+ $ pip install django-environ
+
+
+ How to use
+ ==========
+
+ There are only two classes, `environ.Env` and `environ.Path`
+
+ ::
+
+ >>> import environ
+ >>> env = environ.Env(
+ DEBUG=(bool, False),
+ )
+ >>> env('DEBUG')
+ False
+ >>> env('DEBUG', default=True)
+ True
+
+ >>> open('.myenv', 'a').write('DEBUG=on')
+ >>> environ.Env.read_env('.myenv') # or env.read_env('.myenv')
+ >>> env('DEBUG')
+ True
+
+ >>> open('.myenv', 'a').write('\nINT_VAR=1010')
+ >>> env.int('INT_VAR'), env.str('INT_VAR')
+ 1010, '1010'
+
+ >>> open('.myenv', 'a').write('\nDATABASE_URL=sqlite:///my-local-sqlite.db')
+ >>> env.read_env('.myenv')
+ >>> env.db()
+ {'ENGINE': 'django.db.backends.sqlite3', 'NAME': 'my-local-sqlite.db', 'HOST': '', 'USER': '', 'PASSWORD': '', 'PORT': ''}
+
+ >>> root = env.path('/home/myproject/')
+ >>> root('static')
+ '/home/myproject/static'
+
+
+ Supported Types
+ ===============
+
+ - str
+ - bool
+ - int
+ - float
+ - json
+ - list (FOO=a,b,c)
+ - tuple (FOO=(a,b,c))
+ - dict (BAR=key=val,foo=bar)
+ - 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://
+ - 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://
+
+ Tests
+ =====
+
+ ::
+
+ $ git clone git at github.com:joke2k/django-environ.git
+ $ cd django-environ/
+ $ python setup.py test
+
+
+ License
+ =======
+
+ Django-environ is licensed under the MIT License - see the `LICENSE`_ file for details
+
+ Changelog
+ =========
+
+ `0.4.0 - 23-September-2015 <http://github.com/joke2k/django-environ/compare/v0.3...v0.4>`__
+ -------------------------------------------------------------------------------------------
+ - Fix non-ascii values (broken in Python 2.x)
+ - New email schemes - smtp+ssl and smtp+tls (smtps would be deprecated)
+ - redis_cache replaced by django_redis
+ - Add tuple support. Thanks to @anonymouzz
+ - Add LDAP url support for database (django-ldapdb)
+ - Fix psql/pgsql url
+
+ `0.3 - 03-June-2014 <http://github.com/joke2k/django-environ/compare/v0.2.1...v0.3>`__
+ --------------------------------------------------------------------------------------
+ - Add cache url support
+ - Add email url support
+ - Add search url support
+ - Rewriting README.rst
+
+ 0.2.1 19-April-2013
+ -------------------
+ - environ/environ.py: Env.__call__ now uses Env.get_value instance method
+
+ 0.2 16-April-2013
+ -----------------
+ - environ/environ.py, environ/test.py, environ/test_env.txt: add advanced
+ float parsing (comma and dot symbols to separate thousands and decimals)
+ - README.rst, docs/index.rst: fix TYPO in documentation
+
+ 0.1 02-April-2013
+ -----------------
+ - initial release
+
+ Credits
+ =======
+
... 1556 lines suppressed ...
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/django-environ.git
More information about the Python-modules-commits
mailing list