settings should be simple, boring and forget-able. With settipy it will be just that. Without dependencies pure python
Project description
settipy-pure-python
settings should be simple, and with settipy it is.
Created for working with pypy.
settings parses command line and environment variables on one line. And makes it available throughout the code base. Making using settings in your project as boring and unimportant as it should be. settings vars is as simple as:
settipy.set("FOO", "default value", "help text")
getting vars out has the same level of complexity as setting the value.
settipy["FOO"]
Features
Settipy offers a range of convenient features to help manage configuration settings, such as environment variables and command-line arguments. Here are some of the main features provided by Settipy:
-
Unified access to environment variables and command-line arguments: Settipy allows you to access and manage both environment variables and command-line arguments through a single, consistent interface, making it easier to work with these configuration settings.
-
Default values and descriptions: Settipy allows you to define default values and descriptions for configuration settings, ensuring that your application always has a fallback value and making it easier for other developers to understand the purpose of each setting.
-
Encrypted storage: Settipy provides a secure method for storing sensitive information such as passwords, using a secret splitting technique that divides the data into two separate parts. This method ensures that an attacker would need access to both the process arguments and environment variables to reconstruct the full password, reducing the risk of unauthorized access.
-
Flexible parsing: Settipy can be used to parse a wide range of data types, including integers, floats, booleans, and strings. This makes it suitable for various use cases and simplifies the process of working with different types of configuration settings.
-
Easy integration: Settipy is designed to be easy to integrate into your existing projects. Simply import the library and start using it to manage your configuration settings without any complex setup.
-
Platform independence: Settipy is compatible with both Unix and Windows systems, ensuring that your configuration settings can be managed consistently across different platforms.
Example
example of how to use. More can be found in the example_project
settipy.set("FOO", "default value", "handy help text")
settipy.parse()
print("foo = ", settipy["FOO"])
The above go will produce program that can be used as follows. get handy help text set in the above example on the same line. This can get very handy when the project grows and is used in different environments
$ python example.py --help
Usage of example.py:
-FOO string
handy help text (default "default value")
When no value is given, default value is used
$ python example.py
foo = default value
Running the binary with command line input
$ python example.py -FOO bar
foo = bar
Running the binary with environment variable
$ FOO=ok;python example.py
foo = ok
Order of preference
variables are set with preference variables on the command line will have highest preference. This because while testing you might want to override environment The priority order is as follows
- Command line input
- Environment variables
- Default values
Types
settipy supports different types. It's possible to use the method "get". But to be more clear to the reader of the code you can add the type e.g "get_bool".
// string
settipy.set("FOO", "default", "help text")
settipy["FOO"]
// integer
settipy.set_int("FOO", 42, "help text")
settipy["FOO"]
// boolean
settipy.set_bool("FOO", True, "help text")
settipy["FOO"]
// list
settipy.set_list("FOO", [1, 2, 3], "help text", sep=".")
settipy["FOO"]
dic = {
"foo": ["bar",],
"foo1": ["bar1", "bar2"]
}
settipy.set_dict("foodict", dic, "dict with lists", item_sep=";", key_sep=";", sep=",")
settipy["foodict"]
Var Should be set
settipy supports different types.
// string
settipy.set("foshure", True, "handy message", should=True)
flag: foshure handy message: should be set
Verbose mode
Run the variables that are set before your programs runs, this can help with debugging or in production.
It's possible to hide variables with setting password=True
Either run the program with --settipy-verbose
as cli argument or settipy.parse(verbose=True)
Install
$ pip install settipy-pure-python
Future features
- Add Typing
- Use logging
- Add to Readme features such as 'should_if', 'options'.
- Add options that are available to user, when input is not part of options.
License
MIT
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 settipy_pure_python-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 622a4dea6bf487e7abaf7c7e071cabc502aa9d95d70551a52e2b16cc4bea994e |
|
MD5 | d78946c7f82e7d5fa99ee6686204a2ba |
|
BLAKE2b-256 | 87a33a81341d2deee251f1e9743407bf22564b141afaf723609abbfa73bf3339 |
Hashes for settipy_pure_python-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1e597c404f49774fe6099e3af85ff889e2f021900dcb14da1182a8bc2be76e3 |
|
MD5 | 0d95a08d331ca47a697ba026308e99ef |
|
BLAKE2b-256 | dfddabb1889da419c65b75e706093e8896c8012f7266c0811702ada8dd456d75 |