lKj:0UddlZddlZddlZddlZddlZddlZddlZddlmZm Z m Z ddl m Z m Z m Z ddlmZmZddlmZmZddlmZmZmZmZmZmZmZej6dk\rddlmZndZdd lmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'm(Z(dd l)m*Z*m+Z+dd l,m-Z-m.Z.m/Z/m0Z0m1Z1ej6dk\rddlmZndZerdd l2m3Z3edZ4edeZ5edeZ6e7e7e8e9e9e8e:e:e8e;e;e8dfee>fe?d<e e9eje9e e9ejje:ejje:ejje9ejjee>fe?d<ee5d!ed"e8fd#ee8ge8fde5fd$ZUd%e>e6d&e e8e d"zd#ee8ge8fde6fd'ZVeHeIeJeKeLeMeNeOe ePe eQe eReSeTiZWeed&d"d)ee>e8gefdzd#ee8ge8fde;f d*ZX d:d+ed!d,ddfd-ZYd ed+ee4d+ee4d!e d"d.ee8gefdzd#ee8ge8fdzfd7Z`d0fnnofalseF>1tyyestrueT) target_type)lowerrboolr1s b/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/_convert.py_boolrCPs2  A ** , ,--c(|j}|jdr t|dS|jdr t|dS|jdr t|dSd|vrttt |St|S)N0x0o0b.)r? startswithintroundfloatrAs rB_intrQ[sz  A||D1bz d 1ay d 1ay 5q?##1v rDct|dS)Nutf8)encoding)bytesrAs rB_bytesrVls V $$rDc*tt|SN) bytearrayrVrAs rB _bytearrayrZps VAY rDc,tj|S)zDParse a date string. Returns ------- datetime.date )r fromisoformatrAs rB_dater]ts   a  rDc tj|S#t$r7tj|jj dddcYSwxYw)zLParse a datetime string. Returns ------- datetime.datetime  r*)rr\ ValueErrorstripreplacerAs rB _datetimerd~sRF%%a(( F%%aggi&7&7S!&DEE Fs=AAcd}|jdrd}|dd}tjd|}|std|d}|D]p\}}}t |}|d k(r||z }|d k(r ||d zz }+|d k(r ||d zz }9|dk(r ||dzz }G|dk(r ||dzz }U|dk(r ||dzz }c|dk(si||dzz }r|r| }t |S)zParse a timedelta string.F-Tr`Nz((\d+\.\d+|\d+)([smhdwMy]))z!Could not parse duration string: rr1m<hidiQwi: Mi'r;i3)seconds)rMrefindallrarPr)r1negativematchesrm_valueunits rB _timedeltarusH||C abEjj7;G z_slice..s"Q54 3t9$>5s')zUnable to interpret "zu" as a slice; expected "start:stop" or "start:stop:step" with integer or empty fields (e.g. "0:3", ":10", "0:100:5").)r>msg)splitlenslicerar)r1partss rB_slicersq GGCLECJ! Q5QR R #A3'\ ]    sA AAtype_tokenr)name_transformcddlm}t||}|r |jn|}||}|jj D]\}}|||k(s|cSt |r||d|)zqMatch a token's value to an enum's member. Applies ``name_transform`` to both the value and the member. rr(Nrr>)cyclopts.argumentr) isinstancers __members__itemsr) rrrr)is_tokenrsvalue_transformednamemembers rBget_enum_memberrs(%'H#EKKE&u-))//1 f $ #4 4M2 e %) rD enum_typetokensc\ttjfd|DdS)aConvert tokens to a Flag enum value. Parameters ---------- enum_type : type[F] The Flag enum type to convert to. tokens : Iterable[str] | Iterable[Token] The tokens to convert. Can be member names or :class:`Token` objects. name_transform : Callable[[str], str] | None Function to transform names for comparison. Returns ------- F The combined flag value. Raises ------ CoercionError If a token is not a valid flag member. c38K|]}t|ywrX)r)ryrrrs rBr{z$convert_enum_flag..sOuE> :sr)r operatoror_)rrrs` `rBconvert_enum_flagrs(4  OO!  rD _converters converterc Ntt||tdt|D}t |\}t d|rt |z}|rtddt |dt |dk(r|dn t |dk(rtn td tfd t|DSt |k7rtd dt |d|Dcgc]}t |d}}t|} |D cgc]$} t| D cgc] } t| c} &} } } | D cgc]} t | dk(r| dn| } } tfd t|| d D}|Scc}wcc} wcc} } wcc} w)Nrrc3*K|] }|dus| yw).Nryxs rBr{z!_convert_tuple..sC?aasl?s r`z4Incorrect number of arguments: expected multiple of z but got rL)r|rz%A tuple must have 0 or 1 inner-types.c3DK|]}dk(r|dn|yw)r`rNr)rychunkconvertinner_token_count inner_types rBr{z!_convert_tuple..&s. ; J,=,Ba N;s z(Incorrect number of arguments: expected c36K|]\}}||ywrXr)ryrargrs rBr{z!_convert_tuple..4slDkSGJ,DkF)strict)r _converttupler token_countmaxr~rstrrar%iterrangenextzip)rrrr inner_types consume_all remainderrargs_per_convertitsizerrbatchedelemoutrrrs @@@rB_convert_tupler s h)NSGC8E?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 U\ejDkll J D2PKs$;F"F4F FF"Fdataz Token | Nonect|}t}|jD]1\}}|j||j |j 3t|j |z }|rWt|d}djt|j } td|d|jd| ||y)aValidate 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. rz, zUnknown field "z" in JSON for z. Valid fields: )r|r>rN) r"setraddupdatenameskeyssortedjoinr__name__) rrr field_infos valid_names field_name field_info extra_keys extra_key valid_fieldss rB_validate_json_extra_keysr8s*"%(KEK"-"3"3"5 J #:++,#6TYY[!K/J:&q) yy (8(8(:!;< !)N5>>:JJZ[gZhi  rDrctddlm}t||i}|jD]\}}||vs ||} | rt |j t sX|t| ttzrtj| n t | } t|j | g||} n| } | ||<|di|S)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(rsr) cyclopts.tokenr)rrr'hintrrdictlistjsondumpsr) rrrrrr)converted_datarrrsrconverted_values rB _convert_jsonr^s4%dE*N"-"3"3"5 J  $E )>zPS)TE4RV;9WDJJu$5]`af]gh")*//E7I~"^"')8N: &#6  "> ""rDerrorc D|jj}t|dr |jnt|dr|jdz nd}t d|dz }t t||dz}|||}|dkDrd|z}|t|kr|dz}||z }|dkDr|dz }d} tjd |rd } n8tjd |rd } ntjd |rd} nd|vrd} d|jd|dd|zd|j| S)aCreate 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^ ) rsrbhasattrrrrminr~rnsearchrr|) rrr value_str error_pos snippet_start snippet_endsnippet marker_posrs rB!_create_json_decode_error_messagers?* !!#I%UE2 7SXZaKb ahiI9r>*Mc)ni"n5K k2Gq'/S^#E/]*Jqa  D yyi(J < +L ; *@ K u~~.ggYfS:EUDVVXY^YbYbXcdhci jjrDcrt|}|s|di|Sg}i}|jD]N\}}|j|}|r1|jtj k(r|j ||fJ|||<Pt|j|jfd|d|Di|S)a%Instantiate 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,j|dS)Nr)index)rfield_names_orders rBz'instantiate_from_dict..s 1 7 7! =rD)keyc3&K|] \}}| ywrXr)ryrrvs rBr{z(instantiate_from_dict..s*A1sr) r"rgetkindr!POSITIONAL_ONLYappendrrsort) rrrpos_argskwargsrrsrrs @rBinstantiate_from_dictrs0"%(K }t}H F!ZZ\ E __Z0 *//Y-F-FF OOZ/ 0!&F:  *[--/0 MM=M> ** 5f 55rDr!rcd}i}|}|jD]\}}|j}t|tr||j} |dz }d} n;t |\} } | dk(r||||} |dz }n|||||| z} || z }| } | ||<| rn|t |k(sn|t |k(sJt||S)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)rrr'rrsrr~r) rrrrirrrrrs should_breaktokens_per_elementrs rB_convert_structured_typers< A D D"-"3"3"5 J !s +!HNNE FA L.9$.? +  !Q&eAh/QeA4F0F&GH''&L Z   E ? 1#64 E ??  --rDc ddlmddlm}d}t |rHddlm}|j |\}j r d}fd}|}jrj}ndtt||tt||}t|}|tvr t|}t||turtttf|} n|t vrt ||} n|tvr*t|} t j#| | } | |} nMt$%t'|t$r|j(|} n"t+|rBD]} t-| r | |} nt'|t0rt2t5|| |t6urbd} t|D]} t9||}||k(s|} n| r || _| t5t'|t0r |d| || |t<ur't'|r |||| } nJ||g|d |i} n<|t>vrtAd\}}t'|t0st2d}|d kDrtCfd |Dr |tur|}n |d kDrtEtG|g|zddi}n|}|fd|D} ntI|tJr"tM|t'|t0r|n|g|} n~tI|tNr.converter_with_tokenMsh''''&,%5%5"0#6)05G)H&##$67-uh77.b5(;;rDNrr)rrr`c3K|];}t|xr)|jjjd=yw){N)rrsrbrM)ryr:r)s rBr{z_convert..s9\V[QRJq%(LQWW]]_-G-G-LLV[sAArc36K|]}d|yw)rNr)ryerrs rBr{z_convert..sBc'+a.!4crr )r|rr>r)exception_messagers)@rr)cyclopts.parameterrrfrom_annotationrrr rrrr/rrrr.rrr __value__rr Exceptionrrarrtyper>rrranyrrr'r rr rrsr"r&implicit_valuer#rrrbrMrloads TypeErrorrJSONDecodeErrorrr validatorrrrAssertionErrorr args)rrrrrconverter_needs_tokenr convert_tuple origin_typer concrete_type default_paramr:last_coercion_errorchoiceresr countrrrgenrrr|rr)rrrs @@@@rBrr4s(,!E0!11%8 v   $( ! <"-I  #22Nh)NSGNiP^_MU#K888E 5/K }d38ne, 1 15e'T%%UV#U22-V#"V#&W(:)W##W(c ddlm|stt|ts't|dt rt fd|D}|t}tt||}tt||}t|}|turt }tj||}|tvrt|}tj||}t!|}|tvr t|}|xs|}|t ur ||g|S|t"vr |||S|turpt|tst t%|d} |j)D cic]\} } | t+| | ||} } } t-j||d i| St|trtd|dt/|r t1|||St3|\} }|r |||St5|dk(r |||dS| dk(r|Dcgc] }||| c}St5|| k(r |||St7d#t&$r t } YwxYwcc} } wcc}w) aCoerce 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``. rr(c3BK|]}t|yw)rN)r)ryrr)s rBr{zconvert..Fs;Fqu3q6**Fsrr`z*Dictionary of tokens provided for unknown rLz Unreachable?r)rr)rarrrrr$r rrrrr.rr/rrr IndexErrorrrrrrrr~NotImplementedError)rrrr convert_privrrrmaybe_origin_type value_typekrdict_convertedrritemr)s @rBrrsmt(  fd # 6!9c(B;F;;/8yXLNiP^_M ENE | + / /u =E 22:5A /33M=QU#K888E #,ueU,V,, n ,E6** d "&$'  !%+Jgmfrfrft ft^b^_abAwz1 .Y Yft  02CDV~VV FD !EeYaPQQ ' (!!2FNKK*5e*<'K v. . [A vay1 1 1 $:@A&$L-&A A [. .v. .%n5 5/ J  "Bs,H- I8I -I?Iskip_converter_paramsctt|yddlm}|||\}}|D]F}|j|jdk(ry||urt |d\}}nd }|j|fcS|}t |}|tvr t|}|tvr*t|} tj| | }t |}|xs|tur$t|} | rtd | Dd | vfSy|xs|tury |tvs|tvrtt|dk(ryt!|ry|tvr0tt|rt t|dddfSt"%t%|t"rt |j&St)|rIt|} t | d} | d dD]&} t | }|| k7st+d| dd| | St-|ryt/|}d \}}|j1D]L}|j2|j4urd}n |j6s+t |j8\}}||z }||z}N|sy||fS)aThe 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. N)r`Fr)get_parameters)r.)r`TTFc3BK|]}|dust|dyw).rN)rrs rBr{ztoken_count..s G$Q!3,{1~a($s .)rFr`z=Cannot Union types that consume different numbers of tokens: r_)rrr r0n_tokensrrr/r.rrrsumr@rr~rrrrrrar&r"valuesrVAR_POSITIONALrequiredr)rr.r0 resolved_type parametersparamrrconsume_all_from_typerrrsub_argstoken_count_target sub_type_thisrr"rrs elem_countelem_consume_alls rBrrs,##3E#:;G2 .uLa bM: >> %~~# !-0;=`d/e,A,-2)~~'<<rUsK  88..%w$M   ?:ddw$M' CL Ct Ct y~$s)S 5c?$sCx. 5dDj!1 d OOT dOOOOOO##TOOTOO""D 8"Dt$4 S%  >??@ .S.T.CC"%c%e% # ) !S!T! F F F "&#"&)"&Jce* 7 # cUCZ( .Aw SMHW- -cUCZ( F % 6 z% i z 6 $ T#x- ( 9( (s S()D0(cUCZ( (  (\!# # #  #  # L.# .# .#.#$ .# cUCZ( .#b5k 5k 5k   5k 5kp*6a*6S#X*61*6Z=. 7=. G =.c;&'=. =.  =.@O (7++ ,Oc C(4/ O cUCZ( Oj4826 z6 z6 SMHW- - =z6s S()D0z6cUCZ(4/ z6zj"sj"4j"E#t)DTj"rD