Skip to main content

Configuration for humans

Project description

Latest PyPI version Number of PyPI downloads

Parsing INI configs must be easy, as are the INI files.

Configs provides a simple API for getting data from INI config files.

Loading data from a config is as easy as configs.load('my.conf').

Configs work with Python 2.7+.

The repo is at bitbucket.org/moigagoo/configs.

Read the full documentation at configs.rtfd.org.

Features

  • Root-level params support

  • Numeric and boolean values are converted automatically

  • Sections with only key-value items are parsed as dicts

  • Sections with only flag items (keys with no value) are parsed as lists

  • Mixed content sections are parsed as tuples of a dict and a list, which can be accessed individually

  • Sections are iterable (even the mixed ones; list first, dict second)

  • Comments support

Installation

Install configs with pip:

$ pip install configs

Basic usage

Load a config file:

>>> import configs
>>> c = configs.load('sample.conf')
>>> c['general']
{'foo': 'baz'}

Load a config file with a fallback config file (with default values):

>>> fc = configs.load('sample.conf', fallback_file='default.conf')
>>> fc['general']['spam']
eggs

Tests

Run the tests with:

$ python test_configs.py

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

configs-2.0.7.zip (5.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page