EjE{dZddlmZddlZddlZddlmZddlm Z ddl m Z m Z ddl mZddlmZmZmZmZmZdd lmZdd lmZdd lmZdd lmZdd lmZddlm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3er ddl4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;mZ>Gdde0Z?ejd8ie,Gd d!ZAd9d"ZBe d:d#ZC d;d$ZDdd'ZF d?d(ZGd@d)ZHhd*ZIhd+ZJdd, dAd-ZK dBd.ZL dCd/ZMddd0 dDd1ZN dEd2ZOdFd3ZPdFd4ZQ dGd5ZRdd%d6 dHd7ZSy)IzmPrivate logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`.) annotationsN)Mapping)cache) Parameterismethoddescriptor)Pattern) TYPE_CHECKINGAnyCallableTypeVarcast)PydanticUndefined)TypeIs)AnnotationSource)PydanticDeprecatedSince211)PydanticUserError)AliasGenerator) _generics _typing_extra) ConfigWrapper)extract_docstrings_from_cls)import_cached_base_modelimport_cached_field_info) slots_true) NsResolver)Representation)can_be_positionalget_first_not_none BaseMetadata) FieldInfo) BaseModel)PydanticDataclassStandardDataclass)DecoratorInfosceZdZdZdZy)PydanticMetadataz0Base class for annotation markers like `Strict`.N)__name__ __module__ __qualname____doc__ __slots__r*X/root/workspace/ytshorts/venv/lib/python3.12/site-packages/pydantic/_internal/_fields.pyr)r)'s :Ir0r)c"eZdZUded<ded<y)PydanticExtraInfor annotationboolcompleteN)r+r,r-__annotations__r*r0r1r3r3-sONr0r3c "t|S)zCreate a new `_PydanticGeneralMetadata` class with the given metadata. Args: **metadata: The metadata to add. Returns: The new `_PydanticGeneralMetadata` class. )_general_metadata_cls)metadatas r1pydantic_general_metadatar;4s # "8 ,,r0c2ddlm}Gddt|}|S)zCDo it this way to avoid importing `annotated_types` at import time.rr!ceZdZdZddZy)7_general_metadata_cls.._PydanticGeneralMetadataz,Pydantic general metadata like `max_digits`.c||_yN)__dict__)selfr:s r1__init__z@_general_metadata_cls.._PydanticGeneralMetadata.__init__Hs $DMr0N)r:r )r+r,r-r.rCr*r0r1_PydanticGeneralMetadatar>Es : %r0rD)annotated_typesr"r))r"rDs r1r9r9@s-%#3\% $#r0c t}|D]\}d}t|tr|j|du}n!t|tr|j |}|sN|D]I}t ||st||r|t|divr,td|dt||d|dg}|D]k} t| tr2| j|r%|jd| jdE|j | rW|jd | d md d j|t|d k(rd nd} tjd|d|d|d| d t d_y)NF__pydantic_fields__Field z conflicts with member z of protected namespace .z re.compile()'(z, rz,)z in z$ conflicts with protected namespace zX. You may be able to solve this by setting the 'protected_namespaces' configuration to  stacklevel)r isinstancermatchstr startswithhasattr issubclassgetattr ValueErrorappendpatternjoinlenwarningswarn UserWarning) protected_namespacesann_namebasescls_namer$protected_namespace ns_violationbvalid_namespacespnvalid_namespaces_strs r1_check_protected_namespacesriNs )*I3  )7 3.44X>dJL +S 1#../BCL  1h'&q)4WQPegiEj9j($XL0GPQS[H\G]67J6MQP /1 .?B!"g.!xx1,33k"**q4QR'2226,33at1I> ?*+4995E+F*GPSTdPeijPjpsGt'u$ XLXL8\]p\stlmAlBBCD 7 r0Fct||}|jD]!\}}|j||vs|||_#y)N use_inspect)ritems description)clsfieldsrl fields_docsr` field_infos r1_update_fields_from_docstringsrsysH-c{KK & ;*  ! ! )h+.E%0%:J ";r0c|j<|||}t|tstd|d|j||_yy)Nzfield_title_generator  must return str, not )titlerPrR TypeError __class__)title_generator field_namerrrvs r1*_apply_field_title_generator_to_field_infor{sV  J7%%4_4EE[\a\k\k[lmn n   r0c|j4|jdks%|j|j |jd\}}}t |t r|j |\}}}n>t|r3||}t |tstd|d|j|j|jdkrd|_|jdk(r)t|||_t|||_||_|j||_|jt|||_|jt|||_yyy)avApply an alias generator to aliases on a `FieldInfo` instance if appropriate. Args: alias_generator: A callable that takes a string and returns a string, or an `AliasGenerator` instance. field_name: The name of the field from which to generate the alias. field_info: The `FieldInfo` instance to which the alias generator is (maybe) applied. Nr)NNNzalias_generator ru) alias_priorityaliasvalidation_aliasserialization_aliasrPrgenerate_aliasescallablerRrwrxr )alias_generatorrzrrr~rrs r1$_apply_alias_generator_to_field_inforsh !!)  $ $ )    #  & & .  ) ) 17G4!4 o~ 6;J;[;[\f;g 8E#%8 o &#J/EeS)"2?2CCYZ_ZiZiYj kll  $ $ , 0I0IQ0N()J %  $ $ )-?@SUZ-[J **<=Mu*UJ '$J     #$J   ) ) 1-?@SUZ-[J *  & & .*<=Mu*UJ ' /9 2r0c|jxs |j}| t||||jt|j||yy)apUpdate the `FieldInfo` instance from the configuration set on the model it belongs to. This will apply the title and alias generators from the configuration. Args: config_wrapper: The configuration from the model. field_name: The field name the `FieldInfo` instance is attached to. field_info: The `FieldInfo` instance to update. N)field_title_generatorr{rr)config_wrapperrzrrrs r1update_field_from_configrsS'<<d@d@d(23H*V`a%%1,^-K-KZYcd2r0>copydictjson_iter_calculate_keys_copy_and_set_values> schemafrom_ormvalidate construct parse_obj parse_raw _get_value parse_file schema_jsonupdate_forward_refs) typevars_mapc t}t|j}i}t|D]#}t |ddx}s|j |%t j||} t j|} i} t} | jD]T\} \}}| dk(rt|j| ||jt j|r| j| Zt || t t urDt#fdt$Ds%t'drt#fdt(Drt t+| s|j,r| d k7rt/d | d |D]}t'|| s| | vrt |d ij1d }||ur6t3j4|rt3j6|ndDchc]}|j8}}| |vr~t;j<d| d|j>d|j>dt@dt urd| | vs| |vr4|jC|tDjF}||_$|s"d|_%n|| jM}|rtO|||d}n|}ntQ|rGtSjTr2jTjWd|}|_*|jXd<|j[|tDjF}|_.||_$|sd|_%nWd|j^vrI|jas9t;j<d| d| d| dtbd| j|  te|| |jhd }| |jjvrtmd!| d"|jd#|| | <|jJsHto|| |W|jpr ts|| d}d$| vr| d$\}}tu||%}| || fScc}w#tf$rYwxYw)&aCollect the fields and class variables names of a nascent Pydantic model. The fields collection process is *lenient*, meaning it won't error if string annotations fail to evaluate. If this happens, the original annotation (and assigned value, if any) is stored on the created `FieldInfo` instance. The `rebuild_model_fields()` should be called at a later point (e.g. when rebuilding the model), and will make use of these stored attributes. Args: cls: BaseModel or dataclass. config_wrapper: The config wrapper instance. ns_resolver: Namespace resolver to use when getting model annotations. typevars_map: A dictionary mapping type variables to their concrete types. Returns: A three-tuple containing the model fields, the `PydanticExtraInfo` instance if the `__pydantic_extra__` annotation is set, and class variables names. Raises: NameError: - If there is a conflict between a field name and protected namespaces. - If there is a field other than `root` in `RootModel`. - If a field shadows an attribute in the parent model. rGN) ns_resolver model_config)r_r`rarbc3<K|]}t|duywr@)rV.0 depr_name BaseModel_assigned_values r1 z'collect_model_fields..&sq9 It4Fqs__func__c3fK|](}tt|dddju*yw)Nr)rVrrs r1rz'collect_model_fields..*s7!GJ 4@*dSWeWnWnns.1rootzUnexpected field with name z4; only 'root' is allowed as a field of a `RootModel`__pydantic_generic_metadata__originr*z Field name "z" in "z"" shadows an attribute in parent ""rN_sourceFTrrlenientdefaultfinalz Annotation z= is marked as final and has a default value. Pydantic treats zz as a class variable, but it will be considered as a normal field in V3 to be aligned with dataclasses. If you still want zV to be considered as a class variable, annotate it as: `ClassVar[] = .`)categoryrO__pydantic_decorators__rHz of class zf overrides symbol of same name in a parent class. This override with a computed_field is incompatible.__pydantic_extra__r4r6);rr __bases__reversedrVupdaterget_model_type_hintssafe_get_annotationssetrmrir_r+is_classvar_annotationaddrany_deprecated_method_namesrT_deprecated_classmethod_namesis_valid_field_name__pydantic_root_model__ NameErrorget dataclasses is_dataclassrpnamer\r]r-r^from_annotationrCLASS_original_annotation _complete_copy_recreate_field_inforPrr__get___attributes_setfrom_annotated_attribute_original_assignment _qualifiers is_requiredrdelattrAttributeErrorrAcomputed_fieldsrwruse_attribute_docstringsrsr3)rorrr FieldInfo_raparent_fields_lookupbase model_fields type_hintscls_annotationsrp class_varsr`ann_type evaluatedgeneric_originfielddataclass_fieldsrrparent_field_infor decoratorspydantic_extra_infoannr6rrs @@r1collect_model_fieldsrs@*+J)+J MME136"4)>E E< E ' ' 5633C[QJ$88=O#%F5J+5+;+;+=SK''8Y ~ % #!/!D!D\\    / / 9 NN8 $  h0AB !2 2 qXpq q 3%B/N"8,   & &8v+=-h\9mn  DtX&?2").Mr!R!V!VW_!`>)JUIaIabfIg[-?-?-Emo$#(EJJ$ $// "8*F33C3C2DE))*!- + 8 . .?*h>R.R (77JZJ`J`7a 2: / +0J( %9$B$H$H$J!  !5){Q]gk"J"3J.*5:L^McMc:d )0088sC)0&?GG &x    $^Xz JgSKj..&sF348z)"#78 X/  & 22U$\"  s'P. P33 P?>P?ci}|j|5|jjD]8\}}|jr|||<t |||d}t ||||||<:|j V|j js@ttj|j jg|jd}n |j }ddd||fS#1swY|fSxYw)a^Rebuild the (already present) model fields by trying to reevaluate annotations. This function should be called whenever a model with incomplete fields is encountered. Returns: A two-tuple, the first element being the rebuilt fields, the second element being the rebuild `PydanticExtraInfo` instance, if available. Raises: NameError: If one of the annotations failed to evaluate. Note: This function *doesn't* mutate the model fields in place, as it can be called during schema generation, where you don't want to mutate other model's fields. FrNTr) pushrGrmrrr__pydantic_extra_info__r6r3r eval_typer4types_namespace) rorrrrebuilt_fieldsf_namerr new_fieldrebuilt_extra_infos r1rebuild_model_fieldsrs ,,.N   # ="%"9"9"?"?"A 3 FJ##)3v&0Kl\a )K)2v& 3  & & 23;V;V;_;_!2(22//::=H=X=X " "%!5J5J5VI11\iI #  r0)rrc lt}i}|xs t}|j}t|jD]}t j |s|j|5|jD]\}} tj|} || vr!|j\} } tj| j| | \} }tj| rj| js9| j t j"ur| j$t j"urt'| j |r| j j(r+| j jdurt+d|dd|j-| | j t.j0}| j |_n)|j-| | t.j0}| |_|sd|_| |_|||<t9||||j t:ust't=||||st?|||j  ddd|r&|jAD]}|jC||jDrtG||tI|d |S#1swYwxYw) a|Collect the fields of a dataclass. Args: cls: dataclass. config_wrapper: The config wrapper instance. ns_resolver: Namespace resolver to use when getting dataclass annotations. Defaults to an empty instance. typevars_map: A dictionary mapping type variables to their concrete types. Returns: The dataclass fields. FzDataclass field zD has init=False and init_var=True, but these are mutually exclusive.zclashing-init-and-init-var)coderN__is_pydantic_dataclass__rk)%rr__dataclass_fields__r__mro__rrrrmrrrrtyperinitrMISSINGdefault_factoryrPinit_varrrr DATACLASSrrrrrrVsetattrvaluesapply_typevars_maprrsrT)rorrrrrprrr`dataclass_field base_annsglobalnslocalnsrrrrrs r1collect_dataclass_fieldsr s&*+J#%F-K// %;?''-    d #7 ?-=-C-C-E6 ?)/)>>tD 9,$/$?$?!'&3&A&A/BVBVX`bi&j#) 77A(,,'//;3F3FF'77;;N;NNo55zB&..77*22775@"3"28*=A!B%A# !!+!D!D /"9"9CSC]C]"E"J7F6M6MJ3!+!D!D /;K;U;U"E"J7FJ3 +0J(6>J3#-x (:N%%->>:C:6 DC:+=+=>m6 ?7 ?7 ? ;?z]]_ 3E  $ $\ 2  3 ..&  $C)DEE   MS7 ?7 ?s'F2J)J)4J))J3 c(t}i}|j|5|jjD]\}}|jr|||<|j }t j|jg|j} tj| |} |j| |jtj} | j | j n|| _t!||| | ||< ddd|S#1swY|SxYw)aRebuild the (already present) dataclass fields by trying to reevaluate annotations. This function should be called whenever a dataclass with incomplete fields is encountered. Raises: NameError: If one of the annotations failed to evaluate. Note: This function *doesn't* mutate the dataclass fields in place, as it can be called during schema generation, where you don't want to mutate other dataclass's fields. rN)rrrGrmrrnrrrrrrrrrrr) rorrrrrrrrrrrs r1rebuild_dataclass_fieldsr {s$*+J+-N   # 3"%"9"9"?"?"A 3 FJ##)3v& * 6 6 #--33 00 --c<@&??33,66@ BKAVAVAb (=(=hu %(K)2v&' 33, -3, s CDDc&|jd S)N_rSrs r1rrss# ##r0cL|jdxr|jd S)Nr __rrs r1is_valid_privateattr_namers" ??3  =(=$==r0c tj|}t |j j }t|dk(xr/t|dxr|djtjuS#ttf$rYywxYw)zMWhether the provided default factory callable has a validated data parameter.Frr) rsignature_no_evalrWrwlist parametersrr[rrrempty)rsigrs r1takes_validated_data_argumentrs--o> cnn++-.J z?a  q$5jm$D qTUI^I^bkbqbqIqq  "sA99B  B )validated_datacall_default_factorycddlm}|||S|r@t|r!td|}| t d||Std|}|St S)zMResolve the default value using either a static default or a default_factory.r)smart_deepcopy)rzCallable[[dict[str, Any]], Any]zpThe default factory requires the 'validated_data' argument, which was not provided when calling 'get_default()'.zCallable[[], Any])_utilsrrr rWr)rrrrrfacs r1resolve_default_valuer sp'g&& ( I8/JC% G~& &*Or>ss2#1>>+$</-$&"9M+(!9," B+~ $$% - $ $(8(( !( (  (V; !4 ! ! !/V:/VHK/VYb/Vde"h !&26 Q3 Q3!Q3Q3 / Q3 E Q3h,. ,.",. ,. ( ,. ; ,.^)))()  )  )`&**. i i"i# i ( i  iX+ +"+ + ( +  +\$> rH r, r(-1!&  O*     r0