.. confy documentation master file, created by
   sphinx-quickstart on Sun Jun 23 13:04:33 2013.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

confy
=====

.. image:: https://badge.fury.io/py/confy.png
   :target: https://badge.fury.io/py/confy

.. image:: https://api.travis-ci.org/jqb/confy.png?branch=master
   :target: https://travis-ci.org/jqb/confy

.. image:: https://coveralls.io/repos/jqb/confy/badge.png?branch=master
   :target: https://coveralls.io/r/jqb/confy?branch=master

.. image:: https://pypip.in/d/confy/badge.png
   :target: https://crate.io/packages/confy/


Pragmatic & flexible **configuration loader** that makes your app
settings clean and sexy. It reads configuration from many differnt
sources including: python modules, environment variables and *.ini
files.


The project aims to provide not only simple and easy solution to read
settings in various formats, but also to give strong convention on how
to keep code responsible for loading configuration.


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

Simple and straight forward:


.. code-block:: bash

   pip install confy



Source
------

All the code is hosted on github https://github.com/jqb/confy


.. toctree::
   :maxdepth: 2

   tutorial
   sources


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`