arger 1.2.0

Create argparser automatically from functions

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 other argparse libraries.

• run this normally with

python test.py 100 param2

• Checkout examples folder and documentation to see more of arger in action. It supports any level of sub-commands.

Features

• Uses docstring to parse help comment for arguments. Supports
  • google
  • numpy
  • rst
• Flags will be generated from parameter-name. If needed you could declare it inside docstring like :param arg1: -a --arg this is the document. Also one can use def main(arg1:int=Argument(flags=('-a', '--arg'), ...): ...
• The decorated functions can be composed to form nested sub-commands of any level.
• No external lib dependency
• Most of the Standard types supported. Please see examples for more supported types with examples.
• All argument to ArgumentParser.add_argument is supported. It can be updated with arger.Argument classes.
• *args supported but no **kwargs support 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 the ArgumentParser.parse_args()
  • _arger_ -> to get the parser instance

Similar Projects

argh

• has similar goals as to ease up using argparser.
• doesn't support type hints.
• No recent releases.

typer

• if you are using click , I highly recommend you to check this library.
• it is neat and many features are drawn from it.
• doesn't support loading help text for arguments from docstrings.

invoke

• doesn't support type hints.

cliche

• has similar goals.
• doesn't cover much use cases as arger .

cliar

• no docstring support for help argument.

Recommended Alternatives

Projects that I highly recommend you to checkout.

1. clize
2. nuclear
3. defopt

This project was generated with cookiecutter using jacebrowning/template-python.

Argparser enhancements

• web-ui : https://github.com/nirizr/argparseweb
• extra actions : https://github.com/kadimisetty/action-hero
• automatic shell completions using argcomplete