o 6d;e@s8dZddlmZmZddlZddlZddlZddlZddlZddl m Z m Z ddl Z dZ e r2ddlZe jr:eefZneefZGdddeZdd Zd d ZGd d d e e eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"Gddde"Z#Gd d!d!e"Z$Gd"d#d#eZ%Gd$d%d%eZ&Gd&d'd'eZ'Gd(d)d)eZ(Gd*d+d+e(Z)Gd,d-d-e(Z*Gd.d/d/e(Z+Gd0d1d1e+Z,Gd2d3d3e(Z-Gd4d5d5eZ.Gd6d7d7eZ/Gd8d9d9eZ0Gd:d;d;e0Z1Gdz Defines classes to represent each Stone type in Python. These classes should be used to validate Python objects and normalize them for a given type. The data types defined here should not be specific to an RPC or serialization format. )absolute_importunicode_literalsN)ABCMetaabstractmethodFcs:eZdZdZd fdd ZddZddZd d ZZS) ValidationErrorz=Raised when a value doesn't pass validation by its validator.Ncs4tt||||_g|_|r|j|dSdS)z Args: message (str): Error message detailing validation failure. parent (str): Adds the parent as the closest reference point for the error. Use :meth:`add_parent` to add more. N)superr__init__message_parentsappend)selfr parent __class__C:\Users\jesus\OneDrive\Desktop\erpjis_fastapi\backend\jisbackend\Lib\site-packages\stone/backends/python_rsrc/stone_validators.pyr#s zValidationError.__init__cCs|j|dS)z Args: parent (str): Adds the parent to the top of the tree of references that lead to the validator that failed. N)r r )r r rrr add_parent0szValidationError.add_parentcCs,|jrdd|jddd|jS|jS)z Returns: str: A descriptive message of the validation error that may also include the path to the validator that failed. z{}: {}.N)r formatjoinr r rrr__str__8s zValidationError.__str__cCsdt|S)NzValidationError(%r))six text_typerrrr__repr__CszValidationError.__repr__N) __name__ __module__ __qualname____doc__rrrr __classcell__rrrrr s   rcCsd|j|jfS)Nz%s.%s)rr)trrrtype_name_with_moduleHsr#cCsht|trdSt|tjrdSt|tjrdSt|ttfr dSt|tjr(dS|dur.dSt t |S)zReturn a descriptive type name that isn't Python specific. For example, an int value will return 'integer' rather than 'int'.booleanintegerfloatliststringNnull) isinstanceboolnumbersIntegralRealtupler'r string_typesr#type)vrrrgeneric_type_nameMs     r3c@s0eZdZdZdZeddZddZddZd S) ValidatorzDAll primitive and composite data types should be a subclass of this.)Z_redactcCdS)zValidates that val is of this data type. Returns: A normalized value if validation succeeds. Raises: ValidationError Nrr valrrrvalidategzValidator.validatecCr5)NFrrrrr has_defaultozValidator.has_defaultcCstdNzNo default available.)AssertionErrorrrrr get_defaultrszValidator.get_defaultN) rrrr __slots__rr8r:r>rrrrr4cs  r4c@eZdZdZdZdS) Primitivez&A basic type that is defined by Stone.rNrrrr r?rrrrrAvsrAc@eZdZdZddZdS)BooleanrcCst|ts td||S)Nz%r is not a valid boolean)r*r+rr6rrrr8~s  zBoolean.validateN)rrrr?r8rrrrrD{ rDc@6eZdZdZdZdZdZd ddZddZdd Z dS) Integerz Do not use this class directly. Extend it and specify a 'default_minimum' and 'default_maximum' value as class variables for a more restrictive integer range. minimummaximumNcCs|dur t|tjsJd||jksJd||jf||_n|j|_|durEt|tjs2Jd||jks@Jd||jf||_dS|j|_dS) A more restrictive minimum or maximum value can be specified than the range inherent to the defined type. Nz$min_value must be an integral numberzGmin_value cannot be less than the minimum value for this type (%d < %d)z$max_value must be an integral numberzJmax_value cannot be greater than the maximum value for this type (%d < %d))r*r,r-default_minimumrIdefault_maximumrJr Z min_valueZ max_valuerrrrs,    zInteger.__init__cCsPt|tjstdt||j|kr|jks&ntd||j|jf|S)Nzexpected integer, got %sz%d is not within range [%d, %d])r*r,r-rr3rIrJr6rrrr8s  zInteger.validatecC d|jjSNz%s()rrrrrrr zInteger.__repr__NN rrrr r?rLrMrr8rrrrrrGs  rGc@eZdZdZdZdZdS)Int32riiNrrrr?rLrMrrrrrVrVc@rU)UInt32rrlNrWrrrrrYrXrYc@rU)Int64rllNrWrrrrrZrXrZc@rU)UInt64rrlNrWrrrrr[rXr[c@rF) r.z Do not use this class directly. Extend it and optionally set a 'default_minimum' and 'default_maximum' value to enforce a range that's a subset of the Python float implementation. Python floats are doubles. rHNcCs|dur= 0%max_length must be an integral numbermax_length must be > 0 max_length must be >= min_lengthzpattern must be a stringz\A(?:z)\ZzRegex {!r} failed: {})r*r,r-rr0rfrgrhrirecompileerrorr=rargs)r rfrgrherrrr's< zString.__init__cCst|tjstd|t|ftjs+t|tr+z|d}Wn ty*tdw|j durCt ||j krCtd||j t |f|j dur[t ||j kr[td||j t |f|j rm|j |smtd||j f|S)z A unicode string of the correct length and pattern will pass validation. In PY2, we enforce that a str type must be valid utf-8, and a unicode string will be returned. z$'%s' expected to be a string, got %sutf-8z'%s' was not valid utf-8Nz*'%s' must be at most %d characters, got %dz+'%s' must be at least %d characters, got %dz'%s' did not match pattern '%s')r*rr0rr3PY3strdecodeUnicodeDecodeErrorrglenrfrhrimatchr6rrrr8Bs.   zString.validate)NNNrrrr r?rr8rrrrre#s   rec@s"eZdZdZdddZddZdS)Bytes)rfrgNcCs|durt|tjsJd|dksJd|dur,t|tjs$Jd|dks,Jd|dur<|dur<||kstimestamp should have either a UTC timezone or none set at all)r*datetimerr3tzinfo utcoffset total_secondsr6rrrr8s  zTimestamp.validateNr{rrrrr}s  rc@r@) CompositezLValidator for a type that builds on other primitive and composite types.rNrBrrrrrsrc@rd) Listz= 0z$max_items must be an integral numberzmax_items must be > 0zmax_items must be >= min_items)rr*r,r-rr)r rrrrrrrs z List.__init__cst|ttfs td|jdur"t|jkr"td|jfjdur7t|jkr7td|jffdd|DS)Nz%r is not a valid listz%r has more than %s itemsz%r has fewer than %s itemscsg|]}j|qSr)rr8).0itemrrr sz!List.validate..)r*r/r'rrryrr6rrrr8s z List.validaterSr{rrrrrs   rc@r~)MapzBAssumes map keys and values are homogeneous with respect to types. key_validatorvalue_validatorcCs||_||_dS)z Every Map key/value pair will be validated with item_validator. key validators must be a subclass of a String validator Nr)r rrrrrrs z Map.__init__cs,t|ts td|fdd|DS)Nz%r is not a valid dictcs&i|]\}}j|j|qSr)rr8r)rkeyvaluerrr s  z Map.validate..)r*dictritemsr6rrrr8s   z Map.validateNr{rrrrrs  rcsXeZdZdZfddZddZddZdd Zd d Zd d Z ddZ ddZ Z S)Struct definitioncstt|||_dS)a Args: definition (class): A generated class representing a Stone struct from a spec. Must have a _fields_ attribute with the following structure: _fields_ = [(field_name, validator), ...] where field_name: Name of the field (str). validator: Validator object. N)rrrrr rrrrrs zStruct.__init__cCs|||||S)z} For a val to pass validation, val must be of the correct type and have all required fields present. )validate_type_onlyvalidate_fields_onlyr6rrrr8s  zStruct.validatecCs||||||S)z For a val to pass validation, val must be of the correct type and have all required permissioned fields present. Should only be called for callers with extra permissions. )r8%validate_fields_only_with_permissions)r r7caller_permissionsrrrvalidate_with_permissionss  z Struct.validate_with_permissionscCs(|jjD] }t||std|qdS)ao To pass field validation, no required field should be missing. This method assumes that the contents of each field have already been validated on assignment, so it's merely a presence check. FIXME(kelkabany): Since the definition object does not maintain a list of which fields are required, all fields are scanned. missing required field '%s'N)rZ_all_field_names_hasattrr)r r7 field_namerrrrs zStruct.validate_fields_onlycCsP|||jD]}d|}t|j|tD] }t||s$td|qqdS)a" To pass field validation, no required field should be missing. This method assumes that the contents of each field have already been validated on assignment, so it's merely a presence check. Should only be called for callers with extra permissions. z_all_{}_field_names_rN)rZ permissionsrgetattrrsetrr)r r7rZextra_permissionZall_field_namesrrrrrs     z,Struct.validate_fields_only_with_permissionscCs*t||jstdt|jt|fdS)z Use this when you only want to validate that the type of an object is correct, but not yet validate each field. zexpected type %s, got %sN)r*rrr#r3r6rrrrs zStruct.validate_type_onlycCs |jj SrrZ_has_required_fieldsrrrrr:&s zStruct.has_defaultcCs|jjrJd|Sr<rrrrrr>)szStruct.get_default) rrrr?rr8rrrrr:r>r!rrrrrs   rcs$eZdZdZdZfddZZS) StructTreezValidator for structs with enumerated subtypes. NOTE: validate_fields_only() validates the fields known to this base struct, but does not do any validation specific to the subtype. rcstt||dSr)rrrrrrrr8szStructTree.__init__)rrrr r?rr!rrrrr.src@(eZdZdZddZddZddZdS) UnionrcC ||_dS)a Args: definition (class): A generated class representing a Stone union from a spec. Must have a _tagmap attribute with the following structure: _tagmap = {field_name: validator, ...} where field_name (str): Tag name. validator (Validator): Tag value validator. Nrrrrrr?s zUnion.__init__cCs*||t|dr|jdurtd|S)z For a val to pass validation, it must have a _tag set. This assumes that the object validated that _tag is a valid tag, and that any associated value has also been validated. _tagNz no tag set)rrrrr6rrrr8Ns zUnion.validatecCs.t|jt|stdt|jt|fdS)a Use this when you only want to validate that the type of an object is correct, but not yet validate each field. We check whether val is a Python parent class of the definition. This is because Union subtyping works in the opposite direction of Python inheritance. For example, if a union U2 extends U1 in Python, this validator will accept U1 in places where U2 is expected. z#expected type %s or subtype, got %sN) issubclassrr1rr#r3r6rrrrYs zUnion.validate_type_onlyN)rrrr?rr8rrrrrr<s  rc@r) VoidrcCs|dur tdt|dS)Nzexpected NoneType, got %s)rr3r6rrrr8os z Void.validatecCr5NTrrrrrr:tr;zVoid.has_defaultcCdSrrrrrrr>wr;zVoid.get_defaultN)rrrr?r8r:r>rrrrrls  rcs@eZdZdZfddZddZddZdd Zd d ZZ S) Nullable) validatorcsRtt|t|ttfsJdt|trJdt|tr$Jd||_dS)Nz3validator must be for a primitive or composite typeznullables cannot be stackedzvoid cannot be made nullable)rrrr*rArrr)r rrrrr~s   zNullable.__init__cCs|durdS|j|Sr)rr8r6rrrr8s zNullable.validatecCs|durdS|j|S)z2Use this only if Nullable is wrapping a Composite.N)rrr6rrrrs zNullable.validate_type_onlycCr5rrrrrrr:r;zNullable.has_defaultcCrrrrrrrr>r;zNullable.get_default) rrrr?rr8rr:r>r!rrrrr{s  rc@s,eZdZdZddZeddZddZdS) RedactorregexcCr)zM Args: regex: What parts of the field to redact. Nr)r rrrrrs zRedactor.__init__cCr5)znRedacts information from annotated field. Returns: A redacted version of the string provided. Nrr6rrrapplyr9zRedactor.applycCs0|jsdSzt|j|WStyYdSwr)rrosearch TypeErrorr6rrr _get_matchess zRedactor._get_matchesN)rrrr?rrrrrrrrrs   rc@rC) HashRedactorrc Cs||}t|tst|trt|n|}zt|dd}Wn t t gy0d}Ynw|rDd | }|rBd ||S|S|S)Nrt***z{} ({}))rr*intr&rvhashlibmd5encode hexdigestAttributeError ValueErrorrgroupsr)r r7matchesZ val_to_hashhashedZblottedrrrrs   zHashRedactor.applyNrrrr?rrrrrrrErc@rC) BlotRedactorrcCs ||}|rd|SdS)Nrz********)rrr)r r7rrrrrs zBlotRedactor.applyNrrrrrrrEr)3r __future__rrrrr]r,roabcrrrZ_MYPYtypingrubytes memoryviewr}buffer Exceptionrr#r3with_metaclassobjectr4rArDrGrVrYrZr[r.r`rcrer|rrrrrrrrrrrrrrrrsV ( /H;!^0!