Metadata-Version: 2.1
Name: config-checker
Version: 0.0.1
Summary: Python module wrapper around ConfigParser for enforcing string configuration file operations.
Home-page: https://github.com/stuianna/configChecker
Author: Stuart Ianna
Author-email: stuian@protonmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

[![Build Status](https://travis-ci.org/stuianna/configChecker.svg?branch=master)](https://travis-ci.org/stuianna/configChecker)
[![Codecov](https://img.shields.io/codecov/c/github/stuianna/configChecker)](https://codecov.io/gh/stuianna/configChecker)
![GitHub](https://img.shields.io/github/license/stuianna/configChecker)

Python module wrapper around `ConfigParser` to ensure strict operation when working with configuration (.ini) files.

## Example Usage

Assume a configuration file, `config.ini`, with the following content:

```
[General]
api_key = api-private-key
conversion_factor = 123.456
print_results = False
```

Config parser can be used to ensure the expected values appear in the file, extra values are ignored with default values used as substitutes where entries are missing.

```python
from configchecker import ConfigChecker

config = ConfigChecker()

# Set the configuration values which are to be used.
# set_expectations(SectionName,SectionOption,DataType,DefaultValue)
config.set_expectation('General','api_key',str,'api-private-key')
config.set_expectation('General','retries',int,5)
config.set_expectation('General','conversion_factor',float,3.14)
config.set_expectation('General','print_results',bool,True)

# Try to load a configuration (.ini) file.
# Any previously set expectation which exists in the file has its value updated.
# Any value which doesn't exist in the file has its default value applied.
# Any configuration value in the file which isn't an expectation is ignored.
# This should be called before a file is written, or configuration value set or get
config.set_configuration_file('config.ini')

# Get the value of a configuration variable
printResults = config.get_value("General','print_results')

# Set the value of a configuration variable
config.set_value('General','api_key','123-23423csdfs3-2342-234')

# Write a configuration (.ini) file.
# This operation creates a new file with all the previously set expectations
# If a value hasn't been added for the option, then the default value is used.
config.write_configuation_file('config.ini')
```

The resulting (new) configuration file look as follows:
```ini
[General]
api_key = 123-23423csdfs3-2342-234
retries = 5
conversion_factor = 123.456
print_results = False
```
Notice the option `retries` has been added with the default value based on the expectation, and the `api_key` has been updated. The values of `conversion_factor` and `print_results` remained unchanged, as they existed in the original configuration file.



