Meh
Meh is a Python configuration utility that uses Python as it's data format. It provides a pleasant and very "pythonic" interface to do all the things a configuration utility does, like default values, validators and comments.
Usage
from meh import Config, Option, ExceptionInConfigError
config = Config()
config.add(Option("food", ["Steak", "Pizza", "Burgers"],
validator=lambda x: type(x) is list))
config.add(Option("ages", {"@snoato" : 18, "@PhilipTrauner" : 16},
validator=lambda x: type(x) is dict))
config.add(Option("bytestring", b"test"))
config += Option("another_number", 42.0, comment="hihi")
config -= Option("another_number", 42.0, comment="hihi")
config += Option("another_number", 42.0, comment="hihi")
CONFIG_PATH = "awesome_config.cfg"
try:
config = config.load(CONFIG_PATH)
except (IOError, ExceptionInConfigError):
config.dump(CONFIG_PATH)
config = config.load(CONFIG_PATH)
print(config.food)
print(config.ages)
print(config.bytestring)
print(config.another_number)
# Changing values during runtime
config.food = ["Baked Beans", "Ramen"]
print(config.food)Outputs:
['Steak', 'Pizza', 'Burgers']
{'@PhilipTrauner': 16, '@snoato': 18}
test
42.0
['Baked Beans', 'Ramen']
Creates:
food = ['Baked Beans', 'Ramen']
ages = {'@PhilipTrauner': 16, '@snoato': 18}
bytestring = "test"
another_number = 42.0 # hihiTidbits
Config(options=[], validation_failed=None)
options: Provide a list of options instead of callingaddfor all of them.validation_failed: Provide a function accepting two parameters (name and value) that's called when a validation fails (returns nothing). (Otherwise a ValidationError will be raised)
Option(name, default_value, validator=None, comment="")
validator: Provide a function accepting one parameter which checks if a value is correct (returns a boolean).comment: A comment appended to the variable declaration in the config file itself.
Installation
Manual:
git clone https://github.com/PhilipTrauner/Meh
cd Meh
python setup.py installpip:
pip install mehHonorable Mentions
- @snoato for stuff
To-Do
- More test cases