oimdZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z ddlmZddlmZmZmZmZdd 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/m0Z0m1Z1er ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9m:Z:ddl;me d^d%Z?d_d.Z@d`dad6ZAdbd<ZBdcd?ZCdddBZDhdCZEhdDZFddEdedLZGdfdOZHdddPdgdSZIdhdUZJdidWZKdidXZLdjd\ZMdS)kzmPrivate logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`.) annotationsN)Mapping)cache) Parameterismethoddescriptor signature)Pattern) TYPE_CHECKINGAnyCallableTypeVar)PydanticUndefined)TypeIs)AnnotationSource)PydanticDeprecatedSince211)PydanticUserError)AliasGenerator) _generics _typing_extra) ConfigWrapper)extract_docstrings_from_cls)import_cached_base_modelimport_cached_field_info) NsResolver)Representation)can_be_positionalget_first_not_none BaseMetadata) FieldInfo) BaseModel)PydanticDataclassStandardDataclass)DecoratorInfosceZdZdZdZdS)PydanticMetadataz0Base class for annotation markers like `Strict`.N)__name__ __module__ __qualname____doc__ __slots__r)Q/var/www/findabus/venv/lib/python3.11/site-packages/pydantic/_internal/_fields.pyr(r(&s::IIIr/r(metadatar returnr!c 0t|S)zCreate a new `_PydanticGeneralMetadata` class with the given metadata. Args: **metadata: The metadata to add. Returns: The new `_PydanticGeneralMetadata` class. )_general_metadata_cls)r1s r0pydantic_general_metadatar5,s # " "8 , ,,r/type[BaseMetadata]c:ddlm}Gddt|}|S)zCDo it this way to avoid importing `annotated_types` at import time.rr ceZdZdZddZdS)7_general_metadata_cls.._PydanticGeneralMetadataz,Pydantic general metadata like `max_digits`.r1r c||_dSN)__dict__)selfr1s r0__init__z@_general_metadata_cls.._PydanticGeneralMetadata.__init__@s $DMMMr/N)r1r )r*r+r,r-r>r)r/r0_PydanticGeneralMetadatar9=s.:: % % % % % %r/r?)annotated_typesr!r()r!r?s r0r4r48sK-,,,,,%%%%%#3\%%% $#r/protected_namespacestuple[str | Pattern[str], ...]ann_namestrbasestuple[type[Any], ...]cls_nameNonec Rt}|D]}d}t|tr||du}n*t|tr||}|r5|D]\}t ||rJt||r|t|divs'td|dt||d|d]g}|D]y} t| tr4| |s| d| j dK|| s| d | d zd d |t|d krd nd} tjd|d|d|d| d t ddS)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 isinstancer matchrD startswithhasattr issubclassgetattr ValueErrorappendpatternjoinlenwarningswarn UserWarning) rArCrErGr#protected_namespace ns_violationbvalid_namespacespnvalid_namespaces_strs r0_check_protected_namespacesrgFse )**I3   )7 3 3 D.44X>>dJLL +S 1 1 D#../BCCL    1h''&q)44WQPegiEjEj9j9j(PXPPPQS[H\H\PP7JPPP /1 .??B!"g..?!xx11S,334Q"*4Q4Q4QRRR'22266?,33IIII>>>'u4995E+F+F'uPSTdPePeijPjPjps'u'u$ DXDDXDD]pDDmADDD 7  r/Fcls type[Any]fieldsdict[str, FieldInfo] use_inspectboolct||}|D]\}}|j||vr |||_dS)Nrl)ritems description)rhrjrl fields_docsrC field_infos r0_update_fields_from_docstringsrtqs[-c{KKKK & ;;*  ! )h+.E.E%0%:J ";;r/title_generatorCallable[[str, FieldInfo], str] field_namersr"c|jD|||}t|tstd|d|j||_dSdS)Nzfield_title_generator  must return str, not )titlerSrD TypeError __class__)rurwrsrzs r0*_apply_field_title_generator_to_field_infor}xsj  J77%%% om_mm\a\kmmnn n   r/alias_generator%Callable[[str], str] | AliasGeneratorc|j!|jdks|j|j|jd\}}}t |t r||\}}}nIt|r:||}t |tstd|d|j |j |jdkrd|_|jdkr1t|||_t|||_||_|j||_|jt|||_|jt|||_dSdSdS)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 ry) alias_priorityaliasvalidation_aliasserialization_aliasrSrgenerate_aliasescallablerDr{r|r)r~rwrsrrrs r0$_apply_alias_generator_to_field_infors !)  $ ) )   #  & .  ) 17G4!4 o~ 6 6 m;J;[;[\f;g;g 8E#%8%8 o & & m#OJ//EeS)) m k? k kZ_Zi k klll  $ , 0IQ0N0N()J %  $ ) )-?@SUZ-[-[J **<=Mu*U*UJ '$J    #$J   ) 1-?@SUZ-[-[J *  & .*<=Mu*U*UJ ' ' '; 2 18 / .r/config_wrapperrc|jp|j}|t||||jt|j||dSdS)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}r~r)rrwrsrs r0update_field_from_configrs\'<d@d(23H*V`aaa%1,^-KZYcddddd21r/>copydictjson_iter_calculate_keys_copy_and_set_values> schemafrom_ormvalidate construct parse_obj parse_raw _get_value parse_file schema_jsonupdate_forward_refs) typevars_maptype[BaseModel] ns_resolverNsResolver | NonerMapping[TypeVar, Any] | None%tuple[dict[str, FieldInfo], set[str]]c t}t|j}i}t|D]*}t |ddx}r||+t j||} t j|} i} t} | D]_\} \}}| dkrt|j | ||j t j|r| | Wt || t t urYt#fdt$Ds1t'dr(t#fdt(Drt t+| s|jr| d krt/d | d t |d id }|D]}dt3j|rt3j|ndD}t'|| r?||urK| |vrP| | vrUt9jd| d|jd|jdt>dt urW| | vs| |vr3| |tBj"}|sd|_#||_$n"|| %}ntM|r@tOj(r,j()d|}|_(|j*d<|+|tBj"}|_,|sd|_#||_$nZd|j-vrQ|.s=t9jd| d| d| dt^d| |  ta|| n#tb$rYnwxYw|j2d}| |j3vrtid | d!|j d"|| | <|j#rtk|| |a|r3| 6D]}|j#r|7||j8rts|| | | fS)#a*Collect 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 two-tuple containing model fields 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. rJN)r model_config)rArCrErGc3>K|]}t|duVdSr;)rX.0 depr_name BaseModel_assigned_values r0 z'collect_model_fields..s4qq9 It44Fqqqqqqr/__func__c3fK|]+}tt|dddjuV,dS)Nr)rXrrs r0rz'collect_model_fields.."sX!GJ 4@@*dSSWeWnnr/rootzUnexpected field with name z4; only 'root' is allowed as a field of a `RootModel`__pydantic_generic_metadata__originch|] }|j Sr)name)rfields r0 z'collect_model_fields..6s'   $    r/r)z Field name "z" in "z"" shadows an attribute in parent ""rQ_sourceFdefaultfinalz 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[] = .`)categoryrR__pydantic_decorators__rKz of class zf overrides symbol of same name in a parent class. This override with a computed_field is incompatible.):rr __bases__reversedrXupdaterget_model_type_hintssafe_get_annotationssetrprgrAr*is_classvar_annotationaddrany_deprecated_method_namesrV_deprecated_classmethod_namesis_valid_field_name__pydantic_root_model__ NameErrorget dataclasses is_dataclassrjr^r_r,r`from_annotationrCLASS _complete_original_annotation_copyrSrr__get___attributes_setfrom_annotated_attribute_original_assignment _qualifiers is_requiredrdelattrAttributeErrorr<computed_fieldsr{rvaluesapply_typevars_mapuse_attribute_docstringsrt)rhrrr FieldInfo_rEparent_fields_lookupbase model_fields type_hintsrrj class_varsrCann_type evaluatedgeneric_origindataclass_fieldsrsr decoratorsrrrs @@r0collect_model_fieldsrs>*++J)++J ME1366"4)>EE E< 6 ' ' 5 5 53C[QQQJ 4S99K#%F55J+5+;+;+=+=JKJK''8Y ~ % % #!/!D\       / 9 9  NN8 $ $ $  h0ABB !2 2 2 qqqqqXpqqq q q 3  33 3 %B 3/N"8,,    & 8v+=+=nhnnn  !&ErJJNNxXX  D  EPE]^bEcEc)k);D)A)A)Aik    tX&& >))///;.. -8--33C--)---  . . .;&&(:N*N*N (77JZJ`7aa  ?+0J(7?J32(;AACC .*55 D:L^Mc:d:d D )088sCC)0&=N>rMapping[TypeVar, Any]cHt}i}||5|jD]\}}|jr|||<|j}t j|jg|j R} tj | |} |j x} tur"|| tj} n"|| | tj} | j| jn|| _t%||| | ||< dddn #1swxYwY|S)aRebuild the (already present) model fields by trying to reevaluate annotations. This function should be called whenever a model with incomplete fields is encountered. 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. rN)rpushrJrprrqr eval_typertypes_namespacer replace_typesrrrrrrr) rhrrrrrebuilt_fieldsf_namers existing_descannassign new_fields r0rebuild_model_fieldsrs$*++J+-N   #  33"%"9"?"?"A"A 3 3 FJ# 3)3v&& * 6 #-3 0 -c<@@(==FBSSS * : :3HXH^ : _ _II * C CCYiYo C p pIAJAVAb (=(=hu %(KKK)2v&&% 3333333333333333* sC$DDD)rrtype[StandardDataclass]dict[Any, Any] | Nonec t}i}|p t}|j}t|jD]}t j|s||5|D]\}} tj |} || vr|j \} } tj | j | | \} }tj| r\| js'| jt jur| jt jurt'| j|rd| jjr$| jjdurt+d|dd|| | jt.j}| j|_n)|| | t.j}| |_|sd|_| |_|||<t9||||jt:ur5t't=||||rt?|||j dddn #1swxYwY|r,| D]}|!||j"r!tG||tI|d |S) 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__ro)%rr__dataclass_fields__r__mro__rrrrprrr try_eval_typetyperinitrMISSINGdefault_factoryrSinit_varrrr DATACLASSrrrrrrXsetattrrrrrtrV)rhrrrrrjrrrCdataclass_field base_annsglobalnslocalnsrrrsrs r0collect_dataclass_fieldsr sT&*++J#%F-K/ %%;?;?'--     d # #7 ?7 ?-=-C-C-E-E6 ?6 ?)/)>tDD 9,,$/$?!'&3&A/BVX`bi&j&j#) 7AA(,'/;3FFF'7;;NNNo5zBBF&.7!*275@@"3!B8!B!B!B%A### !!+!D!D /"9CSC]"E""J7F6MJ33!+!D!D /;K;U"E""J7FJ3 ?+0J(6>J3#-x (:NNN%->>>:C:66 DD>C:+=>>>m6 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?7 ?r3]]__ 3 3E  $ $\ 2 2 2 2. &  $C)DEEE      Ms)F,H""H& )H& type[PydanticDataclass]ct}i}||5|jD]\}}|jr|||<|j}t j|jg|j R} tj | |} | | |j tj} | j| jn|| _t!||| | ||< dddn #1swxYwY|S)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)rrrJrprrqrrrrrrrrrrr) rhrrrrrrrsrrrs r0rebuild_dataclass_fieldsr8so$*++J+-N   #  33"%"9"?"?"A"A 3 3 FJ# 3)3v&& * 6 #-3 0 -c<@@&??3,6@ BKAVAb (=(=hu %(KKK)2v&&' 3333333333333333, sB7C**C.1C.rc.|d S)N_rUrs r0rrfss## ##r/cX|do|d S)Nr__rrs r0is_valid_privateattr_namerjs( ??3   =(=(=$==r/r3Callable[[], Any] | Callable[[dict[str, Any]], Any]'TypeIs[Callable[[dict[str, Any]], Any]]c" t|}n#ttf$rYdSwxYwt|j}t |dko-t|do|djtj uS)zMWhether the provided default factory callable has a validated data parameter.Frr) rrYr{list parametersrr]rrrempty)rsigrs r0takes_validated_data_argumentrns((  "uu cn++--..J z??a  q$5jm$D$D qTUI^bkbqIqqs '')r1r r2r!)r2r6) rArBrCrDrErFrGrDr2rH)F)rhrirjrkrlrmr2rH)rurvrwrDrsr")r~rrwrDrsr")rrrwrDrsr"r2rH) rhrrrrrrrr2r) rhrrrrrrrr2rk) rhrrrrrrrr2rk) rhr rrrrrrr2rk)rrDr2rm)rrr2r)Nr- __future__r _annotationsrr^collections.abcr functoolsrinspectrrrrer typingr r r r pydantic_corertyping_extensionsrtyping_inspection.introspectionrpydanticrpydantic.errorsraliasesrrr_configr_docs_extractionr _import_utilsrr_namespace_utilsr_reprr_utilsrrr@r!rjr"mainr# _dataclassesr$r% _decoratorsr&r(r5r4rgrtr}rrrrrrr rrrrr)r/r0r4sss222222######<<<<<<<<<<888888888888++++++$$$$$$<<<<<<//////------$$$$$$&&&&&&&&""""""999999MMMMMMMM((((((!!!!!!99999999,,,,,,,""""""      BBBBBBBB++++++~ - - - - $ $ $ $((((V;;;;; ! ! ! !/V/V/V/Vdeeee"hgg ! ! !&26 DDDDDDN****b&**. iiiiiiX++++\$$$$>>>> r r r r r rr/