Package: settipy-pure-python
settipy-pure-pythonsettings 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"]FeaturesSettipy 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.Exampleexample of how to use. More can be found in theexample_projectsettipy.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$pythonexample.py--helpUsageofexample.py:-FOOstringhandyhelptext(default"default value")When no value is given, default value is used$pythonexample.pyfoo=defaultvalueRunning the binary with command line input$pythonexample.py-FOObarfoo=barRunning the binary with environment variable$FOO=ok;pythonexample.pyfoo=okOrder of preferencevariables 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 followsCommand line inputEnvironment variablesDefault valuesTypessettipy 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".//stringsettipy.set("FOO","default","help text")settipy["FOO"]//integersettipy.set_int("FOO",42,"help text")settipy["FOO"]//booleansettipy.set_bool("FOO",True,"help text")settipy["FOO"]//listsettipy.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 setsettipy supports different types.//stringsettipy.set("foshure",True,"handy message",should=True)flag: foshure handy message: should be setVerbose modeRun the variables that are set before your programs runs, this can help with debugging or in production.
It's possible to hide variables with settingpassword=TrueEither run the program with--settipy-verboseas cli argument orsettipy.parse(verbose=True)Install$pipinstallsettipy-pure-pythonFuture featuresAdd TypingUse loggingAdd to Readme features such as 'should_if', 'options'.Add options that are available to user, when input is not part of options.LicenseMIT