\OSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSKJ r SS KJ r SS KJ r SS K Jr SS KJr SS KJr SSKJr SSKr/SQr"SS\ R,5r"SS\ R,5r"SS\ R,5r"SS\5r"SS\5r"SS\5r"SS\ R,5r"SS\ R,5rg) zA collection of CLI walkers.)absolute_import)division)unicode_literalsN)actions) arg_parsers)cli_tree)markdown)walker) properties)render_document)files) pkg_resources)z favicon.icoz index.htmlz _menu_.cssz _menu_.jsz _title_.htmlcF^\rSrSrSrSrSrS U4SjjrSrSr Sr U=r $) DevSiteGenerator.aGenerates DevSite reference HTML in a directory hierarchy. This implements gcloud meta generate-help-docs --manpage-dir=DIRECTORY. Attributes: _directory: The DevSite reference output directory. _need_section_tag[]: _need_section_tag[i] is True if there are section subitems at depth i. This prevents the creation of empty 'section:' tags in the '_toc' files. _toc_root: The root TOC output stream. _toc_main: The current main (just under root) TOC output stream. z/sdk/gcloud/referencez _toc.yamlc >[[U] XS9 X l[R "UR5 /Ul[RRURUR5n[R"U5Ul URRS5 URRS5 URRSUR-5 URRS5 SUlg)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The devsite output directory path name. hidden: Boolean indicating whether to consider the hidden CLI. progress_callback: f(float), The function to call to update the progress bar or None for no progress bar. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. restricttoc: z- title: "gcloud Reference" path: %s z section: N)superr__init__ _directoryr MakeDir_need_section_tagospathjoin_TOC FileWriter _toc_rootwrite _REFERENCE _toc_main)selfcli directoryhiddenprogress_callbackrtoc_path __class__s *lib/googlecloudsdk/calliope/walker_util.pyrDevSiteGenerator.__init__>s  D*3*BO MM$//"Dww||DOOTYY7H%%h/DNNN"NN89NN$//9:NN(DNc B^^^ ^ U U UU4SjnUR5m T(aD[RR"TR/T SSQ76m [ R "T SS9 O.[RR"TR/T SSQ76m [RRT T(aSOT S5S-nSn[RRRR5(a2[RRRR5n[RRRRS 5 [ R"U5n[R "U5n["R$"S S RT 5[&R("U5UUS 9 SSS5 [RRRRU5 U"5 U$!,(df  NJ=f) a)Updates the TOC and Renders a DevSite doc for each node in the CLI tree. Args: node: group/command CommandCommon info. parent: The parent Visit() return value, None at the top level. is_group: True if node is a group, otherwise its is a command. Returns: The parent value, ignored here. c >[T5S- nU(dgSRT5nU[TR5:a6TRRS5 U[TR5:aM6US:XGa?T(aTR(aTRR 5 [ RRTTR5n[R"U5nUTlURS5 URSU-5 URSSRTR/TSS-5-5 S TRU'TRnS nT(aHURU<S SRTR/TSS-TR/-5<S 35 gOVTRnS US- -nTRUS- (a&STRUS- 'URS U-5 TSnURU<SU<S35 URU<SSRTR/TSS-5<S 35 TTRU'g)zUpdates the DevSIte TOC.N Frz- title: "%s" r/Tz z - include:  z %ssection: z - title: "z" z path: )lenrrappendr$closerrrr r r"r#r!) depthtitler*tocindentcommandr'is_groupr%s r, _UpdateTOC*DevSiteGenerator.Visit.._UpdateTOCfs'lQe hhwe S//0 0 %%e, S//0 0 !  ^^ NN "WW\\)TYY7(  *#$. ))H  ))%- . ))NSXXt.?'!"+.M%NN O*.$  'nn  ))((DOO,wqr{:dii[HI   nn#  ! !%!) ,.3$  + ))NV+ ,  iivu56 ii$chh/@712;/N&O P'/dU#r.r1Nmoder5index.htmluniversedevsiter2)styler:finout command_node)GetPathrrrrr rr VALUEScoreuniverse_domainIsExplicitlySetGetSetr r Markdownr RenderDocumentioStringIO) r%nodeparentr>r?rrOfmdr=r's ` ` @@r,VisitDevSiteGenerator.VisitZs,/,/^llnG'',,t==i mmIE*'',,t?2?i  Y8EO O--==??"))..>>BBDo**..z:   $ 1   T "b$$!kk"o  **..?L M s :AH HcURR5 UR(aURR5 gg)z5Closes the TOC files after the CLI tree walk is done.N)r!r8r$)r%s r,DoneDevSiteGenerator.Dones.NN ~~ nnr.)rrr$r!FNN) __name__ __module__ __qualname____firstlineno____doc__r#rrr[r^__static_attributes__ __classcell__r+s@r,rr.s1 '* $LP8]~r.rc8^\rSrSrSrSU4SjjrSrSrU=r$)HelpTextGeneratorzoGenerates help text files in a directory hierarchy. Attributes: _directory: The help text output directory. cv>[[U] XUS9 X l[R "UR5 g)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The Help Text output directory path name. hidden: Boolean indicating whether to consider the hidden CLI. progress_callback: f(float), The function to call to update the progress bar or None for no progress bar. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. )r)rN)rrjrrr rr%r&r'r(r)rr+s r,rHelpTextGenerator.__init__s6  T+ 8, O MM$//"r.cPUR5nU(a/[RR"UR/USSQ76nO.[RR"UR/USSQ76n[ R "USS9 [RRXS(aSOUS5n[ R"U5n[R"U5n[R"S[R"U5US9 SSS5 U$!,(df  U$=f) aRenders a help text doc for each node in the CLI tree. Args: node: group/command CommandCommon info. parent: The parent Visit() return value, None at the top level. is_group: True if node is a group, otherwise its is a command. Returns: The parent value, ignored here. r1Nr5rArBGROUPtext)rHrIrJ)rLrrrrr rr r rSr rTrUrV) r%rWrXr>r=r'rrYrZs r,r[HelpTextGenerator.VisitsllnG'',,t==i'',,t?2?i MM)%( 77<< h7GBK HD   $ 1   T "b$$6r{{2AN  M  Ms AD D%)rr` rarbrcrdrerr[rfrgrhs@r,rjrjsLP#,r.rjc6^\rSrSrSrSU4SjjrSrSrU=r$)DocumentGeneratorzGenerates style manpage files with suffix in an output directory. All files will be generated in one directory. Attributes: _directory: The document output directory. _style: The document style. _suffix: The output file suffix. c>[[U] XS9 X lX0lX@l[ R"UR5 g)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The manpage output directory path name. style: The document style. suffix: The generate document file suffix. None for .
. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. rN)rrurr_style_suffixr r)r%r&r'rHsuffixrr+s r,rDocumentGenerator.__init__s7 T+C+COKL MM$//"r.c URS:Xa[R"U5nOSnUR5n[R R URSR U55UR-n[R"U5n[R"U5n[R"URSR U5[R "U5UUS9 SSS5 U$!,(df  U$=f)aRenders document file for each node in the CLI tree. Args: node: group/command CommandCommon info. parent: The parent Visit() return value, None at the top level. is_group: True if node is a group, otherwise its is a command. Returns: The parent value, ignored here. linterN_r2)rHr:rIrJcommand_metadata)rxrGetCommandMetaDatarLrrrrryr r r rSr rTrUrV) r%rWrXr> meta_datar=rrYrZs r,r[DocumentGenerator.Visits {{h,,T2iillnG 77<<'): ;dll JD   $ 1   T "b$$ !kk"o$   M  Ms AC<< D )rrxry)Nrsrhs@r,rurus#&r.ruc>^\rSrSrSrSrSrSU4SjjrSrU=r $) HtmlGeneratori5zGenerates HTML manpage files with suffix .html in an output directory. The output directory will contain a man1 subdirectory containing all of the HTML manpage files. cv^^^SmUUU4SjmTRS5 T"U/5 TRS5 g)zWrites the command menu tree HTML on out. Args: command: dict, The tree (nested dict) of command/group names. out: stream, The output stream. c$SRU5$)Nr~)r)rs r,ConvertPathToIdentifier.ConvertPathToIdentifierDs XXd^r.c >[U5nUS::aSOSnUS-S-nURS5nX/-nT RSRSU-UUT "U5S95 URS /5URS /5-nU(aqT RS 5 [ US S 9H nT "X5 M T RSRSUS--S95 T RSRSU-S95 gT RS5 g)zVisit each command and group in the CLI command tree. Args: command: dict, The tree (nested dict) of command/group names. prefix: [str], The subcommand arg prefix. r1visibler(_name_zT{indent}
  • {name}r2)r< visibilitynameitemcommandsgroupsz
      c US$)Nr)xs r,FHtmlGenerator.WriteHtmlMenu..WalkCommandTree.._s( r.)keyz{indent}
    )r<z{indent}
    • z N)r6getr"formatsorted) r=prefixlevelrr<rargsrcrWalkCommandTreerJs r,r4HtmlGenerator.WriteHtmlMenu..WalkCommandTreeGs&ke % 9jqy1}f [[ "d f_d ii 44:F6\#*40 5;5 Z,w{{8R/HHh  (&; man page tree navigation
      z
    N)r")r%r=rJrrs `@@r, WriteHtmlMenuHtmlGenerator.WriteHtmlMenu<s=>IIGR IIr.c[U5RX45n[R"[R R US55nURXV5 SSS5 [HNn[R"SU5n[R"[R R X5U5 MP g!,(df  Ng=f)z&Generates html nav files in directory.z _menu_.htmlNz+googlecloudsdk.api_lib.meta.help_html_data.) CommandTreeGeneratorWalkr r rrrr_HELP_HTML_DATA_FILESr GetResourceWriteBinaryFileContents) r%r'r&r(rtreerJ file_name file_contentss r,_GenerateHtmlNavHtmlGenerator._GenerateHtmlNav~s  $ ) )& ;D   "'',,y-@ AS # B* #// 7m ## '',,y ,m + B As C CcT>[[U] UUSSUS9 URX!X55 g)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The HTML output directory path name. hidden: Boolean indicating whether to consider the hidden CLI. progress_callback: f(float), The function to call to update the progress bar or None for no progress bar. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. htmlrEr'rHrzrN)rrrrrms r,rHtmlGenerator.__init__s:  -'  ( )&;r.rr`) rarbrcrdrerrrrfrgrhs@r,rr5s% @D LP<URRSS9n[RR X&5n[ [ U]XSSUS9 g)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The manpage output directory path name. hidden: Boolean indicating whether to consider the hidden CLI. progress_callback: f(float), The function to call to update the progress bar or None for no progress bar. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. r1)sectionmanz.1rN)_SECTION_FORMATrrrrrrr) r%r&r'r(r)rsection_subdir section_dirr+s r,rManPageGenerator.__init__sN$))000;N'',,y9K D* %x+r.rr`) rarbrcrdrerrrfrgrhs@r,rrs  #/LPr.rc2^\rSrSrSrSU4SjjrSrU=r$)LinterGeneratoriz@Generates linter files with suffix .json in an output directory.c0>[[U] UUSSUS9 g)aConstructor. Args: cli: The Cloud SDK CLI object. directory: The linter output directory path name. hidden: Boolean indicating whether to consider the hidden CLI. progress_callback: f(float), The function to call to update the progress bar or None for no progress bar. restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. r}z.jsonrN)rrrrms r,rLinterGenerator.__init__s(" /4)  *r.rr`)rarbrcrdrerrfrgrhs@r,rrsHLPr.rc6^\rSrSrSrSU4SjjrSrSrU=r$)riaSConstructs a CLI command dict tree. This implements the resource generator for gcloud meta list-commands. Attributes: _with_flags: Include the non-global flags for each command/group if True. _with_flag_values: Include flag value choices or :type: if True. _global_flags: The set of global flags, only listed for the root command. c z>[[U] "U40UD6 U=(d UUlX0l[ 5Ulg)aConstructor. Args: cli: The Cloud SDK CLI object. with_flags: Include the non-global flags for each command/group if True. with_flag_values: Include flags and flag value choices or :type: if True. **kwargs: Other keyword arguments to pass to Walker constructor. N)rrr _with_flags_with_flag_valuesset _global_flags)r%r& with_flagswith_flag_valueskwargsr+s r,rCommandTreeGenerator.__init__s8 .s=f=!5%5D-Dr.c DURRSS5nSU0nUR(GaG/nUR5GHnSnUR(GaFUR (aT[ UR 5n U SS/:wa6SRU V s/sHn [R"U 5PM sn 5nO[UR[5(aSnO[UR[5(aS nO[UR[R5(aS nOq[UR[R 5(aS nOEUR"S :wa5UR$=(d UR&R)5n S U -S -nUR*H#n U(aU SU-- n UR-U 5 M% GM Sn /nUHTnXR.;aMUR1U 5(aSU[3U 5S-nUU;aMCUR-U5 MV U(a:[ U5US'UR.(dUR.R5U5 U(aRU(aI[6R8U;a/U[6R8'U[6R8R-U5 U$[6R:U;a/U[6R:'U[6R:R-U5 gs sn f)aCVisits each node in the CLI command tree to construct the dict tree. Args: node: group/command CommandCommon info. parent: The parent Visit() return value, None at the top level. is_group: True if node is a group, otherwise its is a command. Returns: The subtree parent value, used here to construct a dict tree. r~-rNfalsetrue,z:int:z:float:z:dict:z:list:r:=z--no-z--_flags_)rreplacerGetAllAvailableFlagsrchoicesrrsix text_type isinstancetypeintfloatrArgDictArgListnargsmetavardestupperoption_stringsr7r startswithr6updater LOOKUP_GROUPSLOOKUP_COMMANDS)r%rWrXr>rinfo all_flagsargvaluerchoicerrY no_prefixflagsflagpositives r,r[CommandTreeGenerator.Visits| 99  S# &D d D i**,#  ! ! ! [[S[[)G7F++hhGLG& f 5GLMe#((C((E#((E**E#((K$7$788E#((K$7$788EyyA~kk5SXX^^%5G'MC'E##A  u A   1 $%-,ie$ %% %  ??9 % %DY!122(  "  T  -Y!!    # #E *   ! ! /+-&'' (x%%&--d3 kv-)+fX % %& 8 # #$++D1 Y Ms L )rrr)FFrsrhs@r,rrs AAr.rc\rSrSrSrSrSrg)GCloudTreeGeneratoriAzGenerates an external representation of the gcloud CLI tree. This implements the resource generator for gcloud meta list-gcloud. c.[R"X5$)aOVisits each node in the CLI command tree to construct the external rep. Args: node: group/command CommandCommon info. parent: The parent Visit() return value, None at the top level. is_group: True if node is a group, otherwise its is a command. Returns: The subtree parent value, used here to construct an external rep node. )rCommand)r%rWrXr>s r,r[GCloudTreeGenerator.VisitGs   D ))r.rN)rarbrcrdrer[rfrr.r,rrAs  *r.r)re __future__rrrrUrgooglecloudsdk.callioperrrr r googlecloudsdk.corer &googlecloudsdk.core.document_renderersr googlecloudsdk.core.utilr rrrWalkerrrjrurrrrrrr.r,rs #&' +/,,**B*2 Ov}}Od6 6r9 9xm<%m<`(D':Z6==Zz*&--*r.