A simple, easy to use, unified manner of accessing program properties.
Project description
application_properties
The application_properties
package was born out of necessity.
During the creation of the PyMarkdown
project, there was a distinct need for a configuration subsystem that was able to
handle more complex configuration schemas.
The application_properties
library has the following advnatages:
- Thoroughly tested
- The project currently has over 65 tests and coverage percentages over 99%.
- Simple... With Examples
- The package was created with the intention of being as easy to use as possbile.
- To that extent, there are 4 basic usage examples and over 10 advanced usage examples.
- Complex When Required
- The default is simplicity, but the package can step up when required to do so.
- Any actions outside of the simple scenario of getting an optional string value should be relatively easy to request of the package API.
- Hierarchically Aware
- By default, uses the
.
character in the property names to define levels of hierarchy. - Hierarchy levels can be used to find only those properties that exist under a given hierarchy.
- If desired, the
ApplicationPropertiesFacade
object can be used to restrict access to only those properties that exist under a given hierarchy.
- By default, uses the
- Command Line Aware
- The
set_manual_property
function allows for one or more individual properties to be supplied by the command line.
- The
- Extensible
- The loading of the properties is separate from access to the values for those properties.
- Due to the separation of the loading and accessing parts of the library,
custom loading classes can be added with ease.
- Current loading classes include loaders for Json files, with Simple Property files right around the corner
Requirements
This project required Python 3.8 or later to function.
Installation
pip install app_prop
API Documentation
The full documentation on the API is available in the API document. As that document is rather dry, more information is provided in the way of examples in the How To Use This Package section of the home page.
How To Use, And Other Stuff
For more information on this library please consult the various other section on the home page.
Project details
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 application_properties-0.7.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | fff3c4da157db812f1cf5e5b5d6fdfa98e13c4bfa39033305f0217230b70bd31 |
|
MD5 | 5810f5292f72e93866ca9d7224f64284 |
|
BLAKE2b-256 | 9753cdff1152a8d0ee4bcd3e5e17cc612b30920d65881cfe6fd883b2ad873420 |
Hashes for application_properties-0.7.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8608d071cdfdf089e1e9a995852d13b9e01f3e3eb0d80065a4eefe7154b3b8b5 |
|
MD5 | e6949062529154478943b4747c2484b5 |
|
BLAKE2b-256 | 830cb3a8af0c004faa354ba664301bcc20110a4c1245b25529fefd1c63f16ea4 |