k7i 8 SrSSKrSSKrSSKrSSKJrJrJrJr SSK J r SSK J r SSK JrJrJrJr SSKJrJr \"S5r\(aSS KJr SS KJr SS KJr OSS KJr \R6"\S S9rSSKJr "SS\5r"SS\S9r "SS\ 5r!S\"S\\\/\\44Sjr#S\$4Sjr%S\$4Sjr&SS\-\\-S\'\S44Sjr(SS\-\\-S\)\4Sjr*SS\-\\-S\'\S4S-4S jr+S\S\4S!jr,S"S\S#-\-S\S-4S$jr-S%\"S\"4S&jr.S%\"S\"4S'jr/S(\\S)\0S\\'\S44S*jr1S+S,.S-\"S\$4S.jjr2S/\S\$4S0jr3S1r4\"S2S355r5S9S4S5S6\0S\"4S7jjr6S:S8jr7g);z^To prevent circular dependencies, this module should never import anything else from Cyclopts.N)CallableIterableIteratorSequence)suppress) itemgetter) TYPE_CHECKINGAnyLiteralTypeVar)fieldfrozenT)JSONDecodeError)rConsole)defineT) unsafe_hash)stdlib_module_namesc6\rSrSrS\4SjrS\S4SjrSrg) SentinelMetareturnc"SURS3$)N<>)__name__clss H/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/utils.py__repr__SentinelMeta.__repr__s3<<.""Fcg)NFrs r __bool__SentinelMeta.__bool__!sr#r%N) r __module__ __qualname____firstlineno__strr!r r&__static_attributes__r%r#r rrs##r#rc\rSrSrSrSrg)Sentinel%c[S5e)NzGSentinel objects are not intended to be instantiated. Subclass instead.) ValueErrorrs r __new__Sentinel.__new__&sbccr#r%N)rr(r)r*r2r,r%r#r r.r.%sdr#r.) metaclassc\rSrSrSrSrg)UNSET*zTSpecial sentinel value indicating that no data was provided. **Do not instantiate**.r%N)rr(r)r*__doc__r,r%r#r r6r6*s^r#r6targetrcL^S[[S[[4U4SjjnU$)zJClass decorator that records init argument names as a tuple to ``target``.rrc>^^URm[R"T5n[SUR55m[ R "T5UUU4Sj5nX lU$)Nc34# UHoS:wdM Uv M g7f)selfNr%).0names r 1record_init..decorator..4s]-JTV\nDD-Js  c >T"U/UQ70UD6 [RUT[U4Sj[[ U5555[U5-5 g)Nc3.># UH nTUv M g7fNr%)r>i param_namess r r@Crecord_init..decorator..new_init..:s2\K[a;q>K[s)object __setattr__tuplerangelen)r=argskwargs original_initrFr9s r new_init0record_init..decorator..new_init6sJ $ 0 0 0   tVU2\5QTUYQZK[2\-\_dek_l-l mr#)__init__inspect signaturerJ parameters functoolswraps)rfunction_signaturerPrOrFr9s @@r decoratorrecord_init..decorator1s] $..}=]-?-J-J]]  ' n ( n   r#)typer)r9rYs` r record_initr\.s& tAw 47  r#c[U[[-[-[-5(ag[U[ 5(+=(a [U[ 5$)NT) isinstancelistrJsetdictr+robjs r is_iterablerdBs<#te|c)D011#s# # A 3(AAr#ct[R"U5=(a [X5$![a gf=f)a7Safely check if a type is both a class and a subclass of target_class. Parameters ---------- hint : Any The type to check. target_class : type The target class to check subclass relationship against. Returns ------- bool True if hint is a class and is a subclass of target_class, False otherwise. F)rSisclass issubclass TypeError)hint target_classs r is_class_and_subclassrkHs2t$GD)GG s '* 77value.cFUcg[U5(a [U5$U4$)aConvert a single element or an iterable of elements into a tuple. Intended to be used in an ``attrs.Field``. If :obj:`None` is provided, returns an empty tuple. If a single element is provided, returns a tuple containing just that element. If an iterable is provided, converts it into a tuple. Parameters ---------- value: Any | Iterable[Any] | None An element, an iterable of elements, or None. Returns ------- tuple[Any, ...]: A tuple containing the elements. r%)rdrJrls r to_tuple_converterro^s(  } U  U|xr#c*[[U55$rD)r_rorns r to_list_converterrqvs "5) **r#c0UcgU(dg[U5$)zkConvert a string or Iterable or None into an Iterable or None. Intended to be used in an ``attrs.Field``. Nr%)rorns r optional_to_tuple_converterrszs  }  e $$r#cdUc[$[R"U5(a [U5$U$)aConvert sort_key value, consuming generators with :func:`next`. Parameters ---------- value : Any The sort_key value to convert. Can be None, a generator, or any other value. Returns ------- Any UNSET if value is None, ``next(value)`` if generator, otherwise value unchanged. )r6rS isgeneratornextrns r sort_key_converterrws. }   U # #E{ r# input_value)defaultplaincUcg[U[5(a6US:Xa SSKJn U"5$US:Xa SSKJn U"5$[ SU<S35eU$) axConvert string literals to help formatter instances. Parameters ---------- input_value : None | Literal["default", "plain"] | Any The input value to convert. Can be None, "default", "plain", or a formatter instance. Returns ------- Any | None None, or a HelpFormatter instance. Notes ----- Lazily imports formatters to avoid importing Rich during normal execution. Nryr)DefaultFormatterrz)PlainFormatterzUnknown formatter: z. Must be 'default' or 'plain')r^r+cyclopts.help.formattersr|r}r1)rxr|r}s r help_formatter_converterrs`& K % % ) # A#% % G # ?!# #2;/A_`a ar#sc[R"SSU5n[R"SSU5n[R"SSU5nUR5$)Nz([A-Z]+)([A-Z][a-z])cLURS5SURS53$N_groupms r "_pascal_to_snake..s Aaggaj\6Rr#z([a-z])([A-Z])cLURS5SURS53$rrrs r rr1771:,a |0Lr#z([0-9])([A-Z])cLURS5SURS53$rrrs r rrrr#)resublower)rsnakes r _pascal_to_snakersM FF*,RTU VE FF$&Le TE FF$&Le TE ;;=r#cr[U5R5RSS5RS5$)aConverts a python identifier into a CLI token. Performs the following operations (in order): 1. Convert PascalCase to snake_case. 2. Convert the string to all lowercase. 3. Replace ``_`` with ``-``. 4. Strip any leading/trailing ``-`` (also stripping ``_``, due to point 3). Intended to be used with :attr:`App.name_transform` and :attr:`Parameter.name_transform`. Parameters ---------- s: str Input python identifier string. Returns ------- str Transformed name. r-)rrreplacestrip)rs r default_name_transformrs0, A  $ $ & . .sC 8 > >s CCr#iterablenc[U5U-(a[U<SUS35e[U5/U-n[USS06$)a Collect data into non-overlapping fixed-length chunks or blocks. https://docs.python.org/3/library/itertools.html#itertools-recipes Parameters ---------- iterable: Sequence[Any] Some iterable sequence to group. n: int Number of elements to put in each group. z is not divisible by .strictF)rLr1iterzip)rr iteratorss r grouperrsJ 8}qH<'22('"" 8 89W%% 1' KD KF KL(Xr#cr\rSrSr%Sr\\S'\"\S9r \\S'\\S'\ S\ SS\ S4S j5r S rg ) SortHelperi7zLSort a list of objects by an external key and retrieve the objects in-order.key) converter fallback_keyrlentriesrcSSKJnJnJn /n/n/n/n/n/n UGH1n U RULaUR SU 45 M(U RULaUR SU 45 MLU RULaUR SU 45 MpU R[ S4;aU R U RU 45 M[U R5(aIU RS[ S4;a0UR U RSSU R-U 45 GMUR U RU R4U 45 GM4 UR[S5S9 UR[S5S9 U R[S5S9 UU-U-U-U-U -n U V s/sHoSPM sn $s sn f)z(Sorts a sequence of :class:`SortHelper`.r)#DEFAULT_ARGUMENTS_GROUP_SORT_MARKER"DEFAULT_COMMANDS_GROUP_SORT_MARKER$DEFAULT_PARAMETERS_GROUP_SORT_MARKERNr)r) cyclopts.grouprrrrrr6rrdsortr) rrrrdefault_commands_groupdefault_arguments_groupdefault_parameters_group user_sort_keyordered_no_user_sort_keyno_user_sort_keyentrycombinedxs r rSortHelper.sortHs  "$"$#%  #% Eyy>>&--tUm<AA'..e}=BB(//u >udm+ ''););U(CDUYY''EIIaLUDM,I)//12ASAS1SUZ0[\$$uyy%2D2D&Eu%MN z!}- %%*Q-%8*Q-0 #% && ' '  '    ''h!h'''s,F=r%N)rr(r)r*r8r __annotations__r ror staticmethodrr_rr,r%r#r rr7sZV H (:;L#; JJ,(h|,,(l1C,(,(r#r decode_errorrcontextc TURR5nX RS- nURS- nXA- nUS::aSnSnUnOSnXE- nXA-nU[ U5:a[ U5S-nSn OSn X5Un S[ U5U--S-n SUU U S U S [ U53n U $) zNot intended to be a super robust implementation, but robust enough to be helpful. Parameters ---------- context: int Number of surrounding-character context rrrz... z ... ^zJSONDecodeError: z  )doc splitlineslinenocolnorLr+) rrlinesline error_indexstartprefix_ellipsissegment_error_indexendsuffix_ellipsissegment carat_pointerresponses r json_decode_error_verbosifierrxs    ' ' )E $$q( )D$$q(K  !E z) )1  C c$i$i!m oG3/2EEFLM ! 1'?:K6R_Q``bcfgsctbuv  Or#c @SSKJn UR=(d SnU"S0SS_SU_S[USS 5_S UR=(d S _S UR =(d S _S UR _S UR_S[USS 5_SUR_S[USS5_S[USS5_S[USS 5_S[USS5_SUR_SUR_SUR_S[USS 5_S[USS 5_S[USS 5_6$) aCreate an error console (stderr=True) that inherits settings from a source console. Parameters ---------- console : Console Source Rich Console to copy settings from. Returns ------- Console New Rich Console with stderr=True and inherited settings. rrautostderrT color_systemforce_terminal_force_terminalN force_jupyterforce_interactive soft_wrapwidthheight_heighttab_sizemarkup_markupemoji_emoji emoji_variant_emoji_variant highlight _highlightno_colorlegacy_windowssafe_box_environ get_datetimeget_timer%) rich.consolerrr is_jupyteris_interactiver_widthrrrr)consolerrs r !create_error_console_from_consolersk%''16L   ! w(94@ ((0D   "008D   ##  nn w 40 !! w 40 gx. g'7> '<6 !! --  !!! "*d3# $Wnd;% &*d3' r#))rrrr)8r8rVrSrcollections.abcrrrr contextlibroperatorrtypingr r r r attrsr rrjsonrrrrpartialsysrr[rr.r6r+r\boolrdrkrJror_rqrsrwrrrintrrrrrrrr%r#r rs9d BB77 CL$$   v4 8F#4dd _H_$q'DG); <(BB ,dSj8C=8U38_0+TCZ(3-7+DI+ %tczHSM'A %eCQTHoX\F\ %cc*" 233c9"4Z"JDcDcD2)hsm))sCx0I)$16!#!$!>OCODO8=(=(=(@"0A"C"Y\"J%r#