Skip to content

Latest commit

 

History

History
87 lines (45 loc) · 3 KB

README.md

File metadata and controls

87 lines (45 loc) · 3 KB

figga

A very simple configuration manager for Python.

CI builds

Usage

figga currently supports three ways of specifying the configuration:

  • standard Python dictionary
  • environment variables with a common prefix
  • one or more INI files

Basic Usage

The default mechanism of instantiating a figga.Configuration instance is passing a simple Python dictionary:

from figga import Configuration

config = Configuration({'foo': 'bar', 'var1': 123, 'VAR2': 'buzz'})

This mechanism can be easily used to store configuration in any file format which can easily be converted to a dict, such as JSON or YAML:

import json
from figga import Configuration

with open('config.json') as json_config:
    config = Configuration(json.load(json_config))

The instantiated object can be used from elsewhere in your code, e.g. if the above instantiation happened in module somewhere.py:

from somewhere import config

print(config.some_value)

Note that all variable names are normalised to lowercase, and access is case insensitive: config.foo, config.FOO or config.Foo all point to the same value.

In addition to direct access, values can be retrieved using the get method:

config.get('some_value')

Note that get also accepts the default argument, the value of which will override the default value specified at instantiation (see below).

Default Values

All constructor methods accept the argument default, which defines the behaviour when a non-existing value is accessed. This argument can handle three different types of default values:

  • any object or scalar value, which will be returned as-is
  • a callable, which will be called passing the accessed variable name as the only argument, returning its result
  • a BaseException subclass, which will be raised instead of returning a value

If no default value is specified, an unknown variable will have the value of None.

From Environment Variables

Another option to initialize the configuration manager is by taking the values of all the environment variables which begin with a common prefix:

import os
from figga import Configuration

os.environ['YOURAPP_VARIABLE'] = 'foo bar'

config = Configuration.from_environ(prefix='YOURAPP_')

print(config.yourapp_variable)

Optionally you can remove the prefix from the final configuration variables:

config = Configuration.from_environ(prefix='YOURAPP_', remove_prefix=True)

print(config.variable)

From INI Files

Alternatively, figga.Configuration can be instantiated using one or more configparser-compatible files:

from figga import Configuration

config = Configuration.from_files('config1.ini', '/vars/config2.ini')

If the file paths are not absolute, they are assumed to be relative to the current working directory. Paths can be either strings or os.PathLike instances.