A helper for type-checked command-line argument store
Project description
init_attrs_with_kwargs
A helper for type-checked command-line argument store.
init_args_with_kwargs
enables to store the command line arguments (positioned arguments and options) parsed with docopt
in an object of a typed class.
Sample
from init_attrs_with_kwargs import InitAttrsWKwArgs
class MyArgs(InitAttrsWKwArgs):
count: int
name: str
max_length: int
# Initialize from docopt's return value, with casting str to int
args = MyArgs(_cast_str_values=True, **{'<count>': '1', '--name': "Joe", '--max-length': '100'})
print("args.count=%s" % repr(args.count))
print("args.name=%s" % repr(args.name))
print("args.max_length=%s" % repr(args.max_length))
Another samples:
- sample1.py. Describes data type conversion and error handling.
- sample2.py. Storing
docopt
-parsed command line arguments in a type-hinted class's object.
Motivation
I like to use docopt to design command lines. With docopt, I can design a command line in a vague state at first, and then I can make it more and more concrete and detailed.
As a recent trend in Python coding, you can also use type hints for code completion in text editors such as VSCode. Here's the problem: since the result of docopt parsing is a dict, you will be accessing, for example, args["name"], and the editor's completion will not work. Similarly, you cannot benefit from static type checking with type hints.
This issue can be solved by converting a docopt dict into an object of a typed class.
init_attrs_with_kwargs
is a helper just for this purpose.
Links
-
(PyPI page of)
init_attrs_with_kwargs
https://pypi.org/project/init-attrs-with-kwargs/ -
type-docopt
, which introduces type declaration, and holds arguments/options in dict. https://pypi.org/project/type-docopt/
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 init_attrs_with_kwargs-0.1.9.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ec9cc4674fa8c7c497388e63019156aa8d0b2ecea94526304d35c152e80d9796 |
|
MD5 | fb9871835da545f903033f542e42b06d |
|
BLAKE2b-256 | 332468743a0b156769c17910b819118563b9907e2406f52315104e66e649b3d4 |
Hashes for init_attrs_with_kwargs-0.1.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3fec48a39074a6863891ef61c4431fd54c0549b1f5c44d329c1c50051891ebd8 |
|
MD5 | 672a95ca8cde8d171372eeee9429cc69 |
|
BLAKE2b-256 | 81f220d1eae5884f639dee6b111360c351408ec3db353e85662c0c2e5a93f6f9 |