Arguments parsing without boilerplate.
Features:
- arguments and type hints in IDE
- easy nested sub-commands
- sane defaults for arguments' params (ie if default of arg is 3 then type should be int, or when annotation/type/default is
bool
then generate 2 arguments: for true value--arg
and for false--no-arg
, ...) - 𝕡𝕣𝕖𝕥𝕥𝕪 𝕡𝕣𝕚𝕟𝕥𝕚𝕟𝕘
- support for argparse actions
- auto shortcuts generation:
--verbose -> -v, --foo_bar -> --fb
- auto completion in shell (tnx to argcomplete)
pip install argser
pip install argser[tabulate] # for fancy tables support
pip install argser[argcomplete] # for shell auto completion
pip install argser[all]
from argser import parse_args
class Args:
a = 'a'
foo = 1
bar: bool
args = parse_args(Args, show=True)
argparse alternative
from argparse import ArgumentParser
parser = ArgumentParser()
parser.add_argument('-a', type=str, default='a', help="str, default: 'a'")
parser.add_argument('--foo', '-f', dest='foo', type=int, default=1, help="int, default: 1")
parser.add_argument('--bar', '-b', dest='bar', action='store_true', help="bool, default: None")
parser.add_argument('--no-bar', '--no-b', dest='bar', action='store_false')
parser.set_defaults(bar=None)
args = parser.parse_args()
print(args)
❯ python playground.py -a "aaa bbb" -f 100500 --no-b
>> Args(bar=False, a='aaa bbb', foo=100500)
❯ python playground.py -h
usage: playground.py [-h] [--bar] [--no-bar] [-a [A]] [--foo [FOO]]
optional arguments:
-h, --help show this help message and exit
--bar, -b bool, default: None.
--no-bar, --no-b
-a [A] str, default: 'a'.
--foo [FOO], -f [FOO]
int, default: 1.
from argser import parse_args, sub_command
class SubArgs:
d = 1
e = '2'
class Args:
a: bool
b = []
c = 5
sub = sub_command(SubArgs, help='help message for sub-command')
args = parse_args(Args, '-a -c 10', parser_help='help message for root parser')
assert args.a is True
assert args.c == 10
assert args.sub is None
args = parse_args(Args, '--no-a -c 10 sub -d 5 -e "foo bar"')
assert args.a is False
assert args.sub.d == 5
assert args.sub.e == 'foo bar'
❯ python playground.py -h
usage: playground.py [-h] [-a] [--no-a] [-b [B [B ...]]] [-c [C]]
{sub1,sub2} ...
positional arguments:
{sub1,sub2}
optional arguments:
-h, --help show this help message and exit
-a bool, default: None.
--no-a
-b [B [B ...]] List[str], default: [].
-c [C] int, default: 5.
❯ python playground.py sub1 -h
usage: playground.py sub1 [-h] [-d [D]] [-e [E]]
optional arguments:
-h, --help show this help message and exit
-d [D] int, default: 1.
-e [E] str, default: '2'.
- explicitly specify type annotation for arguments defined with
Arg
class to help your IDE
class Args:
a: int = Arg(default=3)
argser
will know about type of a
without annotation (it can be determined by default value),
but if you want your IDE to know that args.a
is int
and not Arg
then you need an explicit annotation.