lKj\ ddlZddlZddlZddlZddlmZmZmZddlm Z ddl m Z m Z m Z mZmZmZmZddlmZmZej*dk\rddl mZnddlmZddlZddlmZmZmZmZmZm Z m!Z!m"Z"m#Z#dd l$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+m,Z,m-Z-m.Z.m/Z/e0ee1ee1ejdje1e3e1e e1e4e1d fe e1d fhZ5ed Z6e0e1degee5Z7dZ8de9ee9zdzde4e9d ffdZ:ded e fe9zeed e fe9zzdzde4ed e fe9zd ffdZ;ddde4dfdZde1dzde1fdZ?de1ee%e0e9ge9ee9zdzfzdzde1ee%e0e9ge9ee9zdzfzfdZ@dZAde4e9d ffdZBde1eCzeeCze4eCeCdzfzdzde4eCeCdzfdzfdZDde1eje9ze9zdzde1eje9zdzfdZFe.de,Gd d!ZGeGjDcic]%}|jr|j|j'c}ZLeGZMd"efd#ZNd)d$e6d%e1de4e6e3eGffd&ZOeGd'd(ZPycc}w)*N)CallableIterableSequence)deepcopy)AnyListTupleTypeVarcastget_args get_origin)definefield) )Self) ITERABLE_TYPESNoneType is_annotated is_nonetypeis_unionresolveresolve_annotatedresolve_new_typeresolve_optional) FieldInfoget_field_infossignature_parameters)Group)default_name_transformfrozenoptional_to_tuple_converter record_initto_tuple_converter.Tcj|D].}||jdst|jdy)N-z value must NOT start with "-".) startswith ValueErroralias)instance attributevaluesvalues c/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/parameter.py_not_hyphen_validatorr0@s7  !1!1#!6 00OPQ Qr.returncFtttdft|SN.)r tuplestrr$r.s r/_str_tuple_converterr8Fs c3h!3E!: ;;r1cftttdtftzdft |Sr4)r r5rrr6r$r7s r/_validator_tuple_converterr:Js/ hsCx(3.346H6O PPr1z*None | Group | str | Iterable[Group | str]z Group | str.c:ttdt|S)Nr;)r r5r$r7s r/_group_tuple_converterr=Ps ()+=e+D EEr1ct|SN)r"r7s r/_optional_str_tuple_converterr@Ts &u --r1c||SdS)NTr7s r/_default_if_none_truerCXs%5/4/r1c||SdSNFrBr7s r/_default_if_none_falserF\s%5050r1c|dS|SrErBr7s r/_short_alias_converterrH`sM5,u,r1c:t|tr tdy)NzParameter.short_alias does not accept a string. Pass a bool to auto-generate a short flag, or a callable for custom logic. To set an explicit flag like "-z", use Parameter.alias or Parameter.name instead.) isinstancer6 TypeError)r+r,r.s r/_short_alias_validatorrLfs%% 9  r1defaultc`dtttzdzdttdfffd }|S)Nr.r2.c"|St|Sr?)r$)r.rMs r/ converterz&_negative_converter..converterrs =N%e, ,r1)r6rr5rMrPs` r/_negative_converterrRqs4-x},t3-c3h- r1c||dury|duryt|tr|dkrtd|d|dfSt|trt |dk7rtd t |d|\}}||dfSt|tr0t|t s t|trt|t r8t d t|jd t|jd |dks|dkrtd |d |d ||kDrtd|d |d ||fSt dt|jd)zNormalize consume_multiple into (min, max) or None. Returns ------- tuple[int, int | None] | None ``None`` if consume_multiple is disabled (``None`` or ``False``). ``(min, max)`` where ``max=None`` means unlimited. NFT)rNrz5consume_multiple int value must be non-negative, got .zGconsume_multiple sequence must have exactly 2 elements (min, max), got z5consume_multiple sequence elements must be int, got (, z).ze2edfe d0<e?d1edzfd2Z@e?d3ZAd1e2edffd4ZBd5ZCeDd>d7ZEeDd1eFfd8ZGeDd9e d:d6d1e2e dffd;ZHd|jr |jStSr?)r|r rs r/r{zParameter.name_transforms'+';';t##WAWWr1c 2|jr |jyt|}t|rYt |}t |d}g}|D].}|j |D]}||vs|j|0t|St|}|tvr |r |tvryygg}}|jrB|jD]&} | jdr|n|j| (|s t|St|jtsJ|jD]} | jds| dd} | jd} |tus|t vr |j"} n&t%|s| |j&} n |j(} dj+| dd} | r| dz } t| tsJ|j&| D] }|s|jd| || d"|D]} |jd| | t|S) NrBc$t|xs|duSr?)r)xs r/z)Parameter.get_negatives..s;q>;VQRVY;Vr1)keyr'z--rUrT)rrirrr sorted get_negativesappendr5r _NEGATIVE_FLAG_TYPESr(rJrfsplitrYITERATIVE_BOOL_IMPLICIT_VALUErurrwrvjoin)rtype_ union_args sorted_argsoutrnegoriginuser_negativesrirfname_componentsnegative_prefixes name_prefixnegative_prefixs r/rzParameter.get_negativess ::$--/!%( E?!%J!1VWKC --a0C#~ 31!: E" , ,!55 "^ == MM ++C0nLLXV*"Sz!$))U+++IID??4(8D"jjoO})F F$($6$6!U#u}$($6$6!$($:$:!((?3B#78Ks" /7 77}}$'8O& R }_4EoVXFYEZ#[\(9!/HJJK= ;<!/+.Szr1c  dj|jDcgc]?}|j|jvr%|jdt ||j Ac}}t |jd|dScc}w)zOnly shows non-default values.rV=())r__attrs_attrs__r*rcgetattrrfrZr[)racontents r/__repr__zParameter.__repr__s))-- -A77d11177)1WT166256-  t*%%&ay22  sABParameter | Noneci}|Dcgc]}|| }}t|dk(r|dS|stS|D])}|jD]}t|t|||<+|di|Scc}w)a)Returns a new Parameter with combined values of all provided ``parameters``. Parameters ---------- *parameters : Parameter | None Parameters who's attributes override ``self`` attributes. Ordered from least-to-highest attribute priority. rrB)rXEMPTY_PARAMETERrcr_parameter_alias_to_name)cls parameterskwargsrfiltered parameterr*s r/combinezParameter.combines);z!Q]Az; x=A A; " "!I"11 ' 3KE3R Su 2"}V}+>I+>a!&&qww !+>I  Is A A rdefault_parametersc|tjjur|r||j|fS|tfSt |\}}||jg||fS)z1Resolve the immediate Parameter from a type hint.)inspectreemptyrrget_parameters)rrrrs r/from_annotationzParameter.from_annotationsk G%%++ +!kckk+=>>>o-- .u 5 E:+#++G'9GJGG Gr1objct|dst||_n3|jj|k7rt |j|_|jj j ||S)zDecorator interface for annotating a function/class with a :class:`Parameter`. Most commonly used for directly configuring a class: .. code-block:: python @Parameter(...) class Foo: ... __cyclopts__)r)hasattrCycloptsConfigrrrrr)rrs r/__call__zParameter.__call__sasN+-#6C     ! !S ('(8(89C  ##**40 r1)rrr2re)Kr[ __module__ __qualname____doc__rr8rfr6r__annotations__rPrrr:rhr*r@rir=rkrrbrlrYr`rrnrorCrprqrrrscyclopts_env_varrtrRr0rurvrwrxryrzr|r}r^r~rWrr5rrrFrrHrLrr frozensetrrrcpropertyrmr{rr classmethodrrrMrr%rrBr1r/rereso@(-&(D$*x} $ 272IxS!C'$.W\,WIthsCx((3.(38:Ls:R1SS).&)E4#: %,1/,HdSj8C=(9>(  9E4%<#  5 5',"'E4"** t # E4$; >C>L$+#hucz&:: 'L$ T48D#*8'L$+0&+GTCZ(3- ' ).!!//)M8CH% 16%h/' 1M4#: -5:%k2' 5tczHSM116%b)' 1M4#: -"HdTk "'"$ "OT 494OXseSj)D0 !&!L$+ TY-TdTkC'(3-7%S4Z:PP #4>Itd{>"4>Itd{>(E4 ]b(( ]K)Ys^!QTX>X!XYY$)$OTD[ !HcDj ',E%&PNE#s(OP  dTk  XX;eCHo;z 30    HC H>P HUZ[^`k[kUl H HA!r1refc<|jxsdjdryt|jD]}t |j }|st |j dds3tj|j \}}|jot|jtjsK|js?|j|ju}|j|j u}|s |s t#dd|j$vs|j|j us|j }t'|}t)|}t+d|jD} | s>|j,r|j,dnd} | rd | d nd} t#d | d |d | d|j j.d|j j.d| d|j j.d| d| d| d|j j.dy)zValidate if a function abides by Cyclopts's rules. Raises ------ ValueError Function has naming or parameter/signature inconsistencies. rNrzuParameter.parse=False must be used with either a KEYWORD_ONLY function parameter or a parameter with a default value.*c36K|]}|j ywr?)rx).0 field_infos r/ z#validate_command..@s%kPj***=*=&=Pjsr"z" z Parameter z in function z has all optional values, uses Parameter(name="*"), but itself has no default value. Consider either: 1) If immutable, providing a default value "z: z = z2()" 2) Otherwise, declaring it optional like "z# | None = None" and instanting the z, object in the function body: if z is None: z())rr(rr-r annotationrrerrlrJr`rkind KEYWORD_ONLYrMrr)rfrrallnamesr[) rrfield_info_is_annotated_cparamis_keyword_only has_default annotatedclass_field_infosall_fields_optional param_namequoted_param_names r/validate_commandrsA &&z2*1-446 ".z/D/D"E&wz7L7Ln^b/c --j.C.CD 6 << #Jv||RZZ,PY_YeYe(oo1H1HHO$,,J4D4DDK#{ ; 6;; ""j&6&66#--I *I / : "%%kPaPhPhPj%k"k "4>4D4DZ--a0" :Da |2$6"!  !2 3<sCGGQlRTU_UjUjUsUsTttwyCyNyNyWyWxXXEEOLPRS]ShShSqSqRrsVWaVbb%%/L1&&0\Z5J5J5S5S4TTV XE7r1hintskip_converter_paramsc~g} |}ttt|}t|}t |r8t |}|d}|ddDcgc]}t |ts|c}|ddj||k(rnpg}t|ddx}r|j|jg}|s ||zD]} | js| j} t | tr t|| } t| dr'|j| jjnt| dsyt| dst| jds| jj j#| j$} | st| ds|j| jjn||z|z} || fScc}w)aAt root level, checks for cyclopts.Parameter annotations. Includes checking the ``__cyclopts__`` attribute on both the type and any converter functions. Parameters ---------- hint Type hint to extract parameters from. skip_converter_params If True, skip extracting parameters from converter's __cyclopts__. Used to prevent infinite recursion in token_count. Returns ------- hint Annotation hint with :obj:`Annotated`, :obj:`Optional`, and :obj:`NewType` resolved. list[Parameter] List of parameters discovered, ordered by priority (lowest to highest): converter-decoration < type-decoration < annotation. rrNr__self__r[__dict__)r r%rrrr rJrerextendrrPr6rrrrgetr[) rrannotated_params hint_previnnerrtype_cyclopts_config_paramscyclopts_configconverter_paramsparamrP descriptorrs r/rrOs6  A'-.%  TNE8D/4QRy#Uy!Jq)rs 88 w&   QP !*  & T  T  dCi dCi ! CL $h!h!hJg!hiR <hsm 3d : > E#x 3d ?d"#xLD2::c?2S84?D2::VY?DZ]aDa ___H  & & &vvGGQVVO & +33lMM4ME!TR[_J\D]M`BBBas.*J