o +i(>@sUdZddlmZddlZddlZddlZddlZddlZddl m Z m Z m Z ddl mZmZmZddl mZddlmZddlmZdd lmZdd lmZdd lmZmZmZmZm Z m!Z!dd l"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1m2Z2ddl3m4Z4e#ree5e$fee6e$fBZ7de8d<ee5ee6BZ9de8d<ddl:m;Z;e5ee?e@e2jAeee ejBee!eCjDeEjDhZFde8d<eGeHeIeJeKe e e hZLde8d<dgdd ZMdhd#d$ZNdid(d)ZOdjd+d,ZPdkd.d/ZQdld2d3ZRe&d4ZSdmd8d9ZTdnd=d>ZUe&d?ZVe6d@dodFdGZWGdHdIdIe1jXZYe#r'dpdMdNZZnGdOdNdNZZe&dPZ[dqdRdSZ\e]Z^drdWdXZ_dsd[d\Z`ejad]d^Gd_d`d`Zbe&dadbdcZce&ddZdGdedfdfe%ecedfZedS)tzBucket of reusable internal utilities. This should be reduced as much as possible with functions only used in one place, moved to that place. ) annotationsN) OrderedDict defaultdictdeque)CallableIterableMapping)Set)deepcopy)cached_property) Parameter) zip_longest)BuiltinFunctionTypeCodeType FunctionType GeneratorType LambdaType ModuleType) TYPE_CHECKINGAnyGenericTypeVaroverload)MISSING) TypeAlias TypeGuard deprecated)PydanticDeprecatedSince211)_repr _typing_extra)import_cached_base_modelrMappingIntStrAnyAbstractSetIntStr) BaseModelzset[type[Any]]IMMUTABLE_NON_COLLECTIONS_TYPESBUILTIN_COLLECTIONSparamr returnboolcCs|jtjtjfvS)aZReturn whether the parameter accepts a positional argument. ```python {test="skip" lint="skip"} def func(a, /, b, *, c): pass params = inspect.signature(func).parameters can_be_positional(params['a']) #> True can_be_positional(params['b']) #> True can_be_positional(params['c']) #> False ``` )kindr POSITIONAL_ONLYPOSITIONAL_OR_KEYWORD)r(r.L/var/www/html/venv/lib/python3.10/site-packages/pydantic/_internal/_utils.pycan_be_positionalJsr0vrcCst|ttttttfSN) isinstancelisttupleset frozensetrrr1r.r.r/ sequence_like]sr9oclass_or_tuple(type[Any] | tuple[type[Any], ...] | NonecCs"zt||WStyYdSwNF)r3 TypeError)r:r;r.r.r/lenient_isinstanceas   r?clscCs:z t|to t||WStyt|tjrYdSwr=)r3type issubclassr>r WithArgsTypes)r@r;r.r.r/lenient_issubclasshs  rDTypeGuard[type[BaseModel]]cCst}t||o ||uS)zReturns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking, unlike raw calls to lenient_issubclass. )r!rD)r@r%r.r.r/is_model_classqsrF identifierstrcCs|o t| S)zChecks that a string is a valid identifier and not a Python keyword. :param identifier: The identifier to test. :return: True if the identifier is valid. ) isidentifierkeyword iskeyword)rGr.r.r/is_valid_identifierzsrLKeyTypemappingdict[KeyType, Any]updating_mappingscGsd|}|D])}|D]"\}}||vr*t||tr*t|tr*t|||||<q |||<q q|Sr2)copyitemsr3dict deep_update)rNrPupdated_mappingupdating_mappingkr1r.r.r/rTs  rTdict[Any, Any]updateNonecKs|dd|DdS)NcSsi|] \}}|dur||qSr2r.).0rWr1r.r.r/ sz#update_not_none..)rYrR)rNrYr.r.r/update_not_nonesr]T) name_factory input_listlist[T] | tuple[T, ...]r_Callable[[T], str]list[T]cCsJg}g}|D]}||}||vr||||q||||<q|S)zMake a list unique while maintaining order. We update the list if another one with the same name is set (e.g. model validator overridden in subclass). )appendindex)r`r_result result_namesr1v_namer.r.r/ unique_lists   ric@seZdZdZdZd-d d Zd.d dZd.ddZd/ddZd0ddZ e d1d2d d!Z e d3d"d#Z e d4d$d%Ze d5d'd(Zd6d*d+Zd,S)7 ValueItemszOClass for more convenient calculation of excluded or included fields on values.)_items_typevaluerrR$AbstractSetIntStr | MappingIntStrAnyr)rZcCs2||}t|ttfr||t|}||_dSr2) _coerce_itemsr3r4r5_normalize_indexeslenrk)selfrmrRr.r.r/__init__s  zValueItems.__init__itemr*cCs||j|S)zWCheck if item is fully excluded. :param item: key or index of a value )is_truerkgetrrrtr.r.r/ is_excludedszValueItems.is_excludedcCs ||jvS)z`Check if value is contained in self._items. :param item: key or index of value rkrwr.r.r/ is_includeds zValueItems.is_includede int | str+AbstractSetIntStr | MappingIntStrAny | NonecCs|j|}||s |SdS)z:param e: key or index of element on value :return: raw values for element if self._items is dict and contain needed element N)rkrvru)rrr{rtr.r.r/ for_elements zValueItems.for_elementr"v_lengthintdict[int | str, Any]c Csi}d}|D]F\}}t|ts&t|ts&||s&td|d|j|dkr0||}qt|ts9td|dkrA||n|}| || |||<q|sS|S||rgt |D]}| |dq\|St |D]}| |i}||s| ||||<qk|S)a]:param items: dict or set of indexes which will be normalized :param v_length: length of sequence indexes of which will be >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4) {0: True, 2: True, 3: True} >>> self._normalize_indexes({'__all__': True}, 4) {0: True, 1: True, 2: True, 3: True} Nz,Unexpected type of exclude value for index "z" __all__zExcluding fields from a sequence of sub-models or dicts must be performed index-wise: expected integer keys or keyword "__all__"r.) rRr3r AbstractSetrur> __class__ _coerce_valuermergervrange setdefault) rrrRrnormalized_items all_itemsir1 normalized_inormalized_itemr.r.r/rps4        zValueItems._normalize_indexesFbaseoverride intersectcs||durS|sdurS|r&|r$SS|r;fddDfddD}n tfddD}i}|D]}|j|||d}|durd|||<qL|S)aHMerge a `base` item with an `override` item. Both `base` and `override` are converted to dictionaries if possible. Sets are converted to dictionaries with the sets entries as keys and Ellipsis as values. Each key-value pair existing in `base` is merged with `override`, while the rest of the key-value pairs are updated recursively with this function. Merging takes place based on the "union" of keys if `intersect` is set to `False` (default) and on the intersection of keys if `intersect` is set to `True`. Ncg|]}|vr|qSr.r.r[rW)rr.r/ z$ValueItems.merge..crr.r.rrr.r/rrcsg|]}|vr|qSr.r.rrr.r/rr)r)rrur4rrv)r@rrr merge_keysmergedrW merged_itemr.)rrr/rs$    &zValueItems.mergecCsDt|tr |St|trt|d}|St|dd}td|)N.rz???z!Unexpected type of exclude value )r3rrrSfromkeysgetattrr>)rR class_namer.r.r/ros   zValueItems._coerce_itemscCs |dus ||r |S||Sr2)ruro)r@rmr.r.r/r%s zValueItems._coerce_valuer1cCs|dup|duS)NT.r.r8r.r.r/ru+zValueItems.is_true_repr.ReprArgscCs d|jfgSr2ryrrr.r.r/ __repr_args__/ zValueItems.__repr_args__N)rmrrRrnr)rZ)rtrr)r*)r{r|r)r})rRr"rrr)r)F)rrrrrr*r)r)rRrnr)r")rmrr)rr1rr)r*)r)r)__name__ __module__ __qualname____doc__ __slots__rsrxrzr~rp classmethodr staticmethodrorrurr.r.r.r/rjs"     %%   rjname get_valueCallable[[], T]cCdSr2r.rrr.r.r/LazyClassAttribute5src@s2eZdZdZddd Zedd d ZdddZdS)rzA descriptor exposing an attribute only accessible on a class (hidden from instances). The attribute is lazily computed and cached during the first access. rrHrCallable[[], Any]r)rZcCs||_||_dSr2r)rrrrr.r.r/rs?s zLazyClassAttribute.__init__rcCs|Sr2)rrr.r.r/rmCszLazyClassAttribute.valueinstanceowner type[Any]cCs&|dur|jSt|jd|jd)Nz attribute of z is class-only)rmAttributeErrorrr)rrrrr.r.r/__get__GszLazyClassAttribute.__get__N)rrHrrr)rZ)r)r)rrrrr)rZ)rrrrrsr rmrr.r.r.r/r9s   Objobjc Csv|tur|S|j}|tvr|Sz|s"|tvr'|tur|WS|WSWt |SWt |Stttfy:Yt |Sw)zReturn type as is for immutable built-in types Use obj.copy() for built-in empty collections Use copy.deepcopy() for non-empty collections and unknown objects. ) rrr&r'r5rQr> ValueError RuntimeErrorr )robj_typer.r.r/smart_deepcopyPs  rleft Iterable[Any]rightcCs*t||tdD] \}}||urdSqdS)aCheck that the items of `left` are the same objects as those in `right`. >>> a, b = object(), object() >>> all_identical([a, b, a], [a, b, a]) True >>> all_identical([a, b, [a]], [a, b, [a]]) # new list object, while "equal" is not "identical" False ) fillvalueFT)r _SENTINEL)rr left_item right_itemr.r.r/ all_identicalhs  rabcCs|dur|S|S)zTReturn the first argument if it is not `None`, otherwise return the second argument.Nr.)rrr.r.r/get_first_not_nonewrrT)frozenc@s:eZdZUdZdZded<dd d Zerdd d ZdSdS)SafeGetItemProxyzWrapper redirecting `__getitem__` to `get` with a sentinel value as default This makes is safe to use in `operator.itemgetter` when some keys may be missing )wrappedzMapping[str, Any]rkeyrHr)rcCs|j|tSr2)rrvrrrrr.r.r/ __getitem__szSafeGetItemProxy.__getitem__r*cCs |j|Sr2)r __contains__rr.r.r/rrzSafeGetItemProxy.__contains__N)rrHr)r)rrHr)r*) rrrrr__annotations__rrrr.r.r.r/r|s  r_ModelTr%)bound_RTc@sLeZdZdZdddZedd d Zeedddddd Zddd ZdS)deprecated_instance_propertyaA decorator exposing the decorated class method as a property, with a warning on instance access. This decorator takes a class method defined on the `BaseModel` class and transforms it into an attribute. The attribute can be accessed on both the class and instances of the class. If accessed via an instance, a deprecation warning is emitted stating that instance access will be removed in V3. fgetCallable[[type[_ModelT]], _RT]r)rZcCs ||_dSr2)r)rrrr.r.r/rss z%deprecated_instance_property.__init__robjtype type[_ModelT]rcCrr2r.rrrrr.r.r/rsz$deprecated_instance_property.__get__zAccessing this attribute on the instance is deprecated, and will be removed in Pydantic V3. Instead, you should access this attribute from the model class.N)categoryrcCrr2r.rr.r.r/rs_ModelT | NonecCsL|durtjdkr |jjn|jjj}tjd|dtdd|j||S)N) zAccessing the zi attribute on the instance is deprecated. Instead, you should access this attribute from the model class.r$)r stacklevel) sys version_inforr__func__warningswarnrr)rrrr attr_namer.r.r/rs  )rrr)rZ)rrZrrr)r)rrrrr)r)rrrrr)r)rrrrrsrrrr.r.r.r/rs  r)r(r r)r*r)r:rr;r<r)r*)r@rr;rr)r*)r@rr)rE)rGrHr)r*)rNrOrPrOr)rO)rNrXrYrr)rZ)r`rar_rbr)rc)rrHrrr)r^)rrr)r)rrrrr)r*)rrrrr)r)fr __future__r _annotations dataclassesrJrrweakref collectionsrrrcollections.abcrrrr rrQr functoolsr inspectr itertoolsr typesrrrrrrtypingrrrrr pydantic_corertyping_extensionsrrrpydanticrrr _import_utilsr!rrHr"rr#mainr%floatcomplexr*bytesrANoneTyperefNotImplementedrEllipsisr&r4r6r5r7rSr'r0r9r?rDrFrLrMrTr]r^riRepresentationrjrrrobjectrrr dataclassrrrrr.r.r.r/s