~SrSSKJr SSKJr SSKJr SSKrSSKJr SSKJr SSK J r SS K J r SS K J r SS KJr "S S \ R 5r"SS\R$5rg)zCA command that generates and/or updates help document directoriess.)absolute_import)division)unicode_literalsN)base) walker_util) help_util) exceptions)log) console_attrc\rSrSrSrSrg)HelpOutOfDateError z&Help documents out of date for --test.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r&lib/surface/meta/generate_help_docs.pyr r s.rr c.\rSrSrSr\S5rSrSrg)GenerateHelpDocs$aGenerate and/or update help document directories. The DevSite docs are generated in the --devsite-dir directory with pathnames in the reference directory hierarchy. The manpage docs are generated in the --manpage-dir directory with pathnames in the manN/ directory hierarchy. cbURSSSSS9 URSSSS 9 URS SS S 9 URS SS S 9 URSSSS 9 URSSSS 9 URSSSS9 URSSSSS9 URSSSSS9 URSSSSSS9 g) Nz--hidden store_trueFz1Include documents for hidden commands and groups.)actiondefaulthelpz --devsite-dir DIRECTORYzThe directory where the generated DevSite reference document subtree will be written. If not specified then DevSite documents will not be generated.)metavarrz--help-text-dirzThe directory where the generated help text reference document subtree will be written. If not specified then help text documents will not be generated. The --hidden flag is implied for --help-text-dir.z --html-diraThe directory where the standalone manpage HTML files will be generated. index.html contains manpage tree navigation in the left pane. The active command branch and its immediate children are visible and clickable. Hover to navigate the tree. Run `python -m http.server 8888 &` in DIRECTORY and point your browser at [](http://localhost:8888) to view the manpage tree. If not specified then the HTML manpage site will not be generated.z --linter-dirzThe directory where the generated documentation linter errors for the help text reference document subtree will be written. If not specified then documentation linter documents will not be generated.z --manpage-dirzThe directory where the generated manpage document subtree will be written. The manpage hierarchy is flat with all command documents in the manN/ subdirectory. If not specified then manpage documents will not be generated.z--testzqShow but do not apply --update actions. Exit with non-zero exit status if any help document file must be updated.)rrz--updatezUpdate destination directories to match the current CLI. Documents for commands not present in the current CLI will be deleted. Use this flag to update the help text golden files after the help_text_test test fails.z--update-help-text-dirTz;Deprecated. Use --update --help-text-dir=DIRECTORY instead.)hiddenr!rrestrictz COMMAND/GROUP*zRestrict document generation to these dotted command paths. For example: gcloud.alpha gcloud.beta.test OR gcloud.{alpha.,beta.,}compute.instances )r!nargsrr) add_argument)parsers rArgsGenerateHelpDocs.Args,sO A D  13  %'     9; BD  5 7   J L    rc^^^[5mSUUU4SjjnTR(aE[R"SR TRS95 TRTlSTlTR(a+U"S[RTRTRS9 TR (a"U"S[RTR SSS9 TR(a+U"S [RTRTRS9 TR(a+U"S [RTRTRS9 TR (a+U"S [R"TR TRS9 T(atTR$(ab['T5n[)U5S :a)S R+SR+USS5US/5nOUSn[-SR U55egg)Nc>TRVs/sHn[R"SSU5PM nn[R"U5 TR (d!U"T R X&S9RXF5 g[R"T R X!TRUS9RU5(aTRU5 ggs snf)z=Runs generator and optionally updates help docs in directory._-)r#)testr"N) r#resubr ResetConsoleAttrupdate_cli_power_users_onlyWalkr HelpUpdaterr.Updateadd) kind generator directoryencodingr"p restrict_dirargs out_of_dateselfs rGenerate&GenerateHelpDocs.Run..Generate}s59]]C]bffT4+]lC##H- [[  & &  $v $   $ $iyy ))/ )= >  > Ds"Czk[--update-help-text-dir={directory}] is deprecated. Use this instead: --update --help-text-dir={directory}.)r:TDevSite)r"z help textasciihtmlzman pagezcommand linterz and z, rz"{} document files must be updated.)zutf-8F)setupdate_help_text_dirr warningformat help_text_dirr2 devsite_dirrDevSiteGeneratorr"HelpTextGeneratorhtml_dir HtmlGenerator manpage_dirManPageGenerator linter_dirLinterGeneratorr.sortedlenjoinr )r@r>rAnameskindsr?s`` @rRunGenerateHelpDocs.Runzs%K      kkHHN $ 9 9IOI;< 44ddk y+668H8Hkk# {K994;M;Mt% }}v{00$--kk# z;779I9Ikk# !> !{rrN) rrrrr staticmethodr(r[rrrrrr$s#KKZ4>rr)r __future__rrrr/googlecloudsdk.callioperrgooglecloudsdk.command_lib.metargooglecloudsdk.corer r googlecloudsdk.core.consoler Errorr CommandrrrrresM J&' (/5*#4/))/J>t||J>r