Skip to main content

Configuration for humans

Project description

Parsing INI configs must be easy, as are 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 both Python 2 and 3.

The repo is at


  • Root-level params (with no section)
  • Numeric 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 a dict and a list, which can be accessed individually
  • Sections are iterable (even the mixed ones)


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']

Read the full documentation at

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-1.8.tar.gz (3.2 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