�
�1DWc@s�dZd
Z
ddlmZmZ
ddlmZ
ddlmZ	
ddl
mZmZ
dZ
iZiZd�Zd	�Zd
�Zd�Zd�Zd
d2d��YZdd3d��YZigd�Zi
ejd6e_edej�
edej�
edej�
edej�
edej�
edej�
edej �
edej!�
igd�Z"ede"�
igd�Z#ede#�
igd�Z$i
ej%d6e$_ed e$�
igd!�Z&iejd6ej%d"6e&_ed#e&�
igd$�Z'ed%e'�
id&�
Z(ed'e(�
ed(e(�
ed)e(�
ed*e(�
ed+e(�
ed,e(�
ed-e(�
ed.e(�
ed/e(�
d0�Z)d1S(4s

This module defines standard interpreted text role functions, a registry for
interpreted text roles, and an API for adding to and retrieving from the
registry.

The interface for interpreted role functions is as follows::

    def role_fn(name, rawtext, text, lineno, inliner,
                options={}, content=[]):
        code...

    # Set function attributes for customization:
    role_fn.options = ...
    role_fn.content = ...

Parameters:

- ``name`` is the local name of the interpreted text role, the role name
  actually used in the document.

- ``rawtext`` is a string containing the entire interpreted text construct.
  Return it as a ``problematic`` node linked to a system message if there is a
  problem.

- ``text`` is the interpreted text content, with backslash escapes converted
  to nulls (````).

- ``lineno`` is the line number where the interpreted text beings.

- ``inliner`` is the Inliner object that called the role function.
  It defines the following useful attributes: ``reporter``,
  ``problematic``, ``memo``, ``parent``, ``document``.

- ``options``: A dictionary of directive options for customization, to be
  interpreted by the role function.  Used for additional attributes for the
  generated elements and other functionality.

- ``content``: A list of strings, the directive content for customization
  ("role" directive).  To be interpreted by the role function.

Function attributes for customization, interpreted by the "role" directive:

- ``options``: A dictionary, mapping known option names to conversion
  functions such as `int` or `float`.  ``None`` or an empty dict implies no
  options to parse.  Several directive option conversion functions are defined
  in the `directives` module.

  All role functions implicitly support the "class" option, unless disabled
  with an explicit ``{'class': None}``.

- ``content``: A boolean; true if content is allowed.  Client code must handle
  the case where content is required but not supplied (an empty content list
  will be supplied).

Note that unlike directives, the "arguments" function attribute is not
supported for role customization.  Directive arguments are handled by the
"role" directive itself.

Interpreted role functions return a tuple of two values:

- A list of nodes which will be inserted into the document tree at the
  point where the interpreted role was encountered (can be an empty
  list).

- A list of system messages, which will be inserted into the document tree
  immediately after the end of the current inline block (can also be empty).
treStructuredTexti����(tnodestutils(
t
directives(
ten(tLexert
LexerErrorstitle-referencecCst
|j�}g}g}|t
kr2t
||fS|r�d}y|
j|}Wq�tk
r{
}
|jd
|
|f�

q�tk
r�


|jd||
jf�

q�Xnt}|s
y"t	j|}|jd|�

Wq
tk
r




|jd|�

|}q
Xn|r9
|j
dj|�
d|�

}	|j|	�

n|tkrf
t|}
t
||
�
|
|fSd|fSdS(s.

    Locate and return a role function from its language-dependent name, along
    with a list of system messages.  If the role is not found in the current
    language, check English.  Return a 2-tuple: role function (``None`` if the
    named role cannot be found) and a list of system messages.
    s:Problem retrieving role entry from language module %r: %s.s&No role entry for "%s" in module "%s".s%Using English fallback for role "%s".s#Trying "%s" as canonical role name.s

tlineN(tlowert_rolestNonetrolestAttributeErrortappendtKeyErrort__name__tDEFAULT_INTERPRETED_ROLEt_fallback_language_moduletinfotjoint_role_registrytregister_local_role(t	role_nametlanguage_moduletlinenotreportertnormnametmessagestmsg_textt
canonicalnameterrortmessagetrole_fn((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytrole^sB







	



	




	



	









cCst|
�

|
t
|<d
S(s�
    Register an interpreted text role by its canonical name.

    :Parameters:
      - `name`: The canonical name of the interpreted role.
      - `role_fn`: The role function.  See the module docstring.
    N(tset_implicit_optionsR(tnameR ((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytregister_canonical_role�s

cCst|
�

|
t
|<d
S(s�
    Register an interpreted text role by its local or language-dependent name.

    :Parameters:
      - `name`: The local or language-dependent name of the interpreted role.
      - `role_fn`: The role function.  See the module docstring.
    N(R"R	(R#R ((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR�s

c

Cs[t|d
�s|j
dkr5i
tjd6|_
n"d|j
krWtj|j
d<ndS(s]
    Add customization options to role functions, unless explicitly set or
    disabled.
    toptionstclassN(thasattrR%R
Rtclass_option(
R ((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR"�s


cCs t||
�}t
||�
d
S(sAFor roles which simply wrap a given `node_class` around the text.N(tGenericRoleR$(tcanonical_namet
node_classR!((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytregister_generic_role�s
R)cBs&eZ
dZd
�Zigd�ZRS(sw
    Generic interpreted text role, where the interpreted text is simply
    wrapped with the provided node class.
    cCs|
|_||_
dS(
N(R#R+(tselfRR+((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyt__init__�s
	
cCs/t|�

|j
|tj|�
|�g
gfS(
N(tset_classesR+Rtunescape(R-R!trawtextttextRtinlinerR%tcontent((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyt__call__�s

(Rt
__module__t__doc__R.R5(((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR)�s	t
CustomRolecBs,eZ
dZigd
�Zigd�ZRS(s4
    Wrapper for custom interpreted text roles.
    cCsv|
|_||_
d|_t|d
�r9|j|_nd|_t|d�r`|j|_n||_||_dS(NR%R4(R#t	base_roleR
R%R'R4tsupplied_optionstsupplied_content(R-RR9R%R4((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR.�s
	
	
	


	


	
c

Csv|jj
�}|j|�

t|j�
}	|	rD|rD|	d
7}	n|	j|�

|j|
||||d|d|	�S(Ns

R%R4(R:tcopytupdatetlistR;textendR9(
R-R!R1R2RR3R%R4toptstcont((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR5�s









(RR6R7R.R5(((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR8�s
cCs/t|�

t
j|
tj|�
|�g
gfS(
t(R/R
tinlineRR0(R!R1R2RR3R%R4((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytgeneric_custom_role�s

R&tabbreviationtacronymtemphasistliteraltstrongt	subscripttsuperscriptcCs�y1t|�
}|d
ks'|dkr0t
�
nWnOt
k
r�


|jjd|d|�

}|j|
|
|�}	|	g
|g
fSX|jjj|jjj|}
t	|�

t
j|
dtj
|�
d|
|�
g
gfS(Nii's<PEP number must be a number from 0 to 9999; "%s" is invalid.RsPEP trefuri(tintt
ValueErrorRRtproblematictdocumenttsettingstpep_base_urltpep_file_url_templateR/R
t	referenceRR0(R!R1R2RR3R%R4tpepnumtmsgtprbtref((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytpep_reference_role�s






	








s
pep-referencecCs�y%t|�
}|d
k
r$t
�
nWnOt
k
rv


|jjd|d|�

}|j|
|
|�}	|	g
|g
fSX|jjj|j|}
t	|�

t
j|
dtj
|�
d|
|�
}|g
gfS(NisHRFC number must be a number greater than or equal to 1; "%s" is invalid.RsRFC RL(RMRNRRRORPRQtrfc_base_urltrfc_urlR/R
RTRR0(R!R1R2RR3R%R4trfcnumRVRWRXtnode((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytrfc_reference_role
s






	







	
s
rfc-referencec
Cs�|jj
jsF|jjd
�
}|j|
|
|�}|g
|g
fSd|kr�|jjd|d|�

}|j|
|
|�}|g
|g
fSt|�

tj	|
t
j|d�|�}	|jj|�
\|	_
|	_|	g
gfS(Ns raw (and derived) roles disabledtformats�No format (Writer name) is associated with this role: "%s".
The "raw" role cannot be used directly.
Instead, use the "role" directive to create a new role with an associated format.Ri
(RPRQtraw_enabledRtwarningRORR/R
trawRR0tget_source_and_linetsourceR(
R!R1R2RR3R%R4RVRWR]((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytraw_role)
s





	





!

R_RbcCsS
t|�

|j
d
d�}dg
}d|krE|j|d�

n|rg||krg|j|�

ny+ttj|d�||jjj	�}	WnGt
k
r�
}

|jj|
�
}|j
|
|
|�}|g
|g
fSXtj|
dd|�
}
xO|	D]G\}}|r,
|
tj||d|�
7}
q�|
tj||�7}
q�W|
g
gfS(NtlanguageRBtcodetclassesi
(R/tgetR?R
RRR0RPRQtsyntax_highlightRRRaROR
RHRCtText(R!R1R2RR3R%R4RfRhttokensRRVRWR]tvalue((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyt	code_role?
s(



	











RfRgc	CsNt|�

|
j
d
�
}|
jd
�
d}tj|
||�}|g
gfS(Nt
`i
(R/tfindtsplitR
tmath(	R!R1R2RR3R%R4t
iR]((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyt	math_rolea
s






RrcCsA|jj
d
|d|�

}|j|
|
|�}|g
|g
fS(Ns+Interpreted text role "%s" not implemented.R(RRRO(R!R1R2RR3t
attributesRVRW((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pytunimplemented_rolen
s
	


tindexsnamed-referencesanonymous-references
uri-referencesfootnote-referencescitation-referencessubstitution-referencettargets#restructuredtext-unimplemented-rolec

Cs:d
|kr6d|kst�
|d
|d<|d
=ndS(sW
    Auxiliary function to set options['classes'] and delete
    options['class'].
    R&RhN(
tAssertionError(
R%((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyR/�
s


N(((*R7t
__docformat__tdocutilsR
Rtdocutils.parsers.rstRtdocutils.parsers.rst.languagesRRtdocutils.utils.code_analyzerRRRRR	R!R$RR"R,R)R8RDR(R%RERFRGRHRIRJRKttitle_referenceRYR^Ret	unchangedRnRtRvR/(((sK/opt/alt/python27/lib/python2.7/site-packages/docutils/parsers/rst/roles.pyt<module>Gsd


	4