s$SrSSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SS KJ r SS K J r SS K r \ R(aS rS rSrOSrSrSrSrSrSrSr"SS\ R,5rSrg )a<The cli_tree command help document markdown generator. This module generates command help markdown from the tree generated by: gcloud --quiet alpha # make sure the alpha component is installed gcloud --quiet beta # make sure the beta component is installed gcloud meta list-gcloud --format=json | python -c " import json import sys data = json.load(sys.stdin) print 'gcloud_tree =', data" > gcloud_tree.py Usage: from googlecloudsdk.calliope import cli_tree_markdown from googlecloudsdk.command_lib.shell import gcloud_tree command = flag = generator = cli_tree_markdown.CliTreeMarkdownGenerator(command, gcloud_tree) generator.PrintSynopsisSection() generator.PrintFlagDefinition(flag) ... markdown = generator.Edit() )absolute_import)division)unicode_literals) arg_parsers)base)cli_tree)markdown) usage_text) propertiesNsflags positionalsgroupflag positionalgroupcPUS:XaSn[RRU5$)z-Returns the base.ReleaseTrack for release_id.INTERNALGA)r ReleaseTrackFromId) release_ids 0lib/googlecloudsdk/calliope/cli_tree_markdown.py_GetReleaseTrackFromIdrBs&:J   ! !* --c<[[[4U5nSUlUR [ R UR SS55UlURUlSUl UR [ RUR [ RS55Ul URUl URUlUR R#5R%SS5UlUR(UlUR /Ul[/US5(dSUlURS:XaSUlOUR2S ;aS UlURS :Xa6"5UlOBURS :Xa8"5UlOURS :XaSUlUR:R [ R<5(aSUlUR:R S5nU(ao[ R@U;aSnU[ R@nOSnURS:XaSOSn[BRD"U[ RF5UU4Ul$U$)z@Returns a flag object suitable for the calliope.markdown module.Fhidden-_defaultNboolr)?*+dictliststringTpropertyvalue)%typeFLAG_TYPE_NAMEobjectis_groupgetrLOOKUP_IS_HIDDEN is_hiddenr is_positionalLOOKUP_IS_REQUIREDLOOKUP_REQUIRED is_requiredrequired descriptionhelpnamelowerreplacedestr&metavaroption_stringshasattrrnargsrArgDictArgListattrLOOKUP_INVERTED_SYNOPSISinverted_synopsis LOOKUP_VALUEr FromString LOOKUP_NAMEstore_property)dr propkindr&s rFlagrIIs nvi +$$-5522AEE(E4JK$.$+$UU!!155)A)A5#I$""$-$)iioo''S1$)$, $ y ! !DL YY&DJ zz(DJ YY&##%DI yyF##%DI yyHDI YY]]84455!D z "$ $ d8(()eeyyF*Vdd8#7#789  D +rc[[[4U5nURUlSUlSUlSUlURS:gUl URR5RSS5Ul URUl/Ul[!UR5UlU$!["a U$f=f)zFReturns a positional object suitable for the calliope.markdown module.FTrrr)r'POSITIONAL_TYPE_NAMEr)r3r4r*r-r.r<r1r&r6r7r8r9r:int ValueError)rFr s r PositionalrNys(6)Q7****/**!*%++s2*$$**,44S#>*/!''* * :++,J     sB55 CCcUR[RS5(a [U5$UR[RS5(d [ U5$[ [[4U5nUR[R/5Vs/sHn[U5PM snUl SUl URUlSUlSUlSUlSUlU$s snf)zEReturns an argument object suitable for the calliope.markdown module.FNT)r+rLOOKUP_IS_POSITIONALrNLOOKUP_IS_GROUPrIr'GROUP_TYPE_NAMEr)LOOKUP_ARGUMENTSArgument argumentscategoryr3r4 is_globalr- sort_argsdisable_default_heading)rFras rrTrTsUU8 ( (%00 a= x'' / / 7N  1 -%*+%%0I0I2*NO*NQXa[*NO%/%.  %*%/%/%/"'% ,PsC,ct^\rSrSrSrU4SjrSrSrSrSSjr SSjr S r S r SU4S jjr S rS rU=r$)CliTreeMarkdownGeneratoracli_tree command help markdown document generator. Attributes: _capsule: The help text capsule. _command: The tree node for command. _command_path: The command path list. _tree: The (sub)tree root. _sections: The help text sections indexed by SECTION name. _subcommands: The dict of subcommand help indexed by subcommand name. _subgroups: The dict of subgroup help indexed by subcommand name. c B>X lXlU[RUl[ [ U]UR[UR[R5URR[RURRSS555 UR[RUl UR[RUlUR!5UlUR%5UlSUlg)z^Constructor. Args: command: The command node in the root tree. tree: The (sub)tree root. rFTN)_tree_commandr LOOKUP_PATH _command_pathsuperr\__init__rLOOKUP_RELEASEr+r,LOOKUP_CAPSULE_capsuleLOOKUP_SECTIONS _sectionsGetSubCommandHelp _subcommandsGetSubGroupHelp _subgroups_sort_top_level_args)selfcommandtree __class__s rrd!CliTreeMarkdownGenerator.__init__sJM !5!56D "D2 t}}X-D-DEF   % %t}}'8'85'I MM("9"9:DM]]8#;#;Returns True if the given command path after the top is valid.N)ryrDEFAULT_CLI_NAME)rorvs rIsValidSubPath'CliTreeMarkdownGenerator.IsValidSubPaths-   (";";!<|!KL rcURUR5nU[R[RVs/sHn[ U5PM sn$s snf![ [4a /s$f=f)zReturns the command arguments.)ryrbrLOOKUP_CONSTRAINTSrSrTKeyError TypeError)rorprZs r GetArguments%CliTreeMarkdownGenerator.GetArgumentss&&t'9'9:G8667''  a 1+  i  is#&A AA A A54A5cUR$)aReturns the help text with auto-generated details for arg. The help text was already generated on the cli_tree generation side. Args: arg: The arg to auto-generate help text for. depth: The indentation depth at which the details should be printed. Added here only to maintain consistency with superclass during testing. Returns: The help text with auto-generated details for arg. )r4)roargdepths r GetArgDetails&CliTreeMarkdownGenerator.GetArgDetailss  88Orc[R"UR[R5VVs0sHup#U[R U:XdMU[ R"U[RUR[RURSS55[U[R5S9_M snn$s snnf)zDReturns the help dict indexed by command for sub commands or groups.rF) help_textr- release_track) six iteritemsr`rrurQr HelpInforfr+r,rre)ror*r5 subcommands r _GetSubHelp$CliTreeMarkdownGenerator._GetSubHelps!$ MM(22 3!  ! D h.. /8 ; j!! !8!89 nn)):>>(E+J18223   !   s CA4Cc URSS9$)z7Returns the subcommand help dict indexed by subcommand.Fr*rros rrj*CliTreeMarkdownGenerator.GetSubCommandHelps   U  ++rc URSS9$)z3Returns the subgroup help dict indexed by subgroup.Trrrs rrl(CliTreeMarkdownGenerator.GetSubGroupHelp s   T  **rch>[U[5(a [U5n[[U]XS9 g)z$Prints a flags definition list item.)disable_headerN) isinstancer"rIrcr\PrintFlagDefinition)ror rrrs rr,CliTreeMarkdownGenerator.PrintFlagDefinitions1$ $Zd "D= >rcU$)z7{...} references were done when the tree was generated.)rodocs r_ExpandHelpText(CliTreeMarkdownGenerator._ExpandHelpTexts Jr)rgr`rbrirnrkrmr_)N)F)__name__ __module__ __qualname____firstlineno____doc__rdryr}rrrrjrlrr__static_attributes__ __classcell__)rrs@rr\r\s? %."  $,+rr\c4[X5R5$)zReturns the help markdown document string for the command node in tree. Args: command: The command node in the root tree. tree: The (sub)tree root. Returns: The markdown document string. )r\Generate)rprqs rMarkdownrs "' 0 9 9 ;;r)r __future__rrrgooglecloudsdk.callioperrrr r googlecloudsdk.corer rPY2r(rKrRrrIrNrTMarkdownGeneratorr\rrrrrs 6''/(,,.* 77.&/.%/.-`$"|x99|~