j<UdZddlmZddlZddlZddlZddlZddlm Z m Z m Z ddl m Z mZmZddl mZddlmZddlmZdd lmZdd lmZdd lmZmZmZmZmZm Z m!Z!dd l"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z2m3Z3ddl4m5Z5e#r6ee6e$fee7e$fzZ8de9d<ee6ee7zZ:de9d<ddl;me7e?e@eAe!eeeejBee eCjDeEjDhZFde9d<eGeHeIeJeKe e e hZLde9d<d[dZMd\d"ZNd]d&ZOd^d(ZPd_d*ZQd`d-ZRe(d.ZSdad2ZTdbd6ZUe(d7ZVe7d8dcd>ZWGd?d@e2jXZYe#rdddDZZn GdEdFZZe(dGZ[dedIZ\e]Z^dfdMZ_dgdPZ`ejadQdQRGdSdTZbe(dUdVWZce(dXZdGdYdZe%ecedfZedS)hzBucket 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 ModuleTypeNoneType) TYPE_CHECKINGAnyGeneric TypeAlias TypeGuardTypeVaroverload)MISSINGPydanticUndefined) deprecated)PydanticDeprecatedSince211)_repr _typing_extra)import_cached_base_modelrMappingIntStrAnyAbstractSetIntStr) BaseModelzset[type[Any]]IMMUTABLE_NON_COLLECTIONS_TYPESBUILTIN_COLLECTIONSparamr returnboolc@|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+s IC:\Projects\Muse2API\.venv\Lib\site-packages\pydantic/_internal/_utils.pycan_be_positionalr3Hs :)3Y5TU UUvrc jt|ttttt t fSN) isinstancelisttupleset frozensetrrr5s r2 sequence_liker>[s a$sI}eL M MMr4oclass_or_tuple(type[Any] | tuple[type[Any], ...] | NonecF t||S#t$rYdSwxYwNF)r8 TypeError)r?r@s r2lenient_isinstancerE_s9!^,,, uus   clsc t|tot||S#t$rt|tjrYdSwxYwrC)r8type issubclassrDr# WithArgsTypes)rFr@s r2lenient_issubclassrKfs`#t$$HC)H)HH  c=6 7 7 55 s$'$AATypeGuard[type[BaseModel]]cFt}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$rK)rFr(s r2is_model_classrNos))**I c9 - - F#Y2FFr4 identifierstrcT|otj| 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)rOs r2is_valid_identifierrUxs)  " " $ $ JW->z-J-J)JJr4KeyTypemappingdict[KeyType, Any]updating_mappingsc|}|D]o}|D]X\}}||vrJt||tr/t|trt |||||<S|||<Yp|Sr7)copyitemsr8dict deep_update)rWrYupdated_mappingupdating_mappingkr5s r2r^r^sllnnO-''$**,, ' 'DAqO## ?13Et(L(L#Q[\]_cQdQd#%01CQ%G%G""%&""  ' r4dict[Any, Any]updateNonec h|d|DdS)Nci|] \}}||| Sr7).0rar5s r2 z#update_not_none..sEEETQq}Aq}}}r4)rcr\)rWrcs r2update_not_nonerjs1 NNEEV\\^^EEEFFFFFr4T) name_factory input_listlist[T] | tuple[T, ...]rlCallable[[T], str]list[T]cg}g}|D]T}||}||vr+||||<||||<U|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)rmrlresult result_namesr5v_names r2 unique_listrws~F L 33a  % %    ' ' ' MM!    12F<%%f-- . . Mr4ceZdZdZdZd#d Zd$d Zd$d Zd%dZd&dZ e d'd(dZ e d)dZ e d*dZe d+dZd,d!Zd"S)- ValueItemszOClass for more convenient calculation of excluded or included fields on values._itemsvaluerr\$AbstractSetIntStr | MappingIntStrAnyr,rdc||}t|ttfr#||t |}||_dSr7) _coerce_itemsr8r9r:_normalize_indexeslenr{)selfr|r\s r2__init__zValueItems.__init__sQ""5)) edE] + + ?++E3u::>>E(- r4itemr-c\||j|S)zWCheck if item is fully excluded. :param item: key or index of a value )is_truer{getrrs r2 is_excludedzValueItems.is_excludeds$ ||DKOOD11222r4c||jvS)z`Check if value is contained in self._items. :param item: key or index of value rzrs r2 is_includedzValueItems.is_includeds t{""r4e int | str+AbstractSetIntStr | MappingIntStrAny | Nonech|j|}||s|ndS)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)r{rr)rrrs r2 for_elementzValueItems.for_elements2{q!!<<--7tt47r4r%v_lengthintdict[int | str, Any]ci}d}|D]\}}t|tsDt|ts/||st d|d|j|dkr||}zt|tst d|dkr||zn|}| || |||<|s|S||r*t|D]}| |d|St|D]F}| |i}||s| ||||<G|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.) r\r8r AbstractSetrrD __class__ _coerce_valuermergerrange setdefault) rr\rnormalized_items all_itemsir5 normalized_inormalized_items r2rzValueItems._normalize_indexess24 KKMM _ _DAqq'** cjK.H.H cDLLYZOO c aq a aTUT_ a abbbI~~ ..q11 a%% A,-q558a<z$ValueItems.merge.. s;;;Q(]]!]]]r4cg|]}|v| Srgrgrhrars r2rz$ValueItems.merge.. s%>`>`>`QVW[_V_V_qV_V_V_r4cg|]}|v| Srgrgrs r2rz$ValueItems.merge..s&L&L&LQatmmqmmmr4)r)rrr9rr)rFrrr merge_keysmergedra merged_items `` r2rzValueItems.merges0$$X..  &&  K ;;t    O ;;x  3$244( 2  M;;;;T;;;>`>`>`>`(>`>`>``JJd&L&L&L&L(&L&L&LLJ') ( (A))DHHQKKaI)VVK&'q  r4ct|trnTt|trt|d}n#t |dd}t d||S)N.rz???z!Unexpected type of exclude value )r8r rr]fromkeysgetattrrD)r\ class_names r2rzValueItems._coerce_itemssm eW % % N  { + + NMM%--EE  U;;JL LLMM M r4c^|||r|S||Sr7)rr)rFr|s r2rzValueItems._coerce_value#s0 =CKK..=L  '''r4r5c|dup|duS)NT.rgr=s r2rzValueItems.is_true)sDy$AH$r4_repr.ReprArgscd|jfgSr7rzrs r2 __repr_args__zValueItems.__repr_args__-st{#$$r4N)r|rr\r}r,rd)rrr,r-)rrr,r)r\r%rrr,r)F)rrrrrr-r,r)r\r}r,r%)r|rr,rr5rr,r-)r,r)__name__ __module__ __qualname____doc__ __slots__rrrrr classmethodr staticmethodrrrrrgr4r2ryrysYYI....3333####8888# # # # J####[#J\((([( %%%\%%%%%%%r4ryname get_valueCallable[[], T]cdSr7rgrrs r2LazyClassAttributer3sr4c:eZdZdZddZedd ZddZdS)rzA descriptor exposing an attribute only accessible on a class (hidden from instances). The attribute is lazily computed and cached during the first access. rrPrCallable[[], Any]r,rdc"||_||_dSr7r)rrrs r2rzLazyClassAttribute.__init__=sDI&DNNNr4rc*|Sr7)rrs r2r|zLazyClassAttribute.valueAs>>## #r4instanceowner type[Any]cR||jSt|jd|jd)Nz attribute of z is class-only)r|AttributeErrorrr)rrrs r2__get__zLazyClassAttribute.__get__Es3z! DI!_!_u~!_!_!_`` `r4N)rrPrrr,rd)r,r)rrrrr,r)rrrrrr r|rrgr4r2rr7sl   ' ' ' '  $ $ $  $ a a a a a ar4rObjobjc|tus |tur|S|j}|tvr|S |s(|tvr|t ur|n|Sn#tttf$rYnwxYwt|S)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. ) rrrr)r*r:r[rD ValueError RuntimeErrorr )robj_types r2smart_deepcopyrNs  g~~ 111 }H222   >> 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_items r2 all_identicalrfsC"-T5I!N!N!N : J & &55 ' 4r4abc||n|S)zTReturn the first argument if it is not `None`, otherwise return the second argument.rg)rrs r2get_first_not_nonerus 111$r4T)frozenslotsc6eZdZUdZded<d dZerd d Zd Sd S)SafeGetItemProxyzWrapper redirecting `__getitem__` to `get` with a sentinel value as default This makes it safe to use in `operator.itemgetter` when some keys may be missing zMapping[str, Any]wrappedkeyrPr,rcB|j|tSr7)rrrrrs r2 __getitem__zSafeGetItemProxy.__getitem__s|Y///r4r-c6|j|Sr7)r __contains__rs r2rzSafeGetItemProxy.__contains__s<,,S11 1r4N)rrPr,r)rrPr,r-)rrrr__annotations__rrrrgr4r2rrzsj 00002 2 2 2 2 2 222r4r_ModelTr()bound_RTcxeZdZdZddZedd Zeed d ddZddZd S)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,rdc||_dSr7)r)rrs r2rz%deprecated_instance_property.__init__s  r4robjtype type[_ModelT]rcdSr7rgrrrs r2rz$deprecated_instance_property.__get__sFIcr4zAccessing 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)categoryrcdSr7rgrs r2rz$deprecated_instance_property.__get__s JMr4_ModelT | Nonec|*tjd|jjdtd|j||S)NzAccessing the zi attribute on the instance is deprecated. Instead, you should access this attribute from the model class.r')r stacklevel)warningswarnrrr rrs r2rz$deprecated_instance_property.__get__sh   MR!3RRR3      4ty  733555r4)rrr,rd)rrdrrr,r)rrrrr,r)rrrrr,r)rrrrrrrrrgr4r2rrsIIIXI Z J MLL X M666666r4r)r+r r,r-r)r?rr@rAr,r-)rFrr@rr,r-)rFrr,rL)rOrPr,r-)rWrXrYrXr,rX)rWrbrcrr,rd)rmrnrlror,rp)rrPrrr,rk)rrr,r)rrrrr,r-)rrrrr,r)fr __future__r _annotations dataclassesrSrweakref collectionsrrrcollections.abcrrr r rr[r functoolsr inspectr itertoolsrtypesrrrrrrrtypingrrrrrrr pydantic_corerrtyping_extensionsrpydanticr r"r# _import_utilsr$rrPr%rr&mainr(floatcomplexr-bytesrHrefNotImplementedrEllipsisr)r9r;r:r<r]r*r3r>rErKrNrUrVr^rjrkrwRepresentationryrrrobjectrrr dataclassrrrrrgr4r2rs 32222277777777777777777777......%%%%%%!!!!!!nnnnnnnnnnnnnnnnnnWWWWWWWWWWWWWWWWWW44444444((((((//////""""""""333333!")#s("3gc3h6G"GGGGG#.s#3k#6F#FFFFF           K  '30     '    VVVV&NNNNGGGGKKKK ')  GGGG GCLL (+,C%C%C%C%C%%C%C%C%LaKKKKKaaaaaaaa(genn* FHH     %%%% d$///22222220/2* '); / / / genn6666677C<#866666r4