֗jk*ddlmZddlZddlZddlZddlmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZddlmZddlmZmZmZdd lmZmZdd lmZdd lmZm Z dd l!m"Z"dd l#m$Z$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,erddl-m.Z.m/Z/ d& d'dZ0d(d)dZ1 d( d*dZ2ddddddddddddd d+dZ3ddddddddddddd d,dZ4dddddddddddddd d-dZ5dddddddddddddd d.dZ6dddddddddddd d/dZ7e ddddddddddejpd d0dZ9e ddddddddddejpd d1dZ9e ddddddddddejpd d2d Z9e d&ddddddddddejpd d3d!Z9ddddddd" d4d#Z:d&d5d$Z; d6 d7d%Z>   >>FD> QQr>c ddlm}m}m}|syt |t r#|dgddg|dddd |j }|jd |j d S) Nrr@z --completiongeneratecompleter)r(r*zFUse `--completion generate` to print shell-specific completion source.)r.choicesr0r/r1 completion)r4r1r5)r7r r$r&r8rArGr;)rGr r$r&s r<create_completion_argrHSss0/ *d# !,61-Y''     ##  r>) argvinputbackendcolorr2r/rGthemeoutputhelp_formatterstate exit_stackc t|||||||||| | |  } | 6| j| jj| jdS| jj | jdS)aParse the command, returning an instance of `obj`. In the event that a subcommand is selected, only the selected subcommand function is invoked. Arguments: obj: A class which can represent a CLI command chain. argv: Defaults to the process argv. This command is generally only necessary when testing. input: Defaults to the process stdin. This command is generally only necessary when testing. backend: A function used to perform the underlying parsing and return a raw parsed state. This defaults to the native cappa parser, but can be changed to the argparse parser at `cappa.argparse.backend`. color: Whether to output in color. version: If a string is supplied, adds a -v/--version flag which returns the given string as the version. If an `Arg` is supplied, uses the `name`/`short`/`long`/`help` fields to add a corresponding version argument. Note the `name` is assumed to **be** the CLI's version, e.x. `Arg('1.2.3', help="Prints the version")`. help: If `True` (default to True), adds a -h/--help flag. If an `Arg` is supplied, uses the `short`/`long`/`help` fields to add a corresponding help argument. completion: Enables completion when using the cappa `backend` option. If `True` (default to True), adds a --completion flag. An `Arg` can be supplied to customize the argument's behavior. theme: Optional rich theme to customized output formatting. output: Optional `Output` instance. A default `Output` will constructed if one is not provided. Note the `color` and `theme` arguments take precedence over manually constructed `Output` attributes. help_formatter: Override the default help formatter. state: Optional initial State object. exit_stack: Optional ExitStack to use for managing context managers. If provided, the caller is responsible for closing the stack, allowing context to exceed the function call. If not provided, contexts are not entered (parse does not manage contexts by default). objrIrJrKrLr2r/rGrMrNrOrPTrNmanagedF) parse_command enter_contextinstancegetrNcallrTrIrJrKrLr2r/rGrMrNrOrPrQ parse_results r<parser^ksf!   % L''  ! ! % %\-@-@$ % O    % %\-@-@% % PPr>c Kt|||||||||| | |  } | >| j| jj| jdd{S| jj | jdd{S737w)a Parse the command asynchronously, returning an instance of `obj`. This is the async version of `parse()`, necessary when using async parse functions. In the event that a subcommand is selected, only the selected subcommand function is invoked. Arguments: obj: A class which can represent a CLI command chain. argv: Defaults to the process argv. This command is generally only necessary when testing. input: Defaults to the process stdin. This command is generally only necessary when testing. backend: A function used to perform the underlying parsing and return a raw parsed state. This defaults to the native cappa parser, but can be changed to the argparse parser at `cappa.argparse.backend`. color: Whether to output in color. version: If a string is supplied, adds a -v/--version flag which returns the given string as the version. If an `Arg` is supplied, uses the `name`/`short`/`long`/`help` fields to add a corresponding version argument. Note the `name` is assumed to **be** the CLI's version, e.x. `Arg('1.2.3', help="Prints the version")`. help: If `True` (default to True), adds a -h/--help flag. If an `Arg` is supplied, uses the `short`/`long`/`help` fields to add a corresponding help argument. completion: Enables completion when using the cappa `backend` option. If `True` (default to True), adds a --completion flag. An `Arg` can be supplied to customize the argument's behavior. theme: Optional rich theme to customized output formatting. output: Optional `Output` instance. A default `Output` will constructed if one is not provided. Note the `color` and `theme` arguments take precedence over manually constructed `Output` attributes. help_formatter: Override the default help formatter. state: Optional initial State object. exit_stack: Optional AsyncExitStack to use for managing async context managers. If provided, the caller is responsible for closing the stack, allowing context to exceed the function call. If not provided, contexts are not entered (parse does not manage contexts by default). rSNTrUF)rWenter_async_contextrY get_asyncrN call_asyncr\s r< parse_asyncrcsj!   % L33  ! ! + +<3F3FPT + U   &&11""E2   s$AB B .B B B  B ) depsrIrJrKrLr2r/rGrMrNrOrPrQc t||||||||| | | |  dfd }| || Stj5}||cdddS#1swYyxYw)a+ Parse the command, and invoke the selected async command or subcommand. In the event that a subcommand is selected, only the selected subcommand function is invoked. Arguments: obj: A class which can represent a CLI command chain. deps: Optional extra depdnencies to load ahead of invoke processing. These deps are evaluated in order and unconditionally. argv: Defaults to the process argv. This command is generally only necessary when testing. input: Defaults to the process stdin. This command is generally only necessary when testing. backend: A function used to perform the underlying parsing and return a raw parsed state. This defaults to the native cappa parser, but can be changed to the argparse parser at `cappa.argparse.backend`. color: Whether to output in color. version: If a string is supplied, adds a -v/--version flag which returns the given string as the version. If an `Arg` is supplied, uses the `name`/`short`/`long`/`help` fields to add a corresponding version argument. Note the `name` is assumed to **be** the CLI's version, e.x. `Arg('1.2.3', help="Prints the version")`. help: If `True` (default to True), adds a -h/--help flag. If an `Arg` is supplied, uses the `short`/`long`/`help` fields to add a corresponding help argument. completion: Enables completion when using the cappa `backend` option. If `True` (default to True), adds a --completion flag. An `Arg` can be supplied to customize the argument's behavior. theme: Optional rich theme to customized output formatting. output: Optional `Output` instance. A default `Output` will constructed if one is not provided. Note the `color` and `theme` arguments take precedence over manually constructed `Output` attributes. help_formatter: Override the default help formatter. state: Optional initial State object. exit_stack: Optional ExitStack to use for managing context managers. If provided, the caller is responsible for closing the stack, allowing context to exceed the function call. If not provided, a new stack is created and automatically closed. rSc F|j jj j}i} jj D]3\}}|j|j j||<5t j j|| j j\}}|D]-}|j|j j/|j|j jSN)rN) implicit_depsrNrPrd) rXrYrZrNrhitemsr root_commandparsed_commandrP stackrYresolved_implicit_depskey resolved_depresolved global_depsdeprdr]s r<_invoke_with_stackz"invoke.._invoke_with_stackCs&&  ! ! % %\-@-@ % A  79!-!;!;!A!A!C C*/*=*=  (;(; <+ "3 '"D !1  % %  ' ' 0&&$$! +C   |/B/B C D""8<<|7J7J<#KLLr>N)rmzcontextlib.ExitStack)rW contextlib ExitStack)rTrdrIrJrKrLr2r/rGrMrNrOrPrQrtrmr]s ` @r<invokerwsoj!   % LM4!*--    5!%(  s AAc $Kt||||||||| | | |  dfd }| || d{Stj4d{}||d{cdddd{S7B7'77 #1d{7swYyxYww)a0 Parse the command, and invoke the selected command or subcommand. In the event that a subcommand is selected, only the selected subcommand function is invoked. Arguments: obj: A class which can represent a CLI command chain. deps: Optional extra depdnencies to load ahead of invoke processing. These deps are evaluated in order and unconditionally. argv: Defaults to the process argv. This command is generally only necessary when testing. input: Defaults to the process stdin. This command is generally only necessary when testing. backend: A function used to perform the underlying parsing and return a raw parsed state. This defaults to the native cappa parser, but can be changed to the argparse parser at `cappa.argparse.backend`. color: Whether to output in color. version: If a string is supplied, adds a -v/--version flag which returns the given string as the version. If an `Arg` is supplied, uses the `name`/`short`/`long`/`help` fields to add a corresponding version argument. Note the `name` is assumed to **be** the CLI's version, e.x. `Arg('1.2.3', help="Prints the version")`. help: If `True` (default to True), adds a -h/--help flag. If an `Arg` is supplied, uses the `short`/`long`/`help` fields to add a corresponding help argument. completion: Enables completion when using the cappa `backend` option. If `True` (default to True), adds a --completion flag. An `Arg` can be supplied to customize the argument's behavior. theme: Optional rich theme to customized output formatting. output: Optional `Output` instance. A default `Output` will constructed if one is not provided. Note the `color` and `theme` arguments take precedence over manually constructed `Output` attributes. help_formatter: Override the default help formatter. state: Optional initial State object. exit_stack: Optional AsyncExitStack to use for managing async context managers. If provided, the caller is responsible for closing the stack, allowing context to exceed the function call. If not provided, a new stack is created and automatically closed. rSc K|j jj jd{}i} jj D];\}}|j|j jd{||<=t j j|| j j\}}|D]5}|j|j jd{7|j|j jd{S7 77>7 wrg) r`rYrarNrhrirrjrkrPrls r<_invoke_async_with_stackz.invoke_async.._invoke_async_with_stacksJ22  ! ! + +<3F3F + G   79!-!;!;!A!A!C C050I0I&&l.A.A&B1+ "3 '"D !1  % %  ' ' 0&&$$! +C++CMMATATM,UV V V..   l&9&9  :   / + W sG9EEAEEA9E E  4EE EE E EN)rmzcontextlib.AsyncExitStack)rWruAsyncExitStack)rTrdrIrJrKrLr2r/rGrMrNrOrPrQrzrmr]s ` @r< invoke_asyncr|dsj!   % L 8-j999((**e-e44+**:*4+***si,BA3B A5B A;A7A;! B-A9.B5B7A;9B;B B B  B) rIrJrKrLr2r/rGrMrNrOrPc t|} t| ||} tj| }t ||||| | |}|j ||| | |S)N)r/r2rGrKrOrP)rIrJrKrNrP)_coalesce_backend_coalesce_outputrensurecollectrW)rTrIrJrKrLr2r/rGrMrNrOrPconcrete_backendconcrete_outputconcrete_statecommands r<rWrWss)1&vueF namealiasesr/ descriptionepilogrwhidden default_short default_long deprecatedrOc yN _clsrrr/rrrwrrrrrOs r<rrsr>c yrrrs r<rrsr>c yrrrs r<rrs r>c P d   f d } || |S| S)aRegister a cappa CLI command/subcomment. Args: name: The name of the command. If omitted, the name of the command will be the name of the `cls`, converted to dash-case. aliases: Alternate names that may be used to invoke this command as a subcommand. Each entry is either a plain string (visible alias) or an :class:`Alias` instance (which can be marked `hidden=True` or `deprecated=...`). Only meaningful when the class is used as a subcommand. help: Optional help text. If omitted, the `cls` docstring will be parsed, and the headline section will be used to document the command itself, and the arguments section will become the default help text for any params/options. description: Optional extended help text. If omitted, the `cls` docstring will be parsed, and the extended long description section will be used. epilog: Optional text displayed after the argument list in the help output. invoke: Optional command to be called in the event parsing is successful. In the case of subcommands, it will only call the parsed/selected function to invoke. hidden: If `True`, the command will not be included in the help output. This option is only relevant to subcommands. default_short: If `True`, all arguments will be treated as though annotated with `Annotated[T, Arg(short=True)]`, unless otherwise annotated. default_long: If `True`, all arguments will be treated as though annotated with `Annotated[T, Arg(long=True)]`, unless otherwise annotated. deprecated: If supplied, the argument will be marked as deprecated. If given `True`, a default message will be generated, otherwise a supplied string will be used as the deprecation message. help_formatter: Override the default help formatter. cx tj|r t|stj|}t j |}tj|  tn |j    }||_ tj|rtt|S|jS)N) rwrrr/rrrrrrrO)inspectisclassrr6 dataclassrrZr#listr __cappa__ isfunctionrrcmd_cls)_decorated_clsrrYrrrrrrr/rOrrwrs r<wrapperzcommand..wrapperQs ??> *6.3I(22>BN%kk.9&& %,%8DMgoo#'%!)  $,    n ->* *r>)rrreturnrr) rrrr/rrrwrrrrrOrs ``````````` r<rr!s&`  < t} Nr>)rKr2r/rGrOrPc"tj|}tj||j |}t |}|t jurd}t|} t|} t|} |j| | | S)aRetrieve the `Command` object from a cappa-capable source class. Arguments: obj: A class which can represent a CLI command chain. backend: A function used to perform the underlying parsing and return a raw parsed state. This defaults to constructing built-in function using argparse. version: If a string is supplied, adds a -v/--version flag which returns the given string as the version. If an `Arg` is supplied, uses the `name`/`short`/`long`/`help` fields to add a corresponding version argument. Note the `name` is assumed to **be** the CLI's version, e.x. `Arg('1.2.3', help="Prints the version")`. help: If `True` (default to True), adds a -h/--help flag. If an `Arg` is supplied, uses the `short`/`long`/`help` fields to add a corresponding help argument. completion: Enables completion when using the cappa `backend` option. If `True` (default to True), adds a --completion flag. An `Arg` can be supplied to customize the argument's behavior. color: Whether to output in color. help_formatter: Override the default help formatter. state: Optional initial State object. )rO)rPF)r/r2rG) rrrrZrr~r rKrBr=rHadd_meta_actions) rTrKr2r/rGrOrPrrhelp_arg version_argcompletion_args r<rrts: LL E&{{ N  gEg )18+++ t$H$W-K*:6N  # # {~ $ r>c*|tjS|Sr)r rK)rKs r<r~r~s~~ Nr>cf| t}|j||s|jd|S)NF)rrMrL)rNrMrLs r<rrs0~ LL  U Mr>r)r2str | Arg[Any] | NonerzFinalArg[Any] | None)T)r/zbool | Arg[bool] | NonerFinalArg[bool] | None)rGbool | Arg[bool]rr)rTCappaCapable[T]rIlist[str] | NonerJ TextIO | NonerKBackend | NonerLrAr2rr/bool | Arg[Any]rGrrM Theme | NonerN Output | NonerOHelpFormattable | NonerPState[Any] | NonerQcontextlib.ExitStack | Nonerr)rTrrIrrJrrKrrLrAr2rr/rrGrrMrrNrrOrrPrrQ contextlib.AsyncExitStack | Nonerr)rTrrdrrIrrJrrKrrLrAr2rr/rrGrrMrrNrrOrrPrrQrrr)rTrrdrrIrrJrrKrrLrAr2str | Arg[str] | Noner/rrGrrMrrNrrOrrPrrQrrr)rTrrIrrJrrKrrLrAr2rr/rrGrrMrrNrrOrrPzState[S] | NonerzParseResult[T, S])rtype[T]r str | Nonerlist[str | Alias] | Noner/rrrrrrwInvokeCallableSpec[Any] | NonerrArrArrArrArOrrr)rrrrr/rrrrrrwrrrArrArrArrArOrrr)rrrrrrr/rrrrrrwrrrArrArrArrArOrrr)rztype[T] | T | Nonerrrrr/rrrrrrwrrrArrArrArrArOrrz"type[T] | T | FuncOrClassDecorator)rTrrKrr2rr/rrGrrOrrPrrzFinalCommand[T])rKrrr)NNT)rNrrMrrLrA)= __future__rrur6rtypingrrrrrr rich.themer typing_extensionsr cappar r cappa.class_inspectr cappa.commandrrr cappa.helprrcappa.invoke.basercappa.invoke.typesrr cappa.outputr cappa.staterr cappa.typesrrrrrrr7r r!r=rBrHr^rcrwr|rWr5rrr~rrr>r<rs"1"&665.; VV'&* "BR&$( 6""%) "& -1#.2EQ EQ EQ  EQ  EQ  EQ#EQ EQ EQ EQ EQ+EQ EQ,EQEQV""%) "& -1#37I I I  I  I  I#I I I I I+I I1II^!"%) "& -1#.2b) b) b)  b)  b)  b) b)#b) b) b) b) b)+b) b),b)  !b)P!"%)!#' -1#37d5 d5 d5  d5  d5  d5 d5#d5 d5!d5 d5 d5+d5 d51d5  !d5T""%)!#' -1!" " "  "  "  "#" "!" " "+" ""J (,"-1&3&;&;  &       + $   (,"-1&3&;&;   &        +      $     (,"-1&3&;&;    &         +      $    "#O(,"-1&3&;&;O O O& O  O  O O +O OOOO$O(OOj#%)!#'-1#- --# -  - ! -+- --`MQ   )5 EI r>