o im@s dZddlmZddlZddlZddlmZddlm 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/m0Z0m1Z1erddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9m:Z:ddl;me dld&d'Z?dmd0d1Z@dndod9d:ZAdpd@dAZBdqdDdEZCdrdHdIZDhdJZEhdKZFddLdsdSdTZGdtdWdXZHdddYdud\d]ZIdvd_d`ZJdwdbdcZKdwdddeZLdxdidjZMdS)yzmPrivate 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)DecoratorInfosc@seZdZdZdZdS)PydanticMetadataz0Base class for annotation markers like `Strict`.N)__name__ __module__ __qualname____doc__ __slots__r'r'r'T/home/kim/smarthome/.venv/lib/python3.10/site-packages/pydantic/_internal/_fields.pyr&&sr&metadatar returnr cKs 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)r.r'r'r-pydantic_general_metadata,s r1type[BaseMetadata]cCs"ddlm}Gdddt|}|S)zCDo it this way to avoid importing `annotated_types` at import time.rrc@seZdZdZdddZdS)z7_general_metadata_cls.._PydanticGeneralMetadataz,Pydantic general metadata like `max_digits`.r.r cSs ||_dSN)__dict__)selfr.r'r'r-__init__@s z@_general_metadata_cls.._PydanticGeneralMetadata.__init__N)r.r )r(r)r*r+r6r'r'r'r-_PydanticGeneralMetadata=sr7)annotated_typesr r&)r r7r'r'r-r08s r0protected_namespacestuple[str | Pattern[str], ...]ann_namestrbasestuple[type[Any], ...]cls_nameNonec Cs<t}|D]}d}t|tr||du}n t|tr ||}|r|D]%}t||rIt||r8|t|divsIt d|dt||d|dq$g}|D]%} t| tre| |sd| d| j dqN|| ss| d | d qNd d |t |d krd nd} tjd|d|d|d| d tddqdS)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 isinstancermatchr< startswithhasattr issubclassgetattr ValueErrorappendpatternjoinlenwarningswarn UserWarning) r9r;r=r?r"Zprotected_namespaceZ ns_violationbZvalid_namespacesZpnZvalid_namespaces_strr'r'r-_check_protected_namespacesFsH       $rYFcls type[Any]fieldsdict[str, FieldInfo] use_inspectboolcCs>t||d}|D]\}}|jdur||vr|||_q dS)Nr^)ritems description)rZr\r^Z fields_docsr; field_infor'r'r-_update_fields_from_docstringsqs  rdtitle_generatorCallable[[str, FieldInfo], str] field_namercr!cCsB|jdur|||}t|tstd|d|j||_dSdS)Nzfield_title_generator  must return str, not )titlerJr< TypeError __class__)rergrcrir'r'r-*_apply_field_title_generator_to_field_infoxs    rlalias_generator%Callable[[str], str] | AliasGeneratorcCs|jdus|jdks|jdus|jdus|jdurd\}}}t|tr,||\}}}nt|rD||}t|tsDt d|d|j |jdusN|jdkrQd|_|jdkret |||_t |||_||_|jdurm||_|jdurxt |||_|jdurt |||_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 rh) Zalias_priorityaliasvalidation_aliasserialization_aliasrJrZgenerate_aliasescallabler<rjrkr)rmrgrcrorprqr'r'r-$_apply_alias_generator_to_field_infos4               rsconfig_wrapperrcCs@|jp|j}|durt||||jdurt|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_generatorrlrmrs)rtrgrcrur'r'r-update_field_from_configs   rv>dictjsonZ_iterZ_copy_and_set_valuescopyZ_calculate_keys> Z parse_fileZupdate_forward_refsZschemaZfrom_orm _get_valuevalidateZ parse_rawZ schema_jsonZ parse_objZ construct) typevars_maptype[BaseModel] ns_resolverNsResolver | Noner|Mapping[TypeVar, Any] | None%tuple[dict[str, FieldInfo], set[str]]c sTt}t|j}i}t|D]}t|dd}r||qtj||d} t|} i} t } | D]S\} \}}| dkr@q4t |j | ||j dt|rU| | q4t|| ttur~tfddtDs|tdr~tfd dtDr~tt| sq4|jr| d krtd | d t|d id}|D];}ddt|rt|ndD}t|| r||urq| |vrq| | vrqtjd| d|jd|jdtddqtur| | vs| |vr|j |t!j"d}|sd|_#||_$nm|| %}nft&|rt'j(rj()d|}|_(|j*d<|j+|t!j"d}|_,|s.d|_#||_$n#d|j-vrQ|.sQtjd| d| d| dt/dd | | q4zt0|| Wn t1ybYnw|j2d!}| |j3vrzt4d"| d#|j d$|| | <|j#rt5|| |q4|r| 6D] }|j#r|7|q|j8rt9|| | | 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. rAN)r~Z model_config)r9r;r=r?c3s |] }t|duVqdSr3)rO.0Z depr_nameZ BaseModel_Zassigned_valuer'r- sz'collect_model_fields..__func__c3s*|]}tt|dddjuVqdS)Nr)rOrrrr'r-r"s  rootzUnexpected field with name z4; only 'root' is allowed as a field of a `RootModel`Z__pydantic_generic_metadata__origincSsh|]}|jqSr'name)rfieldr'r'r- 6sz'collect_model_fields..r'z Field name "z" in "z"" shadows an attribute in parent ""rH_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[] = .`)categoryrIZ__pydantic_decorators__rBz of class zf overrides symbol of same name in a parent class. This override with a computed_field is incompatible.):rr __bases__reversedrOupdaterZget_model_type_hintssafe_get_annotationssetrarYr9r(is_classvar_annotationaddr any_deprecated_method_namesrM_deprecated_classmethod_namesis_valid_field_nameZ__pydantic_root_model__ NameErrorget dataclasses is_dataclassr\rUrVr*rWfrom_annotationrCLASS _complete_original_annotationZ_copyrJrr__get__Z_attributes_setfrom_annotated_attribute_original_assignmentZ _qualifiersZ is_requiredrdelattrAttributeErrorr4Zcomputed_fieldsrjrvvaluesapply_typevars_mapuse_attribute_docstringsrd)rZrtr~r| FieldInfo_r=Zparent_fields_lookupbaseZ model_fieldsZ type_hintsrr\Z class_varsr;ann_type evaluatedZgeneric_origindataclass_fieldsrcrZ decoratorsrr'rr-collect_model_fieldss                 rrMapping[TypeVar, Any]c Cst}i}||]|jD]N\}}|jr|||<q|j}tj|jg|j R} t | |} |j } t ur@|j| tjd} n |j| | tjd} | jdurQ| jn|| _t||| | ||<qWd|S1sjwY|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)rpushrArarrbr eval_typertypes_namespacer replace_typesrr rrrrrv) rZrtr~r|rrebuilt_fieldsf_namerc existing_descannZassign new_fieldr'r'r-rebuild_model_fieldss0      r)r~r|type[StandardDataclass]dict[Any, Any] | Nonec Cst}i}|p t}|j}t|jD]}t|sq|||D]\}} t |} || vr2q$|j \} } t | j | | \} }t | rGq$| jsW| jtjurW| jtjurWq$t| j|r| jjrr| jjdurqtd|dddq$|j| | jtjd}| j|_n |j| | tjd}| |_|sd|_| |_|||<t||||jturtt||||rt|||jq$Wdn1swYq|r| D]}|!|q|j"rt#||t$|d 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)coderNZ__is_pydantic_dataclass__r`)%rr__dataclass_fields__r__mro__rrrrarrrZ try_eval_typetyperinitrMISSINGdefault_factoryrJZinit_varrrr DATACLASSrrrrvr rOsetattrrrrrdrM)rZrtr~r|rr\rrr;Zdataclass_fieldZ base_annsglobalnslocalnsrrrcrr'r'r-collect_dataclass_fieldssx                9   rtype[PydanticDataclass]c Cst}i}||N|jD]?\}}|jr|||<q|j}tj|jg|j R} t | |} |j | |j tjd} | jdurB| jn|| _t||| | ||<qWd|S1s[wY|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)rrrArarrbrrrrrrrrrrrv) rZrtr~r|rrrrcrrrr'r'r-rebuild_dataclass_fields8s4      rrcCs |d S)N_rLrr'r'r-rfs rcCs|do |d S)Nr__rrr'r'r-is_valid_privateattr_namejsrr3Callable[[], Any] | Callable[[dict[str, Any]], Any]'TypeIs[Callable[[dict[str, Any]], Any]]c Cs\zt|}Wn ttfyYdSwt|j}t|dko-t|do-|djt j uS)zMWhether the provided default factory callable has a validated data parameter.Frr) rrPrjlist parametersrrTrrrempty)rsigrr'r'r-takes_validated_data_argumentns (r)r.r r/r )r/r2) r9r:r;r<r=r>r?r<r/r@)F)rZr[r\r]r^r_r/r@)rerfrgr<rcr!)rmrnrgr<rcr!)rtrrgr<rcr!r/r@) rZr}rtrr~rr|rr/r) rZr}rtrr~rr|rr/r]) rZrrtrr~rr|rr/r]) rZrrtrr~rr|rr/r])rr<r/r_)rrr/r)Nr+ __future__rZ _annotationsrrUcollections.abcr functoolsrinspectrrrrertypingr r r r Z pydantic_corer Ztyping_extensionsrZtyping_inspection.introspectionrZpydanticrZpydantic.errorsraliasesrrr_configrZ_docs_extractionrZ _import_utilsrrZ_namespace_utilsr_reprrZ_utilsrrr8r r\r!mainr"Z _dataclassesr#r$Z _decoratorsr%r&r1r0rYrdrlrsrvrrrrrrrrrr'r'r'r-sd                     +  2 H1 l .