=SrSSKJr SSKrSSKJr SSKJr "SS\5r "SS \R5r \ R\ \ R5 "S S \5r"S S \5r"SS\5r"SS\5rSrSr"SS\5r"SS\5r"SS\\5r"SS\5r"SS\5r"SS\5r\"\5r\"\5r\"\5r \"\!5r"\"\RF5r$\"\%5r&"S S!\5r'"S"S#\5r("S$S%\5r)"S&S'\5r*"S(S)\5r+"S*S+\5r,"S,S-\5r-"S.S/\5r."S0S1\5r/"S2S3\5r0"S4S5\05r1"S6S7\05r2g)8aValidation tools for generic object structures. This library is used for defining classes with constrained attributes. Attributes are defined on the class which contains them using validators. Although validators can be defined by any client of this library, a number of standard validators are provided here. Validators can be any callable that takes a single parameter which checks the new value before it is assigned to the attribute. Validators are permitted to modify a received value so that it is appropriate for the attribute definition. For example, using int as a validator will cast a correctly formatted string to a number, or raise an exception if it can not. This is not recommended, however. the correct way to use a validator that ensure the correct type is to use the Type validator. This validation library is mainly intended for use with the YAML object builder. See yaml_object.py. )absolute_importN) six_subset)yamlc2^\rSrSrSrU4SjrSrSrU=r$) SortedDict-zDRepresents a dict with a particular key order for yaml representing.cX>[[U] 5 XlUR U5 gN)superr__init__keysupdate)selfr data __class__s .lib/googlecloudsdk/appengine/api/validation.pyr SortedDict.__init__0s! *d$&IKKc/nURH8nURU5cMURX RU545 M: U$r )r getappend)rresultkeys r ordered_itemsSortedDict.ordered_items5sA Fyy # " sHHSM*+ Mr)r ) __name__ __module__ __qualname____firstlineno____doc__r r__static_attributes__ __classcell__rs@rrr-sL rrc0^\rSrSrSrSU4SjjrSrU=r$) ItemDumper=z?For dumping validation.Items. Respects SortedDict key ordering.c>[US5(a [[U]XR 5US9$[[U]XUS9$)Nr) flow_style)hasattrr r%represent_mappingr)rtagmappingr(rs rr*ItemDumper.represent_mapping@sUw(( :t 6 $$&:7?? T 4  5 --rr )rrrrr r*r!r"r#s@rr%r%=sG--rr%c\rSrSrSrSrg)ErrorLz"Base class for all package errors.r.Nrrrrr r!r.rrr0r0Ls*rr0c\rSrSrSrSrg)AttributeDefinitionErrorPz8An error occurred in the definition of class attributes.r.Nr2r.rrr4r4Ps@rr4c(\rSrSrSrSSjrSrSrg)ValidationErrorTz4Base class for raising exceptions during validation.Nc[US5(a3UR(a"[R"X/URQ76 O[RX5 XlX lg)zInitialize exception.argsN)r)r:r0r messagecause)rr;r<s rr ValidationError.__init__WsBuf%** nnT0UZZ0 nnT#LJrc,[UR5$r )strr;rs r__str__ValidationError.__str__bs t|| r)r<r;r )rrrrr r rAr!r.rrr7r7Ts< rr7c,^\rSrSrSrU4SjrSrU=r$)MissingAttributefz8Raised when a required attribute is missing from object.cN>SRU5n[[U]U5 g)NzMissing required value [{}].)formatr rDr )rrmsgrs rr MissingAttribute.__init__is# ( / / 4C D*3/rr.)rrrrr r r!r"r#s@rrDrDfs@00rrDc[R"U5(dU[R:Xa [5$[ U[ [R 45(a[U[U55$[ U[5(a [U5$[ U[[[45(a[[U56$[ U[5(aU$[S[ U5-5e)aWrap various types as instances of a validator. Used to allow shorthand for common validator types. It converts the following types to the following Validators. strings -> Regex type -> Type collection -> Options Validator -> Its self! Args: validator: Object to wrap in a validator. Returns: Validator instance that wraps the given value. Raises: AttributeDefinitionError: if validator is not one of the above described types. z%s is not a valid validator)r is_basestring string_typesStringValidator isinstancer? text_typeRegextypeTypelisttuplesetOptions Validatorr4 validators r AsValidatorrZns*y)) j-- -   C!5!5677 DO ,, 4   ? D%-.. E)$ %% 9%%  "#@#&y>$2 33rc[U[5(aUR5$[U[[45(aUVs/sHn[ X5PM sn$[U[ 5(aURU5$U$s snf)aConvert any value to simplified collections and basic types. Args: validator: An instance of Validator that corresponds with 'value'. May also be 'str' or 'int' if those were used instead of a full Validator. value: Value to convert to simplified collections. Returns: The value as a dictionary if it is a ValidatedBase object. A list of items converted to simplified collections if value is a list or a tuple. Otherwise, just the value. )rN ValidatedBaseToDictrSrT_SimplifiedValuerWToValue)rYvalueitems rr^r^sr}%% <<>%$'':? @%$ Y -% @@)Y''   U ## , AsBcL\rSrSrSr\S5rSrSrSr Sr Sr S r S r g ) r\z%Base class for all validated objects.c[S5e)aSafely get the Validator corresponding to the given key. This function should be overridden by subclasses Args: key: The attribute or item to get a validator for. Returns: Validator associated with key or attribute. Raises: ValidationError: if the requested key is illegal. z7Subclasses of ValidatedBase must override GetValidator.NotImplementedErrorclsrs r GetValidatorValidatedBase.GetValidators 7 88rcXUR5Hup#URX#5 M g)zSet multiple values on Validated instance. All attributes will be validated before being set. Args: attributes: A dict of attributes/items to set. Raises: ValidationError: when no validated attribute exists on class. N)itemsSet)r attributesrr`s r SetMultipleValidatedBase.SetMultiples%!&&(  hhs)rc[S5e)a,Set a single value on Validated instance. This method should be overridded by sub-classes. This method can only be used to assign validated attributes/items. Args: key: The name of the attributes value: The value to set Raises: ValidationError: when no validated attribute exists on class. z.Subclasses of ValidatedBase must override Set.rerrr`s rrmValidatedBase.Sets N OOrcg)aChecks for missing or conflicting attributes. Subclasses should override this function and raise an exception for any errors. Always run this method when all assignments are complete. Raises: ValidationError: when there are missing or conflicting attributes. Nr.r@s rCheckInitializedValidatedBase.CheckInitializedsrc[S5e)Convert ValidatedBase object to a dictionary. Recursively traverses all of its elements and converts everything to simplified collections. Subclasses should override this method. Returns: A dictionary mapping all attributes to simple values or collections. z1Subclasses of ValidatedBase must override ToDict.rer@s rr]ValidatedBase.ToDicts 1 22rcR[R"UR5S[S9$)zPrint validated object as simplified YAML. Returns: Object as a simplified YAML string compatible with parsing using the SafeLoader. F)default_flow_styleDumper)rdumpr]r%r@s rToYAMLValidatedBase.ToYAMLs# 99T[[](-& ((rc[S5e)zReturn all the warnings we've got, along with their associated fields. Returns: A list of tuples of (dotted_field, warning), both strings. z5Subclasses of ValidatedBase must override GetWarningsrer@s r GetWarningsValidatedBase.GetWarningss 5 66rr.N)rrrrr classmethodrirormrur]r~rr!r.rrr\r\s6-88" P  2 (6rr\c^\rSrSrSrSrU4Sjr\S5rSr Sr U4Sjr S r U4S jr S rS rS rSrSrSrSrSrSrU=r$) Validatedi aPBase class for classes that require validation. A class which intends to use validated fields should sub-class itself from this class. Each class should define an 'ATTRIBUTES' class variable which should be a map from attribute name to its validator. For example: class Story(Validated): ATTRIBUTES = {'title': Type(str), 'authors': Repeated(Type(str)), 'isbn': Optional(Type(str)), 'pages': Type(int), } Attributes that are not listed under ATTRIBUTES work like normal and are not validated upon assignment. Nc Z>[[U] 5 [UR[ 5(d[ SUR-5eURR5H2n[RXURU5R5 M4 URU5 g)zConstructor for Validated classes. This constructor can optionally assign values to the class via its keyword arguments. Raises: AttributeDefinitionError: when class instance is missing ATTRIBUTE definition or when ATTRIBUTE is of the wrong type. z3The class %s does not define an ATTRIBUTE variable.N)r rr rN ATTRIBUTESdictr4rr object __setattr__ridefaultro)rrnrrs rr Validated.__init__!s )T#% doot , , $ ? NN   ##% D$5$5c$:$B$BC& Z rcXR;a[SU<SUR<S35e[URU5$)zSafely get the underlying attribute definition as a Validator. Args: key: Name of attribute to get. Returns: Validator associated with key or attribute value wrapped in a validator. Raises: ValidationError: if no such attribute exists. zUnexpected attribute 'z' for object of type .)rr7rrZrgs rriValidated.GetValidator7s? ..      s~~c* ++rc/nURR5HBnURURU5R UR U5X 55 MD U$r )rr extendrirGetUnnormalized)rretrs rrValidated.GetWarningsKsY C##% jj""3'33   s #S01& Jrc[XU5 g)zSet a single value on Validated instance. This method can only be used to assign validated attributes. Args: key: The name of the attributes value: The value to set Raises: ValidationError when no validated attribute exists on class. N)setattrrrs rrm Validated.SetRs Durc>URU5n[[U]U5$![a UR s$f=f)zBGet a single value on the Validated instance, without normalizing.)rir r__getattribute__AttributeErrorr)rrrYrs rrValidated.GetUnnormalized`sE!!#&I 9d 4S 99    s'AAc:URU5 [X5$)zGet a single value on Validated instance. This method can only be used to retrieve validated attributes. Args: key: The name of the attributes Raises: ValidationError when no validated attribute exists on class. )rigetattr)rrs rGet Validated.Geths c 4 rc>[[U] U5nUS;aU$URU5n[ U[ 5(aURX!U5$U$![a Us$f=f)N)rrirr)r rrrir7rN Normalizedr)rrrrYrs rrValidated.__getattribute__vst  4 1# 6C EE j##C(i)Z(( ]]3T ** J  jsA A'&A'cURR5H5nURU5nURU5R X!U5 M7 gr )rr rriCheckFieldInitializedrrs rruValidated.CheckInitializedsD##%""3'e 225tD&rcdUbURU5"X!5n[RXU5 g)aJSet attribute. Setting a value on an object of this type will only work for attributes defined in ATTRIBUTES. To make other assignments possible it is necessary to override this method in subclasses. It is important that assignment is restricted in this way because this validation is used as validation for parsing. Absent this restriction it would be possible for method names to be overwritten. Args: key: Name of attribute to set. value: The attribute's new value or None to unset. Raises: ValidationError: when trying to assign to an attribute that does not exist. N)rirrrrs rrValidated.__setattr__s/& $U0e t%(rc[U5$)5Formatted view of validated object and nested values.)reprr@s rrAValidated.__str__s :rc.URR5Vs/sHo[X54PM nnSn/nUH!upURSU<U<SU<35 M# SURR <SSR U5<SU<S3$s snf)rz  =< >)rr rrrrjoin)rattrvaluesdent value_listr`s r__repr__Validated.__repr__s6:oo6J6J6L M6LdWT()6LF M DJ tT59:!NN33SXXj5I4 PP NsBc[U5[U5:wagURR5Hn[X5[X5:wdM g g)aEquality operator. Comparison is done by comparing all attribute values to those in the other instance. Objects which are not of the same type are not equal. Args: other: Other object to compare against. Returns: True if validated objects are equal, else False. FT)rQrr r)rotherrs r__eq__Validated.__eq__sH DzT%[ ##%  wu2 2& rc.URU5(+$)zInequality operator.rrrs r__ne__Validated.__ne__{{5! !!rcSnURR5HHn[X5n[U[5(a [ U5nU[ U5- [ U5- nMJ U$)zHash function for using Validated objects in sets and maps. Hash is done by hashing all keys and values and xor'ing them together. Returns: Hash of validated object. r)rr rrNrSrThash)rrrr`s r__hash__Validated.__hash__s^F##%d e E4 e S !DK/f & Mrc0nURR5HIup#URU5n[U[5(aXCR :XaM<[ X45X'MK U$)aoConvert Validated object to a dictionary. Recursively traverses all of its elements and converts everything to simplified collections. Returns: A dict of all attributes defined in this classes ATTRIBUTES mapped to its value. This structure is recursive in that Validated objects that are referenced by this object and in lists are also converted to dicts. )rrlrrNrWrr^)rrnamerYr`s rr]Validated.ToDicts]F??002""4(e  9 - -%;L;L2L' 9 3 Mrr.)rrrrr rr rrirrmrrrrurrArrrrr]r!r"r#s@rrr sp$*!,,,&   E ).Q&" rrcl^\rSrSrSrSrSrU4Sjr\S5r Sr S Sjr Sr S r S rS rS rU=r$) ValidatedDictiaBase class for validated dictionaries. You can control the keys and values that are allowed in the dictionary by setting KEY_VALIDATOR and VALUE_VALIDATOR to subclasses of Validator (or things that can be interpreted as validators, see AsValidator). For example if you wanted only capitalized keys that map to integers you could do: class CapitalizedIntegerDict(ValidatedDict): KEY_VALIDATOR = Regex('[A-Z].*') VALUE_VALIDATOR = int # this gets interpreted to Type(int) The following code would result in an error: my_dict = CapitalizedIntegerDict() my_dict['lowercase'] = 5 # Throws a validation exception You can freely nest Validated and ValidatedDict inside each other so: class MasterObject(Validated): ATTRIBUTES = {'paramdict': CapitalizedIntegerDict} Could be used to parse the following yaml: paramdict: ArbitraryKey: 323 AnotherArbitraryKey: 9931 Nc L>[[U] 5 URU5 g)zConstruct a validated dict by interpreting the key and value validators. Args: **kwds: keyword arguments will be validated and put into the dict. N)r rr r)rkwdsrs rr ValidatedDict.__init__ s  -')KKrc~[UR5"USUR-5n[UR5$)zCheck the key for validity and return a corresponding value validator. Args: key: The key that will correspond to the validator we are returning. z key in %s)rZ KEY_VALIDATORrVALUE_VALIDATORrgs rriValidatedDict.GetValidators5 c'' (kCLL.H IC s** ++rcZ[RXURU5"X!55 g)a7Set an item. Only attributes accepted by GetValidator and values that validate with the validator returned from GetValidator are allowed to be set in this dictionary. Args: key: Name of item to set. value: Items new value. Raises: ValidationError: when trying to assign to a value that does not exist. N)r __setitem__rirrs rrValidatedDict.__setitem__s$ T 1 1# 6u BCrcX[RXURU5"X!55$)zTrap setdefaultss to ensure all key/value pairs are valid. See the documentation for setdefault on dict for usage details. Raises: ValidationError: if the specified key is illegal or the value invalid. )r setdefaultrirrs rrValidatedDict.setdefault.s% ??4d&7&7&Fzz| ##D)i%i7fl$ Mrr.r )rrrrr rrr rrirrrrmrr]r!r"r#s@rrrsR8-/,,D J+,  rrcL\rSrSrSr\rS SjrS SjrS Sjr Sr Sr S r S r g) rWizaValidator base class. Though any callable can be used as a validator, this class encapsulates the case when a specific validator needs to hold a particular state or configuration. To implement Validator sub-class, override the validate method. This class is permitted to change the ultimate value that is set to the attribute if there is a reasonable way to perform the conversion. NcXlg)zzConstructor. Args: default: Default assignment is made during initialization and will not pass through validation. Nr)rrs rr Validator.__init__s Lrc$URX5$)z.Main interface to validator is call mechanism.)Validaterr`rs r__call__Validator.__call__s == $$rcU$)zValidate this field. Override to customize subclass behavior. Args: value: Value to validate. key: Name of the field being validated. Returns: Value if value is valid, or a valid representation of value. r.rs rrValidator.Validates  Lrc Uc [U5eg)aCheck for missing fields or conflicts between fields. Default behavior performs a simple None-check, but this can be overridden. If the intent is to allow optional fields, then use the Optional validator instead. Args: value: Value to validate. key: Name of the field being validated. obj: The object to validate against. Raises: ValidationError: when there are missing or conflicting fields. N)rDrr`robjs rrValidator.CheckFieldInitializeds } S !!rcU$)aConvert 'value' to a simplified collection or basic type. Subclasses of Validator should override this method when the dumped representation of 'value' is not simply (value) (e.g. a regex). Args: value: An object of the same type that was returned from Validate(). Returns: An instance of a builtin type (e.g. int, str, dict, etc). By default it returns 'value' unmodified. r.rr`s rr_Validator.ToValues  Lrc AAA/$)aReturn any warnings on this attribute. Validates the value with an eye towards things that aren't fatal problems. Args: value: Value to validate. key: Name of the field being validated. obj: The object to validate against. Returns: A list of tuples (context, warning) where - context is the field (or dotted field path, if a sub-field) - warning is the string warning text r.rs rrValidator.GetWarningss sC Irrr z???)rrrrr r expected_typer rrrr_rr!r.rrrWrWzs, -% "$ rrWc"\rSrSrSrSSjrSrg)rMizpVerifies property is a valid text string. In python 2: inherits from basestring In python 3: inherits from str cl[U[R5(d[SU<SU<S35eU$)NValue  for z is not a valid text string.)rNrrLr7rs rrStringValidator.Validates3 eZ44 5 5 S   Lrr.Nr)rrrrr rr!r.rrrMrMs  rrMc<^\rSrSrSrSU4SjjrSrSrSrU=r $)rRiaVerifies property is of expected type. Can optionally convert value if it is not of the expected type. It is possible to specify a required field of a specific type in shorthand by merely providing the type. This method is slightly less efficient than providing an explicit type but is not significant unless parsing a large amount of information: class Person(Validated): ATTRIBUTES = {'name': unicode, 'age': int, } However, in most instances it is best to use the type constants: class Person(Validated): ATTRIBUTES = {'name': TypeUnicode, 'age': TypeInt, } cD>[[U] U5 XlX lg)akInitialize Type validator. Args: expected_type: Type that attribute should validate against. convert: Cause conversion if value is not the right type. Conversion is done by calling the constructor of the type with the value as its first parameter. default: Default assignment is made during initialization and will not pass through validation. N)r rRr rconvert)rrrrrs rr Type.__init__s $w'&Lrc [XR5(dNUR(aURU5$[ SU<SU<SURR <35eU$![a2n[ SU<SU<SURR <S3U5eSnAf[ a1n[ SU<SU<SURR <3U5eSnAff=f)aValidate that value has the correct type. Args: value: Value to validate. key: Name of the field being validated. Returns: value if value is of the correct type. value is coverted to the correct type if the Validator is configured to do so. Raises: ValidationError: if value is not of the right type and the validator is either configured not to convert or cannot convert. rrz could not be converted to type rNz is not of the expected type )rNrr ValueErrorr7r TypeError)rr`res rr Type.Validate s e// 0 0  ?##E* *d0099;< <l ?d0099;<=? ? ?d0099;<=? ? ?s#A++ C 5-B"" C /,CC cA[UR[5(a.UR5VVs/sHupEU<SU<3U4PM snn$/$s snnf)Nr) issubclassrr\r)rr`rrsubkeywarnings rrType.GetWarnings.sW $$$m44%*%6%6%8:%8/&v&0%8:: I:sA)rr)TN) rrrrr r rrr!r"r#s@rrRrRs, !FrrRc<^\rSrSrSrSU4SjjrU4SjrSrU=r$)ExeciBa*Coerces the value to accommodate Docker CMD/ENTRYPOINT requirements. Validates the value is a string, then tries to modify the string (if necessary) so that the command represented will become PID 1 inside the Docker container. See Docker documentation on "docker kill" for more info: https://docs.docker.com/engine/reference/commandline/kill/ If the command already starts with `exec` or appears to be in "exec form" (starts with `[`), no further action is needed. Otherwise, prepend the command with `exec` so that it will become PID 1 on execution. c4>[[U] [SUS9 g)z9Initialize parent, a converting type validator for `str`.T)rrN)r rr r?)rrrs rr Exec.__init__Os $sD'Brc>[[U] X5nURS5(dURS5(aU$SU-$)zFValidate according to parent behavior and coerce to start with `exec`.[execzexec )r rr startswith)rr`rrs rr Exec.ValidateSsH $ &u 2E  0 0 8 8 lu_rr.r rrrrr r rr!r"r#s@rrrBs C  rrc2^\rSrSrSrU4SjrSrSrU=r$)rViaa'Limit field based on pre-determined values. Options are used to make sure an enumerated set of values are the only one permitted for assignment. It is possible to define aliases which map multiple string values to a single original. An example of usage: class ZooAnimal(validated.Class): ATTRIBUTES = { 'name': str, 'kind': Options('platypus', # No aliases ('rhinoceros', ['rhino']), # One alias ('canine', ('dog', 'puppy')), # Two aliases ) c>^ SU;aUSnOSn0m U 4SjnUHn[U[5(a U"XU5 M"[U[[45(a_[ U5S:wa [ S5eUupgU"Xf5 [U[[45(d [ S5eUH nU"X5 M M[ S5e [ [U]#U5 T Ul g)z>Initialize options. Args: options: List of allowed values. rNcx>[U[5(d [S5eUT;a[SU-5eUTU'g)zSet new alias on alias_map. Raises: AttributeDefinitionError: when option already exists or if alias is not of type str. z&All option values must be of type str.z1Option '%s' already defined for options property.N)rNr?r4)aliasoriginal alias_maps rAddAlias"Options.__init__..AddAlias}sKs # #& 46 6 I & ?% GI I!irzAlias is defined as a list or tuple with two items. The first is the original option, while the second is a list or tuple of str aliases. Example: ('original', ('alias1', 'alias2'z#Alias lists must be a list or tuplez?All options must be of type str or of the form (str, [str...]).) rNr?rSrTlenr4r rVr options) rr#kwrroptionraliasesrrrs @rr Options.__init__qs B9 ggI "  FC  ftUm , , v;! (*45 5#$'D%=11()NO OE 5 #'(IJ J/2 '4!'*DLrc [U5nXR;a"[SU<SU<SUR<S35eURU$)zValidate options. Returns: Original value for provided alias. Raises: ValidationError: when value is not one of predefined values. Value '' for z not in r)r?r#r7rs rrOptions.ValidatesC JE LL $c4<<9 :: << r)r#rr#s@rrVrVas 6p  rrVc4\rSrSrSrS SjrSrSrSrSr g) Optionalia Definition of optional attributes. Optional values are attributes which can be set to None or left unset. All values in a basic Validated class are set to None at initialization. Failure to assign to non-optional values will result in a validation error when calling CheckInitialized. Ncf[U5UlURRUlX lg)aInitializer. This constructor will make a few guesses about the value passed in as the validator: - If the validator argument is a type, it automatically creates a Type validator around it. - If the validator argument is a list or tuple, it automatically creates an Options validator around it. Args: validator: Optional validation condition. Raises: AttributeDefinitionError: if validator is not callable. N)rZrYrr)rrYrs rr Optional.__init__s'$!+DN55DLrc$URX5$)a&Optionally require a value. Normal validators do not accept None. This will accept none on behalf of the contained validator. Args: value: Value to be validated as optional. key: Name of the field being validated. Returns: None if value is None, else results of contained validation. rXrs rrOptional.Validates >>% %%rcDUcgURRXU5 gr )rYrrs rrOptional.CheckFieldInitializeds } NN((S9rc@UcgURRU5$)z9Convert 'value' to a simplified collection or basic type.N)rYr_rs rr_Optional.ToValues }  >> ! !% ((r)rrrYr ) rrrrr r rrr_r!r.rrr-r-s, &: )rr-cN^\rSrSrSr\R S4U4SjjrSrSr U=r $)rPiaaRegular expression validator. Regular expression validator always converts value to string. Note that matches must be exact. Partial matches will not validate. For example: class ClassDescr(Validated): ATTRIBUTES = { 'name': Regex(r'[a-zA-Z_][a-zA-Z_0-9]*'), 'parent': Type(type), } Alternatively, any attribute that is defined as a string is automatically interpreted to be of type Regex. It is possible to specify unicode regex strings as well. This approach is slightly less efficient, but usually is not significant unless parsing large amounts of data: class ClassDescr(Validated): ATTRIBUTES = { 'name': r'[a-zA-Z_][a-zA-Z_0-9]*', 'parent': Type(type), } # This will raise a ValidationError exception. my_class(name='AName with space', parent=AnotherClass) Nc>[[U] U5 [U[R 5(a[R "U5(a[S[U5-5e[U[R 5(a[R"SU-5Ul O[S[U5-5eX l g)zInitialized regex validator. Args: regex: Regular expression string to use for comparison. string_type: Type to be considered a string. default: Default value. Raises: AttributeDefinitionError: if string_type is not a kind of string. z*Regex fields must be a string type not %s.z^(?:%s)$z-Regular expression must be string. Found %s.N) r rPr r rrLrKr4r?rNrecompiler)rregex string_typerrs rr Regex.__init__ s %( {J$;$; < <  -- $ 6[9I I KK%0011 :-.dg $ 9CJ F HH%rc [UR[5(a [U5nO [ U5nUR R U5c,[SU<SU<SUR R<S35eU$)a Does validation of a string against a regular expression. Args: value: String to match against regular expression. key: Name of the field being validated. Raises: ValidationError: when value does not match regular expression or when value does not match provided string type. r)r*z does not match expression '') r rr?TYPE_STR TYPE_UNICODEr8matchr7patternrr`r cast_values rrRegex.Validate$sg$$$c**E?j&j ww}}Z ( (-sDGGOOE FF r)rr8) rrrrr rrOr rr!r"r#s@rrPrPs$0)3(<(._RegexStrValue.__BuildRegex..ws9jddTkjsr)rNrJrSr_RegexStrValue__AsStringr)rrsequence regex_listras r __BuildRegex_RegexStrValue.__BuildRegexcs}$,,%%<jhJ-. XX9j9 99 ]rc UR5n[R"U5$![Ra'n[ SU<SUR <SU<3U5eSnAff=f)zmBuild regular expression object from state. Returns: Compiled regular expression based on internal value. r)r*z does not compile: N)_RegexStrValue__BuildRegexr8r9errorr7rL)rr:rs r __Compile_RegexStrValue.__Compile{sZ    E7 ZZ  887 "DJJ345 777s(A#"AA#c"UR5$)z=Compiled regular expression as described by underlying value._RegexStrValue__Compiler@s rr:_RegexStrValue.regexs >> rcL[R"UR5U5$)zMatch against internal regular expression. Args: value: String to match against regular expression. Returns: Regular expression object built from underlying value. )r8rArars rrA_RegexStrValue.matchs 88D%%' //rc$UR5 g)z"Ensure that regex string compiles.Nrfr@s rr_RegexStrValue.Validates NNrc"UR5$)z;Regular expression string as described by underlying value.)rar@s rrA_RegexStrValue.__str__s    rc[U[5(a!UR5UR5:H$[U5U:H$)z:Comparison against other regular expression string values.)rNrGrar?rs rr_RegexStrValue.__eq__s;%((    E$6$6$8 88 t9 rc.URU5(+$)z8Inequality operator for regular expression string value.rrs rr_RegexStrValue.__ne__rr) __attribute__key__regex__valueN)rrrrr r r[rargpropertyr:rArrArrr!r.rrrGrG:sH   0 7   0 "rrGcT^\rSrSrSr\R S4U4SjjrSrSr Sr U=r $)RegexStriaValidates that a string can compile as a regex without errors. Use this validator when the value of a field should be a regex. That means that the value must be a string that can be compiled by re.compile(). The attribute will then be a compiled re object. Nc6>Ub+[XS5n[R"[U55 [[ U]U5 [U[R5(a[R"U5(a[S[U5-5eXl g)zInitialized regex validator. Args: string_type: Type to be considered a string. default: Default value. Raises: AttributeDefinitionError: if string_type is not a kind of string. Nz-RegexStr fields must be a string type not %s.) rGr8r9r?r ryr r rrLrKr4r)rr;rrs rr RegexStr.__init__std3gjjW (D"7+ {J$;$; < <  -- $ 9C [[U] U5 UnU[R;a[RnUcUc [ S5eUbL[ X5(d<[ S[U5<S[[U55<S[U5<S35eUbL[ X%5(d<[ S[U5<S[[U55<S[U5<S35eXl X l X0l [U5Ul g)aInitializer for range. At least one of minimum and maximum must be supplied. Args: minimum: Minimum for attribute. maximum: Maximum for attribute. range_type: Type of field. Defaults to int. Raises: AttributeDefinitionError: if the specified parameters are incorrect. Nz Must specify minimum or maximum.zMinimum value must be of type z, instead it is z (z).zMaximum value must be of type )r rr r integer_typesr4rNr?rQminimummaximumrrR_type_validator)rrr range_typer min_max_typers rr Range.__init__s %(LZ-----l7? $%G HH:g#D#D $ z?CW .G  > ??:g#D#D $ z?CW .G  > ??LL# +Drc URRX5nURc0X0R:a![ SU<SU<SUR<35eURc0X0R:a![ SU<SU<SUR<35eURbX0R:dURb>X0R:a/[ SU<SU<SUR<SUR<35eU$)aValidate that value is within range. Validates against range-type then checks the range. Args: value: Value to validate. key: Name of the field being validated. Raises: ValidationError: when value is out of range. ValidationError when value is not of the same range type. r)r*z less than z greater than z is out of range z - )rrrrr7rCs rrRange.Validates%%..u:J || \\ 9 $c4<<9 ::  *||"; $c4<<9 :: << # \\(A << # \\(A $c4<<G HH r)rrrr) rrrrr intr rr!r"r#s@rrrs 36t,Brrc<^\rSrSrSrSU4SjjrSrSrSrU=r $)Repeatedi0aRepeated field validator. Indicates that attribute is expected to be a repeated value, ie, a sequence. This adds additional validation over just Type(list) in that it retains information about what can be stored in the list by use of its constructor field. cN>[[U] U5 Xl[Ulg)znInitializer for repeated field. Args: constructor: Type used for verifying elements of sequence attribute. N)r rr constructorrSr)rrrrs rr Repeated.__init__9s"  (D"7+"Drc [U[5(d[SU<SU<S35e[U5Hup4[UR[ 5(aURR XB5X'MC[X@R5(aM_[S[U5<SU<SURR<S35e U$)aDo validation of sequence. Value must be a list and all elements must be of type 'constructor'. Args: value: Value to validate. key: Name of the field being validated. Raises: ValidationError: if value is None, not a list or one of its elements is the wrong type. r)r*z! should be a sequence but is not.Value element ' must be type r) rNrSr7 enumeraterrWrr?r)rr`ridxras rrRepeated.ValidateCs eT " " ).5 66u%  D$$i 0 0%%..t9 $ 0 011 IsD,,5578 8 & Lrc Uc [U5e[U5HupE[UR[5(a;URR XRU5 URR XR5X'M_[XPR5(aM{[S[U5<SU<SURR<S35e g)Nrr*rr) rDrrNrrWrrr7r?r)rr`rrrras rrRepeated.CheckFieldInitialized]s } S !!u%  D$$i 0 0 ..t$?%%..t9 $ 0 011 IsD,,5578 8&r)rrr ) rrrrr r rrr!r"r#s@rrr0s4 8 8rrc6^\rSrSrSrSrU4SjrSrSrU=r $) TimeValueikz5Validates time values with units, such as 1h or 3.5d.zImust be a non-negative number followed by a time unit, such as 1h or 3.5dc@>[[U] 5 [Ulgr )r rr r?r)rrs rr TimeValue.__init__qs )T#%Drc [U[R5(d&[SU<SU<S[R <S35eU(d"[SU<S[R <S35eUSS;a[SU<SU<S 35e[ US S5nUS :a&[SU<SU<S [R <S35eU$![a' [SU<SU<S [R <S35ef=f)zValidate a time value. Args: value: Value to validate. key: Name of the field being validated. Raises: ValidationError: if value is not a time value with the expected format. r)r*z is not a string ()z Value for z is empty (smhdzS must end with a time unit, one of s (seconds), m (minutes), h (hours), or d (days)Nz is not a valid time value (rz is negative ()rNrrLr7r_EXPECTED_SYNTAXfloatr)rr`rts rrTimeValue.Validateus eZ44 5 5 $c9+E+EG HH  "I$>$>@ AA Ry -2C9 ::H cr a 1u $c9+E+EG HH L H $c9+E+EG HHHs C 1C:r) rrrrr rr rr!r"r#s@rrrks=+rrc$\rSrSrSrSrSrSrg)rizlNormalizes a field on lookup, but serializes with the original value. Only works with fields on Validated. c$URX5$r rXrs rrNormalized.Validates >>% %%rc[S5e)z7Returns the normalized value. Subclasses must override.zSubclasses must override `Get`!rers rrNormalized.Gets ? @@rr.N)rrrrr rrr!r.rrrrs &Arrc<^\rSrSrSrSU4SjjrSrSrSrU=r $) PreferredizA non-deprecated field when there's a deprecated one. For use with Deprecated. Only works as a field on Validated. Both fields will work for value access. It's an error to set both the deprecated and the corresponding preferred field. c`>[[U] SS9 [U5UlXlX0lg)zInitializer for Preferred. Args: deprecated: The name of the corresponding deprecated field validator: The validator for the actual value of this field. default: The default value for this field. Nr)r rr rZrY deprecatedsynthetic_default)rrrYrrs rr Preferred.__init__s0 )T#D#1 +DN O%rcURUR5nUb'Ub$[SRX R55eUbgUR(dUR R XU5 gg)NzMOnly one of the two fields [{}] (preferred) and [{}] (deprecated) may be set.)rrr7rGrrYrrr`rrdeprecated_values rrPreferred.CheckFieldInitializedsu**4??; -9 AAG #__B6 77#  ! ! nn**5s; "rcdUbU$URUR5nUbU$UR$r )rrrrs rr Preferred.Gets:  l**4??;#   ! !!r)rrrYr ) rrrrr r rrr!r"r#s@rrrs % <""rrcB^\rSrSrSrSU4SjjrSrSrSrSr U=r $) DeprecatedizA deprecated field. For use with Preferred. Only works as a field on Validated. Both fields will work for value access. It's an error to set both the deprecated and the corresponding preferred field. c`>[[U] SS9 [U5UlXlX0lg)zInitializer for Deprecated. Args: preferred: The name of the preferred field. validator: The validator for the actual value of this field. default: The default value for this field. Nr)r rr r-rY preferredr)rrrYrrs rr Deprecated.__init__s. *d$T$2i(DNN$rc>AUbUSU<SUR<S34/$/$)NzField z is deprecated; use z instead.)rrs rrDeprecated.GetWarningss3   7:DNN KMNN IrcdURUR5nUbU$UbU$UR$r )rrr)rr`rrpreferred_values rrDeprecated.Gets9))$..9O"    l  # ##rcgr r.rs rr Deprecated.CheckFieldInitializedsr)rrrYr ) rrrrr r rrrr!r"r#s@rrrs! %$  rr)3r __future__rr8"googlecloudsdk.appengine._internalrruamelrrr SafeDumperr%add_representerrepresent_dict Exceptionr0r4r7rDrZr^rr\rrrWrMrRbool TYPE_BOOLrTYPE_INT TYPE_LONGr?r?rOr@r TYPE_FLOATrrVr-rPrGryrrrrrrr.rrrs0' 9   --  ))++I+AuAe$00"3J2]6F]6@\ \~HM4H^YYx i N9Nb J 9 I 9J(() %[ 4>UiUp7)y7)tDIDNn"Vn"b6y6rIIIX88y88v& &R A A)" )"X( ( r