k7iu,SSKrSSKrSSKrSSKrSSKrSSKJrJrJrJ r J r SSK J r SSK J r SSKJr SSKJrJr SSKJr SSKJr SS KJr SS KJrJrJrJrJrJrJ r J!r!J"r" SS K#J$r$J%r%J&r& SS K'J(r( SS K)J*r* SSK+J,r, SSK-J.r.J/r/J0r0 SSK1J2r2 SSK3J4r4 SSK5J6r6J7r7J8r8J9r9J:r:J;r; SSKr> SSK?J@r@ SSKAJBrB SSKCJDrDJErE SSKFJGrG SSKHJIrI SSKJJKrKJLrLJMrMJNrNJOrOJPrPJQrQJRrR \RS:aO\ "\T5 SSKUrUSSS5 \(aSSKVJWrW SSKXJYrY SSKZJ[r[ SSK\J]r] SSK^J_r_J`r` SS KaJbrb \"S!\S"\4S#9rc\"S$5rdS%reS&S\-\\-S'\f\S"4S-4S(jrg"S)S*\h5riS+rjS,rkS-rlSBS1jrmS2\n\o\4S0S/S'S4S3jrpS4\oS'\o4S5jrqSCS.\S/S'\n\oS644S7jjrrSDS8jrsS9S\o-\=-S'\=S-4S:jrt\%"S;S/55ruS'\vS-4S<jrw"S=S>\o\5rx\S'\x4S?j5ry\S@\xS'S4SAj5rzg!,(df  GN =f)EN)Callable CoroutineIterableIteratorSequence)suppress)copy)Enum) lru_cachepartial)chain)Path) ModuleType) TYPE_CHECKING AnnotatedAnyLiteralOptionalTypeVarUnioncastoverload)Factorydefinefield)resolve_annotated)AppStack)ArgumentCollection)create_bound_argumentsis_option_likenormalize_tokens) CommandSpec)Env)CommandCollisionError CycloptsErrorUnknownCommandErrorUnknownOptionErrorUnusedCliTokensErrorValidationError)Group sort_groups)groups_from_app) CycloptsPanel) Parametervalidate_command) Dispatcher)Token)UNSET!create_error_console_from_consoledefault_name_transformhelp_formatter_converteroptional_to_tuple_convertersort_key_converterto_list_converterto_tuple_converter) Console) DocFormat) HelpPanel) HelpFormatter) ResultActionResultActionSingle)_run_maybe_async_commandT.)boundVmarkdownvaluereturncHUcg[U5nU(d [S5eU$)zConvert result_action value, ensuring non-empty sequences. Intended to be used in an ``attrs.Field`` for result_action. Raises ValueError if an empty iterable is provided. Nz)result_action cannot be an empty sequence)r9 ValueError)rHresults G/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/core.py_result_action_converterrNUs*  }  &F DEE Mc\rSrSrSrg)#_CannotDeriveCallingModuleNameErrorfN)__name__ __module__ __qualname____firstlineno____static_attributes__rSrOrMrQrQfsrOrQc[R"5HPn[R"UR5nUcM(URR S5SnUS:XaMNUs $ [ e)z1Get the calling package name from the call-stack..rcyclopts)inspectstack getmoduleframerTsplitrQ)elemmoduleroot_module_names rM_get_root_module_namerdjsa ""4::. > !??005a8 z )   .-rOcF[U[5(a [S5eU$)N%Cannot register a sub-App to default.) isinstanceApp TypeError)xs rM_validate_default_commandrkxs !S?@@ HrOc[UR5(a1[R"UR5(a UR$UR $N)callableversionr\iscoroutinefunction_version_print_async version_print)apps rM_get_version_commandrt~s= ! $ $Z%A%A B ##J$?$?@ {{z11= ((  >rOkwargscSU;a[UR5US'SU;a[UR5US'SU;a[UR5US'gg)zApply parent app's groups to kwargs dict if not already specified. Parameters ---------- kwargs : dict Keyword arguments dict to modify. parent_app : App The parent app to inherit groups from. group_commandsgroup_parametersgroup_argumentsN)r rwrxry)r{rus rM_apply_parent_groups_to_kwargsrscv%#' (B(B#C '%)**F*F%G!"&$()D)D$E !'rOscbURSS5RSS5R5$)a-Normalize a string for fuzzy command matching. Removes hyphens, underscores, and converts to lowercase (e.g., 'mycommand' matches 'my-command'). .. warning:: This fuzzy matching is primarily for backward compatibility with the introduction of ``_pascal_to_snake`` in ``default_name_transform``. It should **probably be removed in v5** once users have migrated their camelCase command names. Parameters ---------- s : str String to normalize. Returns ------- str Normalized string with hyphens/underscores removed and lowercased. -_)replacelower)rs rM_normalize_for_matchingrs+, 99S"  % %c2 . 4 4 66rOApp | CommandSpecc|Uc0$[UR5nURHnUHnXS;dM XEX5'M M U(a4UR(a#UR [ URSS95 U(a6UR (a%[ UR SS9nUR U5 U$)a*Return a mapping of command names to Apps or CommandSpecs. CommandSpec instances are NOT resolved here - they are resolved lazily only when the command is actually executed, enabling true lazy loading. Parameters ---------- app : App | None The app to get commands from. recurse_meta : bool If True, include commands from the app's meta. recurse_parent_meta : bool If True, include commands from parent meta apps. Returns ------- dict[str, App | CommandSpec] Mapping of command names to :class:`App` or :class:`CommandSpec` instances. Frecurse_parent_meta recurse_meta)dict _commands_flattened_subapps_metaupdate_combined_meta_command_mapping _meta_parent)rsrrcommand_mappingsubappcmd_namemeta_parent_commandss rMrrs, { 3==)O((H.,2,<))  =cii]bcds//=c>N>N]bc34 rOc## U/nUnUR=n(aHUR(a7URU5 UR=n(aUR(aM7[U5ShvN gN7f)zsTypically the result looks like [app] or [meta_app, app]. Iterates from deepest to shallowest meta-app (and app). N)rdefault_commandappendreversed)rs meta_listmetas rM _walk_metasrsb I D:: 4 4#7#7:: 4 4#7#7#7 """sAA9#A91A72A9 input_valuecUcg[U[5(a [U5$[U[5(aU$[erm)rgstrr*ri)rs rM_group_converterrs; K % %[!! K ' 'rOc8\rSrSr%\"SS\S9rS\-\\S4-\ S'\"SSS9r \S-\ S '\"SS 9r \S-\ S '\"S\ S S 9r S\-\\S4-\ S'\"S\S S 9r\S\4S-\ S'\"SS S9r\S-\ S'\"SS\S S9rS\\S\\S4\/\4-\\\S\\S4\/\4-\ S'\"SS S9rS\-\S\4-\S\\\\44-\ S'\"S/\ SS S9r\\\-\ S'\"S S S9r\\ S'\"SS SS9r\S\ S'\"SS SS9r\S\ S '\"S!S"/\ S#S S9r \\\-\ S$'\"SS S9r!\"S%S-\ S&'\"SS S9r#\S-\ S''\"SS S9r$\S-\ S('\"SS S9r%\"S%S-\ S)'\"S\ S S 9r&\'\-\\'\-S4-\ S*'\"S+S\(S S,9r)\'\-S-\ S-'\"S.S\(S S,9r*\'\-S-\ S/'\"S0S\(S S,9r+\'\-S-\ S1'\"S\,S S 9r-\\S\4\ S2'\"SS3S S49r.\\/\4S-\ S5'\"SS6\/S S9r0\\ S7'\"SS S9r1\S-\ S8'\"SS S9r2\S-\ S9'\"SS S9r3\S-\ S:'\"SS S9r4\S-\ S;'\"S S S9r5\\ S<'\"SS S9r6\"S=S-\ S>'\"S\7S S 9r8\9S\"S?S@4\ SA'\"S\:S S 9r;\<\=-S-\ SB'\"SC\>SD9r?\>\SE4\ SF'\"SC\SD9r@\S\ SG'\"SCSSH9rA\S\ SI'\"SCSSH9rB\S\ SJ'\"SCSSCSK9rC\S-\ SL'\"SC\DSCSK9rE\FS-\G\D-\ SM'\"SCSSH9rH\S\ SN'\"SCSSH9rI\S\ SO'\"SC\J"\KS SP9SH9rL\K\ SQ'SRrMSS\\4STjrN\OSU5rP\PRSV5rP\OSW5rR\RRSX5rR\OSY\\S44SZj5rS\OS[5rT\TRS\5rT\OS]5rU\URS^5rU\OS_5rV\VRS`5rV\OSa5rW\WRSb5rW\OSY\4Scj5rX\XRSd5rX\OSe5rY\YRSf5rY\OSg5rZ\ZRSh5rZ\OSY\>\S44Sij5r[\OSSjj5r\\\RS\S4Skj5r\\OSSlj5r]\]RS\S4Smj5r]\OSY\FS-4Snj5r^SSo\SY\4Spjjr_Sq\S\SSYS4Srjr`SS\a\S\"SCSs94SYS4StjjrbSS\a\S\"SCSs94SYS4Sujjrc\OSv5rdSY\>\S44SwjreSx\SYS4SyjrfSSSzjjrgSx\4S{jrhS|\SY\4S}jriSY\j\4S~jrk\OSSj5rlSS S.SS\-\\-SY\\\S4\S\\44SjjjrmS\nSSY\S4SjroS\SS\\SY\\4Sjrp\qSSS.S\rSS\-\\-SS\-\\-S\sSY\r4 Sjjj5rt\qSSS.SSSS\-\\-SS\-\\-S\sSY\\r/\r44 Sjjj5rt\qSSS.S\SS\-\\-SS\-\\-S\sSYS4 Sjjj5rtSSS.S\rS-\-SS\-\\-SS\-\\-S\sSY\r\\r/\r4-S-4 Sjjjrt\qSS.S\rS2\S\4S-SY\r4Sjj5ru\qSSS.SSS2\S\4S-SY\\r/\r44Sjjj5ruSSS.S\rS-S2\S\4S-SY\r\\r/\r4-4SjjjruSSCS.S\S-S\SY\4SjjrvSSSSS.SS\-\\-S\SS\SS8\S-SY\\S\4\wR\\\>\\444 SjjjrySSCS.SS\-\\-S\SY\\S\4\wR\\\>\\4\44SjjjrzSSSSSSSSS.SS\-\\-S\SS\SS9\S-S:\S-S'\S-S;\S-S8\S-SY\\\wR\>\\444Sjjjr{SY\4Sjr|SSSSSSSSSSS. SS\-\\-S\SS\SS9\S-S:\S-S'\S-S;\S-S8\S-S>\"S=S-SB\\"S=S-SB\UHnX M g![a Mf=f)zSafely delete commands. Will **not** raise an exception if command(s) do not exist. Parameters ---------- commands: Iterable[str, ...] Strings of commands to delete. N)KeyError)rrcommands rM_delete_commandsApp._delete_commandss, G M   s  cUR$rm)rrs rMrApp.version_flagss"""rOc URUR5 XlUR(a3URURUR//URSS9 gg)NzDisplay application version.rrrror)rrrrrrorrHs rMrrs] d112#    LL""((  3   rOcUR$rm)rrs rMrApp.help_flagssrOc URUR5 XlUR(a3URURUR//URSS9 gg)NzDisplay this message and exit.r)rrr help_printrors rMrrs[ d../     LL%%  5   rOrIcUR(aURUR-$URcF[[R S5R nUS:Xa [5nU4UR-$URRnURU54UR-$![a# URRRnNKf=f)z?Application name(s). Dynamically derived if not previously set.rz __main__.py) rrrrrargvrrdrTrfuncr)rr func_names rMrApp.names :::: * *  ! ! ) $))D}$,.7TZZ' ' ? 0099 '' 24tzzA A" ? 0055>>  ?s?B44*C! C!c^URc[R"5$UR$rm)ryr*create_default_argumentsrs rMrApp.group_arguments s)  (113 3$$$rOcXlgrm)ryrs rMrrs %rOc^URc[R"5$UR$rm)rxr*create_default_parametersrs rMr~App.group_parameterss)  ! ! )224 4%%%rOcXlgrm)rxrs rMr~rs!&rOc^URc[R"5$UR$rm)rwr*create_default_commandsrs rMr}App.group_commandss)    '002 2###rOcXlgrm)rwrs rMr}r %$rOc8URRS5$)Nr)rresolvers rMr App.config)s~~%%i00rOcXlgrm)rrs rMrr-s rOcURb UR$URc$URcgURR$S[ R ;aYSSKJn [URU5(a!URRRnO-URRnOURRnUcgU$)Nr functoolsrr ) rrrrrrmodulesrr rgr__doc__)rr docs rMrApp.help1s :: !::   ! ! )zz!yy~~%ckk)-d22G<<..33;;C..66C**22{ rOcXlgrm)rrs rMrrLs rOcHUR(a UR$[$rm)rr4rs rMrApp.name_transformPs'+';';t##WAWWrOcXlgrm)rrs rMrrTr rOcDUR[LaS$UR$rm)rr2rs rMr App.sort_keyXs~~.tBDNNBrOc$[U5Ulgrm)r7rrs rMrr\s+E2rOch0nUH)nX R;dX R;aM#XX'M+ U$)z`Commands that are not help or version commands. This includes commands from flattened subapps. )rr)routrjs rM_registered_commandsApp._registered_commands`s; AOO#q,>,>'>WCF rOcURRS5nUbU$URcSSKJn U"5UlUR$)Nrrr<)rr r rich.consoler=)rrLr=s rMr App.consolemsH'' 3  M  ! ! ) ,%,YD "%%%rOcXlgrm)rrrs rMrr$}s rOcURRS5nUbU$URc[UR5UlUR$)Nr)rr rr3r)rrLs rMrApp.error_consolesK''(89  M  ' ' /+LT\\+ZD (+++rOcXlgrm)rr&s rMrr(s%rOcUR[LaGUR(a/[RR UR5UlOSUl[ [S-UR5$)z2Lazily resolve the module name to a module object.N)rr2rrrrrrrs rM_instantiating_moduleApp._instantiating_modulesV  + +u 4..36;;??4CbCb3c0370J%t'G'GHHrOrcSSKJn SSKJn URb3URRnUR S5SnU"U5$[5nU"U5$!Ua Of=fURR $![a NCf=f![a Us$f=f!Ua Of=f[R"U5nUR $![[4a U$f=f)aTGet the version string with multiple fallback strategies. First tries to derive from the instantiating module, then tries to get it from the calling code's module, and finally falls back to a default. Parameters ---------- default : str Default version to use if no version can be determined. Returns ------- str Version string. r)PackageNotFoundError)rorZ) importlib.metadatar.ror+rTr` __version__rrdrQ importlib import_module ImportError)rrr.importlib_metadata_versionfull_module_namercrbs rM_get_fallback_version_string App._get_fallback_version_strings <L  % % 1#99BB /55c:1=  12BCC 46  -.>? ?(   11===!   3 N  $     ,,-=>F%% %^,   sZA! BB&!A*)A*.B BB B#"B#&B/.B/3!CC)(C) version_rawcSSKJn URRS5nUcURRS[S9nUR XS9nU=(d UR RU5 g)zFormat and print the version string. Parameters ---------- version_raw : str Raw version string to format and print. console : ~rich.console.Console Console to print to. r InlineTextrNrfallbackformat) cyclopts.helpr;rr _DEFAULT_FORMAT from_formatrprint)rr8rr;rversion_formatteds rM_format_and_print_versionApp._format_and_print_versionsg -//0@A  !!^^33MO3\N&22;2V  DLL''(9:rOparsecLURbv[UR5(aO[R"UR5(a [ S5e[ [ UR55nOURnOUR5nURX!5 g)zPrint the application version. Parameters ---------- console: ~rich.console.Console Console to print version string to. If not provided, follows the resolution order defined in :attr:`App.console`. NzJasync version handler detected. Use App.run_async within an async context.) rornr\rprKrrr6rErrr8s rMrrApp.version_printsu << # %%..t||<<$%qrr"3 7 "ll ;;=K &&{>#& &--F(#''%'@$#.sm$#$#$#s#C5,D D5 D D D& cURU grm)r)rrXs rM __delitem__App.__delitem__ys NN3 rOrOcXR;agUR(aXR;agURH nX;dM g g)NTF)rrr)rrOrs rM __contains__App.__contains__|sD     %%%--F{.rOc#T# [UR5nUShvN [U5nUR(a/URHnX!;dM Uv UR U5 M! UR H(nUHnX!;dM Uv UR U5 M! M* gN7f)a\Iterate over command & meta command names. Example usage: .. code-block:: python from cyclopts import App app = App() @app.command def foo(): pass @app.command def bar(): pass # help and version flags are treated as commands. assert list(app) == ["--help", "-h", "--version", "foo", "bar"] N)listrsetraddr)rrrrs rM__iter__ App.__iter__s2'x=   ,,*!MLL)- --F!*!MLL)". sB(B&2B(0B(B(c 4URc[U5"URUR[ UR 5[ UR 5[ UR5URS9UlXRl UR$)N)rrr}rr~r) rtyperrr rwryrxrrrs rMrApp.metasu :: d??"00#D$8$89 $T%:%: ;!%d&<&T(dg/nUnUR=nb"URU5 UR=nbM"TRUSSS25 g)ztIf ``app`` is a meta-app, also add it's "normal" app. We assume that ``app._meta`` will always invoke the ``app``. N)rrextend)rs meta_parents meta_parentappsros rMadd_parent_metas,App.parse_commands..add_parent_metass^ 'LK"-":"::;G##K0#.":"::;G KK TrT* +rOrrNrzAmbiguous command 'z'. Could match: , rZ)r!rr startswithrlenrKjoinsorted_consume_leading_meta_optionsrgr"r tuple)rrpro command_chainrs unused_tokensrxrtoken app_or_specnormalized_tokenrmatches remainingrurws ` @rMparse_commandsApp.parse_commandssL"&)   ,  C8Ref !!$EK'-4 %%c**$;5#A -<-<@WX`@aeu@uH_w<1$"1!*"=K\A%$':5'AQRVR[R[\bcj\kRlQmmn%opp"' $ B B4 WI9~M(::(1   +{33 !))*5! S ! KK >d2hnn<<  # #DHNN 3 (H &.&K&K&M#!4'!-E*. ! ) ?" !i(  s/C5D#D6DD 5 D DD)robjr{c grmrSrrrrr{s rMr App.commands rOc grmrSrs rMrrsrOc grmrSrs rMrrsrOc 6Uc[UR4X#S.UD6$US:XaZ[U[5(d [ S5eU(a [ S5e[ X5 URRU5 U$[U[5(aUc'URS5u pVURU54nO [U5nUcSnO [U5n[X(aUSOSUS 9nX#-H%nX;a[S US 35eXpRU'M' g[U[5(a;Un U R cUc [ S 5eU(a [ S 5e[ X5 OUR#SUR$5 UR#SUR&5 SU;aUR(bUR(US'[+X@5 [-U5"S0UD6n U R/U5 [1U R$U R&5H n SXlM U R4cURU l Uc U R6nO [U5nUcSnO [U5nX#-H%nX;a[S US 35eXRU'M' U$)a%Decorator to register a function as a CLI command. Example usage: .. code-block:: from cyclopts import App app = App() @app.command def foo(): print("foo!") @app.command(name="buzz") def bar(): print("bar!") # Lazy loading via import path app.command("myapp.commands:create_user", name="create") app() .. code-block:: console $ my-script foo foo! $ my-script buzz bar! $ my-script create # Imports and runs myapp.commands:create_user Parameters ---------- obj: Callable | App | str | None Function, :class:`App`, or import path string to be registered as a command. For lazy loading, provide a string in format "module.path:function_or_app_name". name: None | str | Iterable[str] Name(s) to register the command to. If not provided, defaults to: * If registering an :class:`App`, then the app's name. * If registering a **function**, then the function's name after applying :attr:`name_transform`. * If registering via **import path**, then the attribute name after applying :attr:`name_transform`. Special value ``"*"`` flattens all sub-App commands into this app (App instances only). See :ref:`Flattening SubCommands` for details. `**kwargs` Any argument that :class:`App` can take. N)rr*zYFlattening (name="*") is only supported for App instances, not functions or import paths.zLCannot supply additional configuration when flattening a sub-App (name="*").:rSr) import_pathr app_kwargsz Command "z" already registered.z#Sub-app MUST have a name specified.zDCannot supplied additional configuration when registering a sub-App.rrroF)r rrgrhrirKrzrrr rpartitionrr9r"r$rr setdefaultrrrorrlrr rrr) rrrrr{rrspecnrsflags rMrrszx ;4<<JdJ6J J 3;c3''o !opp )# 4  # # * *3 /J c3  |"%.."51++I68)$/}*513T!W$[abD\9/)A3>S0TUU$(q!"  c3  Cyy T\ !FGG !ghh )# 4   lDOO <   ot/A/A B&4<<+C$(LLy! *6 8t*&v&C KK #..#*;*;>@Q R 11!33+   rO)rrrcUUUS.nUR/US9 URU5upgpn SSS5 WWWW 4$!,(df  N=f)a>Interpret arguments into a registered function, :class:`~inspect.BoundArguments`, and any remaining unknown tokens. Parameters ---------- tokens: None | str | Iterable[str] Either a string, or a list of strings to launch a command. Defaults to ``sys.argv[1:]`` console: ~rich.console.Console Console to print help and runtime Cyclopts errors. If not provided, follows the resolution order defined in :attr:`App.console`. error_console: ~rich.console.Console Console to print error messages. If not provided, follows the resolution order defined in :attr:`App.error_console`. end_of_options_delimiter: str | None All tokens after this delimiter will be force-interpreted as positional arguments. If None, inherits from :attr:`App.end_of_options_delimiter`, eventually defaulting to POSIX-standard ``"--"``. Set to an empty string to disable. Returns ------- command: Callable Bare function to execute. bound: inspect.BoundArguments Bound arguments for ``command``. unused_tokens: list[str] Any remaining CLI tokens that didn't get parsed for ``command``. ignored: dict[str, Any] A mapping of python-variable-name to annotated type of any parameter with annotation ``parse=False``. :obj:`~typing.Annotated` will be resolved. Intended to simplify :ref:`meta apps `. )rrr overridesN)r_parse_known_args) rrprrrrrrErignoredrs rMparse_known_argsApp.parse_known_argss]X +(@ ^^B)^ 48<8N8Nv8V 5GMA5}g555 4s ; A raise_on_unused_tokensrc  ^^^Tc[[55 [T5mUnURTSS9upEnURTSS9umpgUSm[ [ 5 T(aqTS[ USRUSR-5;aBUSSnTSSmT(a1TS[ USRUSR-5;aMBSSS5 USmA0nURU5 TRRS5=(d Sn [UU4SjU 55n URRS S S 9n [TTRU 5n U b[ TRTR-5n TV s/sH oU ;dM U PM sn TSS&UV s/sH oU ;dM U PM sn USS&URnUR=n(a!URnUR=n(aM![R "U5R#TTR$S 9n/n['5nGO[)U4S jTR55(ay[+T5nUR=n(a [+U5nUR=n(aM [R "U5R#TR$S 9n/n['5nGObTR,(aTR,n[/U5 TR15nUR3SS9Vs0sH7nUR4R6[9UR4R:5_M9 nn[=TR,UUU U S9upTR>HnU"S0UR@D6 M TRRLH(nUR>HnU"S0UR@D6 M M* OVU(a [OUS9eURn[R "U5R#TTR$S9n/n['5nU(aOU(aHUH9n[QU5(dMURSS5Sn[U[WUSS9US9e [YXS9eSSS5 WWXxW4$!,(df  GN=fs sn fs sn fs snf![B[D[F4a0n[IURJ(aURJSOSTS9UeSnAff=f![B[D[F4a0n[IURJ(aURJSOSWS9UeSnAff=f![ZaJnTR,Ul.TUl/T(aTUl0UR$cTRbUleSnAff=f!,(df  GN=f)NTrnFrsrrSc3>># UHn[UTT5v M g7frmr).0rj command_apprs rM (App._parse_known_args..sR6a71k=AA6srrr<rc3,># UH oT;v M g7frmrS)rrrps rMrr6sN4MD4MsrG)rrr)exception_messagers)rr)r)rpr=cli)keywordsource)rr)targetr)2_log_framework_warning_detect_test_frameworkr!rrrrgrrrr r_get_help_flag_indexrrr\ signaturebindrranyrtrr/r filter_by field_inforr annotationrr argumentsAssertionErrorrKrir)argscommand_groupsr&r r`r'r1r(r%rrsrr)rrprrvrapps_for_contextexecution_appsrrrrhelp_flag_indexflags_to_removetrrErargumentre command_grouprrrs ` @@rMrApp._parse_known_argss~ > "#9#; <!&) "&!4!4VQU!4!VQ7;7J7J6gl7J7m4 ~%R( j !  M"$5r"--r0B0P0PP:%"0!4 -cr 2  M"$5r"--r0B0P0PP:% "%R( "$ ^^, -+6+@+@+H+H+S+YWYFR6RRF'+~~'='=>Xcg'='h $ 36;;Q;QSklOS ". '*+*@*@;C\C\*\&]O,2 OFq6NF OF1I3@']=a_D\=']M!$"ooG)4)A)AA+A"-"8"8*5)A)AA+A#--g6;;FKL_L_;`E$&M*<*>'NK4M4MNNN2;?G)4)A)AA+A"6{"C*5)A)AA+A$--g6;;KDWDW;XE$&M*<*>'"22"-"="=(1.9.V.V.X+-@,I,IPU,I,V3,V%//446GH[H[HfHf6gg,V 3 0F'77/)"5M 0,y-8-B-B ) 1H1HI$-$@$@2I2V)"5M"RR'+ooG$+$5$5g$>$C$C6[f[n[n$C$oE,.M2D2F/)m!.)%00$)KK$4Q$7E"4&+E%&H4G#"//g[[k.~}7JJJ_" !B!P']*3!/ IFy"1QRQWQWAFF1I]_ep"qwxxy!/ IF%"1?@vv!&&)2&3#$%%%2! &66# &3AO99$ + 9 9AI m. -s!A7R&;A,V.()U R8R8$ U. R=;R=AUBU%BU)>S'U%S)AT+A8U'1U& R58UT +TT  UU$+UUU V+!AV&&V++V.. V=)rrrrrrrcrUc[[55 [U5nUUUUUUUS.R5V V s0sH upU cM X_M n n n UR /U S9 UR USS9uppnSSS5 W W W4$s sn n f![ Ga nURRS5nURRS5nURRS5nURRS 5nUbUOS UlUUl URceUbU(aOOURUURS 9 UbU(a&OURR[U55 UbU(aO[R"S 5 eSnAff=f!,(df  GN4=f) aNInterpret arguments into a function and :class:`~inspect.BoundArguments`. Raises ------ UnusedCliTokensError If any tokens remain after parsing. Parameters ---------- tokens: None | str | Iterable[str] Either a string, or a list of strings to launch a command. Defaults to ``sys.argv[1:]``. console: ~rich.console.Console Console to print help and runtime Cyclopts errors. If not provided, follows the resolution order defined in :attr:`App.console`. error_console: ~rich.console.Console Console to print error messages. If not provided, follows the resolution order defined in :attr:`App.error_console`. print_error: bool | None Print a rich-formatted error on error. If :obj:`None`, inherits from :attr:`App.print_error`, eventually defaulting to :obj:`True`. exit_on_error: bool | None If there is an error parsing the CLI tokens invoke ``sys.exit(1)``. Otherwise, continue to raise the exception. If :obj:`None`, inherits from :attr:`App.exit_on_error`, eventually defaulting to :obj:`True`. help_on_error: bool | None Prints the help-page before printing an error. If :obj:`None`, inherits from :attr:`App.help_on_error`, eventually defaulting to :obj:`False`. verbose: bool | None Populate exception strings with more information intended for developers. If :obj:`None`, inherits from :attr:`App.verbose`, eventually defaulting to :obj:`False`. end_of_options_delimiter: str | None All tokens after this delimiter will be force-interpreted as positional arguments. If :obj:`None`, inherits from :attr:`App.end_of_options_delimiter`, eventually defaulting to POSIX-standard ``"--"``. Set to an empty string to disable. Returns ------- command: Callable Function associated with command action. bound: inspect.BoundArguments Parsed and converted ``args`` and ``kwargs`` to be used when calling ``command``. ignored: dict[str, Any] A mapping of python-variable-name to type-hint of any parameter with annotation ``parse=False``. :obj:`~typing.Annotated` will be resolved. Intended to simplify :ref:`meta apps `. N)rrrrrrrrTrrrrrFrrz)rrr!rSrrr%r rroot_input_tokensrrrCr-rexit)rrprrrrrrrrOvrrrErrrs rM parse_argsApp.parse_args}sz > "#9#; <!&) $"/*!.!.",Deg   AD   ^^B)^ 4 040F0F+/1G1-A5.w&&M  *! "nn44]C $ 6 6 G $ 6 6 G ..00;'.':G &,#yy,,,$1$==5OOFAIIO>"-"9;tIIOOM!$45$1$==4HHQK  5 4s6 B B#F'%B  F$DFF$$F'' F6c[URR5S:=(dA URSL=(a, [URRR5S:$)zHCheck if this is a nested call (meta app pattern or same-app recursion).rzN)r}roverrides_stackrrs rM_is_nested_callApp._is_nested_callsO4>>112Q6 JJd " Ts4::+?+?+O+O'PST'T rO) rrrrrrrrrc Uc[[55 [U5nUUUUUUU U S.R5V V s0sH upU cM X_M n n n UR 5(aU R SS5 UR X5 URUUUS9upn[[SUR RSSS 95n[XU5nURU5sSSS5 $s sn n f![a+ UR(a[R "S 5 Oef=fSSS5 g!,(df  g=f) a( Interprets and executes a command. Parameters ---------- tokens : None | str | Iterable[str] Either a string, or a list of strings to launch a command. Defaults to ``sys.argv[1:]``. console: ~rich.console.Console Console to print help and runtime Cyclopts errors. If not provided, follows the resolution order defined in :attr:`App.console`. error_console: ~rich.console.Console Console to print error messages. If not provided, follows the resolution order defined in :attr:`App.error_console`. print_error: bool | None Print a rich-formatted error on error. If :obj:`None`, inherits from :attr:`App.print_error`, eventually defaulting to :obj:`True`. exit_on_error: bool | None If there is an error parsing the CLI tokens invoke ``sys.exit(1)``. Otherwise, continue to raise the exception. If :obj:`None`, inherits from :attr:`App.exit_on_error`, eventually defaulting to :obj:`True`. help_on_error: bool | None Prints the help-page before printing an error. If :obj:`None`, inherits from :attr:`App.help_on_error`, eventually defaulting to :obj:`False`. verbose: bool | None Populate exception strings with more information intended for developers. If :obj:`None`, inherits from :attr:`App.verbose`, eventually defaulting to :obj:`False`. end_of_options_delimiter: str | None All tokens after this delimiter will be force-interpreted as positional arguments. If :obj:`None`, inherits from :attr:`App.end_of_options_delimiter`, eventually defaulting to POSIX-standard ``"--"``. Set to an empty string to disable. backend: Literal["asyncio", "trio"] | None Override the async backend to use (if an async command is invoked). If :obj:`None`, inherits from :attr:`App.backend`, eventually defaulting to "asyncio". If passing backend="trio", ensure trio is installed via the extra: `cyclopts[trio]`. result_action: ResultAction | None Controls how command return values are handled. Can be a predefined literal string or a custom callable that takes the result and returns a processed value. If :obj:`None`, inherits from :attr:`App.result_action`, eventually defaulting to "print_non_int_return_int_as_exit_code". See :attr:`App.result_action` for available modes. Returns ------- return_value: Any The value the command function returns. Nrrrrrrrrr return_valuerrrrrr<)rrr!rSrrrrrrr rC_handle_result_actionKeyboardInterruptrrr)rrprrrrrrrrrrOrrrrErresolved_backendrLs rM__call__ App.__call__sVv > "#9#; <!&) $"/*!.!.""!. eg     AD        ! !  . A ^^F . $)A!0! GA $G,=$>@V@VW`kt@V@uv  1'BRS11&9/ .%  :% 33HHSM  !/ . .s6 C3 C3 AD; C991D.*D;,D..D;; E c # Uc[[55 [U5nUUUUUUU U S.R5V V s0sH upU cM X_M n n n UR 5(aU R SS5 UR X5 URUUUS9upn[R"U5(a%U"UR0URD6IShvN nOU"UR0URD6nURU5sSSS5 $s sn n fNA![a+ UR(a[R "S5 Oef=fSSS5 g!,(df  g=f7f)a Async equivalent of :meth:`__call__` for use within existing event loops. This method should be used when you're already in an async context (e.g., Jupyter notebooks, existing async applications) and need to execute a Cyclopts command without creating a new event loop. Parameters ---------- tokens : None | str | Iterable[str] Either a string, or a list of strings to launch a command. Defaults to ``sys.argv[1:]``. console: ~rich.console.Console Console to print help and runtime Cyclopts errors. If not provided, follows the resolution order defined in :attr:`App.console`. error_console: ~rich.console.Console Console to print error messages. If not provided, follows the resolution order defined in :attr:`App.error_console`. print_error: bool | None Print a rich-formatted error on error. If :obj:`None`, inherits from :attr:`App.print_error`, eventually defaulting to :obj:`True`. exit_on_error: bool | None If there is an error parsing the CLI tokens invoke ``sys.exit(1)``. Otherwise, continue to raise the exception. If :obj:`None`, inherits from :attr:`App.exit_on_error`, eventually defaulting to :obj:`True`. help_on_error: bool | None Prints the help-page before printing an error. If :obj:`None`, inherits from :attr:`App.help_on_error`, eventually defaulting to :obj:`False`. verbose: bool | None Populate exception strings with more information intended for developers. If :obj:`None`, inherits from :attr:`App.verbose`, eventually defaulting to :obj:`False`. end_of_options_delimiter: str | None All tokens after this delimiter will be force-interpreted as positional arguments. If :obj:`None`, inherits from :attr:`App.end_of_options_delimiter`, eventually defaulting to POSIX-standard ``"--"``. Set to an empty string to disable. backend: Literal["asyncio", "trio"] | None Override the async backend to use (if an async command is invoked). If :obj:`None`, inherits from :attr:`App.backend`, eventually defaulting to "asyncio". If passing backend="trio", ensure trio is installed via the extra: `cyclopts[trio]`. result_action: ResultAction | None Controls how command return values are handled. Can be a predefined literal string or a custom callable that takes the result and returns a processed value. If :obj:`None`, inherits from :attr:`App.result_action`, eventually defaulting to "print_non_int_return_int_as_exit_code". See :attr:`App.result_action` for available modes. Returns ------- return_value: Any The value the command function returns. Examples -------- .. code-block:: python import asyncio from cyclopts import App app = App() @app.command async def my_async_command(): await asyncio.sleep(1) return "Done!" # In an async context (e.g., Jupyter notebook or existing async app): async def main(): result = await app.run_async(["my-async-command"]) print(result) # Prints: Done! asyncio.run(main()) Nrrrrr)rrr!rSrrrrr\rprr{rrrrr)rrprrrrrrrrrrOrrrrErrLs rM run_async App.run_asyncQshn > "#9#; <!&) $"/*!.!.""!. eg     AD        ! !  . A ^^F . $)A!0! GA ..w77#*EJJ#G%,,#GGF$ejjAELLAF11&9/ .%  6H % 33HHSM  !!/ . .se>E5 D D;E5E$$:D"D 1D"E5 D""1EE$EE$ E5$ E2.E5r)rcLSSKJnJn SSKJn [ U5nUR U5upgnUSn SU0n URXzS9 U RnU Rc U"X5n O#U R(aU RS-n OSn U RRS [S 9n U"X5n URX5nU RRS U"5S 9n[US 5(aURX"RU 5 OU (aUR!U 5 [US 5(aUR#X"RU 5 OU (aUR!U 5 UH?unnU(a UR$OSnUcUn['SU5nU"X"RU5 MA U RRS5=n(a7SSKJn UR!5 UR+UU S9nUR!U5 SSS5 g!,(df  g=f)apPrint the help page. Parameters ---------- tokens: None | str | Iterable[str] Tokens to interpret for traversing the application command structure. If not provided, defaults to ``sys.argv``. console: ~rich.console.Console Console to print help and runtime Cyclopts errors. If not provided, follows the resolution order defined in :attr:`App.console`. r) format_doc format_usage)DefaultFormatterrsrrN rr<r render_usagerender_descriptionr@rr:r>)r@rrcyclopts.help.formattersrr!rrrrr rA_assemble_help_panelshasattrroptionsrCrrrr;rB)rrprrrrrrwr executing_apprrr descriptionhelp_panels_with_groupsdefault_formatterrpanel formatterrr;epilogues rMrApp.help_prints" ;=!&)!%!4!4V!< QR ) ^^D^ 6#++G""*$T9$$%++d2(1199-Ra9bK$]@K'+&@&@&U #!. 7 7 ? ?@P[k[m ? n (.99!..wO e$(*>??!44Woo{[ k*!8 u49E00t $ 1I )< '??E: !8!. 7 7 ? ? PP}P4 %11- 1T h'[7 6 6s GH H#r*r?c 2SSKJn SSKJn SSKJnJnJnJn URU5upn U Sn U RRSU[5n0n [U 5Hn[U5HunnUR(dMXRun nUR"(aRUR%UR"US S 9nUR&(aU"UR&U"5U5UlOUUlUR(R+U"UUS 95 M M UR-U 5nUGHnUR.(dMUR1S S 9nURRS 5=(d Sn[3SU55nUHnUHnUR5U U5n[7UR8R:[25(de[<R>"UR8[=/UR8R:QUP7S95UlM M UR@HnUR(dMURCUS9nU(dM.U REURS5un nU"UUU5nU(aSUl#UR(UR(-UlUR&(a:UR&(a(U"UR&U"5UR&5UlOUR&UlUU4XR'M GM U RI5Vs/sHnUSPM nnU RI5Vs/sHnUSPM nn/n [KUU5un!n"[MU!U"SS9HIunn#U#RO5 U#RFS:XaU#RQ5 U RSUU#45 MK U $![ a% U"URSS9nUU4XR'GNrf=fs snfs snf)Nr)r*)NewLine)r?r;create_parameter_help_panelformat_command_entriesrsrr)titler?T)r?force_empty_endr>)rrrSc3z# UH1n[U[5(dMUR(dM-Uv M3 g7frm)rgr#r)rrjs rMr,App._assemble_help_panels..Vs#T7ajC6HQVV7s ;; ;)env_var)rNN parameterrzF)strict)*r#r*rr@r?r;rrrrr rArr,rrrrrBr entriesrtrrrr_convert_argumentrgrrr.rgroupsrrr?rr+zip_remove_duplicates_sortr)$rrpr RichGrouprr?r;rrrrrrpanelsrrapps_with_names command_panel group_helpapps_for_paramsrconfigs env_configsr env_configrgroup_argument_collectionexisting_panel new_panelrjr help_panelsr sorted_groups sorted_panels help_panels$ rMrApp._assemble_help_panelss 4(  ,0+>+>v+F( q$R( !++33M;P_` 57"+.F*9&*A&zz@'-jj'9$A} ::!+!7!7 ;hl!7!mJ$004=m>W>WY`Ybdn4o 14> 1%%,,-CO\g-hi)+B/466~F%F))"("E"EVZ"E"[ -3,<,<,D,DY,O,USUGT7TTK/"-J(::=(SG%h&8&8&@&@%HHHH)2):): **!*PH,>,>,F,F*P*PQ*H&#.0-33zz,?,I,IPU,I,V)0$*JJuzz<$H!>7?XZef !,7N)(1(9(9NP!P+P  P  output_formatr> recursiveinclude_hidden heading_levelflatten_commandsc SSKJnJnJn SSKJn U"U5nUS:Xa U"UUUUUS9n U $US:Xa U "UUUUUS9n U $US:Xa U"UUUUUSS 9n W $) aGenerate documentation for this CLI application. Parameters ---------- output_format : DocFormat Output format for the documentation. Accepts "markdown"/"md", "html"/"htm", or "rst"/"rest"/"restructuredtext". Default is "markdown". recursive : bool If True, generate documentation for all subcommands recursively. Default is True. include_hidden : bool If True, include hidden commands/parameters in documentation. Default is False. heading_level : int Starting heading level for the main application title. Default is 1 (single # for markdown, = for RST). flatten_commands : bool If True, generate all commands at the same heading level instead of nested. Default is False. Returns ------- str The generated documentation. Raises ------ ValueError If an unsupported output format is specified. Examples -------- >>> app = App(name="myapp", help="My CLI Application") >>> docs = app.generate_docs() # Generate markdown as string >>> html_docs = app.generate_docs(output_format="html") # Generate HTML >>> rst_docs = app.generate_docs(output_format="rst") # Generate RST >>> # To write to file, caller can do: >>> # Path("docs/cli.md").write_text(docs) r)generate_markdown_docsgenerate_rst_docsnormalize_format)generate_html_docsrG)r4r5r6r7htmlrF)r4r5r6r7 no_root_title) cyclopts.docsr9r:r;cyclopts.docs.htmlr<) rr3r4r5r6r7r9r:r;r<rs rM generate_docsApp.generate_docss^  :(7 J &(#-+!1 C2 %f $$#-+!1 C" e ###-+!1# C rO) prog_nameshellrCrD)zshbashfishchUcVUR(d [S5e[UR[5(aURSO URnUc SSKJn U"5nUS:XaSSKJn U"X5$US:XaSSKJn U"X5$US:XaSSK Jn U"X5$[SU35e) aGenerate shell completion script for this application. Parameters ---------- prog_name : str | None Program name for completion. If None, uses first name from app.name. shell : Literal["zsh", "bash", "fish"] | None Shell type. If None, automatically detects current shell. Supported shells: "zsh", "bash", "fish". Returns ------- str Complete shell completion script. Examples -------- Auto-detect shell and generate completion: >>> app = App(name="myapp") >>> script = app.generate_completion() >>> Path("_myapp").write_text(script) Explicitly specify shell type: >>> script = app.generate_completion(shell="zsh") Raises ------ ValueError If app has no name or shell type is unsupported. ShellDetectionError If shell is None and auto-detection fails. z2App must have a name to generate completion scriptr detect_shellrE)generate_completion_scriptrFrGzUnsupported shell: ) rrKrgrcyclopts.completionrJcyclopts.completion.zshrKcyclopts.completion.bashcyclopts.completion.fish)rrCrDrJrKs rMgenerate_completionApp.generate_completionsP  99 !UVV(2499e(D(D ! $))I = 8 NE E> J-d> > f_ K-d> > f_ K-d> >25':; ;rO)rDoutputadd_to_startuprRrSc SSKJn UcU"5nSSKJnJn UR US9nUcU"XR S5nURRSSS9 URU5 U(aUS;aU"X R SU5 U$)a7Install shell completion script to appropriate location. Generates and writes the completion script to a shell-specific location. Parameters ---------- shell : Literal["zsh", "bash", "fish"] | None Shell type for completion. If not specified, attempts to auto-detect current shell. output : Path | None Output path for the completion script. If not specified, uses shell-specific default: - zsh: ~/.zsh/completions/_ - bash: ~/.local/share/bash-completion/completions/ - fish: ~/.config/fish/completions/.fish add_to_startup : bool If True (default), adds source line to shell RC file to ensure completion is loaded. Set to False if completions are already configured to auto-load. Returns ------- Path Path where the completion script was installed. Examples -------- Auto-detect shell and install: >>> app = App(name="myapp") >>> path = app.install_completion() Install for specific shell: >>> path = app.install_completion(shell="zsh") Install to custom path: >>> path = app.install_completion(output=Path("/custom/path")) Install without modifying RC files: >>> path = app.install_completion(shell="bash", add_to_startup=False) Raises ------ ShellDetectionError If shell is None and auto-detection fails. ValueError If shell type is unsupported. rrI)add_to_rc_fileget_default_completion_path)rDT)parentsexist_ok)rFrE) cyclopts.completion.detectrJcyclopts.completion.installrUrVrPrparentmkdir write_text)rrDrRrSrJrUrVscript_contents rMinstall_completionApp.install_completion sn < = NE[111> >0 ! EF D48.) e6 699Q< 7 rOc `SSKJn U"URU5nUR"U4SU0UD6 g)aRegister a command for installing shell completion. This is a convenience method that creates a command which calls :meth:`install_completion`. For more control over the command implementation, users can manually define their own command. Parameters ---------- name : str | Iterable[str] Command name(s) for the install completion command. Defaults to "--install-completion". add_to_startup : bool If True (default), adds source line to shell RC file to ensure completion is loaded. Set to False if completions are already configured to auto-load. **kwargs Additional keyword arguments to pass to :meth:`command`. Can be used to customize the command registration (e.g., `help`, `group`, `help_flags`, `version_flags`). Examples -------- Register install-completion command: >>> app = App(name="myapp") >>> app.register_install_completion_command() >>> app() # Now responds to: myapp --install-completion Use a custom command name: >>> app.register_install_completion_command(name="--setup-completion") Customize help text: >>> app.register_install_completion_command(help="Install shell completion for myapp.") Customize command registration: >>> app.register_install_completion_command(group="Setup", help_flags=[]) Install without modifying RC files: >>> app.register_install_completion_command(add_to_startup=False) See Also -------- install_completion : The underlying method that performs the installation. r)!create_install_completion_commandrN)rZrbr_r)rrrSr{rb command_fns rM#register_install_completion_command'App.register_install_completion_commandf s2h R6t7N7NP^_  Z5d5f5rOpromptquit dispatcherzConsole | Nonec l[RS:Xa [S5 O [S5 UcSS/n[U[5(aU/nSnUcUn0n UbXiS'UbXIS '[ U5n [U 5n U (dM!U S U;agURX5 UR"U 4XES .UD6upnU"XU5nURUS S 9 SSS5 Mx![ a gf=f!,(df  N =f![a N/[a! [[R"55 NXf=f)aCreate a blocking, interactive shell. All registered commands can be executed in the shell. Parameters ---------- prompt: str Shell prompt. Defaults to ``"$ "``. quit: str | Iterable[str] String or list of strings that will cause the shell to exit and this method to return. Defaults to ``["q", "quit"]``. dispatcher: Dispatcher | None Optional function that subsequently invokes the command. The ``dispatcher`` function must have signature: .. code-block:: python def dispatcher(command: Callable, bound: inspect.BoundArguments, ignored: dict[str, Any]) -> Any: return command(*bound.args, **bound.kwargs) The above is the default dispatcher implementation. console: Console | None Rich Console to use for output. If :obj:`None`, uses :attr:`App.console`. exit_on_error: bool Whether to call ``sys.exit`` on parsing errors. Defaults to :obj:`False`. result_action: ResultAction | None How to handle command return values in the interactive shell. Defaults to ``"print_non_int_return_int_as_exit_code"`` which prints non-int results and returns int/bool as exit codes without calling sys.exit. If :obj:`None`, inherits from :attr:`App.result_action`. `**kwargs` Get passed along to :meth:`parse_args`. posixz(Interactive shell. Press Ctrl-D to exit.z:Interactive shell. Press Ctrl-Z followed by Enter to exit.Nqrgc:U"UR0URD6$rm)rr{)rrErs rMdefault_dispatcher1App.interactive_shell..default_dispatcher sEJJ7%,,7 7rOrrr)rr%print_non_int_return_int_as_exit_coder<)osrrCrgrinputEOFErrorr!rrrr%r traceback format_exc)rrfrgrhrrrr{rmr user_inputrprrErrLs rMinteractive_shellApp.interactive_shell sXV 77g  < = N O <=D dC 6D 8  +J  $)6o &  $+j ! "6] &j1FayD  .^^F6.2oo/(//PV/+GG(@F..v@g.h 7  76 !  .i**,- .sH% CC= 2C,C= C)(C), C:6C=:C== D3 'D32D3rLr=cz^SSKJn [[TRR SUS95nU"XU4Sj5$)aFHandle command result based on result_action. Parameters ---------- result : Any The command's return value. fallback : ResultAction The fallback result_action if none is configured. Defaults to "print_non_int_sys_exit". Returns ------- Any Processed result based on action (may call sys.exit() and not return). r)handle_result_actionrr<c:>TRRU5$rm)rrC)rjrs rM+App._handle_result_action.. sdll>P>PQR>SrO)cyclopts._result_actionryrrArr )rrLr=ryactions` rMrApp._handle_result_action s= A  NN " "?X " F  $F4STTrOcNURRUR5 g)zCopy over all commands from another :class:`App`. Commands from the meta app will **not** be copied over. Parameters ---------- app: cyclopts.App All commands from this application will be copied over. N)rr)rrss rMr App.update s cmm,rOc0nURHlnUR(dM[XR5n[ U5[ UR 5:wdX2R :wdM^X1UR 'Mn SRSUR555n[ U5RSUS3$)zOnly shows non-default values.r{c36# UHupUSU<3v M g7f)rNrS)rrOrs rMrApp.__repr__..* sL7Ktq1QEl7Ks()) __attrs_attrs__rgetattrrrlrrr~rSrT)r non_defaultsarrs rM__repr__ App.__repr__ s %%A66ff%AAw$qyy/)Q))^()QWW% &IIL|7I7I7KLL t*%%&a {!44rO)rrrrrryrwrxrrrrrrrrrrrr)rIr=)z0.0.0rm)T)rIr)rIrhr)rGTFrzF)z--install-completionT)z$ NNNFN)print_non_int_sys_exitrsrh)rTrUrVrWrr6rrr__annotations__rrr9rrkrrrrr.rrfrrrorrrboolrrrrrrrrrrr*rryrxrwr8rrr7rrrrrrrr5rrrNrrArBrrrrrrr2rrrlrrrrrrrpropertyrsetterrrrr~r}rrrrr rrr+r6rErrrrqrPrVr[rZr`rcrrirrrrrrrDobjectrrrr\BoundArgumentsrrrrrrrrintrArPrr_rdr0rvrrrrXrSrOrMrhrhs+0FVq*rE4#:c3h 'rd&9E3:9d+E3:++0$+E4#:c3h ' 27tOhrv1wOXc3h'$.w*/d*Ky4'K -     DKsCx2DEsJ K L 8T%[%S/;MNPSST U V Z_dZGTCZ(38, ,xYsCQT}=U8U/V V+0 $ +NC(3-'tT2D$2$)$I$VHhy!V*/dRa*bNHY'b(-4 $ (Kx}$ ejdeKYZ]aa"'tT!BM4$;B %dD AM3:AgldhNG\]`dd 49Qcmq3rE53;us{C/0 0r,1" ,eckD(-2 " -us{T)+0" +OUS[4'+0HYcg*hItHS#X&'h384OXseSj)D0 $ Is,1t+LcDjL$T4@K@!&tT!BM4$;B tB> B  B c\rSrSrSrSrSrg) TestFrameworki? rpytestrSN)rTrUrVrWUNKNOWNPYTESTrXrSrOrMrr? s G FrOrcS[R;a0[RR S5b[ R $[ R$)zDetects if we are currently being ran in a test framework. Returns ------- TestFramework Name of the testing framework. Returns an empty string if not testing framework discovered. rPYTEST_VERSION)rrrpenvironrrrrrSrOrMrrD s;3;;2::>>2B#C#O###$$$rO frameworkcU[R:XagSSKn[R"5GHnUR nUR n[R"U5nUbUcM:URRS5SnUS:XaM`SUR;aMrURSn0UREUREn/n UR5HupXLdM U RU 5 M [U 5S:waSn OU Sn SURS U S 3n UR![#U 5S S 9 g g) zLog a warning message for a given testing framework. Intended to catch developers invoking their app during unit-tests without providing commands and erroneously reading from :obj:`sys.argv`. TO ONLY BE CALLED WITHIN A CYCLOPTS.APP METHOD. NrrZr[rrzrszGCyclopts application invoked without tokens under unit-test framework "z". Did you mean "z([])"?r:) stacklevel)rrwarningsr\r]r_f_backr^rTr`f_localsrrSrr}rHwarn UserWarning) rrrar_rcalling_modulecalling_module_namecalled_cyclopts_app_instancecandidate_variablesmatched_app_variablesvar_name var_instancemessages rMrrW sOM)))   **62  !V^ ,55;;C@C * ,   ' ',~~f'=$E!1!1EV__E "&9&?&?&A "H;%,,X6'B $ % *H,Q/H[\e\k\k[ll}G~HHNO k'*q 9 ; rO)rsrhrurhrIN)TTr){r1r\rprrscollections.abcrrrrr contextlibrr enumr rr r itertoolsr pathlibrtypesrtypingrrrrrrrrrattrsrrrcyclopts.annotationsrcyclopts.app_stackrcyclopts.argumentrrrr r!cyclopts.command_specr"cyclopts.config._envr#cyclopts.exceptionsr$r%r&r'r(r)cyclopts.groupr*r+cyclopts.group_extractorsr,cyclopts.panelr-cyclopts.parameterr.r/cyclopts.protocolsr0cyclopts.tokenr1cyclopts.utilsr2r3r4r5r6r7r8r9 version_infor3readliner#r=cyclopts.docs.typesr>r@r?cyclopts.help.protocolsr@r}rArB cyclopts._runrCrDrFrArrNrrQrdrkrtrzrrrrrrrrhrrrrrrSrOrMrsH MM(   )(2'0RR-$.5(:)    g k $-'5D2 CxS)* CLD3J#$>5c?UYCY" )  . !)(F4S>FuFQUF$7s7s74BF% %% #" "#%P #$*u"4g$5g$5g$5TI#PT*"C  % % %$ )m)) )qPs =H H