o iq@sddlmZddlZddlZddlZddlZddlmZddlm Z m Z m Z m Z m ZmZmZzddlmZWneyEeddiZYnwzddlmZWney]ed diZYnwddlZdd lmZmZmZd d lmZm Z!d d l"m#Z#m$Z$d dl%m&Z&m'Z'm(Z)m*Z+m,Z-dZ.ddZ/Gdddej0Z Gddde Z1Gddde Z2Gddde Z3Gddde Z4Gddde Z5Gddde Z6Gd d!d!e Z7Gd"d#d#e Z8Gd$d%d%e Z9Gd&d'd'e Z:Gd(d)d)e Z;Gd*d+d+e ZGd0d1d1e Z?Gd2d3d3e Z@Gd4d5d5e ZAGd6d7d7e ZBGd8d9d9e ZCGd:d;d;e ZDGddde ZGd?d@d@e ZFGdAdBdBeFZGGdCdDdDeFZHGdEdFdFeFZIGdGdHdHeFZJGdIdJdJe ZKGdKdLdLe ZLGdMdNdNej0ZMGdOdPdPe ZNGdQdRdRe ZOGdSdTdTe ZPGdUdVdVe ZQdqd[d\ZRdrd_d`ZSdadbZTdcddZUdedfZVdgdhZWdidjZXdkdlZYdmdnZZGdodpdpZ[dS)s) annotationsN)Iterable)AnyFinalLiteralTupleTypeTypeVarUnion) UnionTyper ) TypeAliasTyper ) NODEFAULTUNSET UnsetType)Factory to_builtins) is_structis_struct_type)_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 StructTyperrcCtSN)__all__r r r L/home/ubuntu/veenaModal/venv/lib/python3.10/site-packages/msgspec/inspect.py__dir__WsrBc@eZdZdZdS)rzThe base Type.N__name__ __module__ __qualname____doc__r r r rAr[rc@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)rErFrGrH__annotations__rLrMr r r rAr_s  rc@rC)rz%A type corresponding to `typing.Any`.NrDr r r rArrrIrc@rC)rzA type corresponding to `None`.NrDr r r rArvrIrc@rC)r zA type corresponding to `bool`.NrDr r r rAr zrIr c@NeZdZUdZdZded<dZded<dZded<dZded<dZ ded<dS) r!a6A 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 rErFrGrHrQrNrRrSrTrUr r r rAr!~     r!c@rO) 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]rQrRrSrTrUrVr r r rAr"rWr"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**. NrP min_length max_lengthUnion[str, None]pattern)rErFrGrHrXrNrYr[r r r rAr#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``. NrPrXrYrErFrGrHrXrNrYr r r rAr$  r$c@r\)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``. NrPrXrYr]r r r rAr%r^r%c@r\)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``. NrPrXrYr]r r r rAr&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]tzrErFrGrHrarNr r r rAr'  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`rarbr r r rAr(rcr(c@rC)r)z(A type corresponding to `datetime.date`.NrDr r r rAr)rIr)c@rC)r*z-A type corresponding to `datetime.timedelta`.NrDr r r rAr*rIr*c@rC)r+z$A type corresponding to `uuid.UUID`.NrDr r r rAr+rIr+c@rC)r,z*A type corresponding to `decimal.Decimal`.NrDr r r rAr, rIr,c@rC)r-z.A type corresponding to `msgspec.msgpack.Ext`.NrDr r r rAr-$rIr-c@rC)r.z&A type corresponding to `msgspec.Raw`.NrDr r r rAr.(rIr.c@eZdZUdZded<dS)r/zA type corresponding to an `enum.Enum` type. Parameters ---------- cls: type The corresponding `enum.Enum` type. ztyping_Type[enum.Enum]clsNrErFrGrHrNr r r rAr/,  r/c@rd)r0zA 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, ...]]valuesNrfr r r rAr08s  r0c@rd)r1zgA custom type. Parameters ---------- cls: type The corresponding custom type. rKreNrfr r r rAr1Ergr1c@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 rA _z*UnionType.includes_none..)anyrjselfr r rA includes_none\szUnionType.includes_noneN)rkrl)rErFrGrHrNpropertyrvr r r rAr Qs c@rJ)r2aA 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``. r item_typeNrPrXrYrErFrGrHrNrXrYr r r rAr2bs  r2c@rC)r3aA 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``. NrDr r r rAr3yrIr3c@rC)r6aA 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``. NrDr r r rAr6rIr6c@rC)r4a~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``. NrDr r r rAr4rIr4c@rC)r5aA 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``. NrDr r r rAr5rIr5c@rd)r7zA type corresponding to `tuple`. Parameters ---------- item_types: Tuple[Type, ...] A tuple of types for each element in the tuple. ri item_typesNrfr r r rAr7rgr7c@s:eZdZUdZded<ded<dZded<dZded<dS) r8aA 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``. rkey_type value_typeNrPrXrYryr r r rAr8s  r8c@sfeZdZUdZded<ded<ded<dZded <ejd d d Zd ed<ejdd d Z d ed<dS)r9amA 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_namerrKTrlrequiredcCr>r?rr r r rAzField.)default_factoryrdefaultcCr>r?rr r r rArrrN) rErFrGrHrNrmsgspecfieldrrr r r rAr9s  r9c@"eZdZUdZded<ded<dS)r:zA type corresponding to a `typing.TypedDict` type. Parameters ---------- cls: type The corresponding TypedDict type. fields: Tuple[Field, ...] A tuple of fields in the TypedDict. rKreTuple[Field, ...]fieldsNrfr r r rAr:  r:c@r)r;zA type corresponding to a `typing.NamedTuple` type. Parameters ---------- cls: type The corresponding NamedTuple type. fields: Tuple[Field, ...] A tuple of fields in the NamedTuple. rKrerrNrfr r r rAr; rr;c@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. rKrerrNrfr r r rAr<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]rerrNrZ tag_fieldzUnion[str, int, None]tagFrl array_likeforbid_unknown_fields) rErFrGrHrNrrrrr r r rAr=)s    r=rj Iterable[Any]rktuple[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)rjr r rArEs rrKrcCst|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)rKr r rAr\srcCsg} 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?)rKrMeta)romr r rArq z(_origin_args_metadata..r__args__ __supertype__)rget TypeErrorgetattrrKrextend __metadata__rr_TypeAliasType __value___types_UnionTyper tuple)rpmetadataoriginargs supertyper r rA_origin_args_metadata|sF          #rcCst|tjuSr?)rKenumEnumMetarpr r rA_is_enumsrcC t|dS)N__dataclass_fields__hasattrrr r rA _is_dataclass rcCr)N__attrs_attrs__rrr r rA _is_attrsrrcC,z t|to t|dWStyYdSw)N __total__F) issubclassdictrrrr r rA _is_typeddict  rcCr)N_fieldsF)rrrrrr r rA_is_namedtuplerrcCs|rK|}|D]@\}}||vrF||}t|tr(t|tr(t||||<q t|ttfrAt|ttfrAt|t|||<q |||<q |||<q |Sr?)copyitemsrmr _merge_jsonlistr)abkeyb_vala_valr r rArs  rc@sHeZdZddZddZddZddZ d d d Zd S) rcCst||_i|_i|_dSr?)rrj type_hintscache)rurjr r rA__init__s  z_Translator.__init__cCs6z|j|WStyt|}|j|<|YSw)z+A cached version of `get_class_annotations`)rKeyError_get_class_annotations)rurpoutr r rArs   z"_Translator._get_class_annotationscs2ddlm}|tjtfddjDS)Nr)MsgpackDecoderc3|]}|VqdSr? translaternrtr rArqrrz"_Translator.run..)_corerrrjr)rurr rtrArs 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) rRrQrTrSrUr[rXrYra)title descriptionexamplesT)str_keys)rLrM) rrrLr _to_builtinsrMupdate_translate_innerr) rutyprprrconstrsrLrMmetaattrvalrr r rArs6     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)rRrQrTrSrU)rXrYr[)rXrY)rar)r r .c3rr?rrorrtr rArqlrrz/_Translator._translate_inner..rc3s"|] }|tur|VqdSr?) _UnsetTyperrrtr rArqur)rrrrTF)r~rrKrrrc3s.|]\}}t||||vdVqdS))r~rrKrN)r9r)ror~ field_type)rrur rArqs c 3s@|]}t|||t|jvj|tdVqdS))r~rrKrrN)r9rrr_field_defaultsr)ror~)hintsrurpr rArqs  )]rrrmr __bound__rrKrrlr intr!floatr"r}r#bytesr$ bytearrayr% memoryviewr&datetimer'timer(dater) timedeltar*uuidUUIDr+decimalDecimalr,rRawr.msgpackExtr-rr3setr4 frozensetr5rr6lenr7rr8r r rr0sortedrr/rr__struct_config__r=rrrrr__struct_fields____struct_defaults__zip__struct_encode_fields__r_Factoryfactoryrr9appendrrr:_get_typeddict_inforrrr<_get_dataclass_inforr;rr1)rurprrRrQrTrSrUr[rXrYrareconfigrnposrr~r default_objrrr_infodefaultsr is_factoryr )rrrurprArsh                                                   z_Translator._translate_inner) NNNNNNNNN)rErFrGrrrrrr r r rArs-r)rjrrkr)rKrrkr)\ __future__rrrrrcollections.abcrtypingrrrrr typing_Typer r rjr r ExceptionrKr rrrrrrrrrrr _typing_utilsrr_utilsrrrrrrrrr@rBStructrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r6r4r5r7r8r9r:r;r<r=rrrrrrrrrrr r r rAs  $   +        ,