o Ni&@sXUdZddlmZddlZddlZddlZddlZddlmZddl m Z m Z m Z m Z mZddlmZmZerrddlmZmZmZmZddlmZmZeejgejfZd ed <eejgefZd ed <dd lmZGd ddeZ iZ!ded<d-ddZ"GdddejZ#d.ddZ$d/d0ddZ%d1d"d#Z&d2d'd(Z'd/d3d*d+Z(e)d,kre*e(dS)4aBase 'sphinx' command. Subcommands are loaded lazily from the ``_COMMANDS`` table for performance. All subcommand modules must define three attributes: - ``parser_description``, a description of the subcommand. The first paragraph is taken as the short description for the command. - ``set_up_parser``, a callable taking and returning an ``ArgumentParser``. This function is responsible for adding options and arguments to the subcommand's parser. - ``run``, a callable taking parsed arguments and returning an exit code. This function is responsible for running the main body of the subcommand and returning the exit status. The entire ``sphinx._cli`` namespace is private, only the command line interface has backwards-compatibility guarantees. ) annotationsN) TYPE_CHECKING)bolddisable_colour enable_colourterminal_supports_colour underline)__ init_console)CallableIterableIteratorSequence)NoReturn TypeAliasr _PARSER_SETUP_RUNNER)Protocolc@s&eZdZUded<ded<ded<dS)_SubcommandModulestrparser_descriptionr set_up_parserrrunN)__name__ __module__ __qualname____annotations__rrH/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/_cli/__init__.pyr0s  rzdict[str, str] _COMMANDSreturnIterator[tuple[str, str]]c csjtD]-\}}t|}z|j}Wnty&td|tjdYqw|| dddfVqdS)Nz#Failed to load the description for )filez r) ritems importlib import_modulerAttributeErrorprintsysstderrsplit)command module_namemodule descriptionrrr_load_subcommand_descriptions:s   r0c@s8eZdZdddZdd d ZedddZdddZdS)_RootArgumentParserr rcstttddtdt|jddtddg}tt}rQttt t |ddid}t t |d |dtttd dg7}|fd d |D7}| dtd |j_|jddD]}dd |jD}ru||||jprd7}q^|dtddg7}d|S)NzUsage: z {0} [OPTIONS] [] z% The Sphinx documentation generator.strictTrz Commands:cs(g|]\}}d|dd|qS) z Zsz3_RootArgumentParser.format_help..Optionsr#cSsg|] }|jtjkr|qSr)helpargparseSUPPRESS)r7actionrrrr<ds  FFor more information, visit https://www.sphinx-doc.org/en/master/man/.)rrr formatproglistr0maplennextzipminmaxappend _optionalstitle_action_groups_group_actions_format_optional_argumentsjoin)selfhelp_fragmentscommandscommand_lengthsargument_group argumentsrr:r format_helpGsL      z_RootArgumentParser.format_helpactionsIterable[argparse.Action]rO Iterator[str]c csdVtt|dVdV|D]K}dtdd|jD}|ddtt|j}|jdkrB|d ||j|j|j |j 7}|VdV|j pLd }r]d d| DEdHqdS) Nr3:z css|] }|ddkVqdS)r#-Nr)r7orrr zA_RootArgumentParser._format_optional_arguments..r6, rr2rBcss|] }d|dVqdS)z r3Nr)r7linerrrrarb)rralloption_stringsrSrGnargs_format_metavarmetavarchoicesdestr>strip splitlines)rTr[rOrAprefixopt action_helprrrrRws" z._RootArgumentParser._format_optional_argumentsrgint | str | Noneristr | tuple[str, ...] | NonerjIterable[str] | NonerkcCs|dur|durddt|d}n|}|dur|S|tjkr*d|dS|tjkrHt|dkrBd|dd|d d Sd|d S|tjkrU|d|d S|tjkr\d S|tj krf|d Sd}t |)N{rc}[]rz [r#z ...]]z ...]z...z ...zinvalid nargs value) rSsortedupperr?OPTIONAL ZERO_OR_MORErH ONE_OR_MORE REMAINDERPARSER ValueError)rgrirjrkmsgrrrrhs(         z#_RootArgumentParser._format_metavarmessagercCs"tjtd|j|td)Nz0{0}: error: {1} Run '{0} --help' for informationrx)r)r*writer rDrE SystemExit)rTrrrrerrors z_RootArgumentParser.errorN)r r)r[r\rOrr r]) rgrqrirrrjrsrkrr r)rrr r)rrrrZrR staticmethodrhrrrrrr1Fs   0 r1cCstdtdtdddd}|jdddtjtd d |jd d d dtjtdd |td}|jdddddtdd|jdddddtdd|jddddtdd|jd tjtd!d"|S)#Nsphinxz$ Manage documentation with Sphinx.rCF)rEr/epilogadd_help allow_abbrev-V --version store_truezShow the version and exit.)rAdefaultr>z-hz-?z--helpzShow this message and exit.Loggingz-vz --verbosecount verbosityrz$Increase verbosity (can be repeated))rArkrr>z-qz--quiet store_constzOnly print errors and warnings.)rArkconstr>z--silentzNo output at allCOMMANDz )rgri)r1r add_argumentr?r@add_argument_groupr~)parser log_controlrrr_create_parsersl  rrargv Sequence[str]tuple[str, Sequence[str]]cCst}||}|jp d^}}|}trtntd|vs(ddh|rversionrrr)__display_version__sphinx r3r>zsphinx: z/ is not a sphinx command. See 'sphinx --help'. rx)r parse_argsrlowerrrr intersectionrrr)r*rrrZrr )rrargsr8 command_argvrrrr_parse_commands,   rr8r"tuple[str, _PARSER_SETUP, _RUNNER]cCsHz tt|}Wntyd|d}t|dw|j|j|jfS)Nzinvalid command name .)r%r&rKeyErrorrrrr)r8r.rrrr_load_subcommands   rr/ parser_setupargparse.ArgumentParsercCs"tjd||tjdd}||S)NrF)rEr/formatter_classr)r?ArgumentParserRawDescriptionHelpFormatter)r8r/rrrrr_create_sub_parsersrintc Csttjdt|ptjdd}zt|\}}t|\}}}t|||}| |}||WSt yE}z |j WYd}~Sd}~wt t fyPYdSw)NrBr#rx)locale setlocaleLC_ALLr r)rrrrrrcode ExceptionKeyboardInterrupt) rcmd_namecmd_argvcmd_descriptionrrunner cmd_parsercmd_argsexcrrrr*s    r__main__)r r!)r r1)r)rrr r)r8rr r)r8rr/rrrr r)rrr r)+__doc__ __future__rr?r%rr)typingrsphinx._cli.util.colourrrrrr sphinx.localer r collections.abcr r r rrrrrr Namespacerrrrrr0r1rrrrrrrrrrrs:        m < $