s$dZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd l m Z dd l Z e jrd Zd ZdZndZdZdZdZdZdZdZGdde j,ZdZy )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 positionalgroupcN|dk(rd}tjj|S)z-Returns the base.ReleaseTrack for release_id.INTERNALGA)r ReleaseTrackFromId) release_ids 0lib/googlecloudsdk/calliope/cli_tree_markdown.py_GetReleaseTrackFromIdrBs&:J   ! !* --ctttf|}d|_|j t j |j dd|_|j|_d|_ |j t j|j t jd|_ |j|_ |j|_|j j#j%dd|_|j(|_|j g|_t/|dsd|_|jdk(rd|_n|j2d vrd |_|jd k(rt5j6|_n?|jd k(rt5j8|_n|jd k(rd|_|j:j t j<rd|_|j:j d}|rkt j@|vrd}|t j@}nd}|jdk(rdnd}tCjD|t jF||f|_$|S)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]]8445!D z "$ $ d8(()eeyyF*Vdd8#7#789  D +rctttf|}|j|_d|_d|_d|_|jdk7|_ |jjjdd|_ |j|_g|_ t!|j|_|S#t"$rY|SwxYw)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 CCc|jtjdr t|S|jtjds t |St ttf|}|jtjgDcgc] }t|c}|_ d|_ |j|_d|_d|_d|_d|_|Scc}w)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 ( (%0 a= x'' / 7N  1 -%*+%%0I0I2*NO*NQXa[*NO%/%.  %*%/%/%/"'% ,PsCcbeZdZdZfdZdZdZdZd dZd dZ dZ d Z d fd Z d Z xZS)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 F||_||_|tj|_t t ||jt|jtj|jjtj|jjdd|jtj|_ |jtj|_|j!|_|j%|_d|_y)znConstructor. 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 rrcz!CliTreeMarkdownGenerator.__init__sDJDM !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)rwrDEFAULT_CLI_NAME)rnrts rIsValidSubPathz'CliTreeMarkdownGenerator.IsValidSubPaths-   (";";!<|!KL rc|j|j} |tjtjDcgc] }t |c}Scc}w#t tf$rgcYSwxYw)zReturns the command arguments.)rwrarLOOKUP_CONSTRAINTSrSrTKeyError TypeError)rnrorZs r GetArgumentsz%CliTreeMarkdownGenerator.GetArgumentss&&t'9'9:G8667''  a 1+  i  is#&AAAAA10A1c|jS)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)rnargdepths r GetArgDetailsz&CliTreeMarkdownGenerator.GetArgDetailss  88Orctj|jtjDcic]\}}|tj |k(rr|t j|tj|jtj|jddt|tjc}}Scc}}w)zDReturns the help dict indexed by command for sub commands or groups.rF) help_textr- release_track) six iteritemsr_rrsrQr HelpInforer+r,rrd)rnr*r5 subcommands r _GetSubHelpz$CliTreeMarkdownGenerator._GetSubHelps!$ MM(22 3!  ! D* h.. /8 ; j!! !8!89 nn)):>>(E+J18223   !   sBC c&|jdS)z7Returns the subcommand help dict indexed by subcommand.Fr*rrns rriz*CliTreeMarkdownGenerator.GetSubCommandHelps   U  ++rc&|jdS)z3Returns the subgroup help dict indexed by subgroup.Trrrs rrkz(CliTreeMarkdownGenerator.GetSubGroupHelp s   T  **rcft|tr t|}tt|||y)z$Prints a flags definition list item.)disable_headerN) isinstancer"rIrbr\PrintFlagDefinition)rnr rrqs rrz,CliTreeMarkdownGenerator.PrintFlagDefinitions0$ $Zd "D= ^>rc|S)z7{...} references were done when the tree was generated.)rndocs r_ExpandHelpTextz(CliTreeMarkdownGenerator._ExpandHelpTexts Jr)N)F)__name__ __module__ __qualname____doc__rcrwrzrrrrirkrr __classcell__)rqs@rr\r\s: %."  $,+rr\c6t||jS)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)rorps rMarkdownrs "'4 0 9 9 ;;r)r __future__rrrgooglecloudsdk.callioperrrr r googlecloudsdk.corer rPY2r(rKrRrrIrNrTMarkdownGeneratorr\rrrrrs 6''/(,,.* 77.&/.%/.-`$"|x99|~