oppapī
Ergonomic option parser on top of dataclasses, inspired by structopt.
Usage
from typing import Optional
from oppapi import from_args, oppapi
@oppapi
class Opt:
"""
Option parser using oppapi
"""
host: str
""" This will be positional argument of type `str` """
port: Optional[int] = 8000
""" Optional argument will be option argument """
opt = from_args(Opt)
print(opt)
The code above generates such option parser that
- Generates parser description from class's docstring
- Generates argument description from field's docstring
- A field will be a positional argument
- An optional field will be an optional argument
See the parser help message:
$ python simple.py -h
usage: simple.py [-h] [-p PORT] host
Option parser using oppapi
positional arguments:
host This will be positional argument of type `str`
optional arguments:
-h, --help show this help message and exit
-p PORT, --port PORT Optional argument will be option argument
Running the program deserializes the command line arguments into an object of the declared class.
$ python simple.py localhost -p 20000
Opt(host='localhost', port=20000)
Supported types
- Primitives (
int,float,str,bool) - Containers (
List,Tuple) typing.OptionalEnumandIntEnumdatetimedecimalipaddresspathlibuuid
short/long
oppapi generates flag names automatically, but you can specify arbitrary short/long names.
from typing import Optional
from oppapi import from_args, oppapi, field
@oppapi
class Opt:
host: Optional[str] = field(short="-n", long="--hostname")
enum
enum.Enum and enum.IntEnum will be an argument with choices parameter.
class Food(Enum):
A = "Apple"
B = "Beer"
C = "Chocolate"
class Price(IntEnum):
A = 10
B = 20
C = 30
@oppapi
class Opt:
food: Food
price: Optional[Price]
usage will be like this:
positional arguments:
{Apple,Beer,Chocolate}
optional arguments:
-h, --help show this help message and exit
-p {10,20,30}, --price {10,20,30}
oppapi converts the command line arguments back to Enum.
$ python choice.py Apple --price 20
Opt(food=<Food.A: 'Apple'>, price=<Price.B: 20>)
List/Tuple
List will be an arbitrary number of arguments (nargs="+"). Tuple will be a fixed number of arguments (nargs=NUM).
@oppapi
class Opt:
values: List[int]
opts: Optional[Tuple[int, str, float, bool]]
$ python nargs.py 1 2 3 --opts 10 foo 10.0 True
Opt(values=[1, 2, 3], opts=(10, 'foo', 10.0, True))
SubCommand
Union will be subcommands.
from typing import Optional, Union
from oppapi import from_args, oppapi
@oppapi
class Foo:
a: int
@oppapi
class Bar:
b: Optional[int]
@oppapi
class Opt:
cmd: str
sub: Union[Foo, Bar]
def main():
opt = from_args(Opt)
$ python subcommand.py -h
usage: subcommand.py [-h] cmd {foo,bar} ...
positional arguments:
cmd
{foo,bar}
optional arguments:
-h, --help show this help message and exit
Flatten
TODO
LICENSE
This project is licensed under the MIT license
1 Nov 2, 2021
1 Nov 3, 2021
31 Nov 23, 2022
1 Dec 13, 2021
1 Dec 15, 2021
1 Dec 17, 2021
101 Oct 30, 2022
1 Jul 15, 2022
55 Jul 29, 2021
7 Aug 18, 2022
6 May 16, 2022
1 Jan 07, 2022
1 Jan 31, 2022
79 Dec 14, 2022
419 Jan 01, 2023
3 Nov 07, 2021
6.2k Dec 29, 2022
15 Aug 26, 2022
176 Dec 16, 2022
3.2k Jan 08, 2023
276 Dec 19, 2022
97 Dec 29, 2022
261 Jan 04, 2023
13 Jul 05, 2021
13 May 10, 2022
10 Jan 16, 2022
22 Nov 15, 2022
2 Apr 29, 2022
7 Mar 20, 2022