File: //usr/lib/python2.7/dist-packages/mercurial/minirst.pyc
Xc @@ sh d Z d d l m Z d d l Z d d l Z d d l m Z d d l m Z m Z d Z
d Z d Z d
Z
d Z e j d Z d
Z d Z e j d Z e j d Z e j d Z e j d Z e j d Z d Z d Z d Z d Z d Z e j d Z d Z d Z d Z d Z! d Z" d Z# e j d d! e j$ Z% d" Z& i e d# d$ 6e d% d& 6e d' d( 6e d) d* 6e d+ d, 6e d- d. 6e d/ d0 6e d1 d2 6e d3 d4 6Z' d5 Z( d6 Z) d7 Z* d d d8 Z, d9 Z- d: d d d; d d< Z. d= Z/ d> Z0 d e1 d? Z2 d S(@ s simplified reStructuredText parser.
This parser knows just enough about reStructuredText to parse the
Mercurial docstrings.
It cheats in a major way: nested blocks are not really nested. They
are just indented blocks that look like they are nested. This relies
on the user to keep the right indentation for the blocks.
Remember to update https://mercurial-scm.org/wiki/HelpStyleGuide
when adding support for new constructs.
i ( t absolute_importNi ( t _( t encodingt utilc C@ s d | d t j | f S( Ns %s
%s
s "( R t colwidth( t s( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt section s c C@ s d | d t j | f S( Ns %s
%s
t =( R R ( R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
subsection# s c C@ s d | d t j | f S( Ns %s
%s
t -( R R ( R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
subsubsection& s c C@ s d | d t j | f S( Ns %s
%s
t .( R R ( R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt subsubsubsection) s c C@ s] | j t j } x8 | D]0 \ } } | j | j d | j d } q W| j t j S( s5
Apply a list of (find, replace) pairs to a text.
>>> replace("foo bar", [('f', 'F'), ('b', 'B')])
'Foo Bar'
>>> encoding.encoding = 'latin1'
>>> replace('\x81\\', [('\\', '/')])
'\x81/'
>>> encoding.encoding = 'shiftjis'
>>> replace('\x81\\', [('\\', '/')])
'\x81\\'
t ascii( t decodeR t replacet encode( t textt substst utextt ft t( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyR , s (s \n(?:\s*\n)+c C@ s g } x t j | j d j D]i } | j } | r% t d | D } g | D] } | | ^ qZ } | j i | d 6| d 6 q% q% W| S( s Find continuous blocks of lines in text.
Returns a list of dictionaries representing the blocks. Each block
has an 'indent' field and a 'lines' field.
s
c s@ s+ | ]! } t | t | j Vq d S( N( t lent lstrip( t .0t l( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr>O s t indentt lines( t _blockret splitR t rstript
splitlinest mint append( R t blockst bR R R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
findblocksE s % "c C@ s? d } x2| t | k r:d | | d <| | d d j d r-| d t | k r-| | d } | | d d | } | | d d g k r | | =| d 8} n | | d d j d r | | d d d
| | d d <n t | | d d k r[| | d d j d j d r[| | d d j d d
d k r[| d 7} q n" | | d d d | | d d <t j | | d d } | r| | j 7} | | j 8} n xi | d t | k r)| | d d | k r)d | | d d <| | d d c | 8<| d 7} qWn | d 7} q W| S( s Finds literal blocks and adds a 'type' field to the blocks.
Literal blocks are given the type 'literal', all other blocks are
given type the 'paragraph'.
i t paragrapht typeR is ::i R s ::it s .. i t literal( R t endswithR t
startswitht findt _bulletret matcht end( R" t iR t
adjustmentt m( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt findliteralblocksT s6
1
%$$
"1s( (-|[0-9A-Za-z]+\.|\(?[0-9A-Za-z]+\)|\|) s0 ^(-([a-zA-Z0-9]), )?(--[a-z0-9-]+)((.*) +)(.*)$s :(?![: ])([^:]*)(?<! ):[ ]+(.*)s [^ ]s
(=+\s+)*=+c C@ sO d t t f d t t f d t t f d t t f g } d } d } x| t | k rJ| | d d k r=| | d } x | D] \ } } } | | d | | r g } xq t | D]c \ } }
| | | | | r| j i | d 6g d 6| | d
d
6 n | d d j |
q W| | | | d +Pq q Wn | d 7} qH W| S(
s Split paragraphs into lists.t bullett optiont fieldt
definitionc S@ s | | } | d t | k r. | | d p1 d } | j | sG t S| rv | d k pu | d d k pu | j | S| j d Sd S( s Does itemre match an item at line i?
A list item can be followed by an indented line or another list
item (but only if singleline is True).
i t i R' N( R R- t FalseR* ( R R/ t itemret
singlelinet line1t line2( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyR- s
*)i R& R% R R ii ( R, t Truet _optionret _fieldret
_definitionreR8 R t enumerateR! ( R" t listtypesR- R/ R R& R9 R: t itemst jt line( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt splitparagraphs s* i c C@ s d } x | t | k r | | d d k r? | d 7} q n | } x | t | k r | | d d k r t j | | d d } | j \ } } | | | d d <| | | d <| d 7} qH W| d } q W| S( s Find key for field lists.i R& R5 i R t key( R R? R- t groups( R" R/ RD R1 RG t rest( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt updatefieldlists s
)c
C@ s d } x| t | k r| | d d k r? | d 7} q n d } | } x-| t | k rz| | d d k rzt j | | d d } | j d } | j d } | d j } | j d j } | j d j } | | | d d <d
}
| sd }
n d | r!d
| p$d
d |
| | f f } | j } | | | d <t | t j | } | d 7} qN Wx | | | !D] } | | d <qW| d } q W| S( Ni R& R4 i R i i i i R7 s s %s%ss -%s s %s--%s %st optstrt optstrwidth( R R> R- t groupt stripR t maxR R (
R" R/ RL RD R1 t shortoptiont group3t
longoptiont desct
longoptionargt noshortopt optt block( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt updateoptionlists s:
) c
C@ sf g } d } xM| d t | k r[| | d d k rN| | d d j d rN| | d } | | d d | } | | d d d } t } x, | D]$ } | | j d k r t } q q W| r | j | n | | =| } | d 8} x[ | t | k rJ| | d | k rJ| r)| | =q | | d c | 8<| d 7} q Wn | d 7} q W| | f S(
s Prune unwanted containers.
The blocks must have a 'type' field, i.e., they should have been
run through findliteralblocks first.
i i R& R% R s .. container::R i R ( R R* R= R R8 R! (
R" t keept prunedR/ R R0 t
containertypet prunet cRD ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt prunecontainers s0
)
s ^([-=`:.'"~^_*+#])\1+$c
C@ s x| D]} | d d k r t | d d k r t j | d d r | d d | d d k r d | d <t | d <| d d } g t t | D]< } | | d k r | d k s | | d
d k r | ^ q } g } x | d d
d !D] } | | k rt | d <q n g } | d } x t | D] \ } }
| d
t | k r| | d
|
} t j | | | } | t | 7} | j | j
q4| j | | j
q4W| j | q W| | d <q q W| S( sQ Find simple tables
Only simple one-line table elements are supported
R& R% R i i it tablet headerR i R' ( R t _tablereR- R8 t xrangeR= RA R t getcolsR! RN (
R" RW t divt xt columnst rowsR t rowt post nt startt widtht v( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
findtables# s6
<
c C@ s x | D] } | d d k r t | d d k r t j | d d t | d d k r t j | d d r | d d d | d <d | d <| d d =q q W| S( s Finds sections.
The blocks must have a 'type' field, i.e., they should have been
run through findliteralblocks first.
R& R% R i i i t underlineR ( R R R t
_sectionreR- ( R" RW ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt findsectionsU s
+
c C@ s[ d g } xK | D]C } | d d k r g | d D] } t | | ^ q1 | d <q q W| S( Ns ``t "R& R% R R ( s ``Rr ( R% R ( R ( R" R R# R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt inlineliteralsk s
1c C@ s^ d d
g } xK | D]C } | d d k r g | d D] } t | | ^ q4 | d <q q W| S( Ns :hg:`s 'hg t `t 'R& R% R R ( s :hg:`s 'hg ( Rt Ru ( R% R ( R ( R" R R# R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt hgroler s
1c C@ s d } x | t | k r | | d | | d d k r\ | | d d k r\ | d 7} q | | d d s{ | d 7} q | j | i d g d 6d d 6d
d 6 | d 7} q W| S(
s Adds empty blocks for vertical spacing.
This groups bullets, options, and definitions together with no vertical
space between them, and adds an empty block between all other blocks.
i R& R3 R4 R5 R R7 i R t margini ( R3 R4 R5 ( R t insert( R" R/ ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
addmargins} s
(c C@ s d } x | t | k r | | } | d d k r | d d j d s_ | d d g k r | | =| t | k r | | d d k r | | =q q | d 7} q W| S( s Remove comments.i R& R% R s .. s ..Rw i ( R R* ( R" R/ R# ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
prunecomments s
'&
sR \.\. (admonition|attention|caution|danger|error|hint|important|note|tip|warning)::t flagsc C@ s d } x | t | k r t j | | d d } | r d | | d <| | d d d | j d !j } | | d d | j d } | r | | d j d d | n | | | d <| | d d =n | d } q W| S(
sj
Makes the type of the block an admonition block if
the first line is an admonition directive
i R t
admonitionR& i i i s t admonitiontitle( R t
_admonitionreR- R. t lowerRx ( R" R/ R1 R} t firstline( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt findadmonitions s ) s
Attention:t attentions Caution:t cautions !Danger!t dangers Error:t errors Hint:t hints
Important:t importants Note:t notes Tip:t tips Warning!t warningc C@ s d j t t j | d } t j | d } | d } | d } d | d d | | f } d t j | d } d t j | | d | d | S(
NR' R RK i RL s %s%s s %s
t
initindentt
hangindent( t joint mapt strRN R R R t wrap( RW Rl RS R t usablewidtht hangingR R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt formatoption s
c
C@ s | d k r d } n d | d } | d d k r t | d } | d sW | | d St | d d
t | d d
j } | | d } d j t t j | d } d | | t j | d | d
| d | f S| d d k r d S| d d k r(| d 7} | d | j | d d S| d d k rst j
| d d | d } d | | d d | | f S| d d k r| d } g t | D]. } t g | D] }
t j
|
^ q ^ q} d } t
| t | d } d | d } d t | | | d
} x | D] }
g } xE t | |
D]4 \ } } d | t j
| } | j | | q;Wd j | } t j | d | d
| d | } | r| d r| d | d t | | d } q | | d 7} q W| S| d d k r| | d d } t | d d
t | d d
j } | | d } d j t t j | d d } d | t j | d | d
| d | f S| } | d d k r| d d j d r| d d d | d d <qt j | d d } | | j d } n | d d k r| d } | t d } t | d t k r`| j | } n | j t } | | d d | d d <n | d d k rt | | Sd j t t j | d } t j | d | d
| d | d S(! s" Format a block according to width.i iN R' R R& R| R} R s
is %s
%s
Rl R R Rw R( s R Ro s
%s%s
%s%s
R_ R7 i R` R R6 R3 s | i R5 RG R4 ( t _admonitiontitlesR R R R R RN R R R R t zipRO t sumR! R R* R, R- R. t _fieldwidtht ljustR ( RW Rl R R| t hangt defindentR Ro R_ R] t et widthst spanRh R t wRm t padt termt subindentR1 RG ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt formatblock s
,
A
!&,#
c @ s g d } g d } f d } g | D] } | d d k r4 | ^ q4 } xvt | D]h\ } } | d } | d } | d } | d k r | t | d } | d
j t t j | }
j d | |
f n8| d k r j d
| d j | n | d k r&n| d k rU j d | d j | n| d k r| d } | | k r| | 7} n | j | d } j d | | | d | f nb| d k rq| d } j d x} | D]u }
j d xH |
D]@ } j d j | | j d j d qW j j d qW j d n| d k r| d | | | d } | d
j t t j | d }
j d | |
f nG| d k rX| d j d
d \ } } | d! k r | d" | n
| d# | j d$ | d
j | g | d n | d% k r| d | | | d& } | d
j t t j | }
j d | |
f nd | d' k r | d | | | d( } | d
j t t j | } j d | | f n rc d) \ } } | t
| d k rj j d* | j q| | d } | d } | | k s| | k r| d d+ k r j d* | j qqc qc Wd j S(, s Format RST blocks as HTMLR7 c S@ s t j | t S( N( t cgit escapeR= ( R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyR $ s c @ sF s d d | k rB j | | f j d | n d S( Nii s <%s>
( R! ( Rk t level( t listnestt out( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt openlist' s R& Rw R R R| R} R' s <p>
<b>%s</b> %s
</p>
R% s <p>
%s
</p>
s
R( s <pre>
%s
</pre>
R Ro i s <h%d>%s</h%d>
i R_ s <table>
s <tr>s <td>s </td>s </tr>
s </table>
R6 t dls <dt>%s
<dd>%s
R3 R t ult ols <li> %s
R5 RG R4 RK is </%s>
s definition bullet field option( RA R R R R RN R! t indext popR R ( R" t
headernestR R R# Ri t btypeR R R| R R/ R_ Rh Rm R R3 t headRG RV RS Rk t nbt ni( ( R R s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt
formathtml s )
! # #
'
%
.
!
!
c C@ s g } t | } x | D] } | d c | 7<q Wt | } t | } t | | pZ g \ } } t | } t | } t | } t | } t | } t | } t
| } t | } t | } | | f S( s Parse text into a list of blocksR (
R$ R2 Rn R^ Rq Rs Rv RF RJ RX R Ry Rz ( R R RY RZ R" R# ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt parsex s"
c @ s# d j f d | D } | S( NR7 c 3@ s | ] } t | Vq d S( N( R ( R R# ( Rl ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr> s ( R ( R" Rl R ( ( Rl s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt formatblocks s iP t plainc @ s t | | | p g \ } } g } | rt | } g } d }
g } g } t }
x|
t | k r| |
\ } } } | | 3| j |
| | k r| | k rt | } t | } | r | | k r t }
n g } x t d | d D]r } | | } | | k s!| | | k r | j t | | | d } | j | d | j | d q q W| r| j | qn | } | j | xT |
d t | k r| |
d d | k r|
d 7}
| j | |
d qWn |
d 7}
qW W|
r| j x | D] } g | D] }
| |
d d ^ q!} | d d } | | d } d d j | | d g j
d d
| d <| | d | 5qWqn | d k rt | } n d
j f d | D } | d
k r| S| | f Sd
S( s- Parse and format the text according to width.i i i i iR s "%s"R Rr R7 t htmlc 3@ s | ] } t | Vq d S( N( R ( R R# ( Rl ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr> s N(
R t getsectionsR= R R! R8 Rb t extendt reverseR R R t None( R Rl R RY t styleR R" RZ t parentst sectionsR/ t lastparentst synthetict collapset namet nestR# t llent plenR RD t parentt sect patht realt realline( ( Rl s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt format sf
1
%+ c C@ s, d } d } g } d } x
| D]} | d d k r | d } | | k r[ | | 7} n | j | d } | | } | j | | | | g f q" | d d k rd
} | | k r | | 7} n | j | d } | | } x t d t | d D] } | | } | d | k r%Pn g | d D] } | d d k r0| ^ q0} | r | d d
}
| d
} |
| k r| d 7} Pq|
| k r| d } Pqq q W| j | | | | g f q" | sd d g f g } n | d d k rd } | d
}
x | t | k r| | d d } | d d k r| d
} t | d d k r| t | d d t | d d j d
7} n |
| k rPqn | d 7} q W| d k r| | d } | d | d k r| d 7} n | j d | g f qn | d d j | q" W| S( s= return a list of (section name, nesting level, blocks) tuplesR7 i c S@ si | d d k r | d } n | d d } t j | j d } d | k re | j d d } n | S( NR& R5 RG R i Rr t (( R R RN R ( R# Re ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt getname s
R& R Ro i R6 R5 R' i iR Rw R ( R6 R5 ( R R! t rangeR R ( R" R R t secsR R# R/ R t at siblingst
siblingindentR t pointert bindentR t sindentt blevel( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyR sn
"
-
"
"
c C@ sm g } x` t | D]R } | d } t | d | } | j g | j t D] } | | f ^ qL q W| S( s= generate a list of (section name, line text) pairs for searchi i ( R R R! R R= ( R" Rl R R R R R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt decorateblocks s
3c C@ sM g t | D] } t d | D ^ q
} d | } | d j d | D d } | g } x | D] } g } xv t | | D]e \ } }
d |
k r d j d |
j d D }
n d | t j |
} | j |
| q W| j | d j | d qj W| r<t | d k r<| j d | n | j | | S( sA Generate an RST table for the given table data as a list of linesc s@ s | ] } t j | Vq d S( N( R R ( R R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr> s R' c s@ s | ] } d | Vq d S( R N( ( R R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr> s s
c s@ s | ] } | j Vq d S( N( R ( R R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pys <genexpr>) s i i ( R RO R R R R R! R Rx ( t dataR R` R] R Rd R Rh R R Rm R ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt maketable s /
!
%"
(3 t __doc__t
__future__R R t ret i18nR R7 R R R R R
R R t compileR R$ R2 R, R> R? R@ Ra RF R RJ RX R^ Rp Rn Rq Rs Rv Ry Rz t
IGNORECASER~ R R R R R R R R R R R R8 R ( ( ( s5 /usr/lib/python2.7/dist-packages/mercurial/minirst.pyt <module> sf 9 * $ ) 2
Q [ < F