TSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SS KJr SS KJr SSKrS rS rS rSrS r\"/SQ5rSr"SS\5rSrSrSrSr "SS\RB"\RD\55r#"SS\#5r$Sr%g)z6The Calliope command help document markdown generator.)absolute_import)division)unicode_literalsN)base) usage_text) properties) console_io)universe_descriptorN)gcloudz gcloud alphaz gcloud betazgcloud previewc[R"SSU5n[R"SU5nU(a1URS5R 5URS5-nUR S5$)aReturns a help doc index line for a capsule line. The capsule line is a formal imperative sentence, preceded by optional (RELEASE-TRACK) or [TAG] tags, optionally with markdown attributes. The index line has no tags, is not capitalized and has no period, period. Args: capsule: The capsule line to convert to an index line. Returns: The help doc index line for a capsule line. z(\*?[\[(][A-Z]+[\])]\*? +)*z([A-Z])([^A-Z].*)r .)resubmatchgrouplowerrstrip)capsulers 'lib/googlecloudsdk/calliope/markdown.py_GetIndexFromCapsuler0s] FF12w ?' ((' 1% kk!n""$u{{1~5G  c*\rSrSrSrSrSrSrSrg)ExampleCommandLineSplitterGzExample command line splitter. Attributes: max_index: int, The max index to check in line. quote_char: str, The current quote char for quotes split across lines. quote_index: int, The index of quote_char in line or 0 if in previous line. cR[[- [- UlSUlSUlg)Nr)_SPLIT_SECTION_INDENT _FIRST_INDENT _max_index _quote_char _quote_indexselfs r__init__#ExampleCommandLineSplitter.__init__Ps#.>DODDrcSnSnSnSnSnSnXpR:aXnUS- nXR:XaSUlOUR(aUS:XaUS- nURnOaUS;aXlXplSnOLUS:XaUS- nO@XpR:a1US:XaXS:XaS nUnOU(aSnOUnOUS ;aUnOUS :XaSnXpR:aMS n [n U(a Un [n O.U(aUn US :XaSn OU S- n OU(aUn O URn XR::aSUlOSUl[ [ - U - UlUSU U SU -/XS4$)aSplits line into before and after, len(before) < self._max_index. Args: line: str, The line to split. Returns: (before, after) The line split into two parts. is a list of strings that forms the first line of the split and is a string containing the remainder of the line to split. The display width of is < self._max_index. contains the separator chars, including a newline. rNFr "'\-T),;/|=z\ r0 )r%r&r'r$_SUBSEQUENT_INDENTr"r#) r)line punct_indexquoted_space_indexquoted_space_quote space_index space_flagic separatorindent split_indexs r _SplitInTwo&ExampleCommandLineSplitter._SplitInTwoUsKKJ A oo  'a1fa      8 1u #//  ? 9 Q   8W^JKJK & &+ #X*; oo <I Fk!f &k s " q kOOk'''dd.7DO +  3< 8$|:L LLrc/n[U5UR:a?URU5up1URU5 [U5UR:aM?UR U5 SR U5$)zSplits a long example command line by inserting newlines. Args: line: str, The command line to split. Returns: str, The command line with newlines inserted. r)lenr%rEextendappendjoin)r)r:linesbefores rSplit ExampleCommandLineSplitter.Splitse E d)doo %%%d+lf ll6 d)doo % LL 775>r)r%r&r'N) __name__ __module__ __qualname____firstlineno____doc__r*rErN__static_attributes__rrrrGs FMPrrc [R"S[R[R-S9n[R"S[R[R-S9nUR U5nUR U5nU(d U(dU$U(aUnOUnUSUR S5nXR S5UR S5nXR S5Sn[R"S[R5n [R"S[R[R-5n Sn S n U R X{5n U R X{5nU(dU (dOU(aU (aUR S5U R S5:a8[X}R S55unnXXR S5U-- n Un OXXR S5- n UR S5n OeU(a'XXR S5- n UR S5n O7[X}R S55unnXXR S5U-- n Un GM*XlX{S--U-$) a2Removes line breaks and extra spaces in example commands. In command implementation, some example commands were manually broken into multiple lines with or without "". This function removes these line breaks and let ExampleCommandLineSplitter to split the long commands centrally. This function will not change example commands in the following situations: 1. If the command is in a code block, surrounded with ```sh...```. 2. If the values are within a quote (single or double quote). Args: doc: str, help text to process. Returns: Modified help text. z^## EXAMPLES\n(.+?)(\n+## ))flagsz^## EXAMPLES\n(.+)Nrz ^ *(\$ .*)$z^ *```sh(.+?```)rr)rcompileMDOTALLsearchstartendUnifyExampleLine)docexample_sec_until_next_secexample_sec_until_endmatch_example_secmatch_example_sec_to_endselected_matchdoc_before_examplesexample_sectiondoc_after_examplepat_example_linepat_code_blockposresmatch_example_linematch_code_blockexamplenext_poss rNormalizeExampleSectionrqs[& "zz$BDD299,< **244"))#3177<299#> #; J&N-N5n22156,,Q/.2D2DQ2GH/,,Q/12ZZ5::1244"))3CD. # # )00F%,,_B $6 0    "%7%=%=a%@ @, 55a8  s%=%=a%@AGKK s%9%9!%<==""1%  S#7#7#: ;;c   #c* 33A6gx S#;#;A#> ?' IIc c3 4 od&; ; 3w< ''<  # #A &'#&,,Q/+6n)n   +   #' :# GGB ' -g 6'    "(  !!rc[U5S- nUS:aXS:XaUS-nUS:a XS:XaM[U5U- S- $)Nrrr1)rH)rlindexs r_PrecedingBackslashCountr}-sN c(Q,%  szT) QJE  szT) SE A rc/nUR5nSnU[U5:GaXnUS;a6US:XaSnUS:XaU(a USS:XdURU5 US- nGO9US:XaURU5 US- nU[U5:a9XS:wa1URX5 US- nU[U5:a XS:waM1U[U5:aURX5 US- nOURX5 US- nU[U5:a_XS:Xa[U5S -S:XdEURX5 US- nU[U5:aXS:XdM1[U5S -S:XdMEU[U5:aURX5 US- nU[U5:aGMS R U5$) aReturns the example with redundant spaces and line breaks removed. If a character sequence is quoted (either single or double quote), we will not touch its value. Single quote is not allowed within single quote even with a preceding backslash. Double quote is allowed in double quote with preceding backslash though. If the spaces and line breaks are within quote, they are not touched. Args: example, str: Example line to process. rr.r8r-rr0r/r r)striprHrJr}rK)rorlrkrAs rrsrs4s # MMO' # c'l A  d 3h33r7c> 1  Qhc c jjm Qhc #g, 7<3#6 7<  q #g, 7<3#6 s7|  7<  q jj Qhc #g,  ,# ":3"?!"Cq"H 7<  q #g,  ,# ":3"?!"Cq"H s7|  7<  q; c'l> rc\rSrSrSrSr\RS5r\RS5r Sr \ S5r \ S5r \ S 5r\ S 5rS rS rS rSrSrSrS3SjrS4SjrS4SjrS4SjrS5SjrS5SjrS6SjrS7SjrS4SjrS4SjrS4Sjr S4Sjr!S8Sjr"S4Sjr#S4S jr$S9S!jr%S"r&S4S#jr'S6S$jr(S%r)S&r*S3S'jr+S(r,S)r-S*r.S+r/S,r0S-r1S.r2S/r3S:S0jr4S1r5S2r6g);MarkdownGeneratoridaZCommand help markdown document generator base class. Attributes: _buf: Output document stream. _capsule: The one line description string. _command_name: The dotted command name. _command_path: The command path list. _doc: The output markdown document string. _docstring: The command docstring. _file_name: The command path name (used to name documents). _final_sections: The list of PrintFinalSections section names. _is_hidden: The command is hidden. _out: Output writer. _printed_sections: The set of already printed sections. _release_track: The calliope.base.ReleaseTrack. cXlSRUR5UlSUlSUlSUlUR(aURSOSUl[R"5Ul URRUl SUl SUl SS/UlSUl0UlSRUR5Ul[%5UlX0lX l[%5Ulg)zConstructor. Args: command_path: The command path list. release_track: The base.ReleaseTrack of the command. is_hidden: The command is hidden if True. r-NrrEXAMPLESzSEE ALSO_) _command_pathrK _command_name _subcommands _subgroups_sort_top_level_args_topioStringIO_bufwrite_out_capsule _docstring_final_sections _arg_sections _sections _file_nameset _global_flags _is_hidden_release_track_printed_sections)r) command_path release_track is_hiddens rr*MarkdownGenerator.__init__vs&$"4"45DDDO $D)-););""1%DI DI DIDMDO& 3DDDNhht112DODO' UDrcg)aDetermines if the given sub command path is valid from this node. Args: sub_command_path: [str], The pieces of the command path. Returns: True, if the given path parts exist under this command or group node. False, if the sub path does not lead to a valid command or group. NrVr)sub_command_paths rIsValidSubPath MarkdownGenerator.IsValidSubPaths rcg)Returns the command arguments.NrVr(s r GetArgumentsMarkdownGenerator.GetArgumentss rcU(aU(dgSRU5nSU-S-SRU5-S-nU(aUSSRU5-- nU$)aCreates a link to the command reference from a command example. If with_args is False and the provided command includes args, returns None. Args: cmd: [str], a command. args: [str], args with the command. with_args: bool, whether the example is valid if it has args. Returns: (str) a representation of the command with a link to the reference, plus any args. | None, if the command isn't valid. Nr5zlink:[r-])rK)r)cmdargs with_argsref command_links r FormatExampleMarkdownGenerator.FormatExamplesY I  ((3-CS=3&#6Prints a positional or flag arg definition list item at depth.T) definitionr N {usage}{depth} :usagedepthzh + This {arg_type} argument must be specified if any of the other arguments in this group are specified.)arg_typerr  + z {details}{modal} )detailsmodal) rr rr_SECOND_LINE_OFFSET is_requiredr GetArgDetailsreplace)r)rrsinglerrrs r_PrintArgDefinition%MarkdownGenerator._PrintArgDefinitions  " "34$ GE  II##se.A&AB $   5 3))#./ e   2::67KGII$++G+IJrcUR(a"[UR[RS9O URn/nUR (d"UR (dUR(aUR (aURUR 5 UR(aO[U5S:XdUSR(a#UR(aURS5 OhUR (a5UR(aURS5 O4URS5 O"UR(aURS5 UR(dXU(aQURSRS U[--S RU55R!S S 55 S nUS- nUHnUR(aMUR"(a5S n[R$"U5nU(aUR (dUnOSnUR"(aUR'XbUS9 MUR)XbUS9 M g )z-Prints an arg group definition list at depth.)keyrrzThis must be specified.z'Exactly one of these must be specified:z&At most one of these can be specified:z(At least one of these must be specified:z {0} {1} rrrNFT)rr#) sort_argssorted argumentsr GetArgSortKeyhelpis_mutexr rJdisable_default_headingrHrrrrrKr"r GetSingleton_PrintArgGroupr$)r)rrr#rheadinga singletons rr0 MarkdownGenerator._PrintArgGroups == s}}*":":; ]] G xx3<<3?? sxx $ $ t9>T!W00 ?? ..2 3 << ?? ..B C ..A B ??AB ==W ii  U0017<<3H GFG $ g qje   ++A. AF  A6:    ?rc URSR[R"USS9SU[--S95 URSRUR U5S95 g)NrTr rr {arghelp} arghelp)rrrGetPositionalUsagerr!r)rrs rPrintPositionalDefinition+MarkdownGenerator.PrintPositionalDefinitionsfII##//dC!445 $   IIo$$T-?-?-D$EFrc U(dURS5 URSR[R"USS9SU[--S95 URSRUR U5S95 g ) zPrints a flags definition list item. Args: flag: The flag object to display. disable_header: Disable printing the section header if True. depth: The indentation depth at which to print arg help text. r8z{usage}{depth} Tr6rrr7r8N)rrr GetFlagUsagerr!)r)rrrs rPrintFlagDefinition%MarkdownGenerator.PrintFlagDefinitionsv  iioII!!))$>!445 "   IIo$$T-?-?-E$FGrcTU(dURUSS9 URU5 g)zPrints a flag section. Args: heading: The flag section heading name. arg: The flag args / group. disable_header: Disable printing the section header if True. FrN)rr0)r)r1rrs rPrintFlagSection"MarkdownGenerator.PrintFlagSections(  g51rc UR(agUR5 URH(nURURUR US9 M* UR (aU(d7URSRURR55SS9 URSRSR[UR 55UR55 gg)zqPrints the positionals and flags sections. Args: disable_header: Disable printing the section header if True. Nrz {} WIDE FLAGSFrCzN These flags are available to all commands: {}. Run *$ {} help* for details. z, )rrrrDr1rrrrrrrrKr)r)rrs r PrintPositionalsAndFlagsSections2MarkdownGenerator.PrintPositionalsAndFlagsSectionss  }} %%  //7<<&      " "499??#4 55   ii //5viit1123TYY0  rc^UR(aURSURUS9 gg)zzPrints the subgroup section if there are subgroups. Args: disable_header: Disable printing the section header if True. rrGN)rPrintCommandSectionrs rPrintSubGroups MarkdownGenerator.PrintSubGroups-s.    4??>rcUR(aJUR(aURSURSUS9 gURSURUS9 gg)z~Prints the subcommand section if there are subcommands. Args: disable_header: Disable printing the section header if True. TOPICT)rrr rGN)rrrLrs rPrintSubCommands"MarkdownGenerator.PrintSubCommands8s`         ) !    t(( ! rNcNXR;agURRX5nU(dg[U5(aU"5nOUnU(dUR U5 UR SR [R"U5R5S95 g)zPrint a section name if it exists. Args: name: str, The manpage section name. default: str, Default help_stuff if section name is not defined. disable_header: Disable printing the section header if True. Nz {message} )message) rrgetcallablerrrtextwrapdedentr)r)rdefaultr help_stuff help_messages rr&MarkdownGenerator.PrintSectionIfExistsKs %%% ##D2J   \ll  d#IIX__\%B%H%H%JKrc[URSS/-5n[UR5H0nUR 5(dMX2;dM!UR X1S9 M2 g)zPrint extra sections not in excluded_sections. Extra sections are sections that have not been printed yet. PrintSectionIfExists() skips sections that have already been printed. Args: disable_header: Disable printing the section header if True. NOTESrrGN)rrr)risupperr)r)rexcluded_sectionsrs rPrintExtraSections$MarkdownGenerator.PrintExtraSectionsbs[ )CDD$..)   w? !!'!I*rcfURHnURX!S9 M URUS9 g)ziPrint the final sections in order. Args: disable_header: Disable printing the section header if True. rGN)rrPrintNotesSectionrHs rPrintFinalSections$MarkdownGenerator.PrintFinalSectionsrs6 '' G(.9rc Sn[[R"U55HdupgUR(dUR(aM)USR SR URU/-5UURS9- nMf U(asU(dURUS-5 U(aURS5 O-URSR URU5S95 URU5 g g ) zPrints a group or command section. Args: name: str, The section name singular form. subcommands: dict, The subcommand dict. is_topic: bool, True if this is a TOPIC subsection. disable_header: Disable printing the section header if True. rz *link:{ref}[{cmd}]*:: {txt} r5)rrtxtSz#The supplementary help topics are: z{cmd} is one of the following: )rN) r)six iteritemsrrrrKr help_textrrr)r)r subcommandsrrcontent subcommand help_infos rrL%MarkdownGenerator.PrintCommandSection|sG!' k(B!C  3 3 3 7>>++zl:;##?   "D  s +  89 . 5 5$//$:O 5 P  iirc8URRS5$)z,Returns the explicit NOTES section contents.r^)rrUr(s rGetNotesMarkdownGenerator.GetNotess >>  g &&rcUR5nU(a5U(dURS5 U(aURUS-5 ggg)zjPrints the NOTES section if needed. Args: disable_header: Disable printing the section header if True. r^rN)rsrr)r)rnotess rrd#MarkdownGenerator.PrintNotesSections@ MMOE  (  %&.!  rc [USS5(a/[SRUR[US555e[R "XS9$)z4Returns the detailed help message for the given arg. detailed_helpNzA{}: Use add_argument(help=...) instead of detailed_help="""{}""".r)getattr ValueErrorrrrr!r;s rr!MarkdownGenerator.GetArgDetailssMsOT**  M 6$$$gc?&C D   # #C 55rc URU5n[U5n[R"S[[ - [ - -[R5nSnSnURX5nU(dObXAX5RS5[5RXRS5URS55-- nURS5nM{U(aXAUS-nU$)zExpand {...} references in doc.z^ *(\$ .{%d,})$rrrN) rrqrrYr"r$r#rZr\r]rrNr^)r)r`rzrkreprs r_ExpandFormatReferences)MarkdownGenerator._ExpandFormatReferencess   s #C !# &C **f}4FG C C C jj"e   {{1~ &)C)E)K)K kk!nuyy| ,*c IIaLc  cd)Oc Jrc\SRU5SRUR5:g$)Nr)rKr)r)rs r_IsNotThisCommand#MarkdownGenerator._IsNotThisCommands& 88C=CHHT%7%78 88rcSnSnURX5nU(dOURURS5RS55upxUR XxUS9n UR U5(a U (aXQXFR S5U -- nOXQXFRS5- nXQURS5URS5- nURS5nMU(aXQUS-nU$)aBuild a representation of a doc, finding all command examples. Finds examples of both inline commands and commands on their own line. Args: doc: str, the doc to find examples in. pat: the compiled regexp pattern to match against (the "command" match group). with_args: bool, whether the examples are valid if they also have args. Returns: (str) The final representation of the doc. rrrr-rr^N)r\rrsplitrrr]r^) r)r`rzrrkr~rrrlnks r _LinkMarkdownMarkdownGenerator._LinkMarkdowns C C jj"e  ,,U[[-C-I-I#-NOic   sI  >c   $ $ 3Y/0366 39-.. 9% %(8 99c IIe c  cd)Oc Jrc\SR[R"UR5S9$)zRegex to search for inline command examples enclosed in ` or *. Contains a 'command' group and an 'end' group which will be used by the regexp search later. Returns: (str) the regex pattern, including a format string for the 'top' command. zy(?{top}( [a-z][-a-z0-9]*)*)(?P\1)r rrescaperr(s rInlineCommandExamplePattern-MarkdownGenerator.InlineCommandExamplePatterns/ BBH& $))$CIC rcUR(dU$[R"UR55nUR XSS9nU$)z-Add ([`*])command ...\1 link markdown to doc.Fr)rrrYrrr)r`rzs r_AddCommandLinkMarkdown)MarkdownGenerator._AddCommandLinkMarkdownsA    j **T557 8C   S  7C Jrc\SR[R"UR5S9$)zRegex to search for command examples starting with '$ '. Contains a 'command' group and an 'end' group which will be used by the regexp search later. Returns: (str) the regex pattern, including a format string for the 'top' command. zU\$ (?P(?P{top}((?: (?!(example|my|sample)-)[a-z][-a-z0-9]*)*))).?[ `\n]rrr(s rCommandLineExamplePattern+MarkdownGenerator.CommandLineExamplePatterns%& ((.299TYY3G(HrcUR(dU$[R"UR55nUR XSS9nU$)z'Add $ command ... link markdown to doc.Tr)rrrYrrrs r_AddCommandLineLinkMarkdown-MarkdownGenerator._AddCommandLineLinkMarkdown'sA    j **T335 6C   S  6C JrcUR(dU$[R"SUR-S-5nSnSnUR X5nU(dOlUR S5R SS5nUR SS5nS U-S -U-S -nXAX5RS5U-- nURS 5nMU(aXAUS -nU$)z/Add ...(1) man page link markdown to doc.z(\*?(z(?:[-_ a-z])*)\*?)\(1\)rrr rr-r5z*link:rz]*rN) rrrYrr\rr"r]r^) r)r`rzrkr~rrrrs r_AddManPageLinkMarkdown)MarkdownGenerator._AddManPageLinkMarkdown/s    j **X ),FF GC C C jj"e  KKN " "3 ,c KKS !c sNS 3 & -c {{1~ & ,,c IIaLc  cd)Oc Jrc[R"S5nSnSnURU5Hn[R"SUR S55(a!UR UR S55nOUR S5nXAX5R S5U-- nURS5nM U(aXAUS-nU$)z>Change ``.*[[:alnum:]]{2,}.*'' quotes => _UserInput(*) in doc.z[^`](``([^`']*)'')rrz\w\wr rN)rrYfinditerr\rrr]r^)r)r`rzrkr~r quoted_strings r_FixAirQuotesMarkdown'MarkdownGenerator._FixAirQuotesMarkdownCs *** +C C Cc" 7EKKN + + A7  A  {{1~ & 66c IIaLc # cd)Oc Jrc[R"5(+=(a@ [UR[5(+=(a URR 5$N)rr isinstancerdictrr(s r_IsUniverseCompatible'MarkdownGenerator._IsUniverseCompatibleYsA  ( ( ** 14==$/ / 1 MM . . 0rcUR5(a+[R"S[R"5U5nU$)z-Replace static GDU Links with Universe Links.zcloud.google.com)rrrr GetUniverseDocumentDomainr)r`s r!_ReplaceGDULinksWithUniverseLinks3MarkdownGenerator._ReplaceGDULinksWithUniverseLinks`s:  !!## FF   7 7 9  c Jrc UcURR5nURU5nURU5nUR U5nUR U5nUR U5nURU5nU$)aGApplies edits to a copy of the generated markdown in doc. The sub-edit method call order might be significant. This method allows the combined edits to be tested without relying on the order. Args: doc: The markdown document string to edit, None for the output buffer. Returns: An edited copy of the generated markdown. )rgetvaluerrrrrrrs rEditMarkdownGenerator.Editns { II   c  & &s +C  * *3 /C  & &s +C  & &s +C  $ $S )C  0 0 5C JrcURSRURR555 UR 5 UR 5 UR 5 URS5 URS5 UR5 UR5 UR5 UR5 UR5 UR5$)zyGenerates markdown for the command, group or topic, into a string. Returns: An edited copy of the generated markdown. z # {0}(1) DESCRIPTIONr)rrrrrrrrrIrMrQrarerr(s rGenerateMarkdownGenerator.Generates  IIl!!$//"7"7"9:;((*m,j)))+ 99;r)rrrrrrrrrrrrrrrrrr)T)F)rF)r)Fr)NF)FFr)7rPrQrRrSrTr*abcabstractmethodrrrpropertyrrrrrrrrrrrrrrr$r0r<r@rDrIrMrQrrarerLrsrdr!rrrrrrrrrrrrrrUrVrrrrdsc"#6      .  " 6 6 % %    (2"97 $:L +ZK(0@dGH$ :  &.J :?DB' "6.9 B(.(, ,rrcJ^\rSrSrSrU4SjrSrSrSrSr Sr S r U=r $) CommandMarkdownGeneratoria'Command help markdown document generator. Attributes: _command: The CommandCommon instance for command. _root_command: The root CLI command instance. _subcommands: The dict of subcommand help indexed by subcommand name. _subgroups: The dict of subgroup help indexed by subcommand name. c>XlUR5 UR5Ul[[ U]UR5UR5UR55 URRUl URRUl URUR5 URR!SS5URS'URR#[%URS055 UR'5UlUR+5UlUR.R0Ulg)zConstructor. Args: command: A calliope._CommandCommon instance. Help is extracted from this calliope command, group or topic. rr descriptionryN)rLoadAllSubElements_TopCLIElement _root_commandsuperrr*GetPathrIsHidden short_helpr long_helpr_ExtractSectionsFromDocstringrrUupdaterzGetSubCommandHelpsrGetSubGroupHelpsrair(r)r)r __class__s rr*!CommandMarkdownGenerator.__init__sM   //1D "D27//173C3C3EMM,,DMmm--DO&&t7$(NN$6$6}b$IDNN=!NN'$--"EF224D..0DO ' 4 4DrcU(a"US(dUSSnU(a US(dMU(a"US(dUSSnU(a US(dMU(aSRU5URU'gg)zvSets section name help composed of lines. Args: name: The section name. lines: The list of lines in the section. rrNrr8)rKr)r)rrLs r_SetSectionHelp(CommandMarkdownGenerator._SetSectionHelpsg aABie a b CRje b  !YYu-dnnT rc@Sn/n[R"U5R5R5HSn[ U5S:a0UR S5(aUR X#5 USSn/nMBURU5 MU UR X#5 g)z1Extracts section help from the command docstring.rz## rN)rWrXr splitlinesrH startswithrrJ)r) docstringrrLr:s rr6CommandMarkdownGenerator._ExtractSectionsFromDocstrings D E *002==? TaDOOE22 T)ABx T@ %rc8URRU5$)zCReturns True if the given sub command path is valid from this node.)rrrs rr'CommandMarkdownGenerator.IsValidSubPaths    , ,-= >>rcBURRR$)r)rrr*r(s rr%CommandMarkdownGenerator.GetArgumentss ==   % %%rcjURRURRS55$)z?Returns the explicit and auto-generated NOTES section contents.r^)rGetNotesHelpSectionrrUr(s rrs!CommandMarkdownGenerator.GetNotess& == , ,T^^-?-?-H IIr)rrrrrrr) rPrQrRrSrTr*rrrrrsrU __classcell__)rs@rrrs-5.. &?&JJrrc4[U5R5$)zGenerates and returns the help markdown document for command. Args: command: The CommandCommon command instance. Returns: The markdown document string. )rr)rs rMarkdownrs "' * 3 3 55r)&rT __future__rrrrrrrWgooglecloudsdk.callioperrgooglecloudsdk.corergooglecloudsdk.core.consoler 'googlecloudsdk.core.universe_descriptorr rjr"r#r$r9r frozensetrrobjectrrqr_r}rswith_metaclassABCMetarrrrVrrrs =&' (.*2G   !#.ddNDQN5"p-`r **3;;?r jIJ0IJX 6r