k7iG SSKrSSKrSSKrSSKJrJrJr SSKJr SSK J r J r J r J r JrJrJr SSKrSSKJrJr \R(S:aSSK Jr OSSKJr SSKrSSKJr SS KJrJrJrJrJ r J!r!J"r" SS K#J$r$J%r% SS K&J'r' SS K(J)r)J*r*J+r+J,r,J-r- \."\\/\\/\R`R \/\1\/\ \/\2\/S 4\ \/S 415r3\ "S5r4\."\/S\/\Q\3Q5r5Sr6S\2\7S 44Sjr8\,"S5\*"SS555r9\9RtVs0sH-nURv(dMURxURz_M/ snr>\9"5r?S\4Sjr@SS\4S\/S\2\4\1\944SjjrA\"SS55rBgs snf)N)CallableIterableSequence)deepcopy)AnyListTupleTypeVarcastget_args get_origin)definefield) )Self)ITERABLE_TYPES)NoneType is_annotated is_nonetypeis_unionresolveresolve_annotatedresolve_optional)get_field_infossignature_parameters)Group)default_name_transformfrozenoptional_to_tuple_converter record_initto_tuple_converter.Tc|UH6nUcMURS5(dM [URS35e g)N-z value must NOT start with "-".) startswith ValueErroralias)instance attributevaluesvalues L/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/parameter.py_not_hyphen_validatorr.?s:  !1!1#!6!6 00OPQ Qdefaultc6^S[[S44U4SjjnU$)Nreturn.c$>UcT$[U5$N)r")r,r0s r- converter&_negative_converter..converterFs =N%e, ,r/)tuplestrr0r5s` r-_negative_converterr:Es-E#s(O- r/_provided_argsc \rSrSr%Sr\"SSS9rS\-\\-\ S'\"SSS9r \ S \ 4\-S-\ S '\"S S SS 9r S\ \ \ /\ 4-\\ \ \ /\ 4-\ S'\"SSSS 9rS\-\\-\ S'\"S\SS 9rS\-\\-\ S'\"S\SSS9rS\-\-\\\--\ S'\"S\R*R-S5SS 9r\\ S'\"SSSS9r\S-\ S'\"SSS9rS\-\ \ /\ 4-\ S'\"S\R*R-S5SS 9r\\ S'\"SSS9r\S-\ S'\"S\R*R-S5SS 9r\\ S'\"SSSS 9rS\-\\-\ S'\"\R@RBSS9r!\ \ S'\"S\""S 5\#SS!9r$S\-\\-\ S"'\"S\""S#5\#SS!9r%S\-\\-\ S$'\"S\""S 5\#SS!9r&S\-\\-\ S%'\"SSS9r'\S-\ S&'\"SSS9r(\\ S''\"S(SSS)9r)\ \/\4S-\ S*'\"SSS9r*\S-\ S+'\"S\R*R-S5SS 9r+\\ S,'\"SSS9r,\S-\ S-'\"SSS9r-\S-\ S.'\"S\R*R-S5SS 9r.\\ S/'\"SSS9r/\0S-\ S0'\"\1SSS19r2\1\S 4\ S2'\3S3\4S4j5r4\3S55r5S3\1\S 44S6jr6S7r7\8S@S9j5r9\8S3\:4S:j5r;\8S;\ S\=S3\=4S?jr>S r?g)A ParameterOaCyclopts configuration for individual function parameters with :obj:`~typing.Annotated`. Example usage: .. code-block:: python from cyclopts import app, Parameter from typing import Annotated app = App() @app.default def main(foo: Annotated[int, Parameter(name="bar")]): print(foo) app() .. code-block:: console $ my-script 100 100 $ my-script --bar 100 100 NcF[[[S4[U55$N.r r7r8r"xs r-Parameter.tDsCx2DQ2GHr/r9nameT)r0kw_only.r5cl[[[[[/[4S4[ U55$r@)r r7rrr"rBs r-rDrEs)Dxc C'@#'E!FHZ[\H]^r/)r0r5rH validatorcF[[[S4[U55$r@rArBs r-rDrErFr/r(negativeF)r0r5rHhashgroupparseshow)r0r(rH_show show_default show_choiceshelp show_env_varcF[[[S4[U55$r@rArBs r-rDrErFr/env_var env_var_split)zno-)r0r5rKrH negative_bool)zempty-negative_iterable negative_nonerequiredallow_leading_hyphenname_transform)r(r0rH_name_transform accepts_keysconsume_multiple json_dict json_listcountn_tokens)factoryiniteqr;r2cLURb UR$UR$r4)rRrPselfs r-rQParameter.show s!ZZ3tzzCCr/cHUR(a UR$[$r4)r`rrks r-r_Parameter.name_transforms'+';';t##WAWWr/c UR(aURcg[U5n[U5(a\[ U5n[ USS9n/nUH3nUR U5HnXd;dM URU5 M M5 [U5$[U5nU[;aU(a U[;agOg//pUR(aNURH,n U RS5(aUOURU 5 M. U(d [U5$[UR[5(deURGHn U RS5(dMU SSn U RS5n U[Ld U[ ;a UR"n O,[%U5(dUc UR&n O UR(n SR+U SS5n U (aU S- n [U [5(deURc/U H'nU(dM URSU UU S35 M) MUHn URSU U 35 M GM [U5$) NrIc.[U5=(d USL$r4)rrBs r-rD)Parameter.get_negatives..sKN+>I+>a&&!qww !+>I  Is A A rdefault_parameterscU[RRLaU(aXR"U64$U[4$[ U5upXR"/UQUQ764$)z1Resolve the immediate Parameter from a type hint.)inspectr=emptyrrget_parameters)rrrrs r-from_annotationParameter.from_annotation~sa G%%++ +!kk+=>>>o-- .u 5 E++G'9GJGG Gr/objc[US5(d[US9UlO4URRU:wa[ UR5UlURR R U5 U$)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)hasattrCycloptsConfigrrrrry)rlrs r-__call__Parameter.__call__sdsN++-#6C     ! !S ('(8(89C  ##**40 r/)rrr2r=)@r __module__ __qualname____firstlineno____doc__rrGr8r__annotations__r5rrrKr(r rMr"rOrattrs convertersdefault_if_nonerPr}rRrSrTrUrVrXcyclopts_env_varrYr:r.rZr[r\r]r^r`rarbrcrdrerfintr7r;propertyrQr_rxr classmethodrrr0rr#r__static_attributes__rIr/r-r=r=Os@(-H(D$*x} $ 272IxS!C'$. Y^^YIthSz3//(8S#JPSO;T2UU).H)E4#: %,1-,HdSj8C=(9>$  9E4%<#  5 5""2248E4 E4$; 8=8L$+# 44 ""2248L$ T48D#*8""2248L$+0H+GTCZ(3- ' $!!//M8 16%h/' 1M4#: -5:%k2' 5tczHSM116%b)' 1M4#: -"HdTk "'"$ 494OXseSj)D0 !&!L$+ #""2259d #4>Itd{>"4>Itd{>""2259E4 !HcDj ',E%&PNE#s(OP DdDDXX;eCHo;z 30    HC H>P HUZ[^`k[kUl H HA!r/r=fcUR=(d SRS5(ag[U5R5GHn[ UR 5nU(d[ UR SS5(dM>[RUR 5up4UR(d$URURLa [S5eSUR;dMURURLdMUR n[!U5n[#U5n[%SUR555nU(dGM UR&(aUR&SOSnU(aS US 3OSn [S U S US USUR R(SUR R(SUSUR R(SUSUSUSUR R(S35e g)zValidate if a function abides by Cyclopts's rules. Raises ------ ValueError Function has naming or parameter/signature inconsistencies. rNrzJParameter.parse=False must be used with a KEYWORD_ONLY function parameter.*c3B# UHoR(+v M g7fr4)r]).0 field_infos r- #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 annotationrr=rrPkind KEYWORD_ONLYr'rGr0rrrallnamesr) rrfield_info_is_annotated_cparam annotatedclass_field_infosall_fields_optional param_namequoted_param_names r-validate_commandrs &&z22*1-446 ".z/D/D"E&wz7L7Ln^b/c/c --j.C.CD || z7N7N Nij j 6;; ""j&6&66#--I *I / : "%%kPaPhPhPj%k"k ""4>4D4DZ--a0" :Da |2$6"!  !2 3<sCGGQlRTU_UjUjUsUsTttwyCyNyNyWyWxXXEEOLPRS]ShShSqSqRrsVWaVbb%%/L1&&0\Z5J5J5S5S4TTV X97r/hintskip_converter_paramsr2c[U5n/n[USS5=n(aURUR5 /n[ U5(a+[ U5nUSnURSUSS55 /nU(Gd7XB-GH.nUR (dMUR n[U[5(a [X5n[US5(a'URURR5 O[US5(dM[US5(dM[URS5(dMURRRUR5n U (dM[U S5(dGM URU RR5 O Xb-U-n X 4$) agAt 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` and :obj:`Optional` resolved. list[Parameter] List of parameters discovered, ordered by priority (lowest to highest): converter-decoration < type-decoration < annotation. rNrc3T# UHn[U[5(dMUv M g7fr4)r{r=)rrCs r-r!get_parameters..sQ9a 1i8P9s( (r__self__r__dict__)rrextendrrr r5r{r8rrrrgetr) rrtype_cyclopts_config_paramscyclopts_configannotated_paramsinnerconverter_paramsparamr5 descriptorrs r-rrs* D !D#%!$===#**?+E+EFDQxQ59QQ %CE!OO i-- ' 8I9n55$++I,B,B,M,MNIz22 :66 2 2J??"+!3!3!rs 88 w&,F !*  & T  T  dCi dCi ! CL $h!h!hJg!hiR sCx III\  & & &vvAGGQVVO & +--`BB4BE!TR[_J\D]BJBBBs F3F