Python package to handle configuration files specifying values changing over time
Project description
epochs
Python package to handle configuration files specifying values changing over time
Free software: BSD license
Documentation: https://epochs.readthedocs.io.
Features
The main features of epochs are:
Parse date-based configuration files and retrieve values based on datetime.
Validate configuration files, both normal and epoch date-based ones, against a specification.
For example, for a configuration file, epochs.cfg, such as:
[2019-04-09 20:27:15] value : 3 [2019-04-09 22:31:01] value : 5
The dates can be anything parsed by dateutil.parser.parse. Then, epochs can retrieve the correct value from the config file corresponding to a given date:
>>> import epochs
>>> ep = epochs.parse('epochs.cfg')
>>> value = ep.get('value', datetime='2019-04-09 21:55:45')
>>> print(value)
3
>>> value = ep.get('value', datetime='2019-04-09 23:15:40')
>>> print(value)
5
The “correct” value is the one specified in the earliest section of the configuration file with a date on or before the given date.
Below is an example specification for a configuration file:
[city] name : required=True, type=str streets : required=True, type=List[str] temp : required=False, type=float, default=0.0
And an example configuration file following this specification:
[city] name : Boulder streets : [Broadway, Baseline, Valmont]
Then to parse the configuration file with its specification:
>>> import epochs
>>> cf = epochs.parse('example.cfg', spec='spec.cfg')
>>> name = cf.get('name', section='city')
>>> print(name)
Boulder
>>> streets = cf.get('streets', section='city')
>>> print(steets)
['Broadway', 'Baseline', 'Valmont']
>>> temp = cf.get('temp', section='city')
>>> print(temp, type(temp))
0.0 <class 'float'>
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
0.1.0 (2019-04-12)
initial creation
0.1.1 (2019-04-19)
basic config parser with specification file
0.1.2 (2019-04-19)
better repr and str representations
0.2.0 (2019-04-22)
basic epoch parser
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for epochs-0.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4fba2abe7dec700219f79c5438950dad28ec3223d75bc1c587aff2564c07df68 |
|
MD5 | 7d2e2aad838c25d771311b2143d04be2 |
|
BLAKE2b-256 | 7e6bed521178ed38efe996d27e64a1c71c90b0d9a7f2a16afcd69b51882e64b3 |