Your IP : 216.73.216.213
��] � � @ sc d Z d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m
Z
d d l Z d d l Z d d l
Z d d l m Z m Z m Z m Z d d � Z d d � Z d d d
d � Z d d d d
� Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d � Z d d d d! � Z d d d" d# � Z! d d$ d% � Z" d& d' � Z# d( d) � Z$ Gd* d+ � d+ e j% � Z% Gd, d- � d- e j& � Z& Gd. d/ � d/ e j' e j( � Z' Gd0 d1 � d1 e j) � Z* Gd2 d3 � d3 e+ � Z, d S)4a�
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_string_list`,
`validate_comma_separated_string_list`,
`validate_dependency_file`.
* `make_paths_absolute`.
* SettingSpec manipulation: `filter_settings_spec`.
ZreStructuredText� N)�
SUPPRESS_HELP)�locale_encoding�
SafeString� ErrorOutput� ErrorStringc O s^ x! | D] } t | j | d � q Wx3 t | j � � D] \ } } t | j | | � q7 Wd S)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�list�items)�option�opt�value�parser�args�kwargsZ attribute�key� r �B/opt/alt/python35/lib/python3.5/site-packages/docutils/frontend.py�store_multiple/ s
r c C s_ y | j | � } Wn2 t k
rG } z | j | � WYd d } ~ Xn X| j j | | � d S)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_file; s
r c C s@ y t j | � Wn( t k
r; t d | | f � � Yn X| S)Nz$setting "%s": unknown encoding: "%s")�codecs�lookup� LookupError)�settingr
�
option_parser�
config_parser�config_sectionr r r �validate_encodingE s
r! c C s: y t j | � Wn" t k
r5 t d | � � Yn X| 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_handlerN s
r# c C s� d | k ru | j d � \ } } t | d | | | | � | r[ | j | | d | � q{ t | 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 �encodingZhandlerr r r �#validate_encoding_and_error_handlerZ s
r( c C sW t | t � r | Sy | j | j � j � SWn" t k
rR t d | � � Yn Xd S)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_booleanp s
r/ c C sW t | t � s | d k r | Sy | j | j � j � SWn t k
rR | SYn Xd S)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* r+ r, r- r. )r r
r r r r r r �validate_ternary} s
r0 c C s( t | � } | d k r$ t d � � | S)Nr z(negative value; must be positive or zero)�intr )r r
r r r r r r �validate_nonnegative_int� s r2 c C sg y t | � SWnR t k
rb y | j | j � SWn( t t f k
r] t d | � � Yn XYn Xd S)Nzunknown threshold: %r.)r1 r �
thresholdsr- r. �AttributeErrorr )r r
r r r r r r �validate_threshold� s
r5 c C sG t | t � s! | j d � } n" | j � } | j | j d � � | S)Nr$ )r) r r% �pop�extend)r r
r r r �lastr r r �$validate_colon_separated_string_list� s
r9 c C sQ t | t � s | g } | j � } d d � | j d � D� } | j | � | S)zHCheck/normalize list arguments (split at "," and strip whitespace).
c S s. g | ]$ } | j d � r | j d � � q S)z
)r, )�.0�ir r r �
<listcomp>� s z1validate_comma_separated_list.<locals>.<listcomp>�,)r) r r6 r% r7 )r r
r r r r8 r
r r r � validate_comma_separated_list� s
r> c C s) | s
d S| j d � r | S| d Sd S)Nz./�/)�endswith)r r
r r r r r r �validate_url_trailing_slash� s
rA c C s= y t j j | � SWn" t k
r8 t j j d � SYn Xd S)N)�docutils�utils�DependencyList�IOError)r r
r r r r r r �validate_dependency_file� s
rF c C sa t | | | | | � } xB | D]: } t j j | � } | | k r t d | | f � � q W| S)Nz$Invalid class value %r (perhaps %r?))r> rB ZnodesZmake_idr )r r
r r r �clsZ
normalizedr r r �validate_strip_class� s
rH c
C s t | | | | | � } g } x� | D]� } y | j d d � \ } } WnO t k
rk | j | � w% Yn. t k
r� t d | j d d � � � Yn X| j � } | j d � } t | � d k r� | } n. t | � d k r� t d | j d d � � � | j | | f � q% W| 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).)r> r% r4 �appendr �encoder, �len)
r r
r r r Z lc_quotes�item�langZquotesZmultichar_quotesr r r � validate_smartquotes_locales� s*
rR c s� � d k r t j � � xn | D]f } | | k r | | } t | t � rf � f d d � | D� } n | r{ t � | � } | | | <q Wd S)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 � | � � q Sr )�make_one_path_absolute)r: �path)� base_pathr r r< s z'make_paths_absolute.<locals>.<listcomp>)�os�getcwdr) r rS )Zpathdict�keysrU r r
r )rU r �make_paths_absolute� s
rY c C s t j j t j j | | � � S)N)rV rT �abspath�join)rU rT r r r rS s rS c O s� t | � } x� t d t | � d � D]� } g } xu | | D]i } d d � | d D� d } | | k rl q< | t | j � � k r� | j | | � q< | j | � q< Wt | � | | <q% Wt | � 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.)
� � c S s; g | ]1 } | j d � r | d d � j d d � � q S)z--r\ N�-�_)�
startswith�replace)r: Z
opt_stringr r r r< s z(filter_settings_spec.<locals>.<listcomp>rI r )r �rangerO rX rM �tuple)�
settings_specZexcludera �settingsr; ZnewoptsZopt_spec�opt_namer r r �filter_settings_spec s
rg c @ s: e Z d Z d Z d d � Z d d � Z d d � Z d S) �Valuesz�
Updates list attributes by extension rather than by replacement.
Works in conjunction with the `OptionParser.lists` instance attribute.
c O sK t j j | | | � t | d � s5 | j d k rG t j j � | _ d S)N�record_dependencies)�optparserh �__init__�hasattrri rB rC rD )�selfr r r r r rk 0 s zValues.__init__c C s� t | t � r | j } | j � } xb t | j j � � D]K } t | | � r: | | k r: t | | � } | r: | | | 7} | | =q: W| j | � d S)N)
r) rh �__dict__�copyr �listsrX rl �getattrZ
_update_loose)rm �
other_dictr r r
r r r r 7 s z
Values.updatec C s | j d | j � S)z Return a shallow copy of `self`.�defaults)� __class__rn )rm r r r ro C s z Values.copyN)�__name__�
__module__� __qualname__�__doc__rk r ro r r r r rh ) s rh c @ s2 e Z d Z e j j d d g Z d d � Z d S)�Option� validator� overridesc C s� t j j | | | | | � } | j } | r� | j r� t | | � } y | j | | | � } WnD t k
r� } z$ t j d | t | � f � � WYd d } ~ Xn Xt | | | � | j
r� t | | 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) rj ry �process�destrz rq � ExceptionZOptionValueErrorr r r{ ) rm r r
r r �resultr � new_valuer r r r r| L s ) zOption.processN)ru rv rw rj ry ZATTRSr| r r r r ry H s ry c : @ s� e Z d Z d Z d d d g Z d j � Z d d d d d
d d d
d d i Z d d d d d d d d d d d d d d d d d d i Z e e
j d d � p� e p� d Z
d Z d d d d! g i f d" d# d$ g d% d& d' e i f d( d) g d% d* d+ d, i f d- d. d/ g d% d0 d1 d2 d+ d3 i f d4 d5 d6 g d% d0 d1 d7 d+ d3 i f d8 d9 g d% d0 d1 d d+ d3 i f d: d; d< g d% d& d' e i f d= d> g d? d@ i f dA dB g d% dC dC e dD d� i f dG dH g d+ dI d% d0 d1 dJ dK dJ i f dL dM g d+ dI d% d0 d1 dN i f dO dP g d+ dI d% d* i f dQ dR g d% d& dK d d' e i f dS dT g d+ dU d% d* i f dV dW g d% d& d+ dX dK d d' e i f dY dZ g d% d* d+ dX i f d[ d\ g d% d& d' e i f d] d^ g d% d* d+ d_ i f d` da g d% db d+ dc d? dd d' e i f de df g d% db d+ dg d? dd d' e i f dh di dj g dk e dK d d+ dl d? dm d' e i f dn do dp g d% d0 d1 d d+ dl i f dq dr ds g d% d0 d1 d d+ dl i f dt du g dk e d+ dv dK d
d? dm d' e i f dw dx g d% d0 d1 d d+ dv i f dy dz g dk e d+ d{ dK d d? dm d' e i f d| d} g d% d& d' e i f d~ d g d% d* d+ d� i f d� d� g d+ d� d? d� i f d� d� g d% d& dK d d' e i f d� d� g d+ d� d% d* i f d� d� d� g d? d� d' e i f d� d� g dK d� d' e i f d� d� d� g d? d� dK d� d' e i f d� d� g dK d� d' e i f d� e
e f d� d� g d? d� dK e
d' e i f d� e d� g dK e d' e i f d� d� d� g d+ d� dK d� d? d� i f d� d� g d? d� d' e dK d i f d� d� g d? d� d� d� d% dC dC e i f d� d� d� g d% d� i f d� d� d� g d% d� i f e d� g dK d i f e d� g dK d� i f e d� g d% d& i f e d� g d% d& i f e d� g d% d& i f e d� g d% d& i f e d� g d% db d+ d� d' e i f e d� g d% d& i f f2 f Z d� d d� d d� d d� d i Z d� Z d� Z d� e j e j r d� e j pd e
j j � d� e
j! f Z" f d d 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+ d� d� � Z, d S)�� 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 5�inforI Zwarningr\ r r] ZsevererL Znone� �1T�on�yes�true�0F�off�no�false� r' NrJ rK zGeneral Docutils Optionsz'Specify the document title as metadata.z--titlez2Include a "Generated by Docutils" credit and link.z --generatorz-g�action�
store_truerz z"Do not include a generator credit.z--no-generatorZ store_falser} � generatorz2Include the date at the end of the document (UTC).z--datez-dZ store_constZconstz%Y-%m-%dZ datestampz 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�callbackZ
callback_args� source_link�
source_urlz4Link from section headers to TOC entries. (default)z--toc-entry-backlinksZ
toc_backlinks�entry�defaultz0Link from section headers to the top of the TOC.z--toc-top-backlinks�topz+Disable backlinks to the table of contents.z--no-toc-backlinksz6Link from footnotes/citations to references. (default)z--footnote-backlinksz/Disable backlinks from footnotes and citations.z--no-footnote-backlinksZfootnote_backlinksz0Enable section numbering by Docutils. (default)z--section-numberingZ
sectnum_xformz&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_commentsz�Remove all elements with classes="<class>" from the document tree. Warning: potentially dangerous; use with caution. (Multiple-use option.)z--strip-elements-with-classrM Zstrip_elements_with_classesz<class>z�Remove 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-r�choicesZ report_levelz<level>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_levelz6Halt 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>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]>zlSpecify the error handler for undecodable characters. Choices: "strict" (default), "ignore", and "replace".z --input-encoding-error-handler�strictz^Specify the text encoding and optionally the error handler for output. Default: UTF-8:strict.z--output-encodingz-ozutf-8z�Specify 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>z)Write output file dependencies to <file>.z--record-dependenciesz6Read configuration settings from <file>, if it exists.z--config�type�stringz,Show this program's version number and exit.z --versionz-V�versionz Show this help message and exit.z--helpz-h�helpz --id-prefixz--auto-id-prefix�idz--dump-settingsz--dump-internalsz--dump-transformsz--dump-pseudo-xmlz--expose-internal-attributeZexpose_internalsz--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 | _ t j j | | d t d d d t j d d � | �| j s[ | j | _ t | j
� | _
| f t | � | _ | j
| j � | j | p� i � | r| j d ry | j � } Wn8 t k
r} z | j t | � � WYd d } ~ Xn X| j | j � d S)z�
`components` is a list of Docutils components each containing a
``.settings_spec`` attribute. `defaults` is a mapping of setting
default overrides.
Z option_classZadd_help_optionNZ formatter�width�N r� )rp � config_filesrj r� rk ry ZTitledHelpFormatterr� �version_templater �relative_path_settingsrc �
components�populate_from_components�set_defaults_from_dictrs � get_standard_config_settingsr r r rn )rm r� rs Zread_config_filesr r Zconfig_settingsr r r r rk ? s" ( &zOptionParser.__init__c
C sW x | D]} | d k r q | j } | j j | j � x� t d t | � d � D]� } | | | d � \ } } } | r� t j | | | � } | j | � n | } xT | D]L \ } }
} | j |
d | | � } | j d � d k r� d | j
| j <q� W| j rQ | j
j | j � qQ Wq Wx0 | D]( } | r'| j r'| j
j | j � q'Wd S)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� rM rI )rd r� r7 rb rO rj Z OptionGroupZadd_option_group�
add_option�getrp r} �settings_defaultsrs r Zsettings_default_overrides)
rm r� � componentrd r; �title� descriptionZ option_spec�groupZ help_textZoption_stringsr r r r r r� _ s,
z%OptionParser.populate_from_componentsc s� y t j d j t j � } Wn t k
r: | j } Yn Xt j j � d t j k r� y d d l } Wn t k
r� d d � � Yn X� f d d � | 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 � | � � q Sr )r, )r: �f)�expandr r r< � s z:OptionParser.get_standard_config_files.<locals>.<listcomp>)
rV �environr% �pathsepr. �standard_config_filesrT �
expanduser�pwd� ImportError)rm r� r� r )r� r �get_standard_config_files~ s
z&OptionParser.get_standard_config_filesc C s= t � } x- | j � D] } | j | j | � | � q W| S)N)rh r� r r )rm re �filenamer r r r� � s z)OptionParser.get_standard_config_settingsc C s� t � } | j | | � | j j | j � t j j | � } i } t � } xv | j D]k } | sf qW xY t
| j px f � | j f D]8 } | | k r� q� d | | <| j
| j | � | � q� WqW Wt | j | j | � | j S)zAReturns a dictionary containing appropriate config file settings.rI )� ConfigParser�readr� r7 �_filesrV rT �dirnamerh r� rc Zconfig_section_dependenciesr r � get_sectionrY rn r� )rm � config_filer rU Zappliedre 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� rY rn r� r� r� )rm r r r r r � check_values� s zOptionParser.check_valuesc C s� d } } | r1 | j d � } | d k r1 d } | rX | j d � } | d k rX d } | rk | j d � | r� | | k r� | j d � | | f S)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.)r6 r )rm r �sourceZ destinationr r r r� � s
zOptionParser.check_argsc C s | j j | � d S)N)rs r )rm rs r r r r� � s z#OptionParser.set_defaults_from_dictc C s t | j � } | j | _ | S)z(Needed to get custom `Values` instances.)rh rs r� r� )rm rs r r r �get_default_values� s z OptionParser.get_default_valuesc C sV x? | j | g D]- } x$ | j D] } | j | k r! | Sq! Wq Wt d | � � d S)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)Z
option_groupsZ option_listr} r. )rm r} r� r r r r �get_option_by_dest� s
z OptionParser.get_option_by_dest)r� r� )r� )-ru rv rw rx r� r% Zthreshold_choicesr3 r+ rq �sys�stderrr Zdefault_error_encodingZ$default_error_encoding_error_handlerr/ r rH r5 r( r# rF r r r9 rd r� r� r rB � __version__Z__version_details__r� �platformr� rk r� r� r� r r� r� r� r� r� r r r r r� c sf
$$
r� c @ s| e Z d Z d d d d d d i Z d Z d Z d
d � Z d d
� Z d d � Z d d � Z d d � Z
d d � Z d S)r� Zpep_stylesheet�pep_html writer�
stylesheetZpep_stylesheet_path�stylesheet_pathZ pep_template�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 j | | | � g | _ t � | _ d S)N)�CP�RawConfigParserrk r� r �_stderr)rm r r r r r rk � s zConfigParser.__init__c C s. t | � t t f k r! | g } x| D]� } y t j | d d � } Wn t k
r^ w( Yn XyB t j d k r� t j j | | | � n t j j
| | | � Wn< t k
r� | j j
| j | | f � | j � w( Yn X| j � | j j | � | j d � r| j | � | j | | � q( Wd S)N�rzutf-8r] r\ �options)r] r\ )r� �strr �openrE r� � version_infor� r� �readfp� read_file�UnicodeDecodeErrorr� �write�not_utf8_error�closer� rM � has_section�handle_old_config�validate_settings)rm � filenamesr r� �fpr r r r� � s(
zConfigParser.readc C s� t j | j t | d � | j d � } | j d � sD | j d � x� t | j � � D]~ \ } } | | j k r� | j | \ } } | j | � s� | j | � n d } | } | j
| | � sW | j | | | � qW W| j d � d S)Nr r� r� )
�warnings�
warn_explicit� old_warning�ConfigDeprecationWarningr� r� � add_sectionr r
� old_settings�
has_optionr& �remove_section)rm 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 | � } Wn t k
rS w# Yn X| j r� | j | | � } y% | j | | | d | d | �} WnJ t k
r� } z* t d | | t | � | | f � � WYd d } ~ Xn X| j | | | � | j
r# | j | | j
d � q# Wq
Wd S)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� r. rz r� r~ r r r& r{ ) rm r� r r� r r r
r� r r r r r� ' s(
# z ConfigParser.validate_settingsc C s | j � j d d � S)zW
Transform '-' to '_' so the cmdline form of option names can be used.
r^ r_ )r- ra )rm � optionstrr r r � optionxformC s zConfigParser.optionxformc C sI i } | j | � rE x- | j | � D] } | j | | � | | <q% W| S)zf
Return a given section as a dictionary (empty if the section
doesn't exist).
)r� r� r� )rm r� Z section_dictr r r r r� I s
zConfigParser.get_sectionN)r� r� )r� r� )r� r� ) ru rv rw r� r� r� rk r� r� r� r� r� r r r r r� � s r� c @ s e Z d Z d Z d S)r� z3Warning for deprecated configuration file features.N)ru rv rw rx r r r r r� U s r� )-rx Z
__docformat__rV �os.pathr� r� � configparserr� r rj r rB Zdocutils.utilsZdocutils.nodesZ docutils.utils.error_reportingr r r r r r r! r# r( r/ r0 r2 r5 r9 r> rA rF rH rR rY rS rg rh ry r� Z SettingsSpecr� r� �DeprecationWarningr� r r r r �<module> sJ "
" � }v