k7iB%SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJ r J r SSK J r J r J r SSKJrJr SSKJrJr SSKJrJrJrJrJrJrJr \R6S:aSSKJr OSrSS KJrJrJ r J!r!J"r" SS K#J$r$J%r% SS K&J'r'J(r( SS K)J*r*J+r+J,r,J-r-J.r. \R6S:aSSKJr OSr\(aSS K/J0r0 \"S5r1\"S\S9r2\"S\S9r3\4\4\5\6\6\5\7\7\5\8\8\5S4\9\9\5\540r:\9\;\;4\0fnnofalseF>1tyyestrueT) target_type)lowerrboolr.s K/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/_convert.py_boolr@Qs2  A ** , ,--cJUR5nURS5(a [US5$URS5(a [US5$URS5(a [US5$SU;a[[[ U555$[U5$)N0x0o0b.)r< startswithintroundfloatr>s r?_intrN\s  A||D1bz d  1ay d  1ay 5q?##1v rAc[USS9$)Nutf8)encoding)bytesr>s r?_bytesrSms V $$rAc*[[U55$N) bytearrayrSr>s r? _bytearrayrWqs VAY rAc.[R"U5$)z4Parse a date string. Returns ------- datetime.date )r fromisoformatr>s r?_daterZus   a  rAc[R"U5$![a8 [R"UR5R SSS55s$f=f)zs r? _datetimerasRF%%a(( F%%aggi&7&7S!&DEE Fs?AAcSnURS5(aSnUSSn[R"SU5nU(d[SU35eSnUHwupEn[ U5nUS :XaX5- nMUS :Xa X5S -- nM,US :Xa X5S -- nM;US:Xa X5S-- nMJUS:Xa X5S-- nMYUS:Xa X5S-- nMhUS:XdMpX5S-- nMy U(aU*n[ US9$)zParse a timedelta string.F-Tr]Nz((\d+\.\d+|\d+)([smhdwMy]))z!Could not parse duration string: rr.m<hidiQwi: Mi'r8i3)seconds)rJrefindallr^rMr)r.negativematchesrj_valueunits r? _timedeltarrsH||C abEjj7;G ># UHn[TUT5v M g7frU)r).0rtrrus r? $convert_enum_flag..sOuE> : :sr)r operatoror_)rrrus` `r?convert_enum_flagrs(4  OO!  rA _converters converterc j^^^[[XS9m[S[U555n[ U5umn[ TS5mU(a[ U5T-nU(a[STS[ U5S3S9e[ U5S:XaUSmO![ U5S:Xa[mO [S 5e[UUU4S j[UT555$T[ U5:wa[S TS[ U5S3S9eUVs/sHn[ U5SPM nn[U5n UV V s/sH(n [U 5V s/sHn [U 5PM sn PM* n n n U V s/sHn [ U 5S:XaU SOU PM n n [U4S j[XLS S955nU$s snfs sn fs sn n fs sn f)Nrruc32# UH oSLdM Uv M g7f).Nrxs r?r!_convert_tuple..sC?asl?s r]z4Incorrect number of arguments: expected multiple of z but got rI)msgrz%A tuple must have 0 or 1 inner-types.c3L># UHnT"TTS:XaUSOU5v M g7f)r]rNr)rchunkconvertinner_token_count inner_types r?rrs0 ; J,=,Ba N N;s!$z(Incorrect number of arguments: expected c38># UHupT"X5v M g7frUr)rrargrs r?rrslDkGJ,,DksF)strict)r _converttupler token_countmaxlenrstrr^r"iterrangenextzip)rsrrur inner_types consume_all remainderrargs_per_convertitsizerobatchedelemoutrrrs @@@r?_convert_tuplers h)SGC8E?CCK%0%7"{-q1K"33 JK\J]]fgjkqgrfsstu  { q $QJ   "JDE E  ):;   F +>?P>QQZ[^_e[fZgghi 8CC{!KN1-{C &\?OP?OteDk2kDHk2?OPCJK74c$i1n47$67KlC ejDkll J D2PKs$?F )F*<F% F* F0%F*data field_infoscnSSKJn 0nUR5HupxXq;dM Xn U by[UR[ 5(dZU"[ U [[-5(a[R"U 5O [ U 5S9n [URU /X45n OU n XU'M U"S0UD6$)aConvert JSON dict to dataclass with proper type conversion for fields. Parameters ---------- type_ : Type The dataclass type to create. data : dict The JSON dictionary containing field values. field_infos : dict Field information from the dataclass. converter : Callable | None Optional converter function. name_transform : Callable[[str], str] Function to transform field names. Returns ------- Instance of type_ with properly converted field values. rr%rpr) cyclopts.tokenr&r{r$hintrrydictlistjsondumpsr) rsrrrrur&converted_data field_name field_inforprtconverted_values r? _convert_jsonr#s4%N"-"3"3"5  $E )>zPS)T)TE4RV;9W9WDJJu$5]`af]gh")*//E7I"^"')8: &#6  "> ""rAerrorc URR5n[US5(a URO![US5(aURS- OSn[ SUS- 5n[ [U5US-5nX5UnUS:aSU-nU[U5:aUS-nXE- nUS:aUS- nSn [R"S U5(aS n OF[R"S U5(aS n O'[R"S U5(aSn OSU;aSn SURSUSSU-SURU 3 $)aWCreate a helpful error message for JSON decode errors. Parameters ---------- token : Token The token containing the invalid JSON. type_ : Type The target type we were trying to convert to. error : json.JSONDecodeError The JSON decode error that occurred. Returns ------- str A formatted error message with context and hints. poscolnor]rz...rz\bTrue\bz8 Hint: Use lowercase 'true' instead of Python's Truez \bFalse\bz: Hint: Use lowercase 'false' instead of Python's Falsez\bNone\bz. Hint: Use 'null' instead of Python's None'z9 Hint: JSON requires double quotes, not single quoteszInvalid JSON for z: z r\z^ ) rpr_hasattrrrrminrrksearch__name__r) rtrsr value_str error_pos snippet_start snippet_endsnippet marker_posrs r?!_create_json_decode_error_messagerQsJ* !!#I%UE22 7SXZaKbKb ahiI9r>*Mc)ni"n5Kk2Gq'/S^#E/*Jqa  D yyi((J < + +L ; * *@ K u~~.ggYfS:EUDVVXY^YbYbXcdhci jjrAc^[U5nU(dU"S0UD6$/n0nUR5HSupVURU5nU(a2UR[R :XaUR XV45 MOXdU'MU [UR55mURU4SjS9 U"SU50UD6$)aInstantiate a type with proper handling of parameter kinds. Respects POSITIONAL_ONLY, KEYWORD_ONLY, and POSITIONAL_OR_KEYWORD parameter kinds when constructing the object. This function is necessary because `inspect.signature().bind(**data)` has the same limitation we're solving: it cannot accept positional-only parameters as keyword arguments. For example, `def __init__(self, a, /, b)` requires `a` to be passed positionally, but when we have a dict `{"a": 1, "b": 2}`, we need to transform this into the call `type_(1, b=2)`. Parameters ---------- type_ : type[T] The type to instantiate. data : dict[str, Any] Dictionary mapping field names to values. Returns ------- T Instance of type_ constructed from data. c,>TRUS5$)Nr)index)rfield_names_orders r?'instantiate_from_dict..s 1 7 7! =rA)keyc3*# UH upUv M g7frUr)rrovs r?r(instantiate_from_dict..s*1sr) rr{getkindrPOSITIONAL_ONLYappendrkeyssort) rsrrpos_argskwargsrrprrs @r?instantiate_from_dictrs0"%(K }t}H F!ZZ\  __Z0 *//Y-F-FF OOZ/ 0!&:  *[--/0 MM=M> ** 5f 55rArrcSn0nUnUR5HupxURn[U[5(aXRn US- nSn O7[ U5upU S:XaU"XaU5n US- nOU"XaXDU -5n XK- nU n XU'U (a OU[ U5:XdM O U[ U5:Xde[X5$)aConvert tokens to a structured type with proper positional/keyword argument handling. Respects the parameter kind of each field: - POSITIONAL_ONLY: passed as positional argument - KEYWORD_ONLY or POSITIONAL_OR_KEYWORD: passed as keyword argument This correctly handles types with keyword-only fields (e.g., dataclasses with kw_only=True). Parameters ---------- type_ : type[T] The target structured type to instantiate. token : Sequence[Token] The tokens to convert. field_infos : dict[str, FieldInfo] Field information for the structured type. convert : Callable Conversion function for nested types. Returns ------- T Instance of type_ constructed from the tokens. rr]F)r{rr$rrprrr) rsrtrrirrrrrp should_breaktokens_per_elementrs r?_convert_structured_typers< A D D"-"3"3"5  !s + +HNNE FA L.9$.? + !Q&Ah/QA4F0F&GH'&L Z   E ? 1#64 E ??  --rAcd ^^^^SSKJm SSKJn Sn[ U5(aSSSKJn UR U5unmTR (a SnU4SjnUnTR(a TRnOSm[[X#S9m[[X#S9n[U5nU[;a [Un[U5mU[LaT"[[[4U5n GOU[ ;aT"[ UU5n GOU[;a([Un [ R#X5n T"X5n GO[$b*['U[$5(aT"UR(U5n GO[+U5(aITHn [-U 5(aMT"X5n GOP ['U[05(a[2e[5XS 9eU[6LagSn [U5H nT"[9U5U5nX:XdMUn GO U (aX lU e[5['U[05(aUSUS 9eUUS 9eU[<La(['UT5(a U"XUS 9n GOU"U/UQ7S U06n GOU[>;a[ATS5unn['U[05(d[2eTSnUS :a&[CU4S jU55(a U[LaUnO!US :a[E[GU5/U-SS06nOUnU"UU4SjU55n GO[IU[J5(a'[MU['U[05(aUOU/U5n GO[IU[N5(a@['U[05(a[2eUc[QXU5n GOoU"XRR5n GO[[UU5n[WU5(dU(d['UT5(deURX[ZLaURXn GOUc&[\R#X5"URR5n OU(a U"X5n OU"XRR5n O['UT5(aURRRa5RcS5(aTU[LaK[dRf"URR5n['U[5(d[he[kUUUX#5n O%['U[05(dU/n[qXUT5n T(aTRrH nU"X 5 M U $U $![.a GMf=f![4anUn SnAGM`SnAff=f![4a.nUR:cUUlUR^cUUl/eSnAf[2a [5XS 9Sef=f![dRlan[oXU5n[5UXS9UeSnAf[ha) ['U[05(dU/n[qXUT5n GNf=f![t[2[h4a0n[wURx(aURxSOSU S9UeSnAff=f)zInner recursive conversion function for public ``convert``. Parameters ---------- converter: Callable name_transform: Callable rr%) ParameterFTc>TR(deTRn[U[5(a [X5n[R "U5(a U"U45$U"X45$rU)rryrgetattrinspectismethod)t_rpresolved_convertercparams r?converter_with_token&_convert..converter_with_tokensi''''&,%5%5"0#66)0)H&##$677-uh77.b(;;rANrrw)rrr]c3># UHAn[UT5=(a) URR5RS5v MC g7f){N)ryrpr_rJ)rr7r&s r?r_convert..ns8\V[QRJq%(LQWW]]_-G-G-LLV[sA A rc3<># UHnT"TSU5v M g7f)rNr)rerrs r?rrwsBc'+a.!44csr)rrtr;r)exception_messagerp)=rxr&cyclopts.parameterrrfrom_annotationrrur rrrr,rrrr+rrry __value__rr Exceptionrr^rrtyper;rITERABLE_TYPESranyrrr$r rr rrprr#implicit_valuer rrtr_rJrloads TypeErrorrJSONDecodeErrorrr validatorAssertionErrorrargs)rsrtrrurconverter_needs_tokenr convert_tuple origin_typer concrete_type default_paramr7last_coercion_errorchoiceresrcountrorgenrrrrr&rrrs @@@@r?rrs(,!E0!11%8 v   $( ! <"-I  #22Nh)SGNi_MU#K888E 5/K }d38ne, 1 15e Any: "Perform conversion of string token." This allows to use the :func:`convert` function to handle the the difficult task of traversing lists/tuples/unions/etc, while leaving the final conversion logic to the caller. name_transform: Optional[Callable[[str], str]] Currently only used for ``Enum`` type hints. A function that transforms enum names and CLI values into a normalized format. The function should have signature: .. code-block:: python def name_transform(s: str) -> str: "Perform name transform." where the returned value is the name to be used on the CLI. If ``None``, defaults to ``cyclopts.default_name_transform``. Returns ------- Any Coerced version of input ``*args``. rr%c3B># UHnT"[U5S9v M g7f)rN)r)rrr&s r?rconvert..s;Fqu3q6*Fsrr]z*Dictionary of tokens provided for unknown rIz Unreachable?r)rxr&r^ryrrrr!r rrrrr+rr,rrr IndexErrorr{rrrrrrNotImplementedError)rsrrru convert_privr r r maybe_origin_type value_typekrdict_convertedrroitemr&s @r?rrsMt(  fd # # 6!9c(B(B;F;;/8yXLNi_M ENE | + / / =E 22:5A /33MQU#K888E #,ueU,V,, n ,E** d "&$''  !%+Jgmfrfrft ft^b^_Awz Y Yft  0DV~VV FD ! !EeYaPQQ ' ( (!!2NKK v;! ay1 1 +E 2  ":@A&$L-&A A [. .. .%n5 5+ J  BsI&I I IIskip_converter_paramsc4SSKJn U"XS9up4UHEnURcMURS:Xa gX0La [USS9upgOSnURU4s $ Un[ U5nU[ ;a [ UnU[ ;a)[ Un [ RX5n[ U5nU=(d U[La*[U5n U (a[S U 55S U ;4$gU=(d U[Lag U[;d"U[;a[[U55S:Xag[U5(agU[;a5[[U55(a[[U5S5SS4$[b*[!U[5(a[UR"5$[%U5(aK[U5n [U S5n U S SH'n [U 5nX:wdM['S U SSU 35e U $[)U5(ag[+U5nS unnUR-5HTnUR.UR0LaSnOUR2(dM2[UR45unnUU- nUU-nMV U(dgUU4$)aCThe number of tokens after a keyword the parameter should consume. Parameters ---------- type_: Type A type hint/annotation to infer token_count from if not explicitly specified. skip_converter_params: bool If True, don't extract converter parameters from __cyclopts__. Used to prevent infinite recursion when determining consume_all behavior. Returns ------- int Number of tokens to consume. bool If this is ``True`` and positional, consume all remaining tokens. The returned number of tokens constitutes a single element of the iterable-to-be-parsed. r)get_parameters)rN)r]TTFc3J# UHoSLdM [U5Sv M g7f).rN)rrs r?rtoken_count..ws G$Q3,({1~a($s##.)rFr]z=Cannot Union types that consume different numbers of tokens: r\)r]F)rr n_tokensrrr,r+rrrsumr=rrrrryrrr^r#rvaluesrVAR_POSITIONALrequiredr)rsrr  resolved_type parametersparamroconsume_all_from_typer r rsub_argstoken_count_target sub_type_thisrrrrp elem_countelem_consume_alls r?rr>s*2 .u bM >> %~~# !-0;=`d/e,A,-2)~~'<<rGs  88..%w$M[[>:ddw$M' CL Ct Ct y~$s)S 5c?$sCx. 5dDj!1 d OOT dOOOOOO##TOOTOO""D 8"Dt$4   OO   S%  >??@ .S.T.CC"%c%e% # ) !S!T! F F F "&#"&)"&J 7 # cUCZ( .Aw SMHW- -cUCZ( F % 6 z% i z$ T#x- ( 9( (s S()D0(cUCZ( (  (V+# +# +#+#$ +# cUCZ( +#\5k 5k 5k   5k 5kp*6a*6S#X*61*6Z=. 7=. G =.c;&'=. =.  =.@J (7++ ,Jc C(4/ J cUCZ( J`4826 x6 x6 SMHW- - =x6s S()D0x6cUCZ(4/ x6vd"sd"4d"E#t)DTd"rA