, %SrSSKJr SSKJr SSKrSSKrSSKrSSKJ r J r SSK J r SSK Jr SSKJs Js Jr SSKJr SSKJ r SS KJr SS KJr SS KJr SS KJr SS KJ r! SSKJ"r# Sr$\%\&-\'-\(-r)"SS\ 5r*"SS\*SS9r+\RX"SSS9"SS55r-\#R\R^R`\-"SSS9\#R\R^Rb\-"SSS9\#R\R^Rd\-"SSS9\#R\R^Rf\-"SS S90r4S!\5S"'"S#S$\Rl5r7S,S%jr8SS&.S-S'jjr9S.S(jr:S/S)jr;\Rx\Rz"\R|R~5\R"S*S+\R5555rBg)0aLCommand to create a local manifest file from the SaaS Flags API. This command is used to create a local manifest file from the SaaS Flags API. The manifest file will contain all flags for the specified UnitKind. By default, the output file cannot already exist. Use `--overwrite-output-file` to allow overwriting an existing file. ) annotations)IterableN)Any TypedDict) exceptions) list_pager)base)flags)log) properties)files)saasservicemgmt_v1beta1_client) saasservicemgmt_v1beta1_messagesz9https://openfeature.dev/schemas/v1.0.0/flag-manifest.jsonc.\rSrSr%SrS\S'S\S'Srg) _FlagDefinitionBase3zA set of flag properties in JSON manifest schema format. Attributes: flagType: The type of the flag (e.g., 'boolean', 'string'). defaultValue: The default value of the flag. strflagType _FlagValue defaultValueN__name__ __module__ __qualname____firstlineno____doc____annotations____static_attributes__r&lib/surface/saas_runtime/flags/pull.pyrr3s -r rc$\rSrSr%SrS\S'Srg)_FlagDefinition>zA set of flag properties in JSON manifest schema format. Attributes: flagType: The type of the flag (e.g., 'boolean', 'string'). defaultValue: The default value of the flag. description: A human-readable description of the flag. r descriptionrNrrr r!r#r#>sr r#F)totalT)frozenslotsc.\rSrSr%SrS\S'S\S'Srg) _FlagTypeInfoJzA set of type-specific properties for a flag. Attributes: openfeature_type: The OpenFeature type name for the flag. default_value: The default value for this flag type. ropenfeature_typer default_valuerNrrr r!r*r*Jsr r*boolean)r,r-integerdoublegstringz=dict[ezmessages.Flag.ValueTypeValueValuesEnum, _FlagTypeInfo]_FLAG_TYPE_INFO_BY_VALUE_TYPEc\rSrSrSrSrg)InvalidFlagDataErrorsz.Invalid or unsupported flag data from the API.rN)rrrrrrrr r!r5r5ss6r r5cNU[;a[SU<SUS35e[U$)a Gets the type info or raises an error. Args: flag_type: The type enum from the API flag message. flag_key: The key of the flag (for error messages). Returns: The corresponding _FlagTypeInfo. Raises: InvalidFlagDataError: If the flag type is not supported. Flag z invalid. z is not a supported flag type.)r3r5) flag_typeflag_keys r!_GetFlagTypeInfor;xs>33  |:i[1   'y 11r flag_setc#^# [R"U[R"US9SSS9nU4SjU5ShvN gN![a e[ R a!n[R"SU<S35UeSnAff=f7f) a/Lists all flags for the given parent using automatic pagination. Args: flags_service: The SaaS Flags service client. parent: The parent resource name to list flags from. flag_set: The flag set ID to filter flags by. Yields: Flags from the API. Raises: ToolException: If the API call fails. )parentr pageSize)servicerequestfieldbatch_size_attributec3R># UHnTbURT:XdMUv M g7f)N)flagSet).0fr=s r! !_ListFlagsIter..s*!a   X 5 >s' 'NzFailed to retrieve flags for z from the SaaS Flags API.) r YieldFromList ezmessages0SaasservicemgmtProjectsLocationsFlagsListRequest GeneratorExitapitools_exceptions HttpErrorcalliope_exceptions ToolException) flags_servicer?r=flags_iteratores ` r!_ListFlagsIterrVs& --KK ' N!    & &  + + 'z1JK    s8B8AAABAB#A??BBc[URUR5nURURS.nUR (aUR US'U$)zConstructs a single flag entry for the manifest. Args: flag: The flag message from the API. Returns: A dictionary representing the flag definition in the manifest. )rrr%)r; valueTypekeyr,r-r%)flagflag_type_infoflag_definitions r!_ConstructFlagEntryr]sT$DNNDHH=.!11$22&/  %)%5%5OM" r c0nUHonUR(d[SUR<S35eURU;a[SUR<S35e[U5XR'Mq [US.$)aConstructs a JSON manifest file from an iterable of flags. Args: flags: An iterable of flag messages from the API. Returns: A dictionary representing the entire flag manifest. Raises: InvalidFlagDataError: If any flag data is invalid or duplicate. z;Flag invalid. "key" is required but missing for flag name: .r8z< is a duplicate. Cannot create manifest with duplicate keys.)z$schemar )rYr5namer]_OPENFEATURE_SCHEMA_URL)r manifest_flagsrZs r!_ConstructManifestrcs.d 88  ii]!    xx>! $((8 8  348N88") r cz\rSrSrSrS\R "S5\R "S5S.r\S5r Sr S r g ) Pullz?Command to create a JSON manifest file from the SaaS Flags API.zLCreate a JSON manifest file using the SaaS Flags API as the source of truth.a Creates a Flags manifest file under the specified location. The manifest file will contain all flags for the specified UnitKind. By default, the output file cannot already exist. Use `--overwrite-output-file` to allow overwriting an existing file. z To create a manifest file named `my_flags.json` in a home directory: $ {command} --output-file=~/my_flags.json --unit-kind=my-unit-kind )brief DESCRIPTIONEXAMPLEScURS[SSS9 URSSSSS 9 URS [SS S9 [R"USS S 9 g)zvRegisters flags for gcloud saas-runtime flags pull: --output-file, --unit-kind. Args: parser: The argparse parser. z --output-fileTzPath to the JSON manifest file that will be created containing the flag definitions. The manifest file will conform to the OpenFeature CLI flag manifest schema.)typerequiredhelpz--overwrite-output-file store_trueFzAOverwrite the output file if it already exists. Default is False.)actiondefaultrmz --flag-setzFlag set ID to filter flags by.z$UnitKind to pull all the flags from.)rl help_textN) add_argumentr arg_utilsAddUnitKindArgToParser)parsers r!Args Pull.Args s   5   ! O    . $$8r c [RRRR SS9nUR R R5nUR5R5n[R"SU5 [R"SUR5 [R"SUR 5 [R"SUR55 [R"SU5 [R"SUR55 [R"S UR55 [R"5nUR n[R"R%S U<S 35 ['XdUR(S 9n[+U5nUR-S 5(d%[R"R%SU<S35 g[R"R%S5 [.R0"USSSS9n [R"S[3UR-S /555 [4R6"UR8U UR:S9 [R"R%SUR8<35 g![4R<a*n [>R@"SUR8<35U eSn A ff=f)zExecutes the gcloud saas-runtime flags pull command. Args: args: An argparse namespace. All the arguments the command is called with. Raises: ToolException: If file writing fails or API call fails. T)rlz --project=%sz --location=%sz--unit-kind=%szParent reference: %szParent relative name: %szUnitKind Name: %szUnitKind RelativeName: %szFetching flags from z...r<r z No flags found or processed for z. No manifest file was created.NzEGenerating manifest. Using zero values as defaultValue for all flags.F)indent sort_keys ensure_asciiz!Manifest generated with %d flags.)pathcontents overwritez&Successfully created manifest file at zCould not write to output file )!r VALUEScoreprojectGetCONCEPTS unit_kindParseParent RelativeNamer debuglocationNamesaasservicemgmt_utilGetV1Beta1ClientInstanceprojects_locations_flagsstatusPrintrVr=rcgetjsondumpslenr WriteFileContents output_fileoverwrite_output_fileErrorrQrR) selfargsr unit_kind_refr?clientrSrT manifest_datamanifest_contentrUs r!RunPull.Run6sM$$,,00$0?GMM++113M  ! ! # 0 0 2FIIng&IIot}}-II/II$m&:&:&<=II(&1II!=#5#5#78II)=+E+E+GH ! : : rs#$ !>'JJ(EF#**tx@CZ% # % ) )  d$/  0 OO,,AA& OO,,@@-"COO,,CC% OO,,CC% % 8.<< 2>2JM226 ( P( (  (  ( V,#LD%%++,x4<<x -xr