argparse-tui¶
Classes¶
TuiAction ¶
TuiAction(option_strings: list[str], dest: str = argparse.SUPPRESS, default: Any = argparse.SUPPRESS, help: str | None = 'Open Textual UI.', const: str | None = None, metavar: str | None = None, parent_parser: argparse.ArgumentParser | None = None, **_kwargs: Any)
argparse Action
that will analyze the parser and display a TUI.
PARAMETER | DESCRIPTION |
---|---|
option_strings
|
...
TYPE:
|
dest
|
...
TYPE:
|
default
|
...
TYPE:
|
help
|
...
TYPE:
|
const
|
...
TYPE:
|
metavar
|
...
TYPE:
|
parent_parser
|
...
TYPE:
|
Examples:
>>> import argparse
>>> from argparse_tui import TuiAction
...
>>> parser = argparse.ArgumentParser()
>>> _ = parser.add_argument('--tui', action=TuiAction)
...
>>> parser.print_usage()
usage: __main__.py [-h] [--tui]
Functions¶
add_tui_argument ¶
add_tui_argument(parser: argparse.ArgumentParser, parent_parser: argparse.ArgumentParser | None = None, option_strings: str | list[str] | None = None, help: str = 'Open Textual UI.', default=argparse.SUPPRESS, **kwargs) -> None
PARAMETER | DESCRIPTION |
---|---|
parser
|
the argparse parser to add the argument to.
TYPE:
|
parent_parser
|
the parent of the given parser.
TYPE:
|
option_strings
|
list of CLI flags that will invoke the TUI
TYPE:
|
help
|
...
TYPE:
|
default
|
...
DEFAULT:
|
**kwargs
|
passed to
DEFAULT:
|
Examples:
>>> import argparse
>>> from argparse_tui import add_tui_argument
...
>>> parser = argparse.ArgumentParser()
...
>>> add_tui_argument(parser)
...
>>> parser.print_usage()
usage: __main__.py [-h] [--tui]
add_tui_command ¶
add_tui_command(parser: argparse.ArgumentParser, command: str = DEFAULT_COMMAND_NAME, help: str = 'Open Textual UI.', **kwargs: Any) -> argparse._SubParsersAction
PARAMETER | DESCRIPTION |
---|---|
parser
|
the argparse parser
TYPE:
|
command
|
name of the CLI command that will invoke the TUI (default=
TYPE:
|
help
|
help message for the argument
TYPE:
|
**kwargs
|
if subparsers do not already exist, create with these kwargs.
TYPE:
|
RETURNS | DESCRIPTION |
---|---|
_SubParsersAction
|
The Argparse subparsers action that was discovered or created. |
Examples:
>>> import argparse
>>> from argparse_tui import add_tui_argument
...
>>> parser = argparse.ArgumentParser()
>>> subparsers = parser.add_subparsers()
...
>>> _ = add_tui_command(parser)
...
>>> parser.print_usage()
usage: __main__.py [-h] {tui} ...
build_tui ¶
build_tui(parser: argparse.ArgumentParser, cli_args: Sequence[str] | None = None, subparser_ignorelist: list[argparse.ArgumentParser] | None = None) -> App
Build a Textual UI (TUI) given an argparse parser.
PARAMETER | DESCRIPTION |
---|---|
parser
|
...
TYPE:
|
cli_args
|
Arguments parsed for pre-populating the TUI form.
TYPE:
|
subparser_ignorelist
|
...
TYPE:
|
RETURNS | DESCRIPTION |
---|---|
App
|
a Textualize App |
Examples:
>>> import argparse
>>> from argparse_tui import build_tui
>>> import textual
...
>>> parser = argparse.ArgumentParser(prog="awesome-app")
>>> _ = parser.add_argument("--value")
...
>>> app = build_tui(parser)
...
>>> isinstance(app, textual.app.App)
True
invoke_tui ¶
invoke_tui(parser: argparse.ArgumentParser, cli_args: Sequence[str] | None = None, subparser_ignorelist: list[argparse.ArgumentParser] | None = None) -> None
Invoke a Textual UI (TUI) given an argparse parser.
PARAMETER | DESCRIPTION |
---|---|
parser
|
...
TYPE:
|
cli_args
|
Arguments parsed for pre-populating the TUI form.
TYPE:
|
subparser_ignorelist
|
...
TYPE:
|
Examples:
>>> import argparse
>>> from argparse_tui import invoke_tui
...
>>> parser = argparse.ArgumentParser(prog="awesome-app")
>>> _ = parser.add_argument("--value")
...
>>> invoke_tui(parser)