>SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSK J r SSK J r SSK r SS K Jr S r\"S 5urrrrrS rS rSrSrSrSrSrSrSrg)zCommon resource topic text.)absolute_import)division)unicode_literalsN)api_lib)resource_printer)resource_transform)rangec xSnSSSSS.nX;a1[SRSR[U55US 95e0n[R "U5H.upEX@:XaS RUS 9X4'MS RUS 9X4'M0 [ R"U5RUSUSUSUSS9$)aJGenerates resource help DESCRIPTION help text for name. This puts common text for the key, formats and projections topics in one place. Args: name: One of ['filter', 'format', 'key', 'projection']. Raises: ValueError: If name is not one of the expected topic names. Returns: A detailed_help DESCRIPTION markdown string. a Most *gcloud* commands return a list of resources on success. By default they are pretty-printed on the standard output. The *--format=*_NAME_[_ATTRIBUTES_]*(*_PROJECTION_*)* and *--filter=*_EXPRESSION_ flags along with projections can be used to format and change the default output to a more meaningful result. Use the `--format` flag to change the default output format of a command. {see_format} Use the `--filter` flag to select resources to be listed. {see_filter} Use resource-keys to reach resource items through a unique path of names from the root. {see_key} Use projections to list a subset of resource keys in a resource. {see_projection} Note: To refer to a list of fields you can sort, filter, and format by for each resource, you can run a list command with the format set to `text` or `json`. For example, $ gcloud compute instances list --limit=1 --format=text. To work through an interactive tutorial about using the filter and format flags instead, see: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/cloud-shell-tutorials&page=editor&tutorial=cloudsdk/tutorial.md filtersformatsz resource-keys projections)filterformatkey projectionz)Expected one of [{topics}], got [{name}].,)topicsnamez0Resource {topic}s are described in detail below.)topicz)For details run $ gcloud topic {command}.)commandrrrr) see_filter see_formatsee_keysee_projection) ValueErrorrjoinsortedsix iteritemstextwrapdedent)r descriptionrseerrs 3lib/googlecloudsdk/core/resource/resource_topics.pyResourceDescriptionr%!s+6 !  &   @GGxxv'dH4 55 # f-ne }ELLMcj?EEFcj .  % , ,H 8;H 58Z>#.iD//#i""3'i#zz|nQ/Ry"''*?"@AB   33r&c S/n[[R"[R"555Hup[ U5up4nUR SRXS95 U(aV[U5 UR S5 UH#upcUR SRXcS95 M% UR S5 U(dM[U5 UR SRS RU5S 95 M UR S 5 [ [R5up4nU(aJUR S RUS SS95 UH#upcUR SRXcS95 M% U(a8[U5 UR SRS RU5S 95 UR S5 S RU5$)zBReturns help markdown for all registered resource printer formats.z0The formats and format specific attributes are: z *{name}*:: {description} )rr"zThe format attributes are: z*{attribute}*::: {description} )rLr"::: For example: + {example} r6rH:: z {description}: + Nr))r"z*{attribute}*:: {description} r*) rrrrGetFormatRegistryrOr,rr.rPrinterAttributes)rFrrEr"rGrHrLs r$FormatRegistryDescriptionsrWsFF, mm$6689;md'> ?,-|$:;$. )?FFG: ;%/'"w|$8??'''"@$%; f&;((&*"+7/66$7&'", <CCD89#- \"6== >"#d  r&cURS5(aURS5$SnURU5(aU[U5S$U$)z6Returns string with Pythonic unused notation stripped.rIunused_N)r1rDlen)stringunuseds r$_StripUnusedNotationr]sN s ==  & v #f+,  -r&cSnUR(dgURRS5up#n[nSnU/n/n/n /n Sn [R"U5R S5GHmn U (dSn MU S:Xa [ nSn MU S:Xa [nSn M/U[:XaM;U[:Xa[X|U 5n MSU[ :Xa$U RS 5(a[XU 5n MU[:Xa'U RS 5(a[XS SU 5n MU(a [U5nU(a'Xa;a"U RUS RU 545 U RS 5(dU RS 5(a [nGM'U RS 5upcn UR5nUR!S5nU R5/n GMp SSKnUR%U5n['UR(5['UR*=(d /5- n/n[-UR(5HunnU(a [U5nUU;aM UU- nUS:aUR*UOSnUbh[/U5R1SS5nURS5(aUSSnUS:XaSnOUS:XaSnURSR3UUS95 MURU5 M UR4(aURUR45 SR3SRU5S9nSRU5UX4$)a#Parses the doc string for func. Args: func: The doc string will be parsed from this function. Returns: A (description, prototype, args) tuple: description - The function description. prototype - The function prototype string. args - A list of (name, description) tuples, one tuple for each arg. Example transform function docstring parsed by this method: '''Transform description. Example sections optional. These lines are skipped. Another skipped line. Args: r: The resource arg is always sepcified but omitted from the docs. arg-2-name[=default-2]: The description for arg-2-name. arg-N-name[=default-N]: The description for arg-N-name. kwargs: Omitted from the description. Example: One or more example lines for the 'For example:' section. ''' )kwargsrr)r6r6r6r6r*NFTzArgs:r8r9r:r0r7r;r'"zu"FalsefalseTruetruez{formal}={default_display})formaldefault_displayz ({formals})z, )formalsr6)r<r=r>r r!r? _DOC_ARGSrArBr4r1r]r,rr+rCrDinspectgetfullargspecrZargsdefaults enumeratereprreplacervarargs)func hidden_argsr"rIrJrKargrFrHroarg_descriptionr3r2rNrmargspecdefault_index_startrk formal_indexri default_indexdefaultrj prototypes r$_ParseTransformDocStringrs8.+   ..t4+# ' #, ' $/)ooc"((.d i gi  gi I  I l)!1Cg}-GW --c37o  # #D ) ))!"- G #! f $  nn1889:;nnV'6( __ NN7??#""499W+=">)   4 88r&c >/n[[R"U55Hup#[U5upEpgU(dMUR SR X%US95 U(aV[ U5 UR S5 UH4upUR SR XS95 UR S5 M6 U(a8[ U5 UR SR SRU5S 95 UR S 5 M SRU5$) zGenerates resource transform help text markdown for transforms. Args: transforms: The transform name=>method symbol table. Returns: The resource transform help text markdown for transforms. z% *{name}*{prototype}:: {description})rr~r"zThe arguments are: + z*```{arg}```*::: {description} )rwr"rQrRr6rSrT)rrrrr,rr.r) transformsrFr transformr"r~rorHrws r$TransformsDescriptionsrs, j 9:od,DY,O)KD BII KJAB |$34" #?FFG. /G$#|$8??'''"@$%#;$  r&cUS:Xa[R"5$SnSRUS9n[X!/S9n[ X15nU"5$![ a gf=f)z=Returns the transforms for api if it has a transforms module.builtin GetTransformsz'googlecloudsdk.api_lib.{api}.transforms)api)fromlistN)rrr __import__getattr ImportError)r method_name module_pathmodulemethods r$_GetApiTransformsrseI  + + --+9@@S@I+  m  B @A(  Ns B1 B1 )r< __future__rrrrr googlecloudsdkrgooglecloudsdk.core.resourcerrr six.movesr r%r>rlr@rArBr.r4rOrWr]rrrrr&r$rsy "&'"9; =O@BGq> 9o|Y04O4d$Nn9b>  r&