3
T'ícÒ ã @ sÈ d Z dZddlZddlZddlZddlZddlZddlZddlmZ ej d8krhddl
m Z ddlm Z nddl
m Z ddlmZ ddlZddlZddlZdd lmZmZmZmZ ej d9kr¾eZd
d Zd d
Zd:ddZd;ddZ d<ddZ d=ddZ d>ddZ d?ddZ d@ddZ!dAd d Z"dBd d Z#dCd d!Z$dDd"d#Z%dEd$d%Z&dFd&d'Z'dGd(d)Z(d*d+ Z)d,d- Z*G d.d/ d/ej+Z+G d0d1 d1ej,Z,G d2d3 d3ej-ej.Z-G d4d5 d5e Z
G d6d7 d7e/Z0dS )Hau
Command-line and common processing for Docutils front-end tools.
Exports the following classes:
* `OptionParser`: Standard Docutils command-line processing.
* `Option`: Customized version of `optparse.Option`; validation support.
* `Values`: Runtime settings; objects are simple structs
(``object.attribute``). Supports cumulative list settings (attributes).
* `ConfigParser`: Standard Docutils config file processing.
Also exports the following functions:
* Option callbacks: `store_multiple`, `read_config_file`.
* Setting validators: `validate_encoding`,
`validate_encoding_error_handler`,
`validate_encoding_and_error_handler`,
`validate_boolean`, `validate_ternary`, `validate_threshold`,
`validate_colon_separated_list`,
`validate_comma_separated_list`,
`validate_dependency_file`.
* `make_paths_absolute`.
* SettingSpec manipulation: `filter_settings_spec`.
ZreStructuredTexté N)Ú
SUPPRESS_HELPé )ÚRawConfigParser)Úgetcwd)Úgetcwdu)Úlocale_encodingÚ
SafeStringÚ ErrorOutputÚ ErrorStringc O sD x|D ]}t |j|d qW x"|j D ]\}}t |j|| q&W 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)ÚsetattrÚvaluesÚitems)ÚoptionÚoptÚvalueÚparserÚargsÚkwargsÚ attributeÚkey© r ú5/tmp/pip-build-gk9425m9/docutils/docutils/frontend.pyÚstore_multiple8 s
r c C sN y|j |}W n, tk
r: } z|j| W Y dd}~X nX |jj|| dS )zQ
Read a configuration file during option processing. (Option callback.)
N)Úget_config_file_settingsÚ
ValueErrorÚerrorr Úupdate)r r r r Z new_settingsr r r r Úread_config_fileD s
r c C s8 yt j| W n$ tk
r2 td| |f Y nX |S )Nz$setting "%s": unknown encoding: "%s")ÚcodecsÚlookupÚ LookupError)Úsettingr Ú
option_parserÚ
config_parserÚconfig_sectionr r r Úvalidate_encodingN s r% c C s4 yt j| W n tk
r. td| Y nX |S )Nz¿unknown encoding error handler: "%s" (choices: "strict", "ignore", "replace", "backslashreplace", "xmlcharrefreplace", and possibly others; see documentation for the Python ``codecs`` module))r Ú lookup_errorr )r! r r" r# r$ r r r Ú validate_encoding_error_handlerW s r' c C sn d|krV|j d\}}t| d |||| |rB|j|| d | qZt|j| d | 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.
ú:Z_error_handler)Úsplitr' Úsetr r r% )r! r r" r# r$ ÚencodingÚhandlerr r r Ú#validate_encoding_and_error_handlerc s
r- c C sF t |tr|S y|j|j j S tk
r@ td| Y nX dS )z|Check/normalize boolean settings:
True: '1', 'on', 'yes', 'true'
False: '0', 'off', 'no','false', ''
zunknown boolean value: "%s"N)Ú
isinstanceÚboolÚbooleansÚstripÚlowerÚKeyErrorr )r! r r" r# r$ r r r Úvalidate_booleany s
r4 c C sB t |ts|dkr|S y|j|j j S tk
r< |S X dS )zªCheck/normalize three-value settings:
True: '1', 'on', 'yes', 'true'
False: '0', 'off', 'no','false', ''
any other value: returned as-is.
N)r. r/ r0 r1 r2 r3 )r! r r" r# r$ r r r Úvalidate_ternary s r5 c C s t |}|dk rtd|S )Nr z(negative value; must be positive or zero)Úintr )r! r r" r# r$ r r r Úvalidate_nonnegative_int s r7 c C sV yt |S tk
rP y|j|j S ttfk
rJ td| Y nX Y nX d S )Nzunknown threshold: %r.)r6 r Ú
thresholdsr2 r3 ÚAttributeErrorr )r! r r" r# r$ r r r Úvalidate_threshold s r: c C s2 t |ts|jd}n|j }|j|jd |S )Nr( )r. Úlistr) ÚpopÚextend)r! r r" r# r$ Úlastr r r Ú$validate_colon_separated_string_list¥ s
r? c C s: t |ts|g}|j }dd |jdD }|j| |S )zHCheck/normalize list arguments (split at "," and strip whitespace).
c S s g | ]}|j d r|j d qS )z
)r1 )Ú.0Úir r r ú
<listcomp>¹ s z1validate_comma_separated_list.<locals>.<listcomp>ú,)r. r; r< r) r= )r! r r" r# r$ r> r
r r r Ú validate_comma_separated_list® s
rD c C s" |sdS |j dr|S |d S d S )Nz./ú/)Úendswith)r! r r" r# r$ r r r Úvalidate_url_trailing_slash½ s
rG c C s. y t jj|S tk
r( t jjd S X d S )N)ÚdocutilsÚutilsÚDependencyListÚIOError)r! r r" r# r$ r r r Úvalidate_dependency_fileÆ s rL c C sF t | ||||}x0|D ](}tjj|}||krtd||f qW |S )Nz$Invalid class value %r (perhaps %r?))rD rH ZnodesZmake_idr )r! r r" r# r$ ÚclsÚ
normalizedr r r Úvalidate_strip_classÍ s
rO c
C sÔ t | ||||}g }xº|D ]²}y|jdd\}}W nF tk
rR |j| wY n( tk
rx td|jdd Y nX |j }|jd} t| dkr| }n t|dkr¾td|jdd |j||f qW |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>".ÚasciiÚbackslashreplaceé z[Invalid value "%s". Please specify 4 quotes
(primary open/close; secondary open/close).)rD r) r9 Úappendr Úencoder1 Úlen)
r! r r" r# r$ Z lc_quotesÚitemÚlangÚquotesZmultichar_quotesr r r Ú validate_smartquotes_localesÚ s*
rZ c sd dkrt xP|D ]H}|| kr| | }t|trF fdd|D }n|rTt |}|| |< qW dS )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 s g | ]}t |qS r )Úmake_one_path_absolute)r@ Úpath)Ú base_pathr r rB s z'make_paths_absolute.<locals>.<listcomp>)r r. r; r[ )ZpathdictÚkeysr] r r r )r] r Úmake_paths_absoluteý s
r_ c C s t jjt jj| |S )N)Úosr\ ÚabspathÚjoin)r] r\ r r r r[ s r[ c O s t | }xtdt|dD ]l}g }xV|| D ]J}dd |d D d }||krPq,||j krl|j|| q,|j| q,W t|||< qW t|S )a Return a copy of `settings_spec` excluding/replacing some settings.
`settings_spec` is a tuple of configuration settings with a structure
described for 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.)
é r c S s* g | ]"}|j d r|dd
jddqS )z--rc Nú-Ú_)Ú
startswithÚreplace)r@ Z
opt_stringr r r rB $ s z(filter_settings_spec.<locals>.<listcomp>rP r )r; ÚrangerV r^ rT Útuple)Ú
settings_specÚexcluderg ÚsettingsrA ZnewoptsZopt_specÚopt_namer r r Úfilter_settings_spec s
rn c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) ÚValuesz
Updates list attributes by extension rather than by replacement.
Works in conjunction with the `OptionParser.lists` instance attribute.
c O s: t jj| f|| t| d s*| jd kr6tjj | _d S )NÚrecord_dependencies)Úoptparsero Ú__init__Úhasattrrp rH rI rJ )Úselfr r r r r rr 9 s
zValues.__init__c C sl t |tr|j}|j }xD|jj D ]6}t| |r$||kr$t| |}|r$||| 7 }||= q$W | j| d S )N) r. ro Ú__dict__ÚcopyÚlistsr^ rs ÚgetattrÚ
_update_loose)rt Ú
other_dictr" r! r r r r r @ s
z
Values.updatec C s | j | jdS )z Return a shallow copy of `self`.)Údefaults)Ú __class__ru )rt r r r rv L s z Values.copyc C s& t | |ddkr t| || t | |S )zUV.setdefault(n[,d]) -> getattr(V,n,d), also set D.n=d if n not in D or None.
N)rx r )rt ÚnameÚdefaultr r r Ú
setdefaultP s zValues.setdefaultN)Ú__name__Ú
__module__Ú __qualname__Ú__doc__rr r rv r r r r r ro 2 s
ro c @ s$ e Zd Zejjddg Zdd ZdS )ÚOptionÚ validatorÚ overridesc C s t jj| ||||}| j}|r| jrt||}y| j|||}W n8 tk
rx } z t jd|t|f W Y dd}~X nX t ||| | j
rt || j
d |S )z
Call the validator function on applicable settings and
evaluate the 'overrides' option.
Extends `optparse.Option.process`.
z Error in option "%s":
%sN) rq r ÚprocessÚdestr
rx Ú ExceptionÚOptionValueErrorr
r r ) rt r r r r Úresultr! Ú new_valuer r r r r \ s
" zOption.processN)r r r rq r ÚATTRSr r r r r r X s r c 8 @ s~ e Zd ZdZdddgZdj Zdddd d
d Zd d d d d
d
d
d
d
d Ze e
j ddpZe pZdZ
dZddddgi fdddgdedfdd gd d d fd d!d"gd#d$d%d&fd'd(d)gd#d*d%d&fd+d,gd#dd%d&fd-d.d/gdedfd0d1gd2d3ifd4d5gd6edÖd9fd:d;gd<d#d=d=d>fd?d@gd<d#dAdBfdCdDgd<d dEfdFdGgddedHfdIdJgdKd dEfdLdMgddNdedOfdPdQgd dNd fdRdSgdedfdTdUgd dVd fdWdXgdYdZd[ed\fd]d^gdYd_d[ed\fd`dadbgeddcddedefdfdgdhgd#ddcd&fdidjdkgd#d
dcd&fdldmgednd ddedofdpdqgd#ddnd&fdrdsgedtd
ddedofdudvgdedfdwdxgd dyd fdzd{gd|d}d~fddgddedHfddgdd dEfdd
dgdedfddgdedfdddgddedfddgdedfde
ef ddgde
edfde dgeedfdddgddddfd d¡gd}edd¢fd£d¤gd}d¥d6ed¦fd§d¨d©gdªd«ifd¬dd®gdªd¯ifed°gd±d²ifed³gd±d´ifedµgdªdifed¶gdªdifed·gdªdifed¸gdªdifed¹gdYdºed»fed¼gdªdiff2fZddddd½Zd×Zd¾Z d¿e j e j r
dÀe j p d²e
j j dÁ e
j!f Z"f ddfdÂdÃZ#dÄdÅ Z$dÆdÇ Z%dÈdÉ Z&dÊdË Z'dÌdÍ Z(dÎdÏ Z)dÐdÑ Z*dÒdÓ Z+dÔdÕ Z,dS )ØÚ OptionParsera¢
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 restrict to using long options.
z/etc/docutils.confz./docutils.confz ~/.docutilsz(info 1 warning 2 error 3 severe 4 none 5rP rc r rS é )ÚinfoÚwarningr ZsevereÚnoneTF) Ú1ÚonÚyesÚtrueÚ0ÚoffÚnoÚfalseÚ r+ NrQ rR zGeneral Docutils Optionsz'Specify the document title as metadata.z--titlez2Include 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-%dZ 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-urlÚmetavarz<URL>z-Do not include a "View document source" link.z--no-source-linkÚcallbackÚ source_linkÚ
source_url)r r£ Ú
callback_argsz4Link from section headers to TOC entries. (default)z--toc-entry-backlinksZ
toc_backlinksÚentry)r r r¡ r~ z0Link from section headers to the top of the TOC.z--toc-top-backlinksÚtop)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-backlinksZfootnote_backlinksz0Enable section numbering by Docutils. (default)z--section-numberingZ
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-commentsÚstrip_commentszRemove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-elements-with-classrT Zstrip_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-classZ
strip_classeszReport system messages at or higher than <level>: "info" or "1", "warning"/"2" (default), "error"/"3", "severe"/"4", "none"/"5"z--reportz-rZ 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--haltZ
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-statusZexit_status_levelz3Enable debug-level system messages and diagnostics.z--debugz Disable debug output. (default)z
--no-debugÚdebugz-Send the output of system messages to <file>.z
--warningsÚwarning_streamz<file>)r r¢ z1Enable Python tracebacks when Docutils is halted.z --tracebackz%Disable Python tracebacks. (default)z--no-tracebackÚ tracebackziSpecify the encoding and optionally the error handler of input text. Default: <locale-dependent>: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-handlerÚstrict)r~ r
z^Specify the text encoding and optionally the error handler for output. Default: UTF-8:strict.z--output-encodingz-ozutf-8)r¢ r~ r
zSpecify error handler for unencodable output characters; "strict" (default), "ignore", "replace", "xmlcharrefreplace", "backslashreplace".z --output-encoding-error-handlerzJSpecify text encoding and error handler for error output. Default: %s:%s.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-lZ
language_codeÚenz<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--configÚstring)r¢ Útyper r£ z,Show this program's version number and exit.z --versionz-Vr Úversionz Show this help message and exit.z--helpz-hÚhelpz --id-prefixr~ r z--auto-id-prefixÚidz--dump-settingsz--dump-internalsz--dump-transformsz--dump-pseudo-xmlz--expose-internal-attributeZexpose_internals)r r r
z--strict-visitor)Ú_disable_configÚ_sourceÚ _destinationÚ
_config_filesÚgeneralz(%%prog (Docutils %s%s, Python %s, on %s)z [%s]r c O sÖ i | _ g | _tjj| f|tdtjddd| | jsB| j| _t | j
| _
| ft | | _ | j
| j | j|pti |rÒ| jd rÒy | j }W n0 tk
rÄ } z| jt| W Y dd}~X nX | j|j dS )z¶
`components` is a list of Docutils components each containing a
``.settings_spec`` attribute. `defaults` is a mapping of setting
default overrides.
NéN )Úwidth)Ú option_classÚadd_help_optionÚ formatterrµ )rw Ú config_filesrq r rr r ÚTitledHelpFormatterr² Úversion_templater; Úrelative_path_settingsri Ú
componentsÚpopulate_from_componentsÚset_defaults_from_dictr{ Ú get_standard_config_settingsr r r ru )rt rà r{ Zread_config_filesr r Zconfig_settingsr r r r rr O s" zOptionParser.__init__c
C sþ xÒ|D ]Ê}|dkrq|j }| jj|j x¦tdt|dD ]}|||d
\}}}|rrtj| ||}| j| n| }x@|D ]8\} }
} |j|
d| i| } | j ddkr|d| j
| j < q|W |j r:| j
j|j q:W qW x$|D ] }|rÚ|jrÚ| j
j|j qÚW dS )aE
For each component, first 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 rT T)rj r r= rh rV rq Ú OptionGroupÚadd_option_groupÚ
add_optionÚgetrw r Úsettings_defaultsr{ r Zsettings_default_overrides)
rt rÃ Ú componentrj rA ÚtitleÚ descriptionZ option_specÚgroupÚ help_textÚoption_stringsr r r r r rÄ o s,
z%OptionParser.populate_from_componentsc s yt jd jt j}W n tk
r0 | j}Y nX t jj dt jkrny ddl}W n t k
rl dd Y nX fdd|D S ) z:Return list of config files, from environment or standard.ZDOCUTILSCONFIGÚHOMEr Nc S s | S )Nr )Úxr r r Ú<lambda> s z8OptionParser.get_standard_config_files.<locals>.<lambda>c s g | ]}|j r |qS r )r1 )r@ Úf)Úexpandr r rB s z:OptionParser.get_standard_config_files.<locals>.<listcomp>)
r` Úenvironr) Úpathsepr3 Ústandard_config_filesr\ Ú
expanduserÚpwdÚ ImportError)rt r¿ rÛ r )rÖ r Úget_standard_config_files s
z&OptionParser.get_standard_config_filesc C s. t }x"| j D ]}|j| j|| qW |S )N)ro rÝ r r )rt rl Úfilenamer r r rÆ ¢ s z)OptionParser.get_standard_config_settingsc C s¦ t }|j|| | jj|j tjj|}i }t }xX| j D ]N}|sHq>xBt
|j pTf |j f D ](}||krnq`d||< |j
|j|| q`W q>W t|j| j| |jS )zAReturns a dictionary containing appropriate config file settings.rP )Ú ConfigParserÚreadr¿ r= Ú_filesr` r\ Údirnamero rà ri Zconfig_section_dependenciesr$ r Ú get_sectionr_ ru r )rt Ú config_filer r] Zappliedrl rÌ Úsectionr r r r ¨ s$ z%OptionParser.get_config_file_settingsc C s, | j |\|_|_t|j| j | j|_|S )z/Store positional arguments as runtime settings.)Ú
check_argsr¶ r· r_ ru r r¿ r¸ )rt r r r r r Ú check_values½ s zOptionParser.check_valuesc C sh d }}|r"|j d}|dkr"d }|r<|j d}|dkr<d }|rJ| jd |r`||kr`| jd ||fS )Nr rd z Maximum 2 arguments allowed.z_Do not specify the same file for both source and destination. It will clobber the source file.)r< r )rt r ÚsourceZ destinationr r r ræ Ä s
zOptionParser.check_argsc C s | j j| d S )N)r{ r )rt r{ r r r rÅ Õ s z#OptionParser.set_defaults_from_dictc C s t | j}| j|_|S )z(Needed to get custom `Values` instances.)ro r{ r¿ r¸ )rt r{ r r r Úget_default_valuesØ s
z OptionParser.get_default_valuesc C sD x2| j | g D ]"}x |jD ]}|j|kr|S qW qW td| dS )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.N)Ú
option_groupsÚ option_listr r3 )rt r rÏ r r r r Úget_option_by_destÞ s
z OptionParser.get_option_by_dest)r¤ r¥ )r¬ )-r r r r rÙ r) Zthreshold_choicesr8 r0 rx ÚsysÚstderrr Zdefault_error_encodingZ$default_error_encoding_error_handlerr4 r rO r: r- r' rL r r r? rj rË r r$ rH Ú __version__Z__version_details__r² ÚplatformrÁ rr rÄ rÝ rÆ r rç ræ rÅ ré rì r r r r r s sf
r c @ sP e Zd ZddddZdZdZdd Zd
d Zd d
Zdd Z dd Z
dd Z dS )rß úpep_html writerÚ
stylesheetÚstylesheet_pathÚtemplate)Zpep_stylesheetZpep_stylesheet_pathZ pep_templatea
The "[option]" section is deprecated. Support for old-format configuration
files may be removed in a future Docutils release. Please revise your
configuration files. See <http://docutils.sf.net/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.
c O s$ t j| f|| g | _t | _d S )N)r rr rá r Ú_stderr)rt r r r r r rr s zConfigParser.__init__c C sè t |ttfkr|g}xÌ|D ]Ä}ytj|dd}W n tk
rH w Y nX y,tjdk rftj | || ntj
| || W n4 t k
rª | j j
| j||f |j w Y nX |j | jj| | jdrÔ| j| | j|| q W d S )NÚrzutf-8r r Úoptions)r r )r± ÚstrÚunicoder ÚopenrK rí Ú version_infor ÚreadfpÚ read_fileÚUnicodeDecodeErrorrõ ÚwriteÚnot_utf8_errorÚcloserá rT Ú has_sectionÚhandle_old_configÚvalidate_settings)rt Ú filenamesr" rÞ Úfpr r r rà
s(
zConfigParser.readc C s¤ t j| jt|d | jd}| jds0| jd xd|j D ]X\}}|| jkrp| j| \}}| j|sx| j| nd}|}| j ||s:| j
||| q:W | j d d S )Nr r÷ r¹ ) ÚwarningsÚ
warn_explicitÚ old_warningÚConfigDeprecationWarningrã r Ú add_sectionr
Ú old_settingsÚ
has_optionr* Úremove_section)rt rÞ r÷ r r rå r! r r r r % s
z ConfigParser.handle_old_configc C sÜ xÖ| j D ]Ê}xÄ| j|D ]¶}y|j|}W n tk
rB wY nX |jrº| j||}y|j|||| |d}W n< tk
rª } z td||t|||f W Y dd}~X nX | j ||| |j
r| j ||j
d qW q
W dS )zi
Call the validator function and implement overrides on all applicable
settings.
)r# r$ zAError in config file "%s", section "[%s]":
%s
%s = %sN) Úsectionsr÷ rì r3 r
rÊ r r r
r* r ) rt rÞ r" rå r! r r r r r r r r 7 s(
z ConfigParser.validate_settingsc C s |j jddS )zW
Transform '-' to '_' so the cmdline form of option names can be used.
rd re )r2 rg )rt Ú optionstrr r r Ú optionxformS s zConfigParser.optionxformc C s6 i }| j |r2x"| j|D ]}| j||||< qW |S )zf
Return a given section as a dictionary (empty if the section
doesn't exist).
)r r÷ rÊ )rt rå Z section_dictr r r r rã Y s
zConfigParser.get_sectionN)rñ rò )rñ ró )rñ rô ) r r r r r r rr rà r r r rã r r r r rß ï s rß c @ s e Zd ZdZdS )r
z3Warning for deprecated configuration file features.N)r r r r r r r r r
e s r
)r r )r r )NN)NN)NN)NN)NN)NN)NN)NN)NN)NN)NN)NN)NN)N)1r Z
__docformat__r` Úos.pathrí r r rq r rû Ú configparserr r rß r rH Zdocutils.utilsZdocutils.nodesZ docutils.utils.error_reportingr r r r
rø rù r r r% r' r- r4 r5 r7 r: r? rD rG rL rO rZ r_ r[ rn ro r r Z SettingsSpecÚDeprecationWarningr
r r r r Ú<module> sX
"
& ~v