]jB d Z dZddlZddlZddlZddlmZ ddlZddlZddlZddl Z ddl
Z
ddl
m Z m Z d Z
d Z d#dZ d#d Z d#d
Z d#d Z d#d Z d#d
Z d#dZ d#dZ d#dZ d#dZ d#dZ d#dZ d#dZd$dZ d Z d Z G d dej Z G d dej Z G d d ej! e
j" Z! G d d ej# Z$ G d d!e% Z&d" Z'dS )%a
Command-line and common processing for Docutils front-end tools.
This module is provisional.
Major changes will happen with the switch from the deprecated
"optparse" module to "arparse".
Applications should use the high-level API provided by `docutils.core`.
See https://docutils.sourceforge.io/docs/api/runtime-settings.html.
Exports the following classes:
* `OptionParser`: Standard Docutils command-line processing.
Deprecated. Will be replaced by an ArgumentParser.
* `Option`: Customized version of `optparse.Option`; validation support.
Deprecated. Will be removed.
* `Values`: Runtime settings; objects are simple structs
(``object.attribute``). Supports cumulative list settings (attributes).
Deprecated. Will be removed.
* `ConfigParser`: Standard Docutils config file processing.
Provisional. Details will change.
Also exports the following functions:
Interface function:
`get_default_settings()`. New in 0.19.
Option callbacks:
`store_multiple()`, `read_config_file()`. Deprecated.
Setting validators:
`validate_encoding()`, `validate_encoding_error_handler()`,
`validate_encoding_and_error_handler()`,
`validate_boolean()`, `validate_ternary()`,
`validate_nonnegative_int()`, `validate_threshold()`,
`validate_colon_separated_string_list()`,
`validate_comma_separated_list()`,
`validate_url_trailing_slash()`,
`validate_dependency_file()`,
`validate_strip_class()`
`validate_smartquotes_locales()`.
Provisional.
Misc:
`make_paths_absolute()`, `filter_settings_spec()`. Provisional.
reStructuredText N)
SUPPRESS_HELP)ioutilsc |D ]}t |j |d | D ]\ }}t |j || dS )z
Store multiple values in `parser.values`. (Option callback.)
Store `None` for each attribute named in `args`, and store the value for
each key (attribute name) in `kwargs`.
N)setattrvaluesitems)optionoptvalueparserargskwargs attributekeys q/builddir/build/BUILD/imunify360-venv-2.6.3/opt/imunify360/venv/lib/python3.11/site-packages/docutils/frontend.pystore_multipler E sf 0 0
y$//// llnn + +
U
sE****+ + c | | }n,# t $ r }| | Y d}~nd}~ww xY w|j || dS )zQ
Read a configuration file during option processing. (Option callback.)
N)get_config_file_settings
ValueErrorerrorr update)r r r
r new_settingserrs r read_config_filer R sz 66u== S
M v.....s
A<Ac |dk rd S t j | n$# t $ r t d| d|d w xY w|S )N z setting "z": unknown encoding: "")codecslookup LookupErrorsettingr
option_parser
config_parserconfig_sections r validate_encodingr) ] sp {{t.
e . . .k $WWeee- . . .. Ls !A c r t j | n # t $ r t d|z w xY w|S )Nzunknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", "backslashreplace", "xmlcharrefreplace", and possibly others; see documentation for the Python ``codecs`` module))r! lookup_errorr# r$ s r validate_encoding_error_handlerr, i s^ 5E"""" 5 5 5
, /4
45 5 55 Ls 4c d|v re| d \ }}t | dz |||| |r| || dz | n t |j | dz | n|}t | |||| |S )z
Side-effect: if an error handler is included in the value, it is inserted
into the appropriate place as if it was a separate setting/option.
:_error_handler)splitr, setr r r) )r% r
r& r' r( encodinghandlers r #validate_encoding_and_error_handlerr4 v s e|| !KK , ,'' & & > + + + O ng8H.H %
'
'
'
'
M('4D*Dg N N N Ngx #^5 5 5 Or c t |t r|S |j | S # t
$ r t
d|z w xY w)z|Check/normalize boolean settings:
True: '1', 'on', 'yes', 'true'
False: '0', 'off', 'no','false', ''
zunknown boolean value: "%s")
isinstanceboolbooleansstriplowerKeyErrorr# r$ s r validate_booleanr< sv % A %ekkmm&9&9&;&;<< A A A7%?@@@As 0A
A'c t |t s||S |j | S # t
$ r |cY S w xY w)zCheck/normalize three-value settings:
True: '1', 'on', 'yes', 'true'
False: '0', 'off', 'no','false', ''
any other value: returned as-is.
)r6 r7 r8 r9 r: r; r$ s r validate_ternaryr> sj % %- %ekkmm&9&9&;&;<< s 0A AAc N t | }|dk rt d |S )Nr z(negative value; must be positive or zero)intr r$ s r validate_nonnegative_intrA s* JJE qyyCDDD Lr c t | S # t $ rJ |j | cY S # t t
f$ r t
d|z w xY ww xY w)Nzunknown threshold: %r.)r@ r
thresholdsr: r; AttributeErrorr# r$ s r validate_thresholdrE s @5zz @ @ @ @ +EKKMM: : : :.) @ @ @ 6 >?? ? @@s
A% =A%$A!!A%c t |t s| d }n<| }| | d |S )Nr. )r6 listr0 popextend)r% r
r& r' r( lasts r $validate_colon_separated_string_listrK sU eT " " & C yy{{
TZZ__%%% Lr c t |t s|g}| }d | d D }| | |S )zHCheck/normalize list arguments (split at "," and strip whitespace).
c b g | ],}| d | d -S )z
)r9 ).0is r
<listcomp>z1validate_comma_separated_list.<locals>.<listcomp> s5 K K K!!''':J:J KQWWW
K K Kr ,)r6 rG rH r0 rI )r% r
r& r' r( rJ r
s r validate_comma_separated_listrR s` eT " " 99;;D K Ktzz# K K KE LL Lr c B |sdS | d r|S |dz S )Nz.//)endswithr$ s r validate_url_trailing_slashrV s2 t s{r c t t j | S # t $ r t j d cY S w xY wN)r DependencyListOSErrorr$ s r validate_dependency_filer[ sJ *#E*** * * *#D)))))*s 77c t | |||| }|D ]=}t j | }||k rt d|d|d >|S )NzInvalid class value z
(perhaps z?))rR docutilsnodesmake_idr )r% r
r& r' r( cls
normalizeds r validate_strip_classrb s
*'5-*7
I
IE 2 2 ^++C00
* * #ZZZ 1 2 2
2 Lr c : t | |||| }g }|D ]} | dd \ }}nT# t $ r | | Y ?t $ r' t d| dd z w xY w| }| d } t | dk r| }n9t | dk r&t d| dd z | ||f |S )z~Check/normalize a comma separated list of smart quote definitions.
Return a list of (language-tag, quotes) string tuples.r. z4Invalid value "%s". Format is "<language>:<quotes>".asciibackslashreplace z[Invalid value "%s". Please specify 4 quotes
(primary open/close; secondary open/close).)rR r0 rD appendr encoder9 len)
r% r
r& r' r( lc_quotesitemlangquotesmultichar_quotess
r validate_smartquotes_localesrp sw
*'5-*7
I
IE I ) )
I ::c1--LD&&
T " " " H I I I A #{{74F G G H I I
I I
!<<,, A % %%FF
[[A
O #{{74F G G H I I
I $ (((( s 6 B0Bc t j |D ]I}|| v rC| | }t |t rfd|D }n|rt | }|| |< JdS )z
Interpret filesystem path settings relative to the `base_path` given.
Paths are values in `pathdict` whose keys are in `keys`. Get `keys` from
`OptionParser.relative_path_settings`.
Nc 0 g | ]}t | S )make_one_path_absolute)rN path base_paths r rP z'make_paths_absolute.<locals>.<listcomp>) s3 , , , ! 0 4@@ , , ,r )osgetcwdr6 rG rt )pathdictkeysrv r r
s ` r make_paths_absoluter{ s IKK " " (?? SME%&&
A, , , ,%*, , ,
A.y%@@ !HSM" "r c | t j t j | | S rX )rw ru abspathjoin)rv ru s r rt rt 0 s&
7??27<< 488 9 99r c t | }t dt | d D ]}g }|| D ]f}d |d D d }||v r || v r | || Q| | gt | ||< t | S )aj Return a copy of `settings_spec` excluding/replacing some settings.
`settings_spec` is a tuple of configuration settings
(cf. `docutils.SettingsSpec.settings_spec`).
Optional positional arguments are names of to-be-excluded settings.
Keyword arguments are option specification replacements.
(See the html4strict writer for an example.)
c t g | ]5}| d |dd dd 6S )z--r N-_)
startswithreplace)rN
opt_strings r rP z(filter_settings_spec.<locals>.<listcomp>D sS 8 8 8 &%00668
122..sC88 8 8 8r rd r )rG rangerj rz rh tuple)
settings_specexcluder settingsrO newoptsopt_specopt_names r filter_settings_specr 4 s M""H
1c(mmQ
'
'
%
%
)
)H8 8*21+8 8 889;H 7""7<<>>))wx 01111x((((Gnn ??r c 4 e Zd ZdZ fdZd Zd Zd Z xZS )ValueszStorage for option values.
Updates list attributes by extension rather than by replacement.
Works in conjunction with the `OptionParser.lists` instance attribute.
Deprecated. Will be removed.
c t j dt d t j |i | t | dd t
j | _ d S d S )Nz@frontend.Values class will be removed in Docutils 0.21 or later.r
stacklevelrecord_dependencies) warningswarnDeprecationWarningsuper__init__getattrr rY r selfr r __class__s r r zValues.__init__Z sv
3(Q 8 8 8 8 $)&))) 4. 5 5 =',';'='=D $ $ $ > =r c & t |t r|j }t | }|j D ]6}t
| | r$||v r t | | }|r||| z
}||= 7| | d S rX ) r6 r __dict__dictlistsrz hasattrr
_update_loose)r
other_dictr& r% r
s r r z
Values.updatec s j& ) ) -#,J*%%
$*//11 , ,GtW%%
,'Z*?*? g.. ,Z 00E"7+ :&&&&&r c t j 5 t j dt | | j cddd S # 1 swxY w Y dS )z Return a shallow copy of `self`.ignorecategory)defaultsN)r catch_warningsfilterwarningsr r r )r s r copyz Values.copyo s
$
&
& : : #H7I J J J J>>4=>99 : : : : : : : : : : : : : : : : : :s 6AA Ac f t | |d t | || t | | S )znReturn ``self.name`` or ``default``.
If ``self.name`` is unset, set ``self.name = default``.
N)r r )r namedefaults r
setdefaultzValues.setdefaultu s8
4t $ $ , D$ ( ( (tT"""r ) __name__
__module__ __qualname____doc__r r r r
__classcell__r s @r r r Q so > > > > >
'
'
': : : # # # # # # #r r c N e Zd ZdZej j ddgz Z fdZ fdZ xZ S )Optionz`Add validation and override support to `optparse.Option`.
Deprecated. Will be removed.
validator overridesc r t j dt d t j |i | d S )NzDThe frontend.Option class will be removed in Docutils 0.21 or later.r r )r r r r r r s r r zOption.__init__ sJ
3(Q 8 8 8 8 $)&)))))r c t |||| }| j }|r| j rxt || } | ||| }n># t
$ r1}t
j d|dt j | d}~ww xY wt ||| | j rt || j d |S )z
Call the validator function on applicable settings and
evaluate the 'overrides' option.
Extends `optparse.Option.process`.
zError in option "z":
N) r processdestr r ExceptionoptparseOptionValueErrorr error_stringr r )
r r r
r r resultr% new_valuer r s
r r zOption.process s eVV<<) 6~
4 007 $wv F FII 7 7 7"33 33 4 4 467 7 77 333~
6555
s A
B),BB)
r r r r r r ATTRSr r r r s @r r r sq
O ![+$> >E* * * * * r r c e Zd ZdZg dZ d Z dddddd Z d
d
d
d
d d d d d d Z e e
j d
d pe j
pdZdZddg ddgddifddgddifdddgd ed fd d gd d!d"fd#d$d%gd&d'd(d)fd*d+d,gd&d-d(d)fd.d/gd&dd(d)fd0d1d2gd ed fd3d4gdd5ifd6d7gd8ed9d:fd;d<gd=d&d>d>d?fd@dAgd=d&dBdCfdDdEgd=d dFfdGdHgd dedIfdJdKgdLd dFfdMdNgd dOdedPfdQdRgd dOd"fdSdTgd ed fdUdVgd dWd"fdXdYgdZd[d\ed]fd^d_gdZd`d\ed]fdadbdcgeddddeedffdgdhdigd&dddd)fdjdkdlgd&dddd)fdmdngedoddeedpfdqdrgd&ddod)fdsdtgeduddeedpfdvdwgd ed fdxdygd dzd"fd{d|gd}d~dfddgd dedIfddgdd dFfdddgdedfddgdedfdddgddedfddgdedfdededddgdeedfdez dgeedfdddgddddfddgd~eddfddgd~dd8edfdddgddifdddgddifedgddifedgddifedgdd ifedgdd ifedgdd ifedgdd ifedgdZdedfedgdd ifR fZ dddddZ dZ de j e j r
de j z pdde
j d de
j! dǝZ" dӈ fdɄ Z#dʄ Z$e%d˄ Z&d̄ Z'd̈́ Z(d΄ Z)dτ Z*dЄ Z+dф Z,d҄ Z- xZ.S ) OptionParsera
Settings parser for command-line and library use.
The `settings_spec` specification here and in other Docutils components
are merged to build the set of command-line options and runtime settings
for this process.
Common settings (defined below) and component-specific settings must not
conflict. Short options are reserved for common settings, and components
are restricted to using long options.
Deprecated.
Will be replaced by a subclass of `argparse.ArgumentParser`.
)z/etc/docutils.confz./docutils.confz ~/.docutilsz(info 1 warning 2 error 3 severe 4 none 5rd r r rg )infowarningr severenoneTF) 1onyestrue0offnofalser r2 Nre rf zGeneral Docutils OptionszaOutput destination name. Obsoletes the <destination> positional argument. Default: None (stdout).z--outputmetavarz
<destination>z'Specify the document title as metadata.z--titlez<title>z2Include a "Generated by Docutils" credit and link.z --generatorz-g
store_true)actionr z"Do not include a generator credit.z--no-generator store_false generator)r r z2Include the date at the end of the document (UTC).z--datez-d store_constz%Y-%m-%d datestamp)r constr z Include the time & date (UTC).z--timez-tz%Y-%m-%d %H:%M UTCz'Do not include a datestamp of any kind.z--no-datestampz&Include a "View document source" link.z
--source-linkz-sz3Use <URL> for a source link; implies --source-link.z --source-urlz<URL>z-Do not include a "View document source" link.z--no-source-linkcallback) source_link
source_url)r r
callback_argsz4Link from section headers to TOC entries. (default)z--toc-entry-backlinks
toc_backlinksentry)r r r r z0Link from section headers to the top of the TOC.z--toc-top-backlinkstop)r r r z+Disable backlinks to the table of contents.z--no-toc-backlinks)r r z6Link from footnotes/citations to references. (default)z--footnote-backlinks)r r r z/Disable backlinks from footnotes and citations.z--no-footnote-backlinksfootnote_backlinksz0Enable section numbering by Docutils. (default)z--section-numbering
sectnum_xform)r r r r z&Disable section numbering by Docutils.z--no-section-numberingz/Remove comment elements from the document tree.z--strip-commentsz6Leave comment elements in the document tree. (default)z--leave-commentsstrip_commentszRemove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-elements-with-classrh strip_elements_with_classesz<class>)r r r r zRemove all classes="<class>" attributes from elements in the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z
--strip-class
strip_classeszReport system messages at or higher than <level>: "info" or "1", "warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"z--reportz-r report_levelz<level>)choicesr r r r z4Report all system messages. (Same as "--report=1".)z --verbosez-vz3Report no system messages. (Same as "--report=5".)z--quietz-qzdHalt execution at system messages at or above <level>. Levels as in --report. Default: 4 (severe).z--halt
halt_level)r r r r r z6Halt at the slightest problem. Same as "--halt=info".z--strictzjEnable a non-zero exit status for non-halting system messages at or above <level>. Default: 5 (disabled).z
--exit-statusexit_status_levelz3Enable debug-level system messages and diagnostics.z--debugz Disable debug output. (default)z
--no-debugdebugz-Send the output of system messages to <file>.z
--warningswarning_streamz<file>)r r z1Enable Python tracebacks when Docutils is halted.z --tracebackz%Disable Python tracebacks. (default)z--no-traceback tracebackzdSpecify the encoding and optionally the error handler of input text. Default: <auto-detect>:strict.z--input-encodingz-iz<name[:handler]>)r r zlSpecify the error handler for undecodable characters. Choices: "strict" (default), "ignore", and "replace".z --input-encoding-error-handlerstrict)r r z^Specify the text encoding and optionally the error handler for output. Default: utf-8:strict.z--output-encodingz-outf-8)r r r zSpecify error handler for unencodable output characters; "strict" (default), "ignore", "replace", "xmlcharrefreplace", "backslashreplace".z --output-encoding-error-handlerzOSpecify text encoding and optionally error handler for error output. Default: r. .z--error-encodingz-ezSSpecify the error handler for unencodable characters in error output. Default: %s.z --error-encoding-error-handlerz<Specify the language (as BCP 47 language tag). Default: en.z
--languagez-l
language_codeenz<name>)r r r z)Write output file dependencies to <file>.z--record-dependencies)r r r z6Read configuration settings from <file>, if it exists.z--configstring)r typer r z,Show this program's version number and exit.z --versionz-Vr versionz Show this help message and exit.z--helpz-hhelpz --id-prefixr r z--auto-id-prefix%z--dump-settingsz--dump-internalsz--dump-transformsz--dump-pseudo-xmlz--expose-internal-attributeexpose_internals)r r r z--strict-visitor)_disable_config_source _destination
_config_filesgeneralz%prog (Docutils z [%s]z , Python r z, on )rs c j i | _ g | _ dg| _ t j dt
d t
j |t dt j
d d| | j s | j | _ | g|R | _
| | j
| j |pi |rp| j d se | }n,# t$ $ r }| | Y d}~nd}~ww xY w| j |j dS dS dS )
zSet up OptionParser instance.
`components` is a list of Docutils components each containing a
``.settings_spec`` attribute.
`defaults` is a mapping of setting default overrides.
r ztThe frontend.OptionParser class will be replaced by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.r r NN )width) option_classadd_help_option formatterr )r config_filesrelative_path_settingsr r r r r r r TitledHelpFormatterr version_template
componentspopulate_from_componentsr r get_standard_config_settingsr r r ) r r
r read_config_filesr r config_settingsr r s r r zOptionParser.__init__ s
( ;'7&8#
3 )Q 8 8 8 8 '-d#+#?b#I#I#I * *"( * * * | 1 0DL -*-- %%do666
X^,,, ;T]3D%E ;
"&"C"C"E"E
3
M !9 : : : : : ; ; ; ;s C$ $
D
.DD
c L |D ]}||j }| j |j t dt | d D ]}|||dz \ }}}|r,t j | || }| | n| }|D ]=\ } }
} |j |
d| i| } | d dk rd| j
| j < >|j r | j
|j |D ]*}|r&|j r | j
|j +dS )ao Collect settings specification from components.
For each component, populate from the `SettingsSpec.settings_spec`
structure, then from the `SettingsSpec.settings_defaults` dictionary.
After all components have been processed, check for and populate from
each component's `SettingsSpec.settings_default_overrides` dictionary.
Nr r r r rh T)r r
rI r rj r OptionGroupadd_option_group
add_optiongetr r settings_defaultsr r settings_default_overrides)
r r
componentr rO title description option_specgroup help_textoption_stringsr r s
r r z%OptionParser.populate_from_components s $ F FI % 3M ' . .0
2
2
21c- 0 0!44
F
F2?!A#2F/{K ! $ 0uk J JE))%0000 E;F 7 77Y -U -~ 89 806 8 8F zz(++x7726
6;/ . FM(()DEEE
F $ K KI
KY A
K
$$Y%IJJJ K Kr c dt j v r0t j d t j }n| j }d |D S )z:Return list of config files, from environment or standard.DOCUTILSCONFIGc t g | ]5}| t j | 6S rs )r9 rw ru
expanduser)rN fs r rP z:OptionParser.get_standard_config_files.<locals>.<listcomp> s5 III!qwwyyI""1%%IIIr )rw environr0 pathsepstandard_config_files)r` r s r get_standard_config_filesz&OptionParser.get_standard_config_files sL rz ) ) :&67==bjIILL 4LII|IIIIr c . t j 5 t j dt t }d d d n # 1 swxY w Y | D ]+}| | | | ,|S )Nr r )r r r r r r( r r )r r filenames r r z)OptionParser.get_standard_config_settings s
$
&
& #H7I J J J J xxH 6688 K KH OOD 9 9( C CT J J J Js *A
AAc t }t }t j 5 t j dt
| xj | || z
c_ t }ddd n # 1 swxY w Y | j D ]r}|st |j pd |j fz D ]M}||v r|
| | | r | || | Nst! |j | j t& j | |j S )zAReturns a dictionary containing appropriate config file settings.r r Nrs ) ConfigParserr1 r r r r r readr r
r config_section_dependenciesr( add has_sectionr r{ r r
rw ru dirname)r config_filer' appliedr r sections r r z%OptionParser.get_config_file_settings s $
%%
$
&
& #H7I J J J J !3!3K!F!F F xxH B BI
!)"G"M2 N N ( 7 9 :
B
Bg%% G$$$ ,,W55 B OOM'$:DAAA
B H - 7 GOOK 8 8 : : : s AB
BBc | | \ |_ |_ t |j | j | j |_ |S )z/Store positional arguments as runtime settings.)
check_argsr r r{ r r
r r )r r r s r check_valueszOptionParser.check_values sB .2ood.C.C++FOT-HIII # 0
r c d x}}|r | d }|dk rd }|r | d }|dk rd }|r| d |r||k r| d ||fS )Nr r z Maximum 2 arguments allowed.z_Do not specify the same file for both source and destination. It will clobber the source file.)rH r )r r source destinations r r6 zOptionParser.check_args s ## XXa[[F}} # ((1++Kc!! " 7 JJ5 6 6 6 If ++ JJ H
I
I
I{""r c : | j | d S rX )r r r r s r set_defaults_from_dictz#OptionParser.set_defaults_from_dict s
X&&&&&r c t j 5 t j dt t | j }ddd n # 1 swxY w Y | j |_ |S )z(Needed to get custom `Values` instances.r r N)r r r r r r r r r< s r get_default_valuesz OptionParser.get_default_values s
$
&
& - - #H7I J J J J dm,,H - - - - - - - - - - - - - - - "&!2 s 0AAAc x | j | gz D ] }|j D ]}|j |k r|c c S t d|z )a
Get an option by its dest.
If you're supplying a dest which is shared by several options,
it is undefined which option of those is returned.
A KeyError is raised if there is no option with the supplied
dest.
zNo option with dest == %r.)
option_groups option_listr r; )r r r r s r get_option_by_destz OptionParser.get_option_by_dest si '4&0 " "E +
"
";$&&!MMMMM '
" 3d:;;;r )rs NF)/r r r r r' r0 threshold_choicesrC r8 r sysstderrr _locale_encodingdefault_error_encoding$default_error_encoding_error_handlerr< r rb rE r4 r, r[ r r rK r r r( r] __version____version_details__r platformr r r classmethodr( r r r7 r6 r= r? rC r r s @r r r s
CHHJJGAANNJ@dDu EEuF FH? %gcj*d C C )!#!4 )!( ,>( # e 9 ,O4
6 e 4 + 9-
/e
? $
L/?"A "A
B e /
L L
Ne ? T
}z%0 2 2
3e + T
}&:%0 2 2
3e " 4
'2 4 4
5#e ( 3 D
!l1A$C $C
D)e . @
Y 0
2/e 2 :
^ 9 ; ;
<3e : A "
#"mg
;e B =
!"me
L
L
NCe H 8
"m
<
<
>Ie N C !
"!a( * *
+Oe V < $
%'=
A
A
CWe \ =
!!?&6 8 8
9]e d 3 #
$"O
<
<
>ee j <
!0@
A
A
Cke p C
",<
=
=
?qe v # )
) 'D .B D D
Ewe B #
.B D D
ECe N K t
*;'5),> @ @
AOe X A
-!(6 8 8
9Ye ^ @ d
&4 6 6
7_e d 9 *"3\"# $68 8
9ee n C ,=1!-/ /
0oe t 6
):&9)*y+= ? ?
@ue @ @ +,%57 7
8Ae F - .]GDD
FGe J : .#3II
KKe N > /lt)9 ; ;
<Oe T 2
{m L L
NUe X I t
$(; = =
>Ye b B +
, -L
M
M
Oce j ,
%(W; = =
>ke t 5 -
- -L
M
M
Oue e B $
#
#%I%I%I K t
$(5K; = =
>e J ( 0 1 ,
,:7 9 9
:Ke V I
T,4!6 !6
7We \ 6 "
# -E
]e d C ,Hh#-;KM M
Nee j 9
) 4
6ke n - T
Xv .
0oe t - 9b/ :ue v ,- 3/? @we z +,x .F G{e | ,-,/G H}e ~ -.<0H Ie @ -.<0H IAe B 78 '9< > >
?Ce H ,-,/G HIe e h MR0 -1$()-*.0 0
NN $//#7 D &x'C C JGI J J ;,,..q1113<<< A
#"; "; "; "; "; ";H K K K@ J J [J ! ! !0 # # #"' ' ' < < < < < < <r r c R e Zd ZdZddddZ dZdZd fd Zd
Zd Z d Z
d
Z xZ S )r, aZ Parser for Docutils configuration files.
See https://docutils.sourceforge.io/docs/user/config.html.
Option key normalization includes conversion of '-' to '_'.
Config file encoding is "utf-8". Encoding errors are reported
and the affected file(s) skipped.
This class is provisional and will change in future versions.
)pep_html writer
stylesheet)rO stylesheet_path)rO template)pep_stylesheetpep_stylesheet_path pep_templatea The "[option]" section is deprecated.
Support for old-format configuration files will be removed in Docutils 0.21 or later. Please revise your configuration files. See <https://docutils.sourceforge.io/docs/user/config.html>, section "Old-Format Configuration Files".zhUnable to read configuration file "%s": content not encoded as UTF-8.
Skipping "%s" configuration file.
Nc | t j dt d g }t |t r|g}|D ]} |t |d z
}n9# t $ r, t j
| j ||fz Y _w xY wd| v r| | ||
|| |S )Nzbfrontend.ConfigParser.read(): parameter "option_parser" will be removed in Docutils 0.21 or later.r r r )r2 options)r r r r6 strr r- UnicodeDecodeErrorrE rF writenot_utf8_errorhandle_old_configvalidate_settings)r filenamesr& read_okr* r s r r- zConfigParser.readO s $ M 7 -
<
<
<
< i % % $" I!
@
@H
577<<7<CCC%
!4(7K!KLLL
D &&x000 (&&x ???s &A&&3B B c t j | j t |d | d }| d s| d | D ]z\ }}|| j v r;| j | \ }}| | s| | nd}|}| || s|
||| {| d d S )Nr rW r ) r
warn_explicit old_warningConfigDeprecationWarning get_sectionr0 add_sectionr
old_settings
has_optionr1 remove_section)r r* rW r r
r4 r% s r r\ z ConfigParser.handle_old_configg s t /1I ' , , ,""9-- ** ( Y ' ' '!--// 2 2JCd'''#'#4S#9 ''00 .$$W---# ??7G44
2'5111 I&&&&&r c | D ]}| | D ]} | | }n# t $ r Y %w xY w|j r| || } | |||| | }nB# t $ r5}t d| d| dt j | d| d|
d}~ww xY w|
||| |j r |
||j d ߌdS )zi
Call the validator function and implement overrides on all applicable
settings.
)r' r( zError in config file "z
", section "[z]":
z
z = N) sectionsrW rC r; r r r r r r r1 r ) r r* r& r4 r% r r
r r s r r] z ConfigParser.validate_settingsy s
}} > >G <<00
>
> * = =g F FFF H # : HHWg 6 6EI$*$4$4 #UM*.w %5 %H %H % I I I ( *H( *H *H6=*H *H020D0D*H *H 5<*H *H AF*H *H I I II
HHWgy999# >HHWf&6===%
> > >s) A
AA3B
C
0CC
c R | dd S )z
Lowercase and transform '-' to '_'.
So the cmdline form of option names can be used in config files.
r r )r: r )r optionstrs r optionxformzConfigParser.optionxform s$ ((c222r c t j dt d t | | S # t $ r i cY S w xY w)z
Return a given section as a dictionary.
Return empty dictionary if the section doesn't exist.
Deprecated. Use the configparser "Mapping Protocol Access" and
catch KeyError.
zNfrontend.OptionParser.get_section() will be removed in Docutils 0.21 or later.r r )r r r r r; )r r4 s r rd zConfigParser.get_section sc
C(Q 8 8 8 8 W
&& & III s 3 AArX )
r r r r rf rb r[ r- r\ r] rm rd r r s @r r, r, . s
< E79 9L
4 N
0' ' '$> > >43 3 3 r r, c e Zd ZdZdS )rc z3Warning for deprecated configuration file features.N)r r r r rs r r rc rc s ====r rc c t j 5 t j dt t | cddd S # 1 swxY w Y dS )a| Return default runtime settings for `components`.
Return a `frontend.Values` instance with defaults for generic Docutils
settings and settings from the `components` (`SettingsSpec` instances).
This corresponds to steps 1 and 2 in the `runtime settings priority`__.
__ https://docutils.sourceforge.io/docs/api/runtime-settings.html
#settings-priority
r r N)r r r r r r? )r
s r get_default_settingsrq s
" " = = 3EFFFFJ''::<<= = = = = = = = = = = = = = = = = =s <A A!$A!)NNrX )(r
__docformat__r! configparserr r rw os.pathrE r r] r r r r r) r, r4 r< r> rA rE rK rR rV r[ rb rp r{ rt r r r r SettingsSpecRawConfigParserr,
FutureWarningrc rq rs r r <module>rx sK
. .` #
" " " " " "
+
+
+/ / / :> HL
GK 0 9= A A A A 9= AE ;?@ @ @ @ GK FJ
" GK AE* * * * =A EI! ! ! !H" " " "(: : : :+# +# +# +# +#X_ +# +# +#\" " " " "X_ " " "JG< G< G< G< G<8((*? G< G< G<T | | | | |</ | | |~> > > > >} > > >
=
=
=
=
=r