argsloader
Configuration Parsing and Management Based on chainloader.
The argsloader library's main goal is to extract and change configuration data before implementing it using its computational mechanism:
-
Reusability of local configuration modules
-
Scalability and composition of configuration components
-
Constructing complicated configuration data validation quickly
Installation
You can simply install it with pip command line from the official PyPI site.
pip install argsloader
For more information about installation, you can refer to Installation.
Quick Start
Painless Try
A simple usage is like above
from argsloader.units import yesno, number, is_type, interval
if __name__ == '__main__':
yn = yesno() # yes-no option
print(yn('yes')) # True
print(yn('no')) # False
print(yn(True)) # True
print(yn(False)) # False
num = number() # any number
print(num(1)) # 1
print(num('1.2')) # 1.2
print(num('0x4f')) # 79
int_ = number() >> is_type(int) # any int number
print(num(1)) # 1
print(num('0x4f')) # 79
print(num(1.2)) # TypeError
val_ = number() >> interval.LR(0, 10) # number within [0, 10]
print(num(1)) # 1
print(num(1.2)) # 1.2
print(num(11)) # ValueError
After the unit is built, it can be used to transform and validate the given value.
Full Validation
Sometimes, there may be multiple errors in the given value, but if you directly call corresponding loader (i.e. call the pre-defined __call__ method), only the first error will be raised.
from argsloader.units import is_type, interval
if __name__ == '__main__':
in_ = is_type(int) & interval.LR(0, 10) # int within [0, 10]
print(in_(1)) # OK
print(in_(10)) # OK
print(in_(11.2)) # not an int, not in [0, 10] neither
The output should be
1
10
Traceback (most recent call last):
File "test_main.py", line 7, in <module>
print(in_(11.2)) # not an int, not in [0, 10] neither
File "/home/hansbug/projects/argsloader/argsloader/units/base.py", line 237, in __call__
return self.call(v, 'FIRST')
File "/home/hansbug/projects/argsloader/argsloader/units/base.py", line 249, in call
return self._process(PValue(v, ())).act(err_mode)
File "/home/hansbug/projects/argsloader/argsloader/base/result.py", line 264, in act
raise self._first_error()
File "/home/hansbug/projects/argsloader/argsloader/units/build.py", line 80, in _easy_process
pres = self._transform(v, pvalues)
File "/home/hansbug/projects/argsloader/argsloader/units/build.py", line 105, in _transform
v.value, nested_map(lambda x: x.value, pres)
File "/home/hansbug/projects/argsloader/argsloader/units/type.py", line 43, in _calculate
raise TypeError(f'Value type not match - {_tname(type_)} expected but {_tname(type(v))} found.')
TypeParseError: Value type not match - int expected but float found.
To resolve this problem, you can use method call to show them all.
from argsloader.units import is_type, interval
if __name__ == '__main__':
in_ = is_type(int) & interval.LR(0, 10) # int within [0, 10]
print(in_.call(1)) # OK
print(in_.call(10)) # OK
print(in_.call(11.2)) # not an int, not in [0, 10] neither
The output should be
1
10
Traceback (most recent call last):
File "test_main.py", line 7, in <module>
print(in_.call(11.2))
File "/home/hansbug/projects/argsloader/argsloader/units/base.py", line 249, in call
return self._process(PValue(v, ())).act(err_mode)
File "/home/hansbug/projects/argsloader/argsloader/base/result.py", line 268, in act
raise self._full_error()
argsloader.base.exception.MultipleParseError: (2 errors)
<root>: TypeParseError: Value type not match - int expected but float found.
<root>: ValueParseError: Value not in interval - [0, 10] expected but 11.2 found.
For further examples and best practice, see
- Cheat Sheet of Units (still under developing)
- Example of C51 Configuration
- Example of Subprocess Env Manager
- Example of One vs One Configuration
Contributing
We appreciate all contributions to improve argsloader, both logic and system designs. Please refer to CONTRIBUTING.md for more guides.
License
argsloader released under the Apache 2.0 license.
Metadata
Release files for argsloader 0.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| argsloader-0.0.1.tar.gz | 40.2 kB | Without provenance | Details for argsloader-0.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| argsloader-0.0.1-py3-none-any.whl | Python 3 | none | any | Details for argsloader-0.0.1-py3-none-any.whl |
Total release size: 87.2 kB
Release files / argsloader-0.0.1.tar.gz
| Download URL | argsloader-0.0.1.tar.gz |
|---|---|
| Size | 40.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb4db1b853c2e522f52afcfec413040d906b1f90ee44f3b1b803933e0ad48afd
|
|
BLAKE2b-256 checksum How to use checksums |
15d68b7e265db2f2087cd42c57011ab38e648b761e7a87cf4a97eb323304924a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.12
|
Release files / argsloader-0.0.1-py3-none-any.whl
| Download URL | argsloader-0.0.1-py3-none-any.whl |
|---|---|
| Size | 47.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2aa9114e1bb0b1ef933c18bec8c88a21618139b9869e21e45a05f190a180dbbf
|
|
BLAKE2b-256 checksum How to use checksums |
42d0ce5261fa3036087598ea8d551d5912d232236f78b4050ec808ef0574753c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.9 tqdm/4.63.1 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.12
|
Security for argsloader 0.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.