+ Q(iaR7t\0t^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t H t H t ^RI H t H t Ht^RIHtHt^RIHtHt^RIHtHtHtHtHtHtHt]P8R88d^RIHtMRt^RIHtH t H!t!H"t"H#t#H$t$^R I%H&t&H't'^R I(H)t)H*t*^R I+H,t,H-t-H.t.H/t/H0t0]P8R88d^RIHtMRt]'d^R I1H2t2]!R 4t3]!R]R7t4]!R]R7t5]6]6]7,]8]8]7,]9]9]7,]:]:]7R3,];];]7]73,/t<]^k] ]8]P]8] ]8]PzP|]9]PzP~]9]PzP]8]PzP];]PzP];/tC]^k];]7]] ]7,R3,3,tDRRltERRltFRRltGRRltHRRltIRRltJRR ltKR!R"ltLR#R$ltM]N]E]O]F]P]G]Q]H] ]I] ]J]]K/tR]^kR%R&ltSR9R'R(lltTR)R*ltUR+R,ltVR-R.ltWR/R0ltXR1R2ltYR:R3R4lltZR;R5R6llt[R#)<N)CallableIterableSequence)datedatetime timedelta)EnumFlag)partialreduce) TYPE_CHECKINGAnyLiteralTypeVarUnionget_args get_origin) TypeAliasType)ITERABLE_TYPES is_annotated is_enum_flag is_nonetypeis_unionresolve) CoercionErrorValidationError) FieldInfoget_field_infos)UNSETdefault_name_transformgrouper is_builtinis_class_and_subclassTokenTE)boundF. NestedCliArgsc0V^8dQhR\R\/#sreturn)strbool)formats"W/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/_convert.py __annotate__r4Gs..S.T.cfVP4pVR9dR#VR9dR#\\R7h)noFT) target_type>0fnr7false>1tyyestrue)lowerrr1r.s&r3_boolrDGs2  A ** , ,--r5c0V^8dQhR\R\/#r,)r0int)r2s"r3r4r4RsCCr5cRVP4pVPR4'd \V^4#VPR4'd \V^4#VPR4'd \V^4#RV9d\\\ V444#\V4#)0x0o0b.)rB startswithrFroundfloatrCs&r3_intrORs  A||D1bz d  1ay d  1ay 5q?##1v r5c0V^8dQhR\R\/#r,)r0bytes)r2s"r3r4r4cs%%c%e%r5c\VRR7#)utf8)encoding)rQrCs&r3_bytesrUcs V $$r5c0V^8dQhR\R\/#r,)r0 bytearray)r2s"r3r4r4gs  # ) r5c*\\V44#N)rWrUrCs&r3 _bytearrayrZgs VAY r5c0V^8dQhR\R\/#r,)r0r)r2s"r3r4r4ks!!S!T!r5c.\P!V4#)z4Parse a date string. Returns ------- datetime.date )r fromisoformatrCs&r3_dater^ks   a  r5c0V^8dQhR\R\/#r,)r0r)r2s"r3r4r4us F F F Fr5c\P!V4# \d9\P!TP4P RR^44u#i;i)z<"TFp\SVS4xK R#5irY)r).0r{rr|s& r3 $convert_enum_flag..sOuE> : :s)r operatoror_)rrr|sf&fr3convert_enum_flagrs(4  OO!  r5c V^8dQhR\\,RRR\\\.\3,R,R\\.\3,R\/#)r-rzrr% converterNr|r/)r}rrr0tuple)r2s"r3r4r4s\(( 9( (s S()D0(cUCZ( (  (r5c aaa\\WR7o\;QJd.R\V44FNK 5M!R\V444p\ V4wop\ S^4oV'd\ V4S,pV'd\RS R\ V4 R2R7h\ V4^8Xd V^,oM"\ V4^8Xd\oM \R4h\;QJd#.VVV3Rl\VS44FNK 5#!VVV3Rl\VS444#S\ V48wd\RS R\ V4 R2R7hVUu.uFp\ V4^,NK pp\V4p VU U u.uF'p \V 4U u.uFp \V 4NK up NK) p p p V U u.uFp \ V 4^8Xd V ^,MT NK p p \;QJd".V3R l\WLR R 74FNK 5M!V3R l\WLR R 744pV#uupiuup iuup p iuup i) rr|c34"TFqRJgK VxK R#5i.Nrxs& r3r!_convert_tuple..sC?asl?s z4Incorrect number of arguments: expected multiple of z but got rK)msgz%A tuple must have 0 or 1 inner-types.c3V<"TFpS!SS^8Xd V^,MT4xK R#5i)rjNr)rchunkconvertinner_token_count inner_types& r3rrs0 ; J,=,Ba N N;s&)z(Incorrect number of arguments: expected c38<"TFwrS!W4xK R#5irYr)rrargrs& r3rrslDkGJ,,DksF)strict)r _convertrr token_countmaxlenrr0rbr!iterrangenextzip)rzrr|r inner_types consume_all remainderrargs_per_convertitsizerubatchedelemoutrrrs&$$* @@@r3_convert_tuplers  h)SG%C8E?C%%C8E?CCK%0%7"{-q1K"33 JK\J]]fgjkqgrfsstu  { q $QJ   "JDE Eu  ):; u u  ):;   F +>?P>QQZ[^_e[fZgghi 8CC{!KN1--{C &\?OP?OteDk2kDHk2?OPCJK74c$i1n47$67KelC ejDkleelC ejDkll J D2PKs$!H2H< H7 4H<$I7H<c8V^8dQhR\R\RRRR/#)r-datarzr{z Token | Noner/N)dictr})r2s"r3r4r4s0# # # #  #  # r5c\V4p\4pVP4F1wrVVPV4VP VP 4K3 \VP 44V, pV'd\\V4^,pRP\VP 444p \RV RVP RV 2VVR7hR#)auValidate that JSON data doesn't contain extra keys not in the type's fields. Parameters ---------- data : dict The JSON dictionary to validate. type_ : type The target type (dataclass, etc.) to validate against. token : Token | None Optional token for error context. Raises ------ CoercionError If the data contains keys not present in the type's fields. z, zUnknown field "z" in JSON for z. Valid fields: )rr8r{N) rsetraddupdatenameskeyssortedjoinr__name__) rrzr{ field_infos valid_names field_name field_info extra_keys extra_key valid_fieldss &&& r3_validate_json_extra_keysrs*"%(KEK"-"3"3"5  #:++,#6TYY[!K/J:&q) yy (8(8(:!;< !)N5>>:JJZ[gZhi  r5c V^8dQhR\R\R\R\R,R\\.\3,/#)r-rzrrrNr|)rrrr0)r2s"r3r4r4?sI.#.# .# .#.#$ .# cUCZ( .#r5c^RIHp\W4/pVP4FwrxWq9gK W,p V e\ VP \ 4'gcT!\V \\,4'd\P!V 4M \ V 4R7p \VP V .W44p MT p WV&K V!R/VB#)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. r$rvr) cyclopts.tokenr%rrr#hintr0rrlistjsondumpsr) rzrrrr|r%converted_datarrrvr{converted_values &&&&& r3 _convert_jsonr?s4%d*N"-"3"3"5  $E )>zPS)T)TE4RV;9W9WDJJu$5]`af]gh")*//E7I"^"')8: &#6  "> ""r5cTV^8dQhRRR\R\PR\/#)r-r{r%rzerrorr/)rrJSONDecodeErrorr0)r2s"r3r4r4ps<5k5k 5k 5k   5k 5kr5c VPP4p\VR4'd VPM&\VR4'dVP^, M^p\ ^V^, 4p\ \V4V^,4pW5VpV^8d RV,pV\V48d VR,pWE, pV^8d V^, pRp \P!RV4'dRp MI\P!RV4'dRp M)\P!R V4'dR p M R V9dR p R VP RV RRV, RVP V 2 #)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. poscolnoz...z\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 raz^ ) rvrchasattrrrrminrrqsearchrr) r{rzr value_str error_pos snippet_start snippet_endsnippet marker_posrs &&& r3!_create_json_decode_error_messagerpsJ* !!#I%UE22 7SXZaKbKb ahiI9r>*Mc)ni"n5Kk2Gq'/S^#E/*Jqa  D yyi((J < + +L ; * *@ K u~~.ggYfS:EUDVVXY^YbYbXcdhci jjr5ctV^8dQhR\\,R\\\3,R\/#)r-rzrr/)r}r&rr0r)r2s"r3r4r4s-*6*6a*6S#X*61*6r5ca\V4pV'g V!R/VB#.p/pVP4FUwrVVPV4pV'd4VP\P 8XdVP WV34KQWdV&KW \VP44oVPV3RlR7V!RV4/VB#)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. c4<SPV^,4#)r)index)rfield_names_orders&r3'instantiate_from_dict..s 1 7 7! =r5)keyc3*"TF wrVxK R#5irYr)rruvs& r3r(instantiate_from_dict..s*1sr) rrgetkindrPOSITIONAL_ONLYappendrrsort) rzrrpos_argskwargsrrvrrs && @r3instantiate_from_dictrs0"%(K }t}H F!ZZ\  __Z0 *//Y-F-FF OOZ/ 0!&:  *[--/0 MM=M> ** 5f 55r5c V^8dQhR\\,R\R,R\\R3,R\ R\/#)r-rzr{r%rrrr/)r}r&rrr0r)r2s"r3r4r4sM=.=. 7=. G =.c;&'=. =.  =.r5c^p/pTpVP4FwrxVPp\V\4'dW,Pp V^, pRp MH\ V4wrV ^8XdV!WaV,4p V^, pMV!WaWDV ,4p WK, pT p WV&V 'dMV\ V48XgKM V\ V48XgQh\W4#)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. F)rrr#r0rvrrr) rzr{rrirrrrrv should_breaktokens_per_elementrs &&&& r3_convert_structured_typers< A D D"-"3"3"5  !s + +HNNE FA L.9$.? + !Q&Ah/QA4F0F&GH'&L Z   E ? 1#64 E ??  --r5cV^8dQhR\R\R,3,R\\\.\3,R,R\\.\3,/#)r-r{r%rNr|)rrrrr0)r2s"r3r4r4sYJJ (7++ ,Jc C(4/ J cUCZ( Jr5c aaaa^RIHo^RIHpRp\ V4'dV^RIHpVP V4wpoSP 'd RpV3RlpTpSP'd SPpMRo\\W#R7o\\W#R7p\V4pV\9d\V,p\V4oV\Jd!S!\\\3,V4p EMnV\ 9dS!\ V,V4p EMMV\9d-\V,p \ P#W4p S!W4p EM\$e,\'V\$4'dS!VP(V4p EM\+V4'dOSF p \-V 4'dKS!W4p EM \'V\04'd\2h\5WR7hV\6JduRp \V4F!pS!\9V4V4pY8XgKTp EMJ V 'd W nV h\5\'V\04'dV^,VR7hTVR7hV\<Jd-\'VS4'd V!WVR 7p EMV!V.VO5R V/p EMV\>9d\AS^,4wpp\'V\04'g\2hS^,pV^8dN\B;QJdV3R lV4F 'gK RM RM!V3R lV44'dV\JdTpM&V^8d\E\GV4.V,R R/pMTpV!VV3R lV44p EM\IV\J4'd)\MT\'V\04'dTMV.V4p EM\IV\N4'dC\'V\04'd\2hVf\QWV4p EMzV!WPR4p EMf\UV4p\WV4'g V'g\'VS4'gQhVPX\ZJdVPXp EM Vf'\\P#W4!VPR4p MV'd V!W4p MV!WPR4p M\'VS4'dVPRPa4PcR4'dWV\JdM\dPf!VPR4p\'V\4'g\hh\kVVVW#4p M&\'V\04'gV.p\qWVS4p S'dSPrF pV!W 4K V #V # \.dEKi;i \4dpTp Rp?EKRp?ii;i \4d1pTP:fTTnTP^fTTn/hRp?i\2d\5YR7Rhi;i \dPld p\oYT4p\5TYR7ThRp?i\hd+\'T\04'gT.p\qYTS4p ELi;i \t\2\h3d9p\wTPx'dTPx^,MRT R7ThRp?ii;i)zInner recursive conversion function for public ``convert``. Parameters ---------- converter: Callable name_transform: Callable r$) ParameterFTc<SP'gQhSPp\V\4'd \W4p\P !V4'd V!V34#V!W34#rY)rrr0getattrinspectismethod)t_rvresolved_convertercparams&& r3converter_with_token&_convert..converter_with_token.sl'''''&,%5%5"0#66)0)H&##$677-uh77.b(;;r5Nrr)rrc3<"TFBp\VS4;'d*VPP4PR4xKD R#5i){N)rrvrcrL)rr>r%s& r3r_convert..s;\V[QRJq%(LLQWW]]_-G-G-LLV[s A 2A rc3D<"TFpS!S^,V4xK R#5i)rNr)rerrs& r3rrsBc'+a.!44cs r)rr{r8r)exception_messagerv)=rr%cyclopts.parameterrrfrom_annotationrr|r rrr"_abstract_to_concrete_type_mappingrrr0_implicit_iterable_type_mappingrrr __value__rr Exceptionrrbrrr}r8rrranyrrr#r rr rrvrr"implicit_valuer _convertersr{rcrLrloads TypeErrorrrrr validatorAssertionErrorrargs)rzr{rr|rconverter_needs_tokenr convert_tuple origin_typer concrete_type default_paramr>last_coercion_errorchoiceresrcountrurgenrrrr!r%rr rs&&$$ @@@@r3rrs(,!E0!11%8 v    $( ! <"-I  #22Nh)SGNi_MU#K888E 5/K }d38ne, 1 15e> Y6 'Y65Y69[3[[c V^8dQhR\R\\,\R,,\,R\\ \.\3,R,R\\.\3,R,/#)r-rzrr%rNr|)rrr0r*rr})r2s"r3r4r4slx6x6 x6 SMHW- - =x6s S()D0x6cUCZ(4/ x6r5c `a^RIHoV'g\h\V\4'gP\V^,\ 4'd3\ ;QJd.V3RlV4FNK 5M!V3RlV44pVf\p\\W#R7p\\W#R7p\V4pV\Jd\ p\PW4pV\9d#\V,p\PWf4p\!V4pV\9d\V,pT;'gTpV\ Jd V!V.VO5!#V\"9d V!W4#V\Jdz\V\4'g\h\%V4^,p VP)4U U u/uFwrV \+WW#R7bK p p p \,PW4!R/V B#\V\4'd\RV: R24h\/V4'd \1WV4#\3V4^8XdV!W^,4#\5V4wrV ^8XdVUu.uF q!W4NK up#\3V4V 8Xd V!W4#\7R4h \&d \ p ELi;iuup p iuupi)aTCoerce variables into a specified type. Internally used to coercing string CLI tokens into python builtin types. Externally, may be useful in a custom converter. See Cyclopt's automatic coercion rules :doc:`/rules`. If ``type_`` **is not** iterable, then each element of ``tokens`` will be converted independently. If there is more than one element, then the return type will be a ``Tuple[type_, ...]``. If there is a single element, then the return type will be ``type_``. If ``type_`` **is** iterable, then all elements of ``tokens`` will be collated. Parameters ---------- type_: Type A type hint/annotation to coerce ``*args`` into. tokens: Union[Sequence[str], NestedCliArgs] String tokens to coerce. Generally, either a list of strings, or a dictionary of list of strings (recursive). Each leaf in the dictionary tree should be a list of strings. converter: Optional[Callable[[Type, str], Any]] An optional function to convert tokens to the inner-most types. The converter should have signature: .. code-block:: python def converter(type_: type, value: str) -> 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``. r$c3H<"TFpS!\V4R7xK R#5i)rN)r0)rrr%s& r3rconvert.."s;Fqu3q6**Fs"rz*Dictionary of tokens provided for unknown rKz Unreachable?r)rr%rbrrr0rr r rrrrrrrrrr IndexErrorrrrrrrrNotImplementedError)rzrrr| convert_privr%r'r&maybe_origin_type value_typekrdict_convertedrruitemr%s&&&& @r3rrs^t(  fd # # 6!9c(B(B;F;;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  BsJ &J%J+ J"!J"c^V^8dQhR\R\R\\\3,/#)r-rzskip_converter_paramsr/)rr1rrF)r2s"r3r4r4]s/d"d"sd"4d"E#t)DTd"r5c^RIHpV!WR7wr4VFMpVPfKVPR 8XdR u#W0Jd\VRR7wrgMRpVPV3u# Tp\ V4pV\ 9d\ V,pV\ 9d.\ V,p \ PW4p\ V4pT;'gT\Jd-\V4p V 'd\RV 44RV 93#R #T;'gT\JdR #V\9g%V\9d\\V44^8XdR #\V4'dR #V\9d?\\V44'd%\\V4^,4^,R3#\e,\!V\4'd\VP"4#\%V4'dY\V4p \V ^,4p V R,F,p \V 4pW8wgK\'RV ^, R V 24h V #\)V4'dR #\+V4p^RppVP-4F^pVP.VP0JdRpMVP2'gK4\VP44wppVV, pVV,pK` V'gR #VV3#)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. )get_parameters)r;TFc3T"TFqRJgK \V4^,xK R#5ir)rrs& r3rtoken_count..s#G$Q3,({1~a(($s((.riz=Cannot Union types that consume different numbers of tokens: ra)rjT)rF)rjF)rr=n_tokensrrrrrrrsumr1rrrrrrrrbr"rvaluesrVAR_POSITIONALrequiredr)rzr;r= resolved_type parametersparamruconsume_all_from_typer&r'r#sub_argstoken_count_target sub_type_thisrr,rrv elem_countelem_consume_alls&& r3rr]s*2 .u bM >> %~~# !-0;=`d/e,A,-2)~~'<<rfs  88..%w$Mkk>:ddw$M' CL Ct Ct y~$s)S 5c?$sCx. 5 d OOT dOOOOOO##TOOTOO""D 8" S%  >??@ ."% ! F "&J.F % 6 z% i z$ (V# L.#b5kp*6Z=.@JZx6vd"d"r5