>dZddlmZddlmZddlmZddlZddlZddlmZddl m Z ddl m Z ddl Z dd l mZd Zed \ZZZZZd Zd ZdZdZdZdZdZdZdZy)zCommon resource topic text.)absolute_import)division)unicode_literalsN)api_lib)resource_printer)resource_transform)rangec d}ddddd}||vr4tdjdjt|| i}t j |D]5\}}||k(rd j| ||<!d j| ||<7t j|j|d|d|d|dS)a\Generates 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-neW }ELLMc%j?EEFc%j .  % , ,H 8;H 58Z>#.iD//#i""3'i#zz|nQ/Ry"''*?"@AB   G 33r&cdg}ttjtjD]\}}t |\}}}|j dj|||rYt||j d|D]'\}}|j dj||)|j d|st||j djd j| |j d t tj\}}}|rP|j d j|d d|D]'\}}|j dj||)|r;t||j djd j| |j dd j|S)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;mdG'> {?,-|$:;$. )[?FF[G: ;%/'"|$8??'''"@$%; f&;((&*"+z7/66$7&'", ;<CC;D89#- \"6== >"#d  r&c|jdr|jdSd}|j|r|t|dS|S)z6Returns string with Pythonic unused notation stripped.rIunused_N)r1rDlen)stringunuseds r$_StripUnusedNotationr]sH s ==  & v #f+,  -r&cd}|jsy|jjd\}}}t}d}|g}g}g} g} d} tj|j dD]=} | sd} | dk(r t }d} | dk(r t}d} %|tk(r/|tk(rt|| | } F|t k(r| jd rt| | | } n|tk(r"| jd rt|| d d| } |r t|}|r&||vr"| j|d j| f| jd s| jd rt}| jd \}}} |j}|j!d}| jg} @ddl}|j%|}t'|j(t'|j*xsgz }g}t-|j(D]\}}|r t|}||vr||z }|dk\r|j*|nd}|ct/|j1dd}|jdr|dd}|dk(rd}n|dk(rd}|jdj3|||j||j4r|j|j4dj3dj|}dj||| |fS)aKParses 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+q# ' #, ' $/)ooc"((.d i gi  gi I  I lD)!1Cg}-GW --c37o  # #D ))!"- G #! f $  nn1889:;nnV'6( __ NN7??#""499W+=">)   4 88r&c2g}ttj|D]\}}t|\}}}}|s|j dj ||||rYt ||j d|D]8\}}|j dj |||j d:|r;t ||j dj dj| |j d dj|S) 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:odI,DY,O)KD' BII YKJAB |$34" #{?FFG. /G$#|$8??'''"@$%#;$  r&c|dk(rtjSd}dj|} t||g}t ||}|S#t $rYywxYw)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$_GetApiTransformsrsiI  + + --+9@@S@I+  {m  B @A(  Ns B$ B$ )r< __future__rrrrr googlecloudsdkrgooglecloudsdk.core.resourcerrr six.movesr r%r>rlr@rArBr.r4rOrWr]rrrrr&r$rsy "&'"9; =O@BGq> 9o|Y04O4d$Nn9b>  r&