Skip to main content

Configuration for humans

Project description

Latest Version Downloads Wheel Status

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+ (including 3).

The repo is at

Read the full documentation at


  • 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


Install configs with pip:

$ pip install configs


Load a config file:

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


Run the tests with:

$ python

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
configs-3.0.3-py3-none-any.whl (7.1 kB) Copy SHA256 hash SHA256 Wheel 3.4 (230.0 kB) Copy SHA256 hash SHA256 Windows Installer any (8.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page