140 lines
17 KiB
Plaintext
140 lines
17 KiB
Plaintext
|
Ë
|
|||
|
|
ðÅÙjJ ã
|
|||
|
|
óF — d Z ddlmZ ddlZddlZddlZddlZddlm Z m
|
|||
|
|
Z
|
|||
|
|
m Z m Z m
|
|||
|
|
Z
|
|||
|
|
mZmZmZ ddlmZ ddlmZmZ ddlmZmZmZmZmZ dd lm Z dd
|
|||
|
|
l m Z dd l m!Z! dd l"m#Z# dd
|
|||
|
|
l$m%Z%m&Z&m'Z' e r ddl(m)Z) ddl*m+Z+ dZ, ed« Z-ej\ dk\ r‰ eej^ e%e'f¬« edddddddddddœ
|
|||
|
|
d%d„« « Z0 eej^ e%e'f¬« edddddddddddœ
|
|||
|
|
d&d„« « Z0n| eej^ e%e'f¬« edddddddddœ d'd„« « Z0 eej^ e%e'f¬« edddddddddœ d(d „« « Z0 eej^ e%e'f¬« d)dddddddddddœ
|
|||
|
|
d*d „« Z0d+d „Z1 e e2« Z3ej\ d k rd,d „Z4e4ejj _6 ddd!dd"œ d-d#„Z7d.d$„Z8y)/z7Provide an enhanced dataclass that performs validation.é )Ú annotationsN)Ú
|
|||
|
|
TYPE_CHECKINGÚAnyÚCallableÚGenericÚLiteralÚNoReturnÚTypeVarÚoverload)Úwarn)Ú TypeGuardÚdataclass_transformé )Ú_configÚ _decoratorsÚ
|
|||
|
|
_mock_val_serÚ_namespace_utilsÚ
|
|||
|
|
_typing_extra)Ú _dataclasses)Úgetattr_migration)Ú
|
|||
|
|
ConfigDict)ÚPydanticUserError)ÚFieldÚ FieldInfoÚ PrivateAttr)ÚPydanticDataclass)ÚMappingNamespace)Ú dataclassÚrebuild_dataclassÚ_T©é é
|
|||
|
|
)Úfield_specifiersFT.©
|
|||
|
|
ÚinitÚreprÚeqÚorderÚ unsafe_hashÚfrozenÚconfigÚvalidate_on_initÚkw_onlyÚslotsc
|
|||
|
|
ó — y ©N© r% s
|
|||
|
|
úXC:\Users\30997\AppData\Local\Temp\pip-target-6g32zz5s\lib\python\pydantic/dataclasses.pyr r s € ð ó c
|
|||
|
|
ó — y r1 r2 ) Ú_clsr& r' r( r) r* r+ r, r- r. r/ s r3 r r 0 s € ð #&r4 ©r& r' r( r) r* r+ r, r- c ó — y r1 r2 r7 s r3 r r C s € ð r4 c ó — y r1 r2 ) r6 r& r' r( r) r* r+ r, r- s r3 r r R s € ð #&r4 c
|
|||
|
|
ó¦ ‡‡‡‡‡‡‡
|
|||
|
|
‡ — |du sJ d« ‚|dusJ d« ‚t j dk\ r| ‰
|
|||
|
|
dœŠ ni Š dˆˆˆˆ ˆˆˆ
|
|||
|
|
ˆfd„ } | €| S | | « S )aÚ !!! abstract "Usage Documentation"
|
|||
|
|
[`dataclasses`](../concepts/dataclasses.md)
|
|||
|
|
|
|||
|
|
A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`,
|
|||
|
|
but with added validation.
|
|||
|
|
|
|||
|
|
This function should be used similarly to `dataclasses.dataclass`.
|
|||
|
|
|
|||
|
|
Args:
|
|||
|
|
_cls: The target `dataclass`.
|
|||
|
|
init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to
|
|||
|
|
`dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its
|
|||
|
|
own `__init__` function.
|
|||
|
|
repr: A boolean indicating whether to include the field in the `__repr__` output.
|
|||
|
|
eq: Determines if a `__eq__` method should be generated for the class.
|
|||
|
|
order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`.
|
|||
|
|
unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`.
|
|||
|
|
frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its
|
|||
|
|
attributes to be modified after it has been initialized. If not set, the value from the provided `config` argument will be used (and will default to `False` otherwise).
|
|||
|
|
config: The Pydantic config to use for the `dataclass`.
|
|||
|
|
validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses
|
|||
|
|
are validated on init.
|
|||
|
|
kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`.
|
|||
|
|
slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of
|
|||
|
|
new attributes after instantiation.
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
A decorator that accepts a class as its argument and returns a Pydantic `dataclass`.
|
|||
|
|
|
|||
|
|
Raises:
|
|||
|
|
AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`.
|
|||
|
|
Fz7pydantic.dataclasses.dataclass only supports init=Falsez-validate_on_init=False is no longer supportedr! )r. r/ c óz •‡‡— ddl m} || « rt d| j › d�d¬« ‚| }t d„ | j
|
|||
|
|
D « « }|s.‰�,t
|
|||
|
|
| d « r t d
|
|||
|
|
| j › d �t d ¬
|
|||
|
|
« ‰�‰n t | d d« }t j |« }t j j | d¬« }|j |« | j }t# j$ | « rNd}| f}t' | t( « rt( | j* } || fz }t- j. | j |« } ‰�/‰Š|j0 r1t d| j ›d�t d ¬
|
|||
|
|
« n|j0 xs dŠt3 j4 | « }
|
|||
|
|
|
|
|||
|
|
D ]@ } t | | d« } t7 | t8 « sŒ!t; | | t# j< | « « ŒB t# j> | « 5 tA jB | fd‰‰‰‰‰dœ‰¤Ž} ddd« |jD rp| jF ŠtI jJ | jF « dˆˆfd„ « }
|
|||
|
|
|
|
|||
|
|
jM d| « | _# ‰r"t
|
|||
|
|
| d« sd d„}d d„}|| _' || _( d| _) || _* || _ t |dd« }|jV | _+ tX jZ dk\ r|�||_. || _. |j^ | _/ ta tb « | _2 d| _3 t# jh | |d¬« | S # 1 sw Y �Œ"xY w) zÃCreate a Pydantic dataclass from a regular dataclass.
|
|||
|
|
|
|||
|
|
Args:
|
|||
|
|
cls: The class to create the Pydantic dataclass from.
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
A Pydantic dataclass.
|
|||
|
|
r )Úis_model_classz(Cannot create a Pydantic dataclass from z" as it is already a Pydantic modelzdataclass-on-model)Úcodec 3 óF K — | ] }t j |« –— Œ y wr1 )Ú dataclassesÚ is_dataclass)Ú.0Úbases r3 Ú <genexpr>z6dataclass.<locals>.create_dataclass.<locals>.<genexpr>® s è ø€ Ð ZÉMÀD¤×!9Ñ!9¸$×!?ÉMùs ‚ !NÚ__pydantic_config__z[`config` is set via both the `dataclass` decorator and `__pydantic_config__` for dataclass zK. The `config` specification from `dataclass` decorator will take priority.é )ÚcategoryÚ
|
|||
|
|
stacklevelT)Úreplace_wrapped_methodszN`frozen` is set via both the `dataclass` decorator and `config` for dataclass zW.This is not recommended. The `frozen` specification on `dataclass` will take priority.F)r& r' r( r) r* r+ c ó< •— ‰r
|
|||
|
|
‰| ||« S t | « }t ||d « }t |t « r|j | |« y t |t
|
|||
|
|
j « r | j j ||« y |j j | ||« y r1 ) ÚtypeÚgetattrÚ
|
|||
|
|
isinstanceÚpropertyÚ__set__Ú functoolsÚcached_propertyÚ__dict__Ú __setitem__Ú__pydantic_validator__Úvalidate_assignment)ÚinstanceÚnameÚvalueÚinst_clsÚattrÚfrozen_Úoriginal_setattrs €€r3 Úvalidated_setattrz>dataclass.<locals>.create_dataclass.<locals>.validated_setattrþ s„ ø€ áÙ+¨H°d¸EÓBÐBÜ ›>�Ü ˜x¨¨tÓ4�ä ˜d¤HÔ-Ø—L‘L ¨5Õ1Ü ¤i×&?Ñ&?Ô@Ø ×%Ñ%×1Ñ1°$¸Õ>à ×3Ñ3×GÑGÈÐRVÐX]Õ^r4 Ú __setstate__c óz — t j | « D �cg c] }t | |j « ‘Œ c}S c c}w r1 )r? ÚfieldsrK rV )ÚselfÚfs r3 Ú_dataclass_getstatez@dataclass.<locals>.create_dataclass.<locals>._dataclass_getstate s2 € Ü;F×;MÑ;MÈdÔ;SÓTÑ;S°aœG D¨!¯&©&Õ 1Ð;SÑTÐTùÒTs ˜ 8c ó” — t t j | « |« D ]& \ }}t j | |j
|
|||
|
|
|« Œ( y r1 )Úzipr? r_ ÚobjectÚ __setattr__rV )r` ÚstateÚfieldrW s r3 Ú_dataclass_setstatez@dataclass.<locals>.create_dataclass.<locals>._dataclass_setstate s9 € Ü(+¬K×,>Ñ,>¸tÓ,DÀeÖ(L™ ˜˜uÜ ×*Ñ*¨4°·±¸UÕCñ )Mr4 Ú__firstlineno__)r" é
|
|||
|
|
)Ú raise_errors)rU r rV ÚstrrW r ÚreturnÚNone)r` r rn ú list[Any])r` r rg rp rn ro )5Ú_internal._utilsr< r Ú__name__ÚanyÚ __bases__Úhasattrr Ú UserWarningrK r Ú
|
|||
|
|
ConfigWrapperr ÚDecoratorInfosÚbuildÚupdate_from_configÚ__doc__Ú_pydantic_dataclassesÚis_stdlib_dataclassÚ
|
|||
|
|
issubclassr Ú__parameters__ÚtypesÚ new_classr+ r Úsafe_get_annotationsrL r ÚsetattrÚas_dataclass_fieldÚpatch_base_fieldsr? r rT rf rO ÚwrapsÚ__get__Ú __getstate__r] Ú__is_pydantic_dataclass__Ú__pydantic_decorators__Ú
|
|||
|
|
__module__ÚsysÚ version_inforj Ú __qualname__Ú classmethodÚ_pydantic_fields_completeÚ __pydantic_fields_complete__Ú__pydantic_complete__Úcomplete_dataclass)Úclsr< Ú original_clsÚhas_dataclass_baseÚ config_dictÚconfig_wrapperÚ
|
|||
|
|
decoratorsÚ original_docÚbasesÚ generic_baseÚcls_annsÚ
|
|||
|
|
field_nameÚ field_valuer\ rb ri Ú firstlinenorZ r[ r, r( r+ Úkwargsr) r' r/ r* s @@€€€€€€€€r3 Úcreate_dataclassz#dataclass.<locals>.create_dataclass™ sE ú€ õ 5á ˜#Ô Ü#Ø:¸3¿<¹<¸.ÐHjÐkØ)ôð
|
|||
|
|
ð
|
|||
|
|
ˆ ô !Ñ ZÈCÏMÊMÓ ZÓ ZÐÙ! fÐ&8¼WÀSÐJ_Ô=`Ü ØmÐnq×nzÑnzÐm{ð |\ð ]ä$Ø õ
|
|||
|
|
ð !'Ð 2‘f¼ÀÐEZÐ\`Ó8aˆ Ü ×.Ñ.¨{Ó;ˆÜ ×/Ñ/×5Ñ5°cÐSWÐ5ÓXˆ
|
|||
|
|
Ø×%Ñ% nÔ5ð
|
|||
|
|
—{‘{ˆ ä × 4Ñ 4°SÔ 9ð ˆLð
|
|||
|
|
�FˆEܘ#œwÔ'Ü & s×'9Ñ'9Ñ :� Ø Ñ/�Ü—/‘/ #§,¡,°Ó6ˆCð Ð Ø ˆGØ ×$Ò$äØdÐeh×eqÑeqÐdtð umð mä (Ø ö ð %×+Ñ+Ò4¨uˆGô !×5Ñ5°cÓ:ˆÛ"ˆJô " # z°4Ó8ˆKܘ+¤yÕ1ܘ˜ZÔ)>×)QÑ)QÐR]Ó)^Õ_ð #ô #×
|
|||
|
|
4Ñ
|
|||
|
|
4°SÕ
|
|||
|
|
9Ü ×'Ñ'Øð
|
|||
|
|
ð ØØØØ 'Ø ñ
|
|||
|
|
ð ñ
|
|||
|
|
ˆC÷ :ð × -Ò -Ø "Ÿ™Ð ä
|
|||
|
|
�_‰_˜SŸ_™_Ó
|
|||
|
|
-õ
|
|||
|
|
_ó .ð
|
|||
|
|
_ð 0× 7Ñ 7¸¸cÓ BˆCŒOáœW S¨.Ô 9óUóDð $7�Ô Ø#6�Ô ð )-ˆÔ%Ø&0ˆÔ#Ø"ˆŒ ä ˜lÐ,=¸tÓDˆ Ø%×0Ñ0ˆŒÜ × Ñ ˜wÒ &¨;Ð+Bð ,7ˆLÔ (Ø"-ˆCÔ Ø'×4Ñ4ˆÔÜ+6Ô7PÓ+QˆÔ(Ø$)ˆÔ!ô ×0Ñ0°°nÐSXÕY؈
|
|||
|
|
÷S :Ñ
|
|||
|
|
9ús Ç2 L0Ì0L:)r” ú type[Any]rn útype[PydanticDataclass])rŒ r� )
|
|||
|
|
r6 r& r' r( r) r* r+ r, r- r. r/ r¢ r¡ s
|
|||
|
|
`````` ` @r3 r r b sn ÿ€ ð^ �5‰=ÐSÐSÓSˆ=Ø 5Ñ (ÐYÐ*YÓYÐ (ä
|
|||
|
|
×ј7Ò"Ø $¨uÑ5‰àˆ÷^ô ^ð@ $˜|Ð ÐGÑ1AÀ$Ó1GÐGr4 c óV — t d„ | j j « D « « S )z®Return whether the fields were successfully collected (i.e. type hints were successfully resolved).
|
|||
|
|
|
|||
|
|
This is a private helper, not meant to be used outside Pydantic.
|
|||
|
|
c 3 ó4 K — | ] }|j –— Œ y wr1 )Ú _complete)rA Ú
|
|||
|
|
field_infos r3 rC z,_pydantic_fields_complete.<locals>.<genexpr>A s è ø€ ÐWÑ6V¨
|
|||
|
|
ˆz×#Õ#Ñ6Vùs ‚)ÚallÚ__pydantic_fields__Úvalues)r” s r3 r� r� < s$ € ô
|
|||
|
|
ÑW°c×6MÑ6M×6TÑ6TÔ6VÓWÓ WÐWr4 )r" é c ó — t d« ‚)a9 This function does nothing but raise an error that is as similar as possible to what you'd get
|
|||
|
|
if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just
|
|||
|
|
to ensure typing._type_check does not error if the type hint evaluates to `InitVar[<parameter>]`.
|
|||
|
|
z 'InitVar' object is not callable)Ú TypeError)Úargsr¡ s r3 Ú
|
|||
|
|
_call_initvarr° J s € ô
|
|||
|
|
Ð:Ó;Ð;r4 rE )Úforcerl Ú_parent_namespace_depthÚ_types_namespacec óª — |s
|
|||
|
|
| j rydD ]B }|| j v sŒt t | |« t j
|
|||
|
|
« rŒ7t
|
|||
|
|
| |« ŒD d| _ |�|}n#|dkD r t j |d¬« xs i }ni }t j |¬« }t j | t j | j d¬« ||d¬ « S )
|
|||
|
|
ax Try to rebuild the pydantic-core schema for the dataclass.
|
|||
|
|
|
|||
|
|
This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
|
|||
|
|
the initial attempt to build the schema, and automatic rebuilding fails.
|
|||
|
|
|
|||
|
|
This is analogous to `BaseModel.model_rebuild`.
|
|||
|
|
|
|||
|
|
Args:
|
|||
|
|
cls: The class to rebuild the pydantic-core schema for.
|
|||
|
|
force: Whether to force the rebuilding of the schema, defaults to `False`.
|
|||
|
|
raise_errors: Whether to raise errors, defaults to `True`.
|
|||
|
|
_parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
|
|||
|
|
_types_namespace: The types namespace, defaults to `None`.
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
Returns `None` if the schema is already "complete" and rebuilding was not required.
|
|||
|
|
If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
|
|||
|
|
N)Ú__pydantic_core_schema__rS Ú__pydantic_serializer__Fr T)Ú parent_depthr± )Úparent_namespace)Úcheck)rl Ú ns_resolverÚ _force_build)r’ rQ rL rK r Ú
|
|||
|
|
MockValSerÚdelattrr Úparent_frame_namespacer Ú
|
|||
|
|
NsResolverr| r“ r rw rD )r” r± rl r² r³ rY Ú
|
|||
|
|
rebuild_nsrº s r3 r r T sÓ € ñ4 �S×.Ò.ØãaˆØ �3—<‘<Ò ¬
|