h SSKJr SSKJrJrJrJrJrJr SSK J r SSK J r SSK Jr SSKJr \"S5rS S S S S S S S S S . SS jjr04S S S.SSjjjrg )) annotations)AnyMappingSequenceTupleTypeVarUnion) Annotated)Suppress)ConstructorRegistry)TypeFormTNFT) prog descriptionargsuse_underscoresconsole_outputsadd_helpconfigsort_subcommandsregistryc dSSKn [UR55n U RU RR U V s0sH oX S_M sn U V s0sH oX S_M sn US9UUUUUUU R R4Uc [5O [U5-U S9 $s sn fs sn f)a Helper function for creating a CLI interface that allows us to choose between default config objects (typically dataclasses) and override values within it. Turns off subcommand creation for any union types within the config object. This is a lightweight wrapper over :func:`tyro.cli()`, with some default arguments populated. Also see :func:`tyro.extras.subcommand_type_from_defaults()`. Example usage: .. code-block:: python import dataclasses import tyro @dataclasses.dataclass class Config: a: int b: str default_configs = { "small": ( "Small config", Config(1, "small"), ), "big": ( "Big config", Config(100, "big"), ), } config = tyro.extras.overridable_config_cli(default_configs) print(config) Args: configs: A dictionary of config names mapped to a tuple of (description, config object). 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`. We include :class:`tyro.conf.AvoidSubcommands` by default. sort_subcommands: If True, sort the subcommands alphabetically by name. registry: A :class:`tyro.constructors.ConstructorRegistry` instance containing custom constructor rules. rN)defaults descriptionsr)rrrrrrrr) tyrolistkeyscliextrassubcommand_type_from_defaultsconfAvoidSubcommandstuple) configsrrrrrrrrrrrks S/home/james-whalen/.local/lib/python3.13/site-packages/tyro/extras/_base_configs.pyoverridable_config_clir)sV   D 88 110451A&5489DqWZ]*D9- 2  '' **,n57%-9  59s B( B-) prefix_namesrc^^^^SSKm[TR55nU(a [U5n[[ UUUU4SjU55[ S[44-$)aConstruct a Union type for defining subcommands that choose between defaults. For example, when ``defaults`` is set to: .. code-block:: python { "small": Config(...), "big": Config(...), } We return: .. code-block:: python Union[ Annotated[ Config, tyro.conf.subcommand("small", default=Config(...)) ], Annotated[ Config, tyro.conf.subcommand("big", default=Config(...)) ] ] Direct use of :py:data:`typing.Union` and :func:`tyro.conf.subcommand()` should generally be preferred, but this function can be helpful for succinctness. .. warning:: The type returned by this function can be safely used as an input to :func:`tyro.cli()`, but for static analysis when used for annotations we recommend applying a `TYPE_CHECKING` guard: .. code-block:: python from typing import TYPE_CHECKING if TYPE_CHECKING: # Static type seen by language servers, type checkers, etc. SelectableConfig = Config else: # Runtime type used by tyro. SelectableConfig = subcommand_type_from_defaults(...) Args: defaults: A dictionary of default subcommand instances. descriptions: A dictionary conttaining descriptions for helptext. prefix_names: Whether to prefix subcommand names. sort_subcommands: If True, sort the subcommands alphabetically by name. Returns: A subcommand type, which can be passed to :func:`tyro.cli`. rNc 3># UHIn[[TU5TRRUTUTR US5TS94v MK g7f))defaultr prefix_nameN)r typer# subcommandget).0r'rrr*rs r( 0subcommand_type_from_defaults..sf   !%II(( ( $0$4$4Q$;$0 ) sAA)rrrsortedr r%r r )rrr*rrrs``` @r(r"r"ps_|   Dd|     " T8^ $ &# ' )r&zMapping[str, Tuple[str, T]]r str | Nonerr8rzSequence[str] | Nonerboolrr9rr9rzSequence[Any] | Nonerr9rzConstructorRegistry | Nonereturnr) rzMapping[str, T]rzMapping[str, str]r*r9rr9r:z TypeForm[T]) __future__rtypingrrrrrr typing_extensionsr tyro.conf._markersr tyro.constructorsr _typingrrr)r"r7r(rBs "@@''1 CL "!%! #'"+/^ (^ ^ ^  ^  ^^^ !^^)^^F')V" VV#V V  V  Vr7