Your IP : 216.73.216.213

Current Path : /opt/alt/python35/lib/python3.5/site-packages/docutils/utils/__pycache__/
Upload File :
Current File : //opt/alt/python35/lib/python3.5/site-packages/docutils/utils/__pycache__/__init__.cpython-35.pyc



��]Rr�@s�dZdZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
mZmZddl	m
Z
ddlZ	ddlmZmZGdd�de
�ZGd	d
�d
e
�ZGdd�d�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�de�Zdd�Zdd�Zdd�ZGdd�de�Zdd�Zdd �Zd!d"�Zdd#d$�Z d%d&�Z!d'd(�Z"dd)d*�Z#d+d,�Z$d-d.�Z%d/d0�Z&d1d2�Z'd3d4�Z(d5d5d6d7�Z)d8d9�Z*d:d;�Z+d<d=�Z,d>d?�Z-d@dAdBdAdCdDdEdDdFdDdGdDiZ.dHdI�Z/dJdK�Z0dLdM�Z1dNdO�Z2GdPdQ�dQe3�Z4dRdSdTdUdVdWdXdYiZ5ddZd[�Z6dS)\z:
Miscellaneous utilities for the documentation utilities.
ZreStructuredText�N)�ApplicationError�	DataError�__version_info__)�nodes)�ErrorOutput�
SafeStringc@seZdZdd�ZdS)�
SystemMessagecCs#tj||j��||_dS)N)�	Exception�__init__�astext�level)�self�system_messager�r�H/opt/alt/python35/lib/python3.5/site-packages/docutils/utils/__init__.pyr
szSystemMessage.__init__N)�__name__�
__module__�__qualname__r
rrrrrsrc@seZdZdS)�SystemMessagePropagationN)rrrrrrrr src@s�eZdZdZdj�Zeed��\ZZ	Z
ZZdddddd�Z
ddd	d
�Zdd�Zd
d�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�ZdS)�Reporteraq
    Info/warning/error reporter and ``system_message`` element generator.

    Five levels of system messages are defined, along with corresponding
    methods: `debug()`, `info()`, `warning()`, `error()`, and `severe()`.

    There is typically one Reporter object per process.  A Reporter object is
    instantiated with thresholds for reporting (generating warnings) and
    halting processing (raising exceptions), a switch to turn debug output on
    or off, and an I/O stream for warnings.  These are stored as instance
    attributes.

    When a system message is generated, its level is compared to the stored
    thresholds, and a warning or error is generated as appropriate.  Debug
    messages are produced if the stored debug switch is on, independently of
    other thresholds.  Message output is sent to the stored warning stream if
    not set to ''.

    The Reporter class also employs a modified form of the "Observer" pattern
    [GoF95]_ to track system messages generated.  The `attach_observer` method
    should be called before parsing, with a bound method or function which
    accepts system messages.  The observer can be removed with
    `detach_observer`, and another added in its place.

    .. [GoF95] Gamma, Helm, Johnson, Vlissides. *Design Patterns: Elements of
       Reusable Object-Oriented Software*. Addison-Wesley, Reading, MA, USA,
       1995.
    zDEBUG INFO WARNING ERROR SEVERE�NF�backslashreplacecCs�||_||_||_||_||_t|t�sNt|||�}||_|plt|dd�|_	g|_
d|_dS)a7
        :Parameters:
            - `source`: The path to or description of the source data.
            - `report_level`: The level at or above which warning output will
              be sent to `stream`.
            - `halt_level`: The level at or above which `SystemMessage`
              exceptions will be raised, halting execution.
            - `debug`: Show debug (level=0) system messages?
            - `stream`: Where warning output is sent.  Can be file-like (has a
              ``.write`` method), a string (file name, opened for writing),
              '' (empty string) or `False` (for discarding all stream messages)
              or `None` (implies `sys.stderr`; default).
            - `encoding`: The output encoding.
            - `error_handler`: The error handler for stderr output encoding.
        �encoding�ascii�N���)�source�
error_handler�
debug_flag�report_level�
halt_level�
isinstancer�stream�getattrr�	observers�	max_level)r
rrr r"�debugrrrrrr
Ls								zReporter.__init__cCsetjdtdd�||_||_t|t�sOt||j|j�}||_	||_
dS)Nzhdocutils.utils.Reporter.set_conditions deprecated; set attributes via configuration settings or directly�
stacklevel�)�warnings�warn�DeprecationWarningrr r!rrrr"r)r
�categoryrr r"r&rrr�set_conditionss	
			zReporter.set_conditionscCs|jj|�dS)z�
        The `observer` parameter is a function or bound method which takes one
        argument, a `nodes.system_message` instance.
        N)r$�append)r
�observerrrr�attach_observer�szReporter.attach_observercCs|jj|�dS)N)r$�remove)r
r/rrr�detach_observer�szReporter.detach_observercCs"x|jD]}||�q
WdS)N)r$)r
�messager/rrr�notify_observers�szReporter.notify_observersc	Os�t|t�rt|�}|j�}d|kr�t|d�\}}|d=|dk	rl|jd|�|dk	r�|jd|�d|kry"|j|jd��\}}Wntk
r�d\}}YnX|dk	r�||d<|dk	r||d<|jd|j	�t
j||d|d|j||�}|j
r�||jks}|jrn||jks}||jkr�|j
j|j�d�||jkr�t||��||jks�|jr�|j|�t||j�|_|S)	zs
        Return a system_message object.

        Raise an exception or generate a warning if appropriate.
        Z	base_nodeNr�liner�type�
)NN)r!r	r�copy�get_source_line�
setdefaultZget_source_and_line�get�AttributeErrorrrr�levelsr"rr�DEBUG_LEVELr �writerrr4�maxr%)	r
rr3Zchildren�kwargsZ
attributesrr5�msgrrrr�s@"


	
zReporter.system_messagecOs#|jr|j|j||�SdS)z�
        Level-0, "DEBUG": an internal reporting issue. Typically, there is no
        effect on the processing. Level-0 system messages are handled
        separately from the others.
        N)rrr>)r
�argsrArrrr&�s	zReporter.debugcOs|j|j||�S)z�
        Level-1, "INFO": a minor issue that can be ignored. Typically there is
        no effect on processing, and level-1 system messages are not reported.
        )r�
INFO_LEVEL)r
rCrArrr�info�sz
Reporter.infocOs|j|j||�S)z�
        Level-2, "WARNING": an issue that should be addressed. If ignored,
        there may be unpredictable problems with the output.
        )r�
WARNING_LEVEL)r
rCrArrr�warning�szReporter.warningcOs|j|j||�S)zz
        Level-3, "ERROR": an error that should be addressed. If ignored, the
        output will contain errors.
        )r�ERROR_LEVEL)r
rCrArrr�error�szReporter.errorcOs|j|j||�S)z�
        Level-4, "SEVERE": a severe error that must be addressed. If ignored,
        the output will contain severe errors. Typically level-4 system
        messages are turned into exceptions which halt processing.
        )r�SEVERE_LEVEL)r
rCrArrr�severe�szReporter.severe)rrr�__doc__�splitr=�list�ranger>rDrFrHrJr
r-r0r2r4rr&rErGrIrKrrrrr#s!3/	rc@seZdZdS)�ExtensionOptionErrorN)rrrrrrrrP�srPc@seZdZdS)�BadOptionErrorN)rrrrrrrrQ�srQc@seZdZdS)�BadOptionDataErrorN)rrrrrrrrR�srRc@seZdZdS)�DuplicateOptionErrorN)rrrrrrrrS�srScCst|�}t||�}|S)aC
    Return a dictionary mapping extension option names to converted values.

    :Parameters:
        - `field_list`: A flat field list without field arguments, where each
          field body consists of a single paragraph only.
        - `options_spec`: Dictionary mapping known option names to a
          conversion function such as `int` or `float`.

    :Exceptions:
        - `KeyError` for unknown option names.
        - `ValueError` for invalid option values (raised by the conversion
           function).
        - `TypeError` for invalid option value types (raised by conversion
           function).
        - `DuplicateOptionError` for duplicate options.
        - `BadOptionError` for invalid fields.
        - `BadOptionDataError` for invalid option data (missing name,
          missing data, bad quotes, etc.).
    )�extract_options�assemble_option_dict)�
field_list�options_spec�option_list�option_dictrrr�extract_extension_options�srZcCsg}x|D]	}t|dj�j��dkrAtd��t|dj�j��}|d}t|�dkr�d}n�t|�dks�t|dtj�s�t|d�dks�t|ddtj	�r�t
d|��n|ddj�}|j||f�q
W|S)a�
    Return a list of option (name, value) pairs from field names & bodies.

    :Parameter:
        `field_list`: A flat field list, where each field name is a single
        word and each field body consists of a single paragraph only.

    :Exceptions:
        - `BadOptionError` for invalid fields.
        - `BadOptionDataError` for invalid option data (missing name,
          missing data, bad quotes, etc.).
    rrz:extension option field name may not contain multiple wordsNzMextension option field body may contain
a single paragraph only (option "%s"))�lenrrMrQ�str�lowerr!r�	paragraph�TextrRr.)rVrXZfield�nameZbody�datarrrrTs"

"	
	)1
rTcCs�i}x�|D]�\}}||}|dkr;t|��||krWtd|��y||�||<Wq
ttfk
r�}z-|jd||dj|j�f��WYdd}~Xq
Xq
W|S)aa
    Return a mapping of option names to values.

    :Parameters:
        - `option_list`: A list of (name, value) pairs (the output of
          `extract_options()`).
        - `options_spec`: Dictionary mapping known option names to a
          conversion function such as `int` or `float`.

    :Exceptions:
        - `KeyError` for unknown option names.
        - `DuplicateOptionError` for duplicate options.
        - `ValueError` for invalid option values (raised by conversion
           function).
        - `TypeError` for invalid option value types (raised by conversion
           function).
    Nzduplicate option "%s"z(option: "%s"; value: %r)
%s� )�KeyErrorrS�
ValueError�	TypeError�	__class__�joinrC)rXrW�optionsr`�valueZ	convertorZdetailrrrrU.s
	6rUc@seZdZdS)�NameValueErrorN)rrrrrrrrjOsrjcCs�t|t�r|Sy|jtj�d�}Wnmtk
rPtj|�SYnOtk
r�y|jdd�}Wn$tk
r�|jdd�}YnXYnXtj|�S)z�
    Ensure `path` is Unicode. Return `nodes.reprunicode` object.

    Decode file/path string in a failsave manner if not already done.
    �strictzutf-8r�replace)	r!r\�decode�sys�getfilesystemencodingr<rZreprunicode�UnicodeDecodeError)�pathrrr�decode_pathRs


rrcCs�g}x�|r�|jd�}|d
kr6td��|d|�j�}|dks_|rktd��||dd�j�}|s�td|��|ddkrX|j|dd�}|dkr�td	||df��t|�|dkr+||dj�r+td
||df��|d|�}||dd�j�}nT|jd�}|dkr�|}d}n*|d|�}||dd�j�}|j|j�|f�q	W|S)z�
    Return a list of (name, value) from a line of the form "name=value ...".

    :Exception:
        `NameValueError` for invalid input (missing name, missing data, bad
        quotes, etc.).
    �=rzmissing "="Nrz!missing attribute name before "="zmissing value after "%s="z'"z%attribute "%s" missing end quote (%s)z8attribute "%s" end quote (%s) not followed by whitespacerb�rrr)�findrj�strip�lstripr[r.r])r5Zattlist�equalsZattnameZendquoteraZspacerrr�extract_name_valuegsB		
*	rycCs@t||j|jd|jd|jd|jd|j�}|S)z�
    Return a new Reporter object.

    :Parameters:
        `source` : string
            The path to or description of the source text of the document.
        `settings` : optparse.Values object
            Runtime settings.
    r"r&rr)rrr Zwarning_streamr&Zerror_encodingZerror_encoding_error_handler)�source_path�settings�reporterrrr�new_reporter�s
	r}cCsuddlm}|dkr.|j�j�}t|�}t||�}tj||d|�}|j|d�|S)a�
    Return a new empty document object.

    :Parameters:
        `source_path` : string
            The path to or description of the source text of the document.
        `settings` : optparse.Values object
            Runtime settings.  If none are provided, a default core set will
            be used.  If you will use the document object with any Docutils
            components, you must provide their default settings as well.  For
            example, if parsing, at least provide the parser settings,
            obtainable as follows::

                settings = docutils.frontend.OptionParser(
                    components=(docutils.parsers.rst.Parser,)
                    ).get_default_values()
    r)�frontendNrrr)	�docutilsr~ZOptionParserZget_default_valuesrrr}r�documentZnote_source)rzr{r~r|r�rrr�new_document�sr�cCs�t|�dkr�t|dtj�r�|d}xL|D]D\}}|j|�}|r9tj|j||��|d<dSq9WdS)Nrr)r[r!rr_�search�sub)r^Zkeyword_substitutionsZtextnode�patternZsubstitution�matchrrr�clean_rcs_keywords�s(
r�cCs�tjj|pt|�d��jtj�}tjj|�jtj�}|dd�|dd�kr{dj|�S|j�|j�x8|r�|r�|d|dkr�|j�|j�q�W|j�dgt	|�d|}dj|�S)	z�
    Build and return a path to `target`, relative to `source` (both files).

    If there is no common prefix, return the absolute path to `target`.
    Z
dummy_fileNr(�/rz..rr)
�osrq�abspathr6rM�seprg�reverse�popr[)r�targetZsource_partsZtarget_parts�partsrrr�
relative_path�s$ 




r�cCsO|jrD|jstd��|dkr4|j}t||j�S|jSdS)z�
    Retrieve a stylesheet reference from the settings object.

    Deprecated. Use get_stylesheet_list() instead to
    enable specification of multiple stylesheets as a comma-separated
    list.
    z6stylesheet and stylesheet_path are mutually exclusive.N)�stylesheet_path�
stylesheet�AssertionErrorZ_destinationr�)r{Zrelative_torrr�get_stylesheet_reference�s	
		r�csy�jo�jstd���jp4�jp4g}t|t�sbdd�|jd�D�}�fdd�|D�S)zJ
    Retrieve list of stylesheet references from the settings object.
    z6stylesheet and stylesheet_path are mutually exclusive.cSsg|]}|j��qSr)rv)�.0rqrrr�
<listcomp>s	z'get_stylesheet_list.<locals>.<listcomp>�,cs"g|]}t|�j��qSr)�find_file_in_dirsZstylesheet_dirs)r�rq)r{rrr�s	)r�r�r�r!rNrM)r{Zstylesheetsr)r{r�get_stylesheet_list�s	r�cCs}tjj|�r|Sx`|D]X}|dkr8|}n'tjj|�}tjj||�}tjj|�r|SqW|S)z}
    Search for `path` in the list of directories `dirs`.

    Return the first expansion that matches an existing file.
    �.)r�rq�isabs�
expanduserrg�exists)rq�dirs�d�frrrr�
s
	r�cCs6|jdkr+t|d�o*|jdkS|jSdS)z�
    Return whether or not to trim footnote space.

    If trim_footnote_reference_space is not None, return it.

    If trim_footnote_reference_space is None, return False unless the
    footnote reference style is 'superscript'.
    N�footnote_referencesZsuperscript)Ztrim_footnote_reference_space�hasattrr�)r{rrr�get_trim_footnote_ref_spaces	
r�cCs<x5|r7|js|jr+|j|jfS|j}qWdS)zk
    Return the "source" and "line" attributes from the `node` given or from
    its closest ancestor.
    N)NN)rr5�parent)Znoderrrr9+s
	
r9cCs�g}d}x�|jd|�}|dkrQ|j||d��dj|�S|j|||��|jd||d|d��|d}qWdS)	z;Return a string with escape-backslashes converted to nulls.r�\rNrt�r(r)rur.rg)�textr��start�foundrrr�escape2null6s
#r�FcCsP|r|jdd�Sx/dddgD]}dj|j|��}q&W|SdS)zw
    Return a string with nulls removed or restored to backslashes.
    Backslash-escaped spaces are also removed.
    r�r�z z
rtN)rlrgrM)r�Zrestore_backslashesZrespect_whitespacer�rrr�unescapeCs
r�cCs5|jd�}dd�|D�}ttj|��S)zh
    Split `text` on escaped whitespace (null+space or null+newline).
    Return a list of strings.
    z cSsg|]}|jd��qS)z
)rM)r��stringrrrr�Us	z,split_escaped_whitespace.<locals>.<listcomp>)rMrN�	itertools�chain)r�Zstringsrrr�split_escaped_whitespaceOsr�cCs<t|t�r"tjdkr"|Sdjdd�|D��S)N�rrtcSs%g|]}tj|�s|�qSr)�unicodedata�	combining)r��crrrr�\s	z)strip_combining_chars.<locals>.<listcomp>)r�r)r!r\rn�version_inforg)r�rrr�strip_combining_charsYsr�cCs9t|t�r"tjdkr"gSdd�t|�D�S)u�Return indices of all combining chars in  Unicode string `text`.

    >>> from docutils.utils import find_combining_chars
    >>> find_combining_chars(u'A t̆ab̆lĕ')
    [3, 6, 9]

    r�rcSs+g|]!\}}tj|�r|�qSr)r�r�)r��ir�rrrr�hs	z(find_combining_chars.<locals>.<listcomp>)r�r)r!r\rnr��	enumerate)r�rrr�find_combining_chars^sr�cCsJttt|���}xt|�D]}d||<q%Wdd�|D�S)u�Indices of Unicode string `text` when skipping combining characters.

    >>> from docutils.utils import column_indices
    >>> column_indices(u'A t̆ab̆lĕ')
    [0, 1, 2, 4, 5, 7, 8]

    NcSs"g|]}|dk	r|�qS)Nr)r�r�rrrr�ws	z"column_indices.<locals>.<listcomp>)rNrOr[r�)r�Zstring_indices�indexrrr�column_indicesjs
r��Wr(�FZNar�H�N�AcCs�t|t�r(tjdkr(t|�Sytdd�|D��}Wntk
ret|�}YnX|tt|��8}|S)zqReturn the column width of text.

    Correct ``len(text)`` for wide East Asian and combining Unicode chars.
    r�rcSs#g|]}ttj|��qSr)�east_asian_widthsr�Zeast_asian_width)r�r�rrrr��s	z column_width.<locals>.<listcomp>)r�r)r!r\rnr�r[�sumr<r�)r��widthrrr�column_width�s

r�cCs4g}x'|D]}||kr
|j|�q
W|S)N)r.)�L�r�itemrrr�uniq�s

r�ccsy|dkrgVnax^tt|�|d�D]B}x9t||dd�|d�D]}||g|VqWWq/WdS)z=Return n-length tuples, in sorted order, no repeated elementsrrN)rOr[�unique_combinations)�items�nr��ccrrrr��s
!(r�cCs�|j�jdd�}tjdd|�}dd�|jd�D�}|jd�g}g}xTtt|�dd	�D]:}x1t||�D] }|j	dj
||��q�WqzW||7}|S)
aWReturn a list of normalized combinations for a `BCP 47` language tag.

    Example:

    >>> from docutils.utils import normalize_language_tag
    >>> normalize_language_tag('de_AT-1901')
    ['de-at-1901', 'de-at', 'de-1901', 'de']
    >>> normalize_language_tag('de-CH-x_altquot')
    ['de-ch-x-altquot', 'de-ch', 'de-x-altquot', 'de']

    �-�_z_([a-zA-Z0-9])_z_\1-cSsg|]}|�qSrr)r�Zsubtagrrrr��s	z*normalize_language_tag.<locals>.<listcomp>rrr)r]rl�rer�rMr�rOr[r�r.rg)�tagZsubtagsZbase_tagZtaglistr�Ztagsrrr�normalize_language_tag�s
"
r�c@sXeZdZdZdgdd�Zdd�Zdd�Zd	d
�Zdd�ZdS)
�DependencyListz�
    List of dependencies, with file recording support.

    Note that the output file is not automatically closed.  You have
    to explicitly call the close() method.
    NcCs/|j|�x|D]}|j|�qWdS)z�
        Initialize the dependency list, automatically setting the
        output file to `output_file` (see `set_output()`) and adding
        all supplied dependencies.
        N)�
set_output�add)r
�output_fileZdependenciesr�rrrr
�s

zDependencyList.__init__cCs^g|_|rQ|dkr$d}n|}tjjd|dddd�|_n	d|_dS)aH
        Set the output file and clear the list of already added
        dependencies.

        `output_file` must be a string.  The specified file is
        immediately overwritten.

        If output_file is '-', the output will be written to stdout.
        If it is None, no file output is done when calling add().
        r�NZdestination_pathr�utf8Z	autocloseF)rNr�ioZ
FileOutput�file)r
r�Zofrrrr��s		zDependencyList.set_outputcGsWxP|D]H}||jkr|jj|�|jdk	r|jj|d�qWdS)z�
        If the dependency `filename` has not already been added,
        append it to self.list and print it to self.file if self.file
        is not None.
        Nr7)rNr.r�r?)r
�	filenames�filenamerrrr��s

zDependencyList.addcCs|jj�d|_dS)z(
        Close the output file.
        N)r��close)r
rrrr��s
zDependencyList.closecCsEy|jj}Wntk
r*d}YnXd|jj||jfS)Nz
%s(%r, %s))r�r`r<rfrrN)r
r�rrr�__repr__�s

zDependencyList.__repr__)	rrrrLr
r�r�r�r�rrrrr��s
r�Zalpha�aZbeta�b�	candidate�rc�finalrtcCs�|dkrt}|dr-d|d}nd}t|d}|drX|d}nd}|drqd}nd}d	|d
|d||||f}|S)z~
    Given a `version_info` tuple (default is docutils.__version_info__),
    build & return a version identifier string.
    Nr(z.%srtr��rz.devz
%s.%s%s%s%s%srr)r�release_level_abbreviations)r��micro�releaselevel�serialZdev�versionrrr�version_identifier	s*



	
r�)7rLZ
__docformat__rnr��os.pathr�r�r)r�rrrrrZdocutils.ioZdocutils.utils.error_reportingrrrrrrPrQrRrSrZrTrUrjrrryr}r�r�r�r�r�r�r�r9r�r�r�r�r�r�r�r�r�r�r��objectr�r�r�rrrr�<module>sp� !,	

	E