-Ph&UdZddlmZddlZddlZddlZddlZddlmZddl m Z m Z m Z m Z mZddlmZmZerWddlmZmZmZmZddlmZmZeejgejfZd ed <eejgefZd ed <dd lmZGd deZ iZ!ded<d'dZ"GddejZ#d(dZ$d)d*dZ%d+dZ&d,d#Z'd)d-d%Z(e)d&kre*e(dS).aBase '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.eZdZUded<ded<ded<dS)_SubcommandModulestrparser_descriptionr set_up_parserrrunN)__name__ __module__ __qualname____annotations__T/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/_cli/__init__.pyrr0s1$$$$ r rzdict[str, str] _COMMANDSreturnIterator[tuple[str, str]]c#KtD]o\}}tj|} |j}||dddfVB#t $r!td|tj YlwxYwdS)Nz rz#Failed to load the description for )file) r"items importlib import_modulersplitAttributeErrorprintsysstderr)command module_namemodule descriptions r!_load_subcommand_descriptionsr4:s ) 1 1;;$-$;K$H$H ; 3K ;,,VQ77:: : : : :  T T T AAA S S S S S S T ;;sA(B B c>eZdZddZddZeddZddZdS)_RootArgumentParserr#rc jtttddtdt|jddtddg}t t x}rtttt|ddid}tt|d |dtttd dgz }|fd |Dz }| dtd |j_|jd dD]5}d|jDx}r ||||jpdz }6|dtddgz }d|S)NzUsage: z {0} [OPTIONS] [] z% The Sphinx documentation generator.strictTrz Commands:c.g|]\}}d|dd|S) z z3_RootArgumentParser.format_help..ZsJ.L,K\J%7JJJJLJJr Optionsr&c<g|]}|jtjk|Sr)helpargparseSUPPRESS)r>actions r!rBz3_RootArgumentParser.format_help..ds2;("333333r FFor more information, visit https://www.sphinx-doc.org/en/master/man/.)rr r formatproglistr4maplennextzipminmaxappend _optionalstitle_action_groups_group_actions_format_optional_argumentsjoin)selfhelp_fragmentscommandscommand_lengthsargument_group argumentsrAs @r! format_helpz_RootArgumentParser.format_helpGs 2h<<(( ) )  1 2 2 9 9$ty// J J   6 7 7 % 9;;<< <8 (!#tC,G$,G,G'L'LMMO!$S%9%92!>!>  Yr+//00 N 2: N  ! !$ ' ' '!#9 "1!""5  N,;y  $"A"A"(.B##   X      ww~&&&r actionsIterable[argparse.Action]rV Iterator[str]c #KdVtt|dzVdV|D]}dtd|jDz}|dzdt t|jz}|jdkr2|d||j|j|j |j zz }|VdV|j pd x}r$d | DEd{VdS) Nr9:z c3.K|]}|ddkVdS)r&-Nr)r>os r! zA_RootArgumentParser._format_optional_arguments..s*!M!M!!A$#+!M!M!M!M!M!Mr r=, rr8rIc3"K|] }d|dV dS)z r9Nr)r>lines r!rjzA_RootArgumentParser._format_optional_arguments..s.UUD/t///UUUUUUr )rr alloption_stringsrZrNnargs_format_metavarmetavarchoicesdestrEstrip splitlines)r[rbrVrHprefixopt action_helps r!rYz._RootArgumentParser._format_optional_argumentswsK  9US[))*****  V VFc!M!Mv7L!M!M!MMMMF4-$))Cf6K,L,L"M"MMC|q  sT11L&.&.&+IIIJJJ%{0b77999{ VUUK>> ! h+ + +7||q  ;71:;;;;;;)7)))) h* * *///// / h( ( (5 ho % %### ##oor messagerctd}tj||j|t d)Nz0{0}: error: {1} Run '{0} --help' for informationr)r r.r/writerKrL SystemExit)r[rrs r!errorz_RootArgumentParser.errorsBDEE DIw77888mmr N)r#r)rbrcrVrr#rd) rprzrrr{rsr|rtrr#r)rrr#r)rrrrarY staticmethodrqrrr r!r6r6Fsu.'.'.'.'`VVVV*\:r r6c tdtdtddd}|dddtjtd  |d d d dtjtd |td}|dddddtd|dddddtd|ddddtd|d tjtd!"|S)#Nsphinxz$ Manage documentation with Sphinx.rJF)rLr3epilogadd_help allow_abbrev-V --version store_truezShow the version and exit.)rHdefaultrEz-hz-?z--helpzShow this message and exit.Loggingz-vz --verbosecount verbosityrz$Increase verbosity (can be repeated))rHrtrrEz-qz--quiet store_constzOnly print errors and warnings.)rHrtconstrEz--silentzNo output at allCOMMANDz )rprr)r6r add_argumentrFrGadd_argument_groupr)parser log_controls r!_create_parserrs =>> T  F  ! , - -    ! - . . ++ByMM::K   6 7 7    1 2 2   " # #   ; Mr rargv Sequence[str]tuple[str, Sequence[str]]ct}||}|jpd^}}|}t rt nt d|vsddh|r8ddlm }tj d|dtdd |vs|d kr@tj |td|tvr?tj t!d |d td ||fS) N)rEversionrrr)__display_version__sphinx r9rEzsphinx: z/ is not a sphinx command. See 'sphinx --help'. r)r parse_argsrlowerrrr intersectionrrr.r/rrrar"r )rrargsr? command_argvrs r!_parse_commandrsq   F   T " "D"&,";)L<%%''L!!DT;/<<\JJ...... :#6:::;;;mm~~// ++--...mm9$$  )<)))     mm  %%r r?r"tuple[str, _PARSER_SETUP, _RUNNER]c tjt|}n$#t$rd|d}t |dwxYw|j|j|jfS)Nzinvalid command name .)r)r*r"KeyErrorrrrr)r?r2rs r!_load_subcommandrsn($-$;Ilrs&#""""" +*******FFFFFFFFFFFF********'  !8#:: M"8#5"6";