application_settings 0.2.0

For providing a python application with configuration and/or settings

application_settings

"You write the dataclasses to define parameters for configuration and settings, application_settings takes care of the logic."

What and why

Application_settings is a package for providing a python application with parameters for configuration and settings. It uses toml or json files that are parsed into dataclasses. This brings some benefits:

• Minimal work for the application designer
• Parameters are typed, which allows for improved static code analyses.
• IDEs will provide helpful hints and completion when using the parameters.
• More control over what happens when a file contains mistakes (by leveraging the power of pydantic).
• Possibility to specify defaults when no file is found or entries are missing.
• Configuration parameters are read-only (i.e., changed by editing the config file); we recommend (and support) the use of toml for this, which is a human-oriented, flexible, standardardized and not overly complex format.
• Settings parameters are read-write (i.e., mostly changed via the UI of the application); we recommend (and support) use json for this, an established standardized machine-oriented format.

Parsing is done once during first access and the resulting set of parameters is stored as a singleton.

Interested? Then have a look at our quick start.

License

This project is licensed under the terms of the MIT license.