Create argparser automatically from functions
Project description
Overview
A wrapper around argparser to help build CLIs from functions. Uses type-hints extensively :snake:.
Setup
:gear: Installation
Install it directly into an activated virtual environment:
$ pip install arger
or add it to your Poetry project:
$ poetry add arger
:books: Usage
- create a python file called test.py
from arger import Arger
def main(param1: int, param2: str, kw1=None, kw2=False):
"""Example function with types documented in the docstring.
:param param1: The first parameter.
:param param2: The second parameter.
"""
print(locals())
if __name__ == '__main__':
Arger(main).run()
-
Here Arger is just a subclass of
ArgumentParser. It will not conceal you from using otherargparselibraries. -
run this normally with
python test.py 100 param2
- Checkout examples folder and documentation to see more of
argerin action. It supports any level of sub-commands.
Features
-
Uses docstring to parse help comment for arguments. Supports
-
Flags will be generated from parameter-name.
- e.g.
def main(param: ...)->-p, --param - If needed you could declare it inside docstring like
:param arg1: -a --arg this is the document.
- e.g.
-
one can use
Argumentclass to pass any values to the parser.add_argument function -
The decorated functions can be composed to form nested sub-commands of any level.
-
Most of the Standard types supported. Please see examples for more supported types with examples.
NOTE
*argssupported but no**kwargssupport yet.- all optional arguments that start with underscore is not passed to
Parser. They are considered private to the function implementation. Some parameter names with special meaning
_namespace_-> to get the output from theArgumentParser.parse_args()_arger_-> to get the parser instance
Argparser enhancements
- web-ui : https://github.com/nirizr/argparseweb
- extra actions : https://github.com/kadimisetty/action-hero
- automatic shell completions using argcomplete
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
File details
Details for the file arger-1.3.5.tar.gz.
File metadata
- Download URL: arger-1.3.5.tar.gz
- Upload date:
- Size: 12.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.4 CPython/3.8.7 Linux/5.4.0-1039-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d03de3b1c6bc60ae0af2d6f35ecba19ca25bf8e595cc9e270f89af840c578734 |
|
| MD5 | d21cca68d169d5957d9875a9f013f3e9 |
|
| BLAKE2b-256 | 64cdd2e89497bbfe9d706df1f3a84ef9c829936491b3376c99383debf281d872 |
File details
Details for the file arger-1.3.5-py3-none-any.whl.
File metadata
- Download URL: arger-1.3.5-py3-none-any.whl
- Upload date:
- Size: 12.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.4 CPython/3.8.7 Linux/5.4.0-1039-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6e5109ec321961925545d8581258d14ed0df065bc200d7cbe59622d7745b56cb |
|
| MD5 | fea5f8fc711e040cc4d035dc48711f3f |
|
| BLAKE2b-256 | 5a202de43712fc0261aa77df344b7541f089de840e046d4ea9bcc994bba83adf |
