Metadata-Version: 2.1
Name: config-resolver
Version: 5.0.0.post4
Summary: A small package to automatically find a configuration file.
Home-page: https://github.com/exhuma/config_resolver
Author: Michel Albert
Author-email: michel@albert.lu
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: packaging

config_resolver
===============

.. image:: https://travis-ci.org/exhuma/config_resolver.svg?branch=master
    :target: https://travis-ci.org/exhuma/config_resolver

Full Documentation
    https://config-resolver.readthedocs.org/en/latest/

Repository
    https://github.com/exhuma/config_resolver

PyPI
    https://pypi.python.org/pypi/config_resolver


``config_resolver`` provides a simple, yet flexible way to provide
configuration to your applications. It follows the `XDG Base Dir Spec
<https://standards.freedesktop.org/basedir-spec/0.8/>`_ (This instance is
based on 0.8 of this spec) for config file locations, and adds additional ways
to override config locations. The aims of this package are:

* Provide a simple API
* Follow well-known standards for config-file locations
* Be as close to pure-Python as possible
* Be framework agnostic
* Allow custom configutaion types (``.ini`` and ``.json`` support is shipped by
  default)
* Allow to provide system-wide defaults but allow overriding of values for more
  specific environments. These are (in increasing order of specificity):

  1. System-wide configuration (potentially requiring root-access to modify)
  2. User-level configuration (for all instances running as that user)
  3. Current Working Directory configuration (for a running instance)
  4. Per-Instance configuration


