9tjZdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZddlmZddlmZmZmZmZmZmZmZmZddlmZmZdd lmZmZmZm Z m!Z!dd l"m#Z#d d l$m%Z%m&Z&d d l'm(Z(d dlm)Z)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8m9Z9ddl:m;Z;mZ>m?Z?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGmHZHmIZImJZJddlKmLZLmMZMer!d dlNmOZPd dlNmQZQmRZRd dlNmSZTd dlUmVZVddl2mWZWneXZPeXZTeXjYZZGd d!e[Z\d"d#d[d(Z]ed)Z^ed*ePeTe]f+Gd,d-e Z_d\d2Z`d]d8Zad^d?Zbd_dBZcd`dCZddadHZed*d*dd"dIdbdPZfdcdQZgGdRdSZhGdTdUZidddXZjdddYZke dedZZldS)fz"Private logic for creating models.) annotationsN)ABCMeta)cachepartialwraps) FunctionType) TYPE_CHECKINGAnyCallableGenericLiteralNoReturnTypeVarcast)PydanticUndefinedSchemaSerializer) TypeAliasTypedataclass_transform deprecatedget_args get_origin)typing_objects)PydanticUndefinedAnnotationPydanticUserError)create_schema_validator)GenericBeforeBaseModelWarningPydanticDeprecatedSince20) ConfigWrapper)DecoratorInfosPydanticDescriptorProxyget_attribute_from_basesunwrap_wrapped_function)collect_model_fieldsis_valid_field_nameis_valid_privateattr_namerebuild_model_fields)GenerateSchemaInvalidSchemaError)PydanticGenericMetadataget_model_typevars_map)import_cached_base_modelimport_cached_field_info)set_model_mocks) NsResolver)generate_pydantic_signature)_make_forward_refeval_type_backportis_classvar_annotationparent_frame_namespace)LazyClassAttributeSafeGetItemProxy)Field) FieldInfoModelPrivateAttr) PrivateAttr) BaseModel)PydanticExtraInfoc$eZdZdZd fd ZxZS) _ModelNamespaceDictz{A dictionary subclass that intercepts attribute setting on model classes and warns about overriding of decorators. kstrvobjectreturnNonec||d}|r@||ur.wrapped_model_post_inits. 0g>>>00w?????rVmodel_post_init__class_vars____private_attributes__type[BaseModel]zClasses should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) for pydantic generics to work properly.rrH__pydantic_base_init__FT)replace_wrapped_methodsrm parametersra__parameters__c3 K|]}|vV dSNra).0xrs rU z)ModelMetaclass.__new__..s(?k?kTUZ?k?k?k?k?k?krV)RootModelRootTypec3$K|] }|v|V dSrra)rrparent_parameterss rUrz)ModelMetaclass.__new__..s..c.cQQbHbHbqHbHbHbHb.c.crVz, cg|] }|j SrarWrrs rU z*ModelMetaclass.__new__..s3[3[3[1AJ3[3[3[rVzS is a subclass of `RootModel`, but does not include the generic type identifier(s) zL in its parameters. You should parametrize RootModel directly, e.g., `class z (RootModel[z ]): ...`.c,g|]}t|Sra)rArs rUrz*ModelMetaclass.__new__..s3X3X3XqCFF3X3X3XrVztyping.Generic[]zJAll parameters must be present on typing.Generic; you should inherit from .cg|] }|j Srarrs rUrz*ModelMetaclass.__new__..s2M2M2M!1:2M2M2MrVz- Note: `typing.Generic` must go last: `class (z): ...`))originargsr__pydantic_parent_namespace__)parent_namespace)config_wrapper ns_resolverc$i|] \}}||jSrainforr@rBs rU z*ModelMetaclass.__new__..s-000"a16000rV) raise_errorscreate_model_module__hash__)__pydantic_fields_set____pydantic_extra____pydantic_private__rRr<r~r rDrE)Bsys version_info annotationlibryrzr{ FORWARDREFrJ_collect_bases_datar for_model config_dictinspect_namespace ignored_typesget_model_post_initrrrrP__new__r-__mro__r indexrLrMrgetattr__init____pydantic_custom_init__r__pydantic_post_init____pydantic_setattr_handlers__r!build__pydantic_decorators__update_from_configrmall root_modelrtuplejoinrW TypeError__pydantic_complete__items __set_name__build_lenient_weakvaluedictr5rrKdictunpack_lenient_weakvaluedictr0set_model_fieldscomputed_fields__pydantic_computed_fields__ defer_buildr/complete_model_classfrozenset_default_hash_func__pydantic_init_subclass__popclear)&mcsrhrirkrmrorqrsraw_annotationsryrzr{annotatebase_field_names class_varsbase_private_attributesrprivate_attributesrcls BaseModel_mrormissing_parametersparameters_str error_messagecombined_parametersgeneric_type_label bases_strnameobjrr instance_slotrrrrTs& @@@rUrzModelMetaclass.__new__Ts6 i N7**%22&/0A&BOOpooooooooo#D#DY#O#OOx-*@*@RXRc*d*d*d*,"+--0A2"F"FDGD[D[\aDbDb A j*A*4UIX^__N(6(BIn %!2?N,H*Vf"" " K%< K+>y%+P+P(+7344@@@@@54@4KI/003JI/0*4I& '2c5L2cPb2cI. /(/%''/#xPY*d*d]c*d*deeC133J+C#~~#))G"4"4syy7L7L"L"L 1B ! 07s|E]_d/e/e+eC (+z/IIIO`  &13C -*8*>s\`*a*a*aC '  ' : :> J J J-. 4Q11$+C1PRT$U$U$Y$YZfhj$k$k!$S*:DAAVEV #3"3#3C?k?k?k?kYj?k?k?k>>>>>)..c.c.c.c*.c.c.c)c)c&(,===BS[eBeBe*.3[3[HZ3[3[3[)\)\"|JJ-JJWZWcJJp~JJJ& /@BT.T+)-3X3XDW3X3X3X)Y)Y-P~-P-P-P*N8JNNN&#%// )- 2M2Mu2M2M2MQcPd2d(e(eI) rPSP\ r r_h r r rM$M222#",551 ).C %05577 , , c  d++++2 j4OPfPhPh4i4i16=cCbdh6i6i *D11 R#?@P#Q#Q $6FGGGK S[ Y Y Y Y00&)&A&Q&W&W&Y&Y000C ,) $$$$%"!&(< $ 29)D)D%c5111 7E#sOO 6 @ @ @ @ @J"i    ! MM+R 0 0 6 6 8 8 8"577?3%MMfMM MrVitemcp|jd}|r ||vr||St|)zNThis is necessary to keep attribute access working for class attribute access.r)__dict__rJAttributeError)rRrrs rU __getattr__zModelMetaclass.__getattr__sE!%!2!23K!L!L ! 0d.@&@&@)$// && &rVrdict[str, object]ctSr)r?)rrrss rU __prepare__zModelMetaclass.__prepare__$s"$$$rVsubclasstype[_T]ctjd|jddt|S)Nz>For performance reasons, virtual subclasses registered using 'zK.register()' are not supported in 'isinstance()' and 'issubclass()' checks.rrH)rLrMrYrPregister)rRrrTs rUrzModelMetaclass.register,sV  MTM^ M M M    ww)))rV6tuple[set[str], set[str], dict[str, ModelPrivateAttr]]cjt}t}t}i}|D]}t||rn||urj|t |di||j||j|||fS)N__pydantic_fields__)r-set issubclassupdaterkeysrr)rir< field_namesrrbases rUrz"ModelMetaclass._collect_bases_data7s,.. # "uu :< G GD$ ** Gt9/D/D""741F#K#K#P#P#R#RSSS!!$"5666"))$*EFFFJ(:::rVXThe `__fields__` attribute is deprecated, use the `model_fields` class property instead.)categorydict[str, FieldInfo]c\tjdtdt|diS)NrrrHr)rLrMrrrRs rU __fields__zModelMetaclass.__fields__Fs;  f %    t2B777rVcd|jvrdStd|j}td|j}||j}nd}t d|Do|S)zWhether the fields were successfully collected (i.e. type hints were successfully resolved). This is a private attribute, not meant to be used outside Pydantic. rFrzPydanticExtraInfo | NoneNTc3$K|] }|jV dSr) _complete)r field_infos rUrz>ModelMetaclass.__pydantic_fields_complete__..cs%OOJ:'OOOOOOrV)rrr__pydantic_extra_info__completervalues)rR field_infospydantic_extra_infoextra_completes rU__pydantic_fields_complete__z+ModelMetaclass.__pydantic_fields_complete__Rs ! 5 55143KLL "#=t?[\\  *09NN!NOO+:L:L:N:NOOOOObTbbrV list[str]ctt}d|vr|d|S)Nr)listrP__dir__remove)rR attributesrTs rUrzModelMetaclass.__dir__esC%''//++,, : % %   l + + +rV)NTN)rhrArirjrkrlrmrnrorprqrrrsr rDrt)rrArDr )rr rsr rDr)rrrDr)rirjrDr)rDr)rDrp)rDr)rWrXrYrr r classmethodrrrt__instancecheck____subclasscheck__ staticmethodrpropertyrrrrr[r\s@rUrgrgRsrIM48+/DNDNDNDNDNDNDNL ' ' ' ' '%%%[%******.. ; ; ;\ ;Zbmq888X8cccXc$rVrgrRr<r~rEc(t|ddi}|jD]Q\}}|jr!|di|j|}n|d}|t ur|||<Rt|d|dSdS)a This function is meant to behave like a BaseModel method to initialize private attributes. It takes context as an argument since that's what pydantic-core passes when calling it. Args: self: The BaseModel instance. context: The context. rNT)call_default_factoryvalidated_data)r)rrr$default_factory_takes_validated_data get_defaultrrobject_setattr)rRr~pydantic_privater private_attrdefaults rUrrlst+T22:"&"="C"C"E"E 1 1 D,@ N&22)->c>cRb>c3'222MM///)0 &t35EFFFFF;:rVrkrlrirjCallable[..., Any] | Nonecpd|vr|dSt}t|d}||jur|SdS)zaGet the `model_post_init` method from the namespace or the class bases, or `None` if not defined.rN)r-r#r)rkrir<rs rUrrsPI%%*++(**I.u6GHHOi77787rVrrbase_class_varsset[str]base_class_fieldsdict[str, ModelPrivateAttr]c nddlmm}t}|t z}i}d|vsd|vrt dt } t|D]\} } | dks| dkrt| tr9| j |dkr(d|vr$| j |dd rat| |s| jj d kr| | t| rZ| d rt!d | d t#| rt!d d| zd| d | || <|| =t| |rFields must not use names with leading underscores; e.g., use )r$zField z defined on a base class was overridden by a non-annotated attribute. All field definitions, including overrides, require a type annotation.zmodel-field-overridden)codez requires a type annotationzmodel-field-missing-annotationz)A non-annotated attribute was detected: `z = z3`. All model fields require a type annotation; if `z` is not meant to be a field, you may be able to resolve this error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.NFT) is_argumentis_class)globalnslocalnsc3<K|]}t||VdSr)rK)rrBr:s rUrz$inspect_namespace..s3$\$\1JqJZ<[<[$\Q$\$\$\$\$\$\rV)$fieldsr:r;r.default_ignored_typesrrrrrKrtrXrY startswithrTadd NameErrorr&lstripr'r4rrrrAr _getframer3r2 f_globalsf_localsr is_annotatedrrnext)rkrrr'r)r;r9all_ignored_typesr ignored_namesvar_namevaluesuggested_nameann_nameann_typeframer/metadatar#r:s @rUrrsb876666666(**I%(=(?(??68_$$ i(?(?oppp!eeM  1 122;;% ~ % %5I)I)I  ud # #8  Il$;;;)++"-->1J.M.M.MNN,  0 1 10 U_5OS^5^5^   h ' ' '  / 0 0- ""4(( PBJPPP%X.. [/2X~[[MU[[[,1 x ((## y ) ) 2Eh2O2O %__S11?ZNJ,JJz make_hash_func..'slmrVrRr rDintc t|jS#t$r-tt|jcYSwxYwr)hashrKeyErrorr7)rRgetters rU hash_funcz!make_hash_func..hash_func)sm At}--.. . A A A / >>??@@ @ @ @  As 4AA)rRr rDrS)roperator itemgetterr)rrXrWs @rUrMrM&s\EHE\ mX #"9">">"@"@ A AbmbmFAAAAAA rVrr rr0c.t|}t||||\}}}||_||_|j||D]C}|j|d}|$|jturt|||jDdS)zCollect and set `cls.__pydantic_fields__` and `cls.__class_vars__`. Args: cls: BaseModel or dataclass. config_wrapper: The config wrapper instance. ns_resolver: Namespace resolver to use when getting model annotations. ) typevars_mapN) r,r%rr rrrrr$rsetattr) rrrr\r7rrr@rEs rUrr6s*#..L.B ^[|///+F %C"5Cj)))  + +*..q$77  6G!G!G CEM * * * + +rV)rcall_on_complete_hookris_force_rebuildrrpr^rrrr_c `t|}|js t||||\|_|_nI#t $r<}t j|} t|d| j d|r| |Yd}~nd}~wwxYw|s |jsdS|jsJt|||} | |} n4#t $r'}|rt|d|j dYd}~dSd}~wwxYw| |j } | | } n #t$rt|YdSwxYwd|jjD|_t)|| |_t-| ||p|j|j|rdnd| |j| |_t7| | | |_t;d t=t>|j |j|j!|j" |_#d |_$|r|%d S) aFinish building a model class. This logic must be called after class has been created since validation functions must be bound and `get_type_hints` requires a class object. Args: cls: BaseModel or dataclass. config_wrapper: The config wrapper instance. ns_resolver: The namespace resolver instance to use during schema building. raise_errors: Whether to raise errors. call_on_complete_hook: Whether to call the `__pydantic_on_complete__` hook. create_model_module: The module of the class to be created, if created by `create_model`. is_force_rebuild: Whether the model is being force-rebuilt (if True, pre-built serializers and validators are not used, to avoid stale references). Returns: `True` if the model is successfully completed, else `False`. Raises: PydanticUndefinedAnnotation: If PydanticUndefinedAnnotation occurs in __get_pydantic_core_schema__ and `raise_errors=True`. )rrr\rGNF)titlec$i|] \}}||jSrarrs rUrz(complete_model_class..s 'r'r'rda16'r'r'rrV create_modelr<) _use_prebuilt __signature__)r^r7validate_by_nameextraT)&r,rr(rr r;rfrom_name_errorr/rr)generate_schema core_configrW clean_schemar*rrrrset_deprecated_descriptors__pydantic_core_schema__rrXrYplugin_settings__pydantic_validator__r__pydantic_serializer__r6rr1rrfrgrer__pydantic_on_complete__) rrrrr^rr_r\eexc gen_schemaschemarjs rUrrXs@*#..L  +0 !CW-') DDD @C #S%@%@  ! ! !-=a@@C CSX 1 1 1 !q  ! ! ! ! ! !  C$D 5////J ++C00 &   ]]]]+++uuuuu  !,,3<,@@K((00 uu (s'rc>Y>i>o>o>q>q'r'r'rC$s####)C !8 -s~ ->;&** " " "C#36;ZjVj"k"k"kC + '*+< &      C!%C' $$&&& 4s? 9 A?2A::A?(B>> C/C**C/D$$EEc|jD]D\}}|jx}6t|}|||t |||E|jD]l\}}|jx}^tt|j ds-c22D   c5 ) ) ) C % % %&)&F&L&L&N&N&&""'; ;S H34G4XYY[kll I.c3F3WXXD   c5 ) ) ) C % % %&&rVcBeZdZUdZded<ddd ZddZdddZddZdS)ryaWRead-only data descriptor used to emit a runtime deprecation warning before accessing a deprecated field. Attributes: msg: The deprecation message to be emitted. wrapped_property: The property instance if the deprecated field is a computed field, or `None`. field_name: The name of the field being deprecated. rA field_nameNr}r{property | NonerDrEc"||_||_dSr)r}r{)rRr}r{s rUrz#_DeprecatedFieldDescriptor.__init__s 0rVrrrc||_dSr)r)rRrrs rUrz'_DeprecatedFieldDescriptor.__set_name__s rVrBaseModel | Noneobj_typetype[BaseModel] | Noner c|6|j|jd|St|jt j|jtd|j|j||S|j|jS)NrrH) r{__get__rrrLrMr}DeprecationWarningr)rRrrs rUrz"_DeprecatedFieldDescriptor.__get__s ;$0,44T8DDD 11 1 dh 2qAAAA  ,(00h?? ?|DO,,rVrErc*t|jr)rr)rRrrEs rU__set__z"_DeprecatedFieldDescriptor.__set__sT_---rVr)r}rAr{rrDrE)rrrrArDrE)rrrrrDr )rr rEr rDr) rWrXrYrZrxrrrrrarVrUryrysOOO11111 - - - - -......rVryc*eZdZdZd dZd dZd dZd S) _PydanticWeakRefaWrapper for `weakref.ref` that enables `pickle` serialization. Cloudpickle fails to serialize weakref.ref objects due to an arcane error related to to abstract base classes (`abc.ABC`). This class works around the issue by wrapping `weakref.ref` instead of subclassing it. See https://github.com/pydantic/pydantic/issues/6763 for context. Semantics: - If not pickled, behaves the same as a `weakref.ref`. - If pickled along with the referenced object, the same `weakref.ref` behavior will be maintained between them after unpickling. - If pickled without the referenced object, after unpickling the underlying reference will be cleared (`__call__` will always return `None`). rr cN| d|_dStj||_dSr)_wrweakrefref)rRrs rUrz_PydanticWeakRef.__init__s) ;DHHH{3''DHHHrVrDc<|jdS|Sr)rrs rU__call__z_PydanticWeakRef.__call__%s 8 488:: rV4tuple[Callable, tuple[weakref.ReferenceType | None]]c&t|ffSr)rrs rU __reduce__z_PydanticWeakRef.__reduce__+s$$&&**rVN)rr )rDr )rDr)rWrXrYrZrrrrarVrUrr sZ (((( ++++++rVrddict[str, Any] | Nonec|dSi}|D]-\}} t|}n#t$r|}YnwxYw|||<.|S)aXTakes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs. We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values in a WeakValueDictionary. The `unpack_lenient_weakvaluedict` function can be used to reverse this operation. N)rrr)rresultr@rBproxys rUrr/sv yt F 1 $Q''EE   EEE q Ms1 AAc|dSi}|D]1\}}t|tr|}||||<,|||<2|S)zAInverts the transform performed by `build_lenient_weakvaluedict`.N)rrKr)rrr@rBs rUrrCsiyt F 1 a) * * A}q F1II MrVcddlm}tttt t |tg}tj dkr| tjt|S)Nr)ComputedFieldInfo)rv ) r7rrrrrr"rrrappendtypingr)rrs rUr8r8Ssg****** M 7""V1222   rV)r^r_rDr r)rkrlrirjrDr%) rkrlrrlrrjr'r(r)r(rDr*)rrrirjrDrE)rrrDr )rrrr rr0rDrE)rrrr rr0rrpr^rprrrr_rprDrp)rrrDrE)rrrDr)rDrj)mrZ __future__r _annotationsrYrrrLrabcrr-rrrtypesrr r r r r rrr pydantic_corerrtyping_extensionsrrrrrtyping_inspectionrerrorsrrplugin._schema_validatorrrr_configr _decoratorsr!r"r#r$_fieldsr%r&r'r(_generate_schemar)r* _genericsr+r, _import_utilsr-r. _mock_val_serr/_namespace_utilsr0 _signaturer1 _typing_extrar2r3r4r5_utilsr6r7r7r8PydanticModelFieldr9r:r;PydanticModelPrivateAttrmainr<r=rC __setattr__r!rr?rbrcrgrrrrrMrrrlryrrrr8rarVrUrs;((222222 ++++++++++ZZZZZZZZZZZZZZZZZZZZ========bbbbbbbbbbbbbb,,,,,,CCCCCCCC>>>>>>OOOOOOOO""""""ssssssssssssoooooooooooo@@@@@@@@FFFFFFFFMMMMMMMM******((((((333333 98888888(44444444444444@@@@@@      *******%vxx# ) ) ) ) )$ ) ) )$! WT]]T=OQikv