lKj<dZddlZddlmZmZmZddlmZddlm Z m Z ddl m Z ddl mZmZmZmZmZmZmZerddlmZed e Zdd lmZdd lmZmZmZmZdd lm Z m!Z!m"Z"m#Z#m$Z$m%Z%ddl&m'Z'ejPdk\rddl m)Z)ndZ)e'ddddddZ*ie"e"fe"e"e!fe!e"e fe e"e$fe$e"e#fe#e!e"fe!e!e!fe!e!e fde!e$fe$e!e#fde e"fe e e!fde e fe e e$fde e#fe#e$e"fe!e$e!fe!e$e fde$e$fe$e$e#fde#e"fe e#e!fde#e fe e#e$fde#e#fe#iZ+de,dee-ge-fde.e-fdZ/dZ0deege1e-e%ffdede1e-efge.e-ffdZ2de,ede1e-e3fdee-ge-fdefdZ4de-de3fdZ5de-ee-zdzde3fd Z6d!dd"e7e-ddfd#Z8d!dd$e'de3fd%Z9d!dd"e7e-de:e-d&fdzfd'Z;d(ede1e:e-d&fe'ffd)Z d1d-e:e-d&fdzdee:e:e-d&feffd.Z?d/e-de-fd0Z@y)2z?Shared helper functions and constants for the argument package.N)CallableIterableIterator)suppress)EnumFlag)partial) TYPE_CHECKING AnnotatedAnyLiteralTypeVarget_args get_origin)ArgumentF)bound)convert_enum_flag)ITERABLE_TYPESis_class_and_subclassis_unionresolve_annotated) KEYWORD_ONLYPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD VAR_KEYWORDVAR_POSITIONAL FieldInfo) Parameter) ) TypeAliasType)namealias converter validator accepts_keysenv_vartype_name_transformreturnc:tt}g}t|}t|tr6t |t r&|jfd|jD|St|r;t|Dcgc] }|| }}|D]}|s|j||S|tur#|jdt|D|S|tvrVt|}t|dk(s!|tur3t|dk(r%|dtur|j||d|S|t ur"|j|t#||St$1t|t$r!|j||j&|Scc}w)aExtract completion choices from a type hint. Recursively extracts choices from Literal types, Enum types, and Union types. Parameters ---------- type_ : type Type annotation to extract choices from. name_transform : Callable[[str], str] Function to transform choice names (e.g., for case conversion). Returns ------- list[str] List of choice strings extracted from the type hint. )r*c3.K|] }|ywN).0xr*s h/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/argument/utils.py z(get_choices_from_hint..`sD2CQ~a(2Csc32K|]}t|ywr.)strr0r1s r2r3z(get_choices_from_hint..gs7!s1vsr)r get_choices_from_hintr isinstancetyperrextend __members__rrr rlentupleEllipsisr rr" __value__) r)r* get_choiceschoices_origininner inner_choicesr1argss ` r2r9r9Ksr"/OKGG%#8#ED%2C2CDD N ' 9A%IU+ IAq! N G 7x77 N N " t9>g.3t9>d1gQYFY NN;tAw/ 0 N I {#4U#;<= N  "z%'G{5??34 NJs>FcBd}||j||S)Nc&|jddS)N_-)replace)ss r2 normalizezstartswith..normalizetsyyc"" startswith)stringprefixrNs r2rQrQss$# V  ' ' &(9 ::rOget_field_inforcXdddtttfdttffd }|S)Nargumentrdatar+ct|}|j}|jDcgc]\}}|js||vs|c}}Scc}}wr.)sethintitemsrequired)rVrW provided_keys field_infokvrTs r2rEz#missing_keys_factory..inner}sND #HMM2 (..0\0daQZZA]DZ0\\\sAA A)dictr5r list)rTrEs` r2missing_keys_factoryrczs4] ]$sCx.]T#Y] LrO enum_typerWcFt|d|jD|S)a5Convert a dictionary of boolean flags to a Flag enum value. Parameters ---------- enum_type : type[F] The Flag enum type to convert to. data : dict[str, bool] Dictionary mapping flag names to boolean values. Returns ------- F The combined flag value. c3,K|] \}}|s |ywr.r/)r0r_r`s r2r3z&enum_flag_from_dict..s(I|tq!q|s )rr[)rdrWr*s r2enum_flag_from_dictrgs& Y(Itzz|(I> ZZrOflagcFt|dk(xr|ddk(xr|ddk7S)zWReturn :obj:`True` for a single-letter flag like ``-e`` (not ``--env`` or ``-`` alone).r8rrKr7)r>)rhs r2 is_short_flagrjs* t9> ?d1gn ?aC?rOnamescTt|tr|f}td|xsdDS)a}Return :obj:`True` if the parameter surfaces at the root CLI namespace. A root-namespace parameter has an **undotted** long flag (e.g. ``--env``). This covers genuine top-level command parameters as well as fields promoted to the root via ``Parameter(name="*")`` or PEP 692 unpacking (``--name``), while excluding dotted nested fields such as ``--user.name``. c3JK|]}|jdxrd|vyw)--.NrP)r0ns r2r3z%_is_root_namespace..s&J[qq||D!2cl2[s!#r/)r:r5any)rks r2_is_root_namespacerrs,% JU[b[J JJrOrVused_short_aliasesc|j}g|jxsd|jxsdD]}t|s|j |!y)aPhase 1a: reserve every explicitly-provided short flag into ``used_short_aliases``. Runs for *every* argument as the tree is built (independent of eligibility), so that auto-generation (phase 2, deferred until the whole tree is known) avoids user-supplied shorts regardless of parameter ordering. At this point no auto short has been appended yet, so any single-letter flag present is necessarily user-provided. r/N) parameterr#r$rjadd)rVrscparamrhs r2reserve_explicit_shortsrxsK  F=6;;$"=);=    " "4 (>rOimmediate_parameterc|j}|jsyd|jvsd|jvs |jryt |j sy|j r |jsyy)u)Phase 1b: pure predicate for whether this argument should receive an auto-generated short flag. Auto shorts apply to opted-in (``short_alias``), **input-binding** parameters only (scalars, dicts, enum flags) — never to promoted containers whose fields become child options. They apply only to **root-namespace** parameters (an undotted long flag). A field that stays namespaced (e.g. ``--user.name``) never gets one — ``short_alias`` on such a field is inert; flatten it to the root namespace via ``name="*"`` to expose it. Fr#r$T)ru short_alias_provided_argsr$rrr#_accepts_keywords_enum_flag_type)rVryrws r2is_short_alias_eligiblersp  F   $333wBUBdBd7dhnhtht fkk *!!(*B*B rO.c|j}|j}d}|j}t|r||t }n|r|j t tfvry|jtur|jdury|j|jd}|r8|dj}d|d|jfD] }|vs|}n|syt|t r|f} n t#|} | D],} t| t r t'| rt)d| dt#fd| D} | syj+| | S#t$$rt%d|ddwxYw) aPhase 2: generate the auto short flag(s) for an argument deemed eligible by phase 1. Deferred until every parameter's explicit short has been reserved, so an earlier parameter's auto short can never shadow a later parameter's explicit ``alias``. Returns the generated short name(s) to append to the argument's name as standalone flags (so they surface globally, e.g. ``-e``, never dotted like ``-u.name``), or :obj:`None`. Mutates ``used_short_aliases`` to reserve claimed letters. NTrrKzSParameter.short_alias callable must return a str, an iterable of str, or None; got rozTParameter.short_alias callable must return single-letter short flags like '-e'; got c3,K|] }|vs| ywr.r/)r0rMrss r2r3z'generate_short_alias.. sDf1C(C1fs )rur^r{callable frozensetkindrrrZbooldefaultr*rklowerupperr:r5r? TypeErrorrj ValueErrorupdate) rVrsrwr^shortr{ transformedletter candidateshortsrMs ` r2generate_short_aliasrs  F$$J E$$K J 2D(EF .0QQ ==D Z%7%74%?++J,<,*   M  s1 C>AD 'AD>D DDD21D2c|jdr|ddjd}|r|jdsd|z}|S)N*rrorKrn)endswithrstriprQ)elems r2resolve_parameter_name_helperrOs@ }}SCRy$ DOOC(d{ KrOargsscttd|D}t|dk(ryt|dk(rtd|dDSg}|dD]S}t|}|dD]>}|jds|s|j |(|j |dz|z@Ut t|g|dd S) aResolve parameter names by combining and formatting multiple tuples of strings. Parameters ---------- *argss Each tuple represents a group of parameter name components. Returns ------- tuple[str, ...] A tuple of resolved parameter names. c3&K|] }|s| ywr.r/r6s r2r3z)resolve_parameter_name..ds(Ua!Usrr/r7c3@K|]}|dk(rdn t|yw)rN)rr6s r2r3z)resolve_parameter_name..is$]T\qAHS*G*JJT\srKror8N)r?r>rrQappendresolve_parameter_name)routa1a2s r2rrWs (U( (E 5zQ Uq]TYZ[T\]]] CAh *2 .(B}}S! 2 28b=)  "%* 9uQRy 99rO parent_keysc#K|d}t|trJ|jD]6\}}||fz}t|trt||Ed{1||f8yd|fy7w)Nr/)r:rar[ walk_leaves)drkeyvalue current_keyss r2rrwsr !T'')JC&#/L%&&ul;;;"E)) $!e rs E 88XXX4 Ct/ )w$M$   "124I"O,o"L)<"N+^ " K(+ " +,o "o&"l#T"n%~"k"D"()<"?#T"< ,">"D";" *+_!""_%#"$\"D^$n[!4'(,/"D,.!4+ 3":%%xs 7K%PTUXPY%P;cUDi$889 z4S>*DI56[Aw[ sDy/[cUCZ([ [,@@@ KcHSM1D8 KT K )j )c#h )SW )'j'y'UY'T??C? 38_t?D%h%4c3h0J+K%P:5c?:uS#X:D+/sCx4'eE#s(OS()*$!c!c!rO