Metadata-Version: 2.0
Name: conficus
Version: 0.4.0
Summary: ini config library
Home-page: http://thebitsilo.com/dev/conficus/current
Author: Mark Gemmill
Author-email: mark@markgemmill.com
License: UNKNOWN
Download-URL: https://bitbucket.org/mgemmill/conficus
Description-Content-Type: UNKNOWN
Keywords: conficus ini configurtion
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: pathlib2 (>=2.3.0); python_version < "3.4"

Conficus v0.4.0 
===================

Python INI Configuration
^^^^^^^^^^^^^^^^^^^^^^^^


|version-badge| |coverage-badge|

``conficus`` is a python ini configuration utility. It reads ini-based
configuration files into a python dict. ``conficus`` provides automatic
coercing of values (e.g. str -> int), nested sections, easy access and
section inheritance.

Installation
~~~~~~~~~~~~

Install the ``ficus`` package with pip.

.. code:: bash

        pip install conficus

Quick Start
~~~~~~~~~~~

Basic usage:

.. code:: python

    >>> 
    >>> import conficus as ficus
    >>>

Configurations can be loaded from a file path string:

.. code:: python

    >>> config = ficus.load('/Users/mgemmill/config.ini')
    >>>

Or from path stored in an environment variable:

.. code:: python

    >>> config = ficus.load('ENV_VAR_CONFIG_PATH')
    >>>

.. code:: python

    >>> # configuration is just a dictionary:
    ... 
    >>> print config['app']['debug']
    True
    >>>
    >>> # with ease of access:
    ... 
    >>> print config['app.debug']
    True

.. |version-badge| image:: https://img.shields.io/badge/version-v0.4.0-green.svg
.. |coverage-badge| image:: https://img.shields.io/badge/coverage-100%25-green.svg


