Skip to main content

the simple way to deal with environment constants

Project description

The simple way to deal with environment constants!

The problem?

Most applications use constants. Many constants take different values based on the environment the application is executed in.

Think database credentials over development, testing, staging, production or stock market execution over development, testing, paper, production …

A solution

Shamelessly inspired by the app_constants gem, constants aims to solve that problem (and that problem only).

.ini file

constants uses the .ini file format to specify the application constants values in each environment. DEFAULT values are available in every environment unless specifically overridden in a section.

[DEFAULT]
something = a_default_value
all =  1

[a_section]
something = a_section_value
just_for_me = 5

To find out more about ini files and sections, check the Python standard library configparser documention.

The default file is constants.ini in the current working directory. but you can use any filename you want cf. Instantiation.

Environment

Define the environment the application will run in. The default environment variable to store that value is __CONSTANTS__, but you can use any variable name you want cf. Instantiation.

Most platform have a way to do that, in bash:

export __CONSTANTS__=a_section

Instantiation

>>> import constants
>>> consts = constants.Constants()

On instantiation, constants looks for an environement variable named __CONSTANTS__ whose value is used to find out which section of the constants.ini file should be used.

Constants’ constructor takes two (2) optional parameters. variable let’s you specify the name of the environment variable and filename the absolute path to the .ini file containing the constants definitions.

>>> consts = Constants(variable='AN_ENVIRONMENT_VARIABLE',
...                    filename='constants.cfg') # doctest: +SKIP

Values

To access the values, the instance can be used like a dictionary (getitem).

>>> consts['something']
'a_section_value'

Values are cast into integer or float when possible.

>>> consts['all']
1

Values can also be accessed using the . operator (getattr)

>>> consts.all
1

Installation

constants is available on PyPI

pip install constants

… and can be forked on GitHub.

Project details


Download files

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

Files for constants, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size constants-0.1.1.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page