o i> @sddlZddlZddlZddlmZmZmZddlmZddl m Z m Z m Z m Z mZmZmZddlZddlmZmZejdkrFddl mZnddlmZddlZddlmZdd lmZmZmZmZm Z m!Z!m"Z"dd l#m$Z$m%Z%dd l&m'Z'dd l(m)Z)dd l*m+Z+m,Z,m-Z-m.Z.m/Z/e0ee1ee1ej2je1e3e1e e1e4e1dfe e1dfhZ5e dZ6e0e1degee5Z7ddZ8de4e9dffddZ:e.de,GdddZ;dde;jdefddZ?de6de4e6e3e;ffdd Z@eGd!d"d"ZAdS)#N)CallableIterableSequence)deepcopy)AnyListTupleTypeVarcastget_args get_origin)definefield) )Self)ITERABLE_TYPES)NoneType is_annotated is_nonetypeis_unionresolveresolve_annotatedresolve_optional)get_field_infossignature_parameters)Group)Token)default_name_transformfrozenoptional_to_tuple_converter record_initto_tuple_converter.TcCs0|D]}|dur|drt|jdqdS)N-z value must NOT start with "-".) startswith ValueErroralias)instance attributevaluesvaluer,X/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/parameter.py_not_hyphen_validator@s r.defaultcsdttdfffdd }|S)Nreturn.cs|durSt|SN)r")r+r/r,r- converterGsz&_negative_converter..converter)tuplestrr/r3r,r2r-_negative_converterFsr7_provided_argsc @seZdZUdZeddddZdeBeeBed<edddZ e e e e gefdBed <ed d ddd Zde eegefBee eegefBed <eddddd ZdeBeeBed<ededd ZdeBeeBed<ededddZdeBeBeeeBBed<edejddd Zeed<eddddZedBed<edddZdeBe egefBed<edejddd Zeed<edddZedBed<edejddd Zeed<eddddd Z deBeeBed<ee!j"j#ddZ#e ed<ede$de%dd Z&deBeeBed!<ede$d"e%dd Z'deBeeBed#<ede$d e%dd Z(deBeeBed$<edddZ)edBed%<edddZ*eed&<ed'ddd(Z+e egefdBed)<edddZ,edBed*<edejddd Z-eed+<edddZ.edBed,<edddZ/edBed-<edejddd Z0eed.<ee1ddd/Z2e1ed0fed1<e3d2efd3d4Z4e3d5d6Z5d2e1ed0ffd7d8Z6d9d:Z7e8dHd=d>Z9e8d2e:fd?d@Z;e8dAedBddS)I ParameteraCyclopts 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 NcCtttdft|SN.r r4r5r"xr,r,r-uzParameter.r6nameT)r/kw_onlyr3r,cCs"tttttgtfdft|Sr;)r r4rrr"r=r,r,r-r?s")r/r3rB validatorcCr:r;r<r=r,r,r-r?r@r'negativeF)r/r3rBhashgroupparseshow)r/r'rB_show show_default show_choiceshelp show_env_varcCr:r;r<r=r,r,r-r?r@env_var env_var_split)zno-)r/r3rCrB negative_bool)zempty-negative_iterable negative_nonerequiredallow_leading_hyphenname_transform)r'r/rB_name_transform accepts_keysconsume_multiple json_dict json_listcount)factoryiniteq.r8r0cCs|jdur|jS|jSr1)rIrGselfr,r,r-rHszParameter.showcCs|jr|jStSr1)rVrr_r,r,r-rU szParameter.name_transformc Cs|jr |jdur dSt|}t|r:t|}t|ddd}g}|D]}||D] }||vr4||q)q"t|St |}|t vrM|rK|t vrJdSndSgg}}|jrm|jD]} | dra|n|| qX|smt|St |j tsuJ|j D]n} | dsqx| dd} | d} |tus|tvr|j} nt|s|dur|j} n|j} d| dd } | r| d7} t | tsJ|jdur| D]}|r|d| || d qqx|D] } |d| | qqxt|S) Nr,cSst|p|duSr1)rr=r,r,r-r?sz)Parameter.get_negatives..)keyr$z--.)r[rDrrr sorted get_negativesappendr4r _NEGATIVE_FLAG_TYPESr% isinstancerAsplitboolITERATIVE_BOOL_IMPLICIT_VALUErPrrRrQjoin)r`type_ union_args sorted_argsoutr>negoriginuser_negativesrDrAname_componentsnegative_prefixes name_prefixnegative_prefixr,r,r-rf sh        zParameter.get_negativescs0dfddjD}tjd|dS)zOnly shows non-default values.z, cs0g|]}|jjvr|jdt|jqS)=)r'r8getattrrA.0ar_r,r- Ms  z&Parameter.__repr__..())rm__attrs_attrs__type__name__)r`contentr,r_r-__repr__Js  zParameter.__repr__ parametersParameter | NonecGsdi}dd|D}t|dkr|dS|stS|D]}|jD] }t|t|||<qq|di|S)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. cSsg|]}|dur|qSr1r,r|r>r,r,r-r~`sz%Parameter.combine..rNr,)lenEMPTY_PARAMETERr8rz_parameter_alias_to_name)clsrkwargsfiltered parameterr'r,r,r-combineUs   zParameter.combinecCs|didd|jDS)zCreate a Parameter with all Cyclopts-default values. This is different than just :class:`Parameter` because the default values will be recorded and override all upstream parameter values. cSi|] }|jr|j|jqSr,)r]r'r/r{r,r,r- vsz%Parameter.default..Nr,)r)rr,r,r-r/nszParameter.defaultrndefault_parameterscGsJ|tjjur|r||j|fS|tfSt|\}}||jg||RfS)z1Resolve the immediate Parameter from a type hint.)inspectr9emptyrrget_parameters)rrnrrr,r,r-from_annotationys  zParameter.from_annotationobjcCsBt|ds t|d|_n |jj|krt|j|_|jj||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)hasattrCycloptsConfigrrrrrg)r`rr,r,r-__call__s   zParameter.__call__)rrr0r9)?r __module__ __qualname____doc__rrAr5r__annotations__r3rrrrrrCr'r rDr"rFrattrs convertersdefault_if_nonerGrkrIrJrKrLrMrNcyclopts_env_varrOr7r.rPrQrRrSrTrVrWrXrYrZr[r4r8propertyrHrUrfr classmethodrrr/rr#rr,r,r,r-r9Ps  "2"       =   r9cCrr,)r]r'rA)r|pr,r,r-rs rfc Cs<|jpddr dSt|D]}t|j}|s!t|jdds!qt|j\}}|j s6|j |j ur6t dd|j vr|j|jur|j}t|}t|}tdd|D}|r|jra|jd nd}|rkd |d nd} t d | d |d|d|jjd|jjd|d|jjd|d|d|d|jjdqdS)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.*css|]}|j VqdSr1)rS)r| field_infor,r,r- sz#validate_command..r"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 annotationrzr9rrGkind KEYWORD_ONLYr&rAr/rrrallnamesr) rrfield_info_is_annotated_cparam annotatedclass_field_infosall_fields_optional param_namequoted_param_namer,r,r-validate_commandsR   rhintr0cCsdg}t|}t|dd}r||jt|r.t|}|d}|dd|ddD||fS)aAt root level, checks for cyclopts.Parameter annotations. Includes checking the ``__cyclopts__`` attribute. Returns ------- hint Annotation hint with :obj:`Annotated` and :obj:`Optional` resolved. list[Parameter] List of parameters discovered. rNrcss|] }t|tr|VqdSr1)rir9rr,r,r-rsz!get_parameters..r)rrzextendrrr )rrcyclopts_configinnerr,r,r-rs  rc@s6eZdZUdZdZeed<eeddZ ee ed<dS)rz^ Intended for storing additional data to a ``__cyclopts__`` attribute via decoration. NrF)r\r]r) rrrrrrrrlistrr9r,r,r,r-rs  r)Bcollections.abc collectionsrsysrrrcopyrtypingrrrr r r r rr r version_infortyping_extensionscyclopts._env_varrcyclopts._convertrcyclopts.annotationsrrrrrrrcyclopts.field_inforrcyclopts.grouprcyclopts.tokenrcyclopts.utilsrrr r!r" frozensetrkabcrr4rlr#rhr.r5r7r9rrrrrrr,r,r,r-sZ $    $       H0