Metadata-Version: 2.2
Name: configloader
Version: 1.0.1
Summary: Python dict that supports common app configuration-loading scenarios.
Home-page: https://github.com/adblair/configloader
Author: Arthur Blair
Author-email: adblair@gmail.com
License: MIT
Keywords: configloader
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
License-File: LICENSE
License-File: AUTHORS.rst
Provides-Extra: attrdict
Requires-Dist: attrdict>=1; extra == "attrdict"
Provides-Extra: yaml
Requires-Dist: PyYAML>=3; extra == "yaml"
Provides-Extra: all
Requires-Dist: PyYAML>=3; extra == "all"
Requires-Dist: attrdict>=1; extra == "all"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: summary

============
ConfigLoader
============

.. image:: https://travis-ci.org/adblair/configloader.svg?branch=master
        :target: https://travis-ci.org/adblair/configloader

.. image:: https://coveralls.io/repos/adblair/configloader/badge.svg?branch=master&service=github
        :target: https://coveralls.io/github/adblair/configloader?branch=master

.. image:: https://img.shields.io/pypi/dm/configloader.svg
        :target: https://pypi.python.org/pypi/configloader

ConfigLoader is a Python dictionary subclass that provides convenience methods
for common app configuration-loading scenarios, inspired by `flask.Config`_.


Features
--------

Easily load config settings from:

* Python modules, classes or objects
* JSON files
* YAML files
* Environment variables

Supports Python 2.6+ and 3.3+.


Installation
------------

Install ConfigLoader from `PyPI`_ using `pip`_::

    pip install configloader[all]

The ``[all]`` indicates that all optional dependencies (AttrDict and PyYAML)
should be installed.


Example usage
-------------

::

    >>> from configloader import ConfigLoader
    >>> config = ConfigLoader
    >>> config.update_from_object('my_app.settings')
    >>> config.update_from_yaml_env('YAML_SETTINGS_PATH')


Documentation
-------------

https://configloader.readthedocs.org/en/stable/


.. _flask.Config: http://flask.pocoo.org/docs/0.10/api/#configuration
.. _PyPI: https://pypi.python.org/pypi
.. _pip: https://pip.pypa.io/
