^SrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK J r SSK Jr SSKJr SS KJr SSKJ r SS KJr SSKrS r\R."S \ R05r\R."S\ R05r\R6"S SS9r\R6"S SSS9r/SQrSS/rSr Sr!Sr"Sr#Sr$Sr%Sr&Sr'Sr(Sr)Sr*S r+S!r,S"r-S#r.S$r/0S%\,_S&\-_S'\"_S(\"_S)\._S*\/_S+\ _S,\ _S-\._S.\*_S/\ _S0\(_S1\+_S2\&_S3\%_S4\ _S5\"_\ \.\"\"\"\.\ \'\ \#\$\"S6. Er0S7r1S8r2S9r3S:r4S;r5S<r6S=r7\Rp"S>5r9S?r:S@r;\Rp"SA5rSDr?\Rp"SE5r@\Rp"SF5rASGrBSHrCSIrD\Rp"SJ5rESKrFg)Lz?A shared library to validate 'gcloud test' CLI argument values.)absolute_import)division)unicode_literalsN) exceptions)util) storage_util) arg_parsers)filesc~Uc[R"US5eU[;a[U"X5$[X5$)aDo checks/mutations on arg values parsed from YAML which need validation. Any arg not appearing in the _FILE_ARG_VALIDATORS dictionary is assumed to be a simple string to be validated by the default _ValidateString() function. Mutations of the args are done in limited cases to improve ease-of-use. This includes: 1) The YAML parser automatically converts attribute values into numeric types where possible. The os-version-ids for Android devices happen to be integers, but the Testing service expects them to be strings, so we automatically convert them to strings so users don't have to quote each one. 2) The include: keyword, plus all test args that normally expect lists (e.g. device-ids, os-version-ids, locales, orientations...), will also accept a single value which is not specified using YAML list notation (e.g not enclosed in []). Such single values are automatically converted into a list containing one element. Args: arg_internal_name: the internal form of the arg name. arg_value: the argument's value as parsed from the yaml file. Returns: The validated argument value. Raises: InvalidArgException: If the arg value is missing or is not valid. zno argument value found.)test_exceptionsInvalidArgException_FILE_ARG_VALIDATORS_ValidateStringarg_internal_name arg_values 8lib/googlecloudsdk/api_lib/firebase/test/arg_validate.pyValidateArgFromFiler&sL8  - -.?.H JJ..  1 23D PP * 661m6h) lower_bound upper_boundus)rr parsed_unit)portrait landscapedefaultallnonec [U[R5(aU/$[U[5(a [ U5/$[U[ 5(aUVs/sHn[ X5PM sn$[R"X5es snf)aValidates an arg whose value should be a list of strings. Args: arg_internal_name: the internal form of the arg name. arg_value: the argument's value parsed from yaml file. Returns: The validated argument value. Raises: InvalidArgException: the argument's value is not valid. ) isinstancesix string_typesintstrlistrr r )rrvalues rValidateStringListr*Tsy 3++,, ; 3  N  4  CL M9%O- 59 MM++,=II NsB c[U[R5(aU$[U[5(a [ U5$[ R "X5e)z7Validates an arg whose value should be a simple string.)r#r$r%r&r'r r rs rrrksD 3++,,  3 y>++,=IIrc\[U[5(aU$[R"X5e)z8Validates an argument which should have a boolean value.)r#boolr r rs r _ValidateBoolr.ts) 4  ++,=IIrcf[U[R5(a [U5$[U[5(a[[ U55$[R"X5e![ Ra0n[R"U[R"U55eSnAff=f)z9Validates an argument which should have a Duration value.N) r#r$r%TIMEOUT_PARSERr&r'r ArgumentTypeErrorr r text_typerres r_ValidateDurationr5}s@)S--.. I && Is # # C N ++ $ ++,=II  & &@  - -.?.1mmA.> @@@)A,(A,,B0+B++B0cf[U[R5(a [U5$[U[5(a[[ U55$[R"X5e![ Ra0n[R"U[R"U55eSnAff=f)zGValidates an argument which should have Duration value in microseconds.N) r#r$r%TIMEOUT_PARSER_USr&r'r r1r r r2r3s r_ValidateDurationUsr9s@)S--.. y )) Is # # s9~ .. $ ++,=II  & &@  - -.?.1mmA.> @@@r6c[U[5(a[[U55$[ R"X5e![R a0n[ R"U[R"U55eSnAff=f)z5Validates an argument which should be an integer > 0.N) r#r&POSITIVE_INT_PARSERr'r r1r r r$r2r3s r_ValidatePositiveIntegerr<s{@)S!! Y 00" ++,=II  & &@  - -.?.1mmA.> @@@(AB+BBc[U[5(a[[U55$[ R"X5e![R a0n[ R"U[R"U55eSnAff=f)z6Validates an argument which should be an integer >= 0.N) r#r&NONNEGATIVE_INT_PARSERr'r r1r r r$r2r3s r_ValidateNonNegativeIntegerr@s{@)S!! #C N 33" ++,=II  & &@  - -.?.1mmA.> @@@r=c[U[5(aU/n[U[5(aUVs/sHn[X5PM sn$[R "X5es snf)a Validates an arg whose value should be a list of ints > 0. Args: arg_internal_name: the internal form of the arg name. arg_value: the argument's value parsed from yaml file. Returns: The validated argument value. Raises: InvalidArgException: the argument's value is not valid. )r#r&r(r<r r )rrvs r_ValidatePositiveIntListrCsY 3 I 4  DM NIq $%6 :I NN++,=II OsA c[X5nUHn[U5 M [U5[[U55:wa[R "US5eU$)z=Validates that 'orientations' only contains allowable values.z!orientations may not be repeated.)r*_ValidateOrientationlensetr r )rr orientations r_ValidateOrientationListrIsU !2>)k%^s3y>**  - -> @@ rcDU[;a[R"U5eg)N)ORIENTATION_LISTr OrientationNotFoundError)rHs rrErEs!((  2 2; ??)rcHU[;a[R"US5eU$)Nz=Invalid permissions specified. Must be either "all" or "none")PERMISSIONS_LISTr r rs r_ValidatePermissionsrOs.&&  - -G II rch[X5n[U5S:a[R"US5eU$)z6Validates that 'obb-files' contains at most 2 entries.z'At most two OBB files may be specified.r*rFr r rs r_ValidateObbFileListrSs: !2>)^a  - -D FF rc[X5n[U5S:a[R"US5e[U5S:a[R"US5eU$)z;Validates that 'additional-apks' contains [1, 100] entries.rz,At least 1 additional apk must be specified.dz-At most 100 additional apks may be specified.rRrs r_ValidateAdditionalApksListrVsa !2>)^a  - -I KK^c  - -J LL rc[U5S:a[R"US5e[U5S:a[R"US5eU$)z;Validates that 'additional-ipas' contains [1, 100] entries.rz,At least 1 additional ipa must be specified.rUz-At most 100 additional ipas may be specified.)rFr r rs r_ValidateAdditionalIpasListrXsV^a  - -I KK^c  - -J LL rc[U[5(a40nUR5Hup4[X5U[ U5'M U$[ R "US5e)zDValidates that an argument is a dict of string-type key-value pairs.zMalformed key-value pairs.)r#dictitemsrr'r r )rrnew_dictkeyr)s r_ValidateKeyValueStringPairsr^s[ 4  H!) *+<Dhs3x* O  - -.?.J LLrcR[U[5(d[R"US5e/nUHrn[U[5(d[R"US5e0nUR 5HupV[ XV5U[U5'M URU5 Mt U$)zHValidates that an argument is a list of dicts of key=value string pairs.z)is not a list of maps of key-value pairs.z7Each list item must be a map of key-value string pairs.) r#r(r r rZr[rr'append)rrnew_lista_dictr\r]r)s r"_ValidateListOfStringToStringDictsrcs It $ $  - -F HH (f fd # #  / /  C EEH  *36hs3x' OOH /radditional_apksadditional_ipasasync_auto_google_loginclient_detailsdevice device_idsdirectories_to_pullenvironment_variablesgrant_permissionslocales orientations obb_filesnum_flaky_test_attemptsnum_uniform_shardstest_targets_for_shardtest_special_entitlements) os_version_ids other_filesperformance_metrics record_videoresignrobo_directivesscenario_labelsscenario_numbers test_targetstimeout timeout_ususe_orchestratorc4US:XagURSS5$)zFConverts a user-visible arg name into its corresponding internal name.asyncrf-_)replace)arg_external_names rInternalArgNameFromr;s"'!   " "3 ,,rcX!SUS-nX!SUS-nXV-nUH=n[XS5cMX;dM[R"USRU55e UHYn[XS5bM[R "SR[R "U55SRU55e g)a<Raise errors if required args are missing or invalid args are present. Args: args: an argparse.Namespace object which contains attributes for all the arguments that were provided to the command invocation (i.e. command group and command arguments combined). test_type: string containing the type of test to run. type_rules: a nested dictionary defining the required and optional args per type of test, plus any default values. shared_rules: a nested dictionary defining the required and optional args shared among all test types, plus any default values. all_test_args_set: a set of strings for every gcloud-test argument to use for validation. Raises: InvalidArgException: If an arg doesn't pair with the test type. RequiredArgumentException: If a required arg for the test type is missing. requiredoptionalNz%may not be used with test type [{0}].z{0}z'must be specified with test type [{0}].)getattrr r formatrRequiredArgumentExceptionExternalArgNameFrom) args test_type type_rules shared_rulesall_test_args_set required_args optional_argsallowable_args_for_typeargs rValidateArgsForTestTyperJs(' 3l:6NN-' 3l:6NN-)9ct$+ +11 8?? JL L ct$'  0 0 ,,::3? @ 3 : :9 E GGrcURcg[RRURSS9nURUlg![a0n[ R "S[R"U55eSnAff=f)zDo some basic sanity checks on the format of the results-bucket arg. Args: args: the argparse.Namespace containing all the args for the command. Raises: InvalidArgumentException: the bucket name is not valid or includes objects. NF)require_prefixzresults-bucket) results_bucketrBucketReference FromArgument ExceptionrInvalidArgumentExceptionr$r2bucket)r bucket_referrs rValidateResultsBucketrps   B--::4;N;NJO;QJ #))$ B  - -.>.1mmC.@ BBBs(A B+A??BcTUR(d[5UlgURRS5UlSUR;dSUR;a[R"SS5e[ UR5S:a[R"SS5eg) zSanity checks the results-dir arg and apply a default value if needed. Args: args: the argparse.Namespace containing all the args for the command. Raises: InvalidArgumentException: the arg value is not a valid cloud storage name. N/  z results-dirz3Name may not contain newline or linefeed charactersizName is too long) results_dir_GenerateUniqueGcsObjectNamerstriprrrF)rs rValidateResultsDirrs   35D %%,,S1$ T  )9)9!9  - -L NN   S  - -m=O PP!rc SR[RR5R[R (aSOS5SR [R"[RS555$)aCreate a unique GCS object name to hold test results in the results bucket. The Testing back-end needs a unique GCS object name within the results bucket to prevent race conditions while processing test results. By default, the gcloud client uses the current time down to the microsecond in ISO format plus a random 4-letter suffix. The format is: "YYYY-MM-DD_hh:mm:ss.ssssss_rrrr". Returns: A string with the unique GCS object name. z{0}_{1}_r) rdatetimenow isoformatr$PY2joinrandomsamplestring ascii_lettersrrrrs\   ''SA277 --,,a 0D2 33rcUR(dg[5nURH&nURSU5nURU5 M( [ U5Ulg)aValidate os-version-ids strings against the TestEnvironmentCatalog. Also allow users to alternatively specify OS version strings (e.g. '5.1.x') but translate them here to their corresponding version IDs (e.g. '22'). The final list of validated version IDs is sorted in ascending order. Args: args: an argparse namespace. All the arguments that were provided to the command invocation (i.e. group and command arguments combined). catalog_mgr: an AndroidCatalogManager object for working with the Android TestEnvironmentCatalog. Nversion)rurGValidateDimensionAndValueaddsorted)r catalog_mgrvalidated_versionsvers version_ids rValidateOsVersionsrsX    u!!d66y$GJ:&"12$rc^UR(aURUR5 gg)zEValidates an Xcode version string against the TestEnvironmentCatalog.N) xcode_versionValidateXcodeVersion)rrs rrrs$ $$T%7%78rz2(.*[\\/:])?(main|patch)\.\d+(\.[a-zA-Z]\w*)+\.obb$cnU(aWUVs/sHFnU(a$UR[R5(aUO[R"U5PMH snUSS&U=(d /HCn[ R U5(aM[R"SSRU55e gs snf)zConfirm that any OBB file names follow the required Android pattern. Also expand local paths with "~" Args: obb_files: list of obb file references. Each one is either a filename on the local FS or a gs:// reference. Nrpzm[{0}] is not a valid OBB file name, which must have the format: (main|patch)...obb) startswithrGSUTIL_BUCKET_PREFIXr ExpandHomeDir_OBB_FILE_REGEXmatchr r r)rpobb_files r NormalizeAndValidateObbFileNamesrs7@7@(!L==>>  H% &6?IaL ??h   * *  / /  ::@&:J LL# sA B2cJ[5n[5n[R"UR=(d 05Hup4[R "U5upVUS;a-U(a&[ R"SSRX455eU(d&[ R"SSRU55eXa;aURU5 MURU5 M U(a5[ R"SSRSRU555eg)z5Validates key-value pairs for 'robo_directives' flag.)clickignorerzz>Input value not allowed for click or ignore actions: [{0}={1}]z$Missing resource_name for key [{0}].z0Duplicate resource names are not allowed: [{0}].z, N) rGr$ iteritemsrzrParseRoboDirectiveKeyr r rrr)rresource_names duplicatesr]r) action_type resource_names rValidateRoboDirectivesListrs5.u*MM4#7#7#=2?jc#'#=#=c#B [))e  / /  J 6#     / / CJJ3O QQ&nn]#'#@&  - -:AA IIj ! # $$rz^[a-zA-Z][\w.-]+$cUR=(d /HCn[RU5(aM[R"SSR U55e g)z;Validates key-value pairs for 'environment-variables' flag.rlz"Invalid environment variable [{0}]N)rl_ENVIRONMENT_VARIABLE_REGEXrr r r)rr]s r ValidateEnvironmentVariablesListrsO((.B.c & , ,S 1 1  / / ! . 5 5c : <</rz1^/?/(?:sdcard|data/local/tmp)(?:/[\w\-\.\+ /]+)*$c$U(a2UVs/sH!o(a[R"U5OUPM# snUSS&U=(d /HCn[RU5(aM[R "SSR U55e gs snf)zValidate list of file paths for 'directories-to-pull' flag. Also collapse paths to remove "." ".." and "//". Args: dirs: list of directory names to pull from the device. NrkInvalid path [{0}]) posixpathabspath_DIRECTORIES_TO_PULL_PATH_REGEXrr r r)dirspath file_paths r)NormalizeAndValidateDirectoriesToPullListrs~ EIJTT$y  &D8TJDGJBJi * 0 0 ; ;  / / !5! 0.z game-loopNr|)typer|r<)rnums rValidateScenarioNumbersr=sL YY+T%:%: &*&;&;=&;s44FL&;=$=sAcrUR(dgURHnUR5Hup4URX45X#'M SU;aUR5US'SU;aUR 5US'SU;aUR 5US'SU;dMUR 5US'M g)zFValidates that --device contains a valid set of dimensions and values.NmodelrlocalerH)rir[rGetDefaultModelGetDefaultVersionGetDefaultLocaleGetDefaultOrientation)rr device_specdimvals rValidateDeviceListrEs  [[k!'') $>>sHk*k!(88:k' #*<<>k){")::rs F&' N=7/.* !7J",,Q <$//3;;?%%$DI(($D:76?J.JJ J JJJJ(@   L(22 m  2   0 $-9-!,%:2 0!" #$)/(!3)0& %%;B-#GL*(Q.3"3,9 **9;L.$<!jj)=><#%**8#:I(** ,-$M2A$=G(')jjA'C#Ir