hDvSSKJr SSKJrJrJrJrJrJr SSK r SSK J r J r SSK Jr \"S\S9r"SS 5rg) ) annotations)AnyCallableDictSequenceTypeVaroverloadN)delimeter_contextswap_delimeters)ConstructorRegistry CallableT)boundc \rSrSrSrSSjr\SSj5r\SSS.SSjjj5rSSS.SSjjjrSSSS S S SS SS . SS jjrS r g) SubcommandApp a This class provides a decorator-based API for subcommands in :mod:`tyro`, inspired by click. Under-the-hood, this is a light wrapper over :func:`tyro.cli`. Example: .. code-block:: python from tyro.extras import SubcommandApp app = SubcommandApp() @app.command def greet(name: str, loud: bool = False): '''Greet someone.''' greeting = f"Hello, {name}!" if loud: greeting = greeting.upper() print(greeting) @app.command(name="addition") def add(a: int, b: int): '''Add two numbers.''' print(f"{a} + {b} = {a + b}") if __name__ == "__main__": app.cli() Usage: .. code-block:: bash python my_script.py greet Alice python my_script.py greet Bob --loud python my_script.py addition 5 3 c0UlgN _subcommands)selfs U/home/james-whalen/.local/lib/python3.13/site-packages/tyro/extras/_subcommand_app.py__init__SubcommandApp.__init__3s 13cgr)rfuncs rcommandSubcommandApp.command6s58rN)namecgrr)rrr s rrr9s ,/rc2^^SUU4SjjnUbU"U5$U$)axA decorator to register a function as a subcommand. This method is inspired by Click's ``@cli.command()`` decorator. It adds the decorated function to the list of subcommands. Args: func: The function to register as a subcommand. If None, returns a function to use as a decorator. name: The name of the subcommand. If None, the name of the function is used. cD>Tc URmUTRT'U$r)__name__r)rr rs rinner$SubcommandApp.command..innerRs&|}}&*D  d #Krrr returnr r)rrr r%s` ` rrrAs$"    ; LrFT) prog descriptionargsuse_underscoresconsole_outputsadd_helpconfigsort_subcommandsregistryc URceU(a-[[URR5SS95n OURR 5n [ U(aSOS5 [ U R55n U H n U RU 5U [U 5'M" SSS5 [RRU UUUUUUUU S9 $!,(df  N3=f)aRun the command-line interface. This method creates a CLI using tyro, with all subcommands registered using :func:`command()`. Args: prog: The name of the program printed in helptext. Mirrors argument from `argparse.ArgumentParser()`. description: Description text for the parser, displayed when the --help flag is passed in. If not specified, the class docstring is used. Mirrors argument from `argparse.ArgumentParser()`. args: If set, parse arguments from a sequence of strings instead of the commandline. Mirrors argument from `argparse.ArgumentParser.parse_args()`. use_underscores: If True, use underscores as a word delimiter instead of hyphens. This primarily impacts helptext; underscores and hyphens are treated equivalently when parsing happens. We default helptext to hyphens to follow the GNU style guide. https://www.gnu.org/software/libc/manual/html_node/Argument-Syntax.html console_outputs: If set to `False`, parsing errors and help messages will be suppressed. add_help: Add a -h/--help option to the parser. This mirrors the argument from `argparse.ArgumentParser()`. config: Sequence of config marker objects, from `tyro.conf`. sort_subcommands: If True, sort the subcommands alphabetically by name. registry: A :class:`tyro.constructors.ConstructorRegistry` instance containing custom constructor rules. Nc US$)Nrr)xs r#SubcommandApp.cli..s qQRtr)key_-)r)r*r+r,r-r.r/r1) rdictsorteditemscopyr listkeyspopr tyroextrassubcommand_cli_from_dict) rr)r*r+r,r-r.r/r0r1 subcommandsorig_subcommand_names orig_names rcliSubcommandApp.cli_sN  ,,, vd&7&7&=&=&?^TUK++002Kos3 ?$()9)9);$< !2 :E//):T OI673@ {{33 #++4  @ ?s 2AC C-r)r(Noner'r)rrIr str | Noner(z Callable[[CallableT], CallableT])rzCallableT | Noner rJr(z,CallableT | Callable[[CallableT], CallableT])r)rJr*rJr+zSequence[str] | Noner,boolr-rKr.rKr/zSequence[Any] | Noner0rKr1zConstructorRegistry | Noner(r) r$ __module__ __qualname____firstlineno____doc__rr rrG__static_attributes__rrrrr s$L488 / // / * //"&   6 B "&%) % $'+!&/3? ?  ? # ?  ? ? ? %? ? -?  ? ? rr) __future__rtypingrrrrrr rA tyro._stringsr r tyro.constructorsr r rrrrrUs/"CC <1 Kx 0 R R r