o ;hp@sddlmZddlZddlZddlZddlZddlmZddlm Z m Z m Z m Z m ZmZmZzddlmZWneyEeddiZYnwzddlmZWney]ed diZYnwddlZdd lmZmZmZd d lmZm Z!d d l"m#Z#m$Z$m%Z&m'Z(m)Z*dZ+ddZ,Gdddej-Z Gddde Z.Gddde Z/Gddde Z0Gddde Z1Gddde Z2Gddde Z3Gdd d e Z4Gd!d"d"e Z5Gd#d$d$e Z6Gd%d&d&e Z7Gd'd(d(e Z8Gd)d*d*e Z9Gd+d,d,e Z:Gd-d.d.e Z;Gd/d0d0e ZGd5d6d6e Z?Gd7d8d8e Z@Gd9d:d:e ZAGd;d<dd?d?e ZCGd@dAdAeCZDGdBdCdCeCZEGdDdEdEeCZFGdFdGdGeCZGGdHdIdIe ZHGdJdKdKe ZIGdLdMdMej-ZJGdNdOdOe ZKGdPdQdQe ZLGdRdSdSe ZMGdTdUdUe ZNdrdZd[ZOdsd^d_ZPd`daZQdbdcZRdddeZSdfdgZTdhdiZUdjdkZVdldmZWdndoZXGdpdqdqZYdS)t) annotationsN)Iterable)AnyFinalLiteralTupleTypeTypeVarUnion) UnionTyper ) TypeAliasTyper ) NODEFAULTUNSET UnsetType)Factory to_builtins)_CONCRETE_TYPES_AnnotatedAliasget_class_annotationsget_dataclass_infoget_typeddict_info)% type_infomulti_type_inforMetadataAnyTypeNoneTypeBoolTypeIntType FloatTypeStrType BytesType ByteArrayTypeMemoryViewType DateTimeTypeTimeTypeDateType TimeDeltaTypeUUIDType DecimalTypeExtTypeRawTypeEnumType LiteralType CustomTyper CollectionTypeListTypeSetType FrozenSetType VarTupleType TupleTypeDictTypeField TypedDictTypeNamedTupleType DataclassType StructTypecCtSN)__all__r r r B/var/www/html/venv/lib/python3.10/site-packages/msgspec/inspect.py__dir__Tsr@c@eZdZdZdS)rzThe base Type.N__name__ __module__ __qualname____doc__r r r r?rXrc@2eZdZUdZded<dZded<dZded<dS)ra_A type wrapping a subtype with additional metadata. Parameters ---------- type: Type The subtype. extra_json_schema: dict, optional A dict of extra fields to set for the subtype when generating a json-schema. extra: dict, optional A dict of extra user-defined metadata attached to the subtype. rtypeNzUnion[dict, None]extra_json_schemaextra)rCrDrErF__annotations__rJrKr r r r?r\s  rc@rA)rz%A type corresponding to `typing.Any`.NrBr r r r?rorGrc@rA)rzA type corresponding to `None`.NrBr r r r?rsrGrc@rA)rzA type corresponding to `bool`.NrBr r r r?rwrGrc@NeZdZUdZdZded<dZded<dZded<dZded<dZ ded<dS) ra6A type corresponding to `int`. Parameters ---------- gt: int, optional If set, an instance of this type must be greater than ``gt``. ge: int, optional If set, an instance of this type must be greater than or equal to ``ge``. lt: int, optional If set, an instance of this type must be less than to ``lt``. le: int, optional If set, an instance of this type must be less than or equal to ``le``. multiple_of: int, optional If set, an instance of this type must be a multiple of ``multiple_of``. NUnion[int, None]gtgeltle multiple_of rCrDrErFrOrLrPrQrRrSr r r r?r{     rc@rM) r aBA type corresponding to `float`. Parameters ---------- gt: float, optional If set, an instance of this type must be greater than ``gt``. ge: float, optional If set, an instance of this type must be greater than or equal to ``ge``. lt: float, optional If set, an instance of this type must be less than to ``lt``. le: float, optional If set, an instance of this type must be less than or equal to ``le``. multiple_of: float, optional If set, an instance of this type must be a multiple of ``multiple_of``. NzUnion[float, None]rOrPrQrRrSrTr r r r?r rUr c@s6eZdZUdZdZded<dZded<dZded<dS)r!aA type corresponding to `str`. Parameters ---------- min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. pattern: str, optional If set, an instance of this type must match against this regex pattern. Note that the pattern is treated as **unanchored**. NrN min_length max_lengthUnion[str, None]pattern)rCrDrErFrVrLrWrYr r r r?r!s   r!c@*eZdZUdZdZded<dZded<dS)r"aSA type corresponding to `bytes`. Parameters ---------- min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrNrVrWrCrDrErFrVrLrWr r r r?r"  r"c@rZ)r#aWA type corresponding to `bytearray`. Parameters ---------- min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrNrVrWr[r r r r?r#r\r#c@rZ)r$aXA type corresponding to `memoryview`. Parameters ---------- min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrNrVrWr[r r r r?r$r\r$c@eZdZUdZdZded<dS)r%a{A type corresponding to `datetime.datetime`. Parameters ---------- tz: bool The timezone-requirements for an instance of this type. ``True`` indicates a timezone-aware value is required, ``False`` indicates a timezone-aware value is required. The default is ``None``, which accepts either timezone-aware or timezone-naive values. NUnion[bool, None]tzrCrDrErFr_rLr r r r?r%  r%c@r])r&awA type corresponding to `datetime.time`. Parameters ---------- tz: bool The timezone-requirements for an instance of this type. ``True`` indicates a timezone-aware value is required, ``False`` indicates a timezone-aware value is required. The default is ``None``, which accepts either timezone-aware or timezone-naive values. Nr^r_r`r r r r?r&rar&c@rA)r'z(A type corresponding to `datetime.date`.NrBr r r r?r'rGr'c@rA)r(z-A type corresponding to `datetime.timedelta`.NrBr r r r?r(rGr(c@rA)r)z$A type corresponding to `uuid.UUID`.NrBr r r r?r)rGr)c@rA)r*z*A type corresponding to `decimal.Decimal`.NrBr r r r?r*rGr*c@rA)r+z.A type corresponding to `msgspec.msgpack.Ext`.NrBr r r r?r+!rGr+c@rA)r,z&A type corresponding to `msgspec.Raw`.NrBr r r r?r,%rGr,c@eZdZUdZded<dS)r-zA type corresponding to an `enum.Enum` type. Parameters ---------- cls: type The corresponding `enum.Enum` type. ztyping_Type[enum.Enum]clsNrCrDrErFrLr r r r?r-)  r-c@rb)r.zA type corresponding to a `typing.Literal` type. Parameters ---------- values: tuple A tuple of possible values for this literal instance. Only `str` or `int` literals are supported. z'Union[Tuple[str, ...], Tuple[int, ...]]valuesNrdr r r r?r.5s  r.c@rb)r/zgA custom type. Parameters ---------- cls: type The corresponding custom type. rIrcNrdr r r r?r/Brer/c@s(eZdZUdZded<ed ddZdS) r zA union type. Parameters ---------- types: Tuple[Type, ...] A tuple of possible types for this union. Tuple[Type, ...]typesreturnboolcCstdd|jDS)zAA helper for checking whether ``None`` is included in this union.css|]}t|tVqdSr=) isinstancer.0tr r r? \z*UnionType.includes_none..)anyrhselfr r r? includes_noneYszUnionType.includes_noneN)rirj)rCrDrErFrLpropertyrtr r r r?r Ns c@rH)r0aA collection type. This is the base type shared by collection types like `ListType`, `SetType`, etc. Parameters ---------- item_type: Type The item type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. rZ item_typeNrNrVrWrCrDrErFrLrVrWr r r r?r0_s  r0c@rA)r1aA type corresponding to a `list`. Parameters ---------- item_type: Type The item type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrBr r r r?r1vrGr1c@rA)r4aA type corresponding to a variadic `tuple`. Parameters ---------- item_type: Type The item type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrBr r r r?r4rGr4c@rA)r2a~A type corresponding to a `set`. Parameters ---------- item_type: Type The item type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrBr r r r?r2rGr2c@rA)r3aA type corresponding to a `frozenset`. Parameters ---------- item_type: Type The item type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. NrBr r r r?r3rGr3c@rb)r5zA type corresponding to `tuple`. Parameters ---------- item_types: Tuple[Type, ...] A tuple of types for each element in the tuple. rgZ item_typesNrdr r r r?r5rer5c@s:eZdZUdZded<ded<dZded<dZded<dS) r6aA type corresponding to `dict`. Parameters ---------- key_type: Type The key type. value_type: Type The value type. min_length: int, optional If set, an instance of this type must have length greater than or equal to ``min_length``. max_length: int, optional If set, an instance of this type must have length less than or equal to ``max_length``. rZkey_typeZ value_typeNrNrVrWrvr r r r?r6s  r6c@sfeZdZUdZded<ded<ded<dZded <ejd d d Zd ed<ejdd d Z d ed<dS)r7amA record describing a field in an object-like type. Parameters ---------- name: str The field name as seen by Python code (e.g. ``field_one``). encode_name: str The name used when encoding/decoding the field. This may differ if the field is renamed (e.g. ``fieldOne``). type: Type The field type. required: bool, optional Whether the field is required. Note that if `required` is False doesn't necessarily mean that `default` or `default_factory` will be set - optional fields may exist with no default value. default: Any, optional A default value for the field. Will be `NODEFAULT` if no default value is set. default_factory: Any, optional A callable that creates a default value for the field. Will be `NODEFAULT` if no ``default_factory`` is set. strname encode_namerrITrjrequiredcCr<r=rr r r r?zField.)default_factoryrdefaultcCr<r=r{r r r r?r|r}r~N) rCrDrErFrLrzmsgspecfieldrr~r r r r?r7s  r7c@"eZdZUdZded<ded<dS)r8zA type corresponding to a `typing.TypedDict` type. Parameters ---------- cls: type The corresponding TypedDict type. fields: Tuple[Field, ...] A tuple of fields in the TypedDict. rIrcTuple[Field, ...]fieldsNrdr r r r?r8  r8c@r)r9zA type corresponding to a `typing.NamedTuple` type. Parameters ---------- cls: type The corresponding NamedTuple type. fields: Tuple[Field, ...] A tuple of fields in the NamedTuple. rIrcrrNrdr r r r?r9rr9c@r)r:zA type corresponding to a `dataclasses` or `attrs` type. Parameters ---------- cls: type The corresponding dataclass type. fields: Tuple[Field, ...] A tuple of fields in the dataclass. rIrcrrNrdr r r r?r:rr:c@sReZdZUdZded<ded<dZded<dZd ed <d Zd ed <d Zd ed<dS)r;aA type corresponding to a `msgspec.Struct` type. Parameters ---------- cls: type The corresponding Struct type. fields: Tuple[Field, ...] A tuple of fields in the Struct. tag_field: str or None, optional If set, the field name used for the tag in a tagged union. tag: str, int, or None, optional If set, the value used for the tag in a tagged union. array_like: bool, optional Whether the struct is encoded as an array rather than an object. forbid_unknown_fields: bool, optional If ``False`` (the default) unknown fields are ignored when decoding. If ``True`` any unknown fields will result in an error. ztyping_Type[msgspec.Struct]rcrrNrX tag_fieldzUnion[str, int, None]tagFrj array_likeforbid_unknown_fields) rCrDrErFrLrrrrr r r r?r;&s    r;rh Iterable[Any]rituple[Type, ...]cCs t|S)aYGet information about multiple msgspec-compatible types. Parameters ---------- types: an iterable of types The types to get info about. Returns ------- tuple[Type, ...] Examples -------- >>> msgspec.inspect.multi_type_info([int, float, list[str]]) # doctest: +NORMALIZE_WHITESPACE (IntType(gt=None, ge=None, lt=None, le=None, multiple_of=None), FloatType(gt=None, ge=None, lt=None, le=None, multiple_of=None), ListType(item_type=StrType(min_length=None, max_length=None, pattern=None), min_length=None, max_length=None)) ) _Translatorrun)rhr r r?rBs rrIrcCst|gdS)aGet information about a msgspec-compatible type. Note that if you need to inspect multiple types it's more efficient to call `multi_type_info` once with a sequence of types than calling `type_info` multiple times. Parameters ---------- type: type The type to get info about. Returns ------- Type Examples -------- >>> msgspec.inspect.type_info(bool) BoolType() >>> msgspec.inspect.type_info(int) IntType(gt=None, ge=None, lt=None, le=None, multiple_of=None) >>> msgspec.inspect.type_info(list[int]) # doctest: +NORMALIZE_WHITESPACE ListType(item_type=IntType(gt=None, ge=None, lt=None, le=None, multiple_of=None), min_length=None, max_length=None) r)r)rIr r r?rYsrcCsg} zt|}Wn tyd}Ynw|durd}n_t|dd}|dur_t|tur;|dd|jD|}n@|tkrE|j d}n6t|t urR|j |j }n)t|dd}t||}nt|dd}|durl|}nt|t urv|j }n|}d}nqt|t ur|j }t }||t|fS)NT __origin__css"|] }t|tjur|VqdSr=)rIrZMeta)rmmr r r?ro z(_origin_args_metadata..r__args__ __supertype__)rget TypeErrorgetattrrIrextend __metadata__rr_TypeAliasType __value___types_UnionTyper tuple)rnmetadataoriginargsZ supertyper r r?_origin_args_metadataysF          #rcCst|ttjuSr=)rIrStructrnr r r? _is_structsrcCst|tjuSr=)rIenumEnumMetarr r r?_is_enumsrcC t|dS)N__dataclass_fields__hasattrrr r r? _is_dataclass rcCr)NZ__attrs_attrs__rrr r r? _is_attrsrrcC,z t|to t|dWStyYdSw)N __total__F) issubclassdictrrrr r r? _is_typeddict  rcCr)N_fieldsF)rrrrrr r r?_is_namedtuplerrcCs|rK|}|D]@\}}||vrF||}t|tr(t|tr(t||||<q t|ttfrAt|ttfrAt|t|||<q |||<q |||<q |Sr=)copyitemsrkr _merge_jsonlistr)abkeyZb_valZa_valr r r?rs  rc@sHeZdZddZddZddZddZ d d d Zd S) rcCst||_i|_i|_dSr=)rrh type_hintscache)rsrhr r r?__init__s  z_Translator.__init__cCs6z|j|WStyt|}|j|<|YSw)z+A cached version of `get_class_annotations`)rKeyError_get_class_annotations)rsrnoutr r r?rs   z"_Translator._get_class_annotationscs2ddlm}|tjtfddjDS)Nr)MsgpackDecoderc3|]}|VqdSr= translaterlrrr r?rorpz"_Translator.run..)_corerrrhr)rsrr rrr?rs z_Translator.runc Cst|\}}}i}i}i}|D]@}dD]} t|| } dur"| || <qdD]} t|| } dur4| || <q%|jdurDt|t|jdd}|jdurO||jq|j||fi|} |s^|rit| |pcd|pfddS| S)N) rPrOrRrQrSrYrVrWr_)title descriptionZexamplesT)Zstr_keys)rJrK) rrrJr _to_builtinsrKupdate_translate_innerr) rstyprnrrZconstrsrJrKmetaattrvalrr r r?rs6     z_Translator.translateNc  sJturtSttrjdurjStSdus$tdur'tStur.t St ur;t |||||dSt urHt |||||dSturSt| | |dStur]t| | dSturgt| | dSturqt| | dStjur{t| dStjurt| dStjurtStjurtStjurt St!j"urt#St$j%urt&St$j'j(urt)St*urt+|rĈ|dnt| | dSt,urt-|rو|dnt| | dSt.urt/|r|dnt| | dSt0ur5|dkrd}|durt1t| | dSt2|dkr(|d d ur(t1|d| | dSt3t0fd d |DSt4urXt5|rE|dnt|rQ|d nt| | dSt6urwt0fdd |D}t2|d krs|dSt7|St8urt9t0t:|St;rt<St=r$|r|n} | j>vrj>| Sj?} t@| d| jA| jB| jC| jDdj>| <}E| t2jFt2jG}g}tHjFjItJf|jGD]A\}}}|tJurdtJ}}nt|tKrdtJ}|jL}n d|tMurtJn|}tJ}tN|||||d}|O|qt0||_P|StQr`|r0|n} | j>vr=j>| StR| dj>| <}tS| \t0fdd t:TD|_P|StUsjtVr|rq|n} | j>vr~j>| StW| dj>| <}tX| \}}}}}tJft2|t2||}g}tH||D];\\}}}}|tJurdtJ}}n|rdtJ}|}n d|tMurtJn|}tJ}|OtN|||||dqt0||_P|StYr!|r|n} | j>vrj>| StZ| dj>| <}E| t0fdd j[D|_P|St\S)N)rPrOrRrQrS)rVrWrY)rVrW)r_r)r r .c3rr=rrmrrrr r?romrpz/_Translator._translate_inner..rc3s"|] }|tur|VqdSr=) _UnsetTyperrrrr r?rovr)rrrrTF)rxryrIrzrr~c3s.|]\}}t||||vdVqdS))rxryrIrzN)r7r)rmrxZ field_type)rzrsr r?ros c 3s@|]}t|||t|jvj|tdVqdS))rxryrIrzrN)r7rrr_field_defaultsr)rmrx)hintsrsrnr r?ros  )]rrrkr __bound__rrIrrjrintrfloatr rwr!bytesr" bytearrayr# memoryviewr$datetimer%timer&dater' timedeltar(uuidUUIDr)decimalDecimalr*rZRawr,msgpackZExtr+rr1setr2 frozensetr3rr4lenr5rr6r r rr.sortedrr-rrZ__struct_config__r;rrrrrZ__struct_fields__Z__struct_defaults__zipZ__struct_encode_fields__r_Factoryfactoryrr7appendrrr8_get_typeddict_inforrrr:_get_dataclass_inforr9rr/)rsrnrrPrOrRrQrSrYrVrWr_rcconfigrZnposrrxryZ default_objrr~r_infodefaultsrZ is_factoryr )rrzrsrnr?rsh                                                   z_Translator._translate_inner) NNNNNNNNN)rCrDrErrrrrr r r r?rs-r)rhrrir)rIrrir)Z __future__rrrrrcollections.abcrtypingrrrrrZ typing_Typer r rhr r ExceptionrIr rrrrrrrrrrrZ_utilsrrrrrrrrr>r@rrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r4r2r3r5r6r7r8r9r:r;rrrrrrrrrrrr r r r?s  $   )        ,