@.|jtjtj}|D]5\}}|j |jd|jd}7|j tjtjS)aB Apply a list of (find, replace) pairs to a text. >>> replace(b"foo bar", [(b'f', b'F'), (b'b', b'B')]) 'Foo Bar' >>> encoding.encoding = b'latin1' >>> replace(b'\x81\\', [(b'\\', b'/')]) '\x81/' >>> encoding.encoding = b'shiftjis' >>> replace(b'\x81\\', [(b'\\', b'/')]) '\x81\\' ascii)decodersysstrrreplaceencode)textsubstsutextfts rr$r$5so$ KK(9(9: ;E1 ahhw/'1BC <<(9(9: ;;rs \n(?:\s*\n)+cg}tj|jdjD]M}|j }|st d|D}|Dcgc]}||d }}|j ||dO|Scc}w)zFind continuous blocks of lines in text. Returns a list of dictionaries representing the blocks. Each block has an 'indent' field and a 'lines' field.  c3fK|])}t|t|jz +ywN)lenlstrip).0ls r zfindblocks..Zs$CU#a&3qxxz?2Us/1N)indentlines)_blockresplitr0rstrip splitlinesminappend)r&blocksblinesindentr2s r findblocksr@Ps F ^^DKK.557 8  CUCCF)./AQvwZE/ MMf> ? 9 M0s! Bcd}|t|krd||d<||ddjdr|dzt|kr~||d}||dzd|z }||ddgk(r ||=|dz}n||ddjd r||ddd d ||dd<nyt||ddk(rN||ddjd jd r%||ddj d ddk(r|dz }||ddd d||dd<t j ||dd}|r&||jz }||jz}|dzt|krQ||dzd|kDrCd||dzd<||dzdxx|zcc<|dz }|dzt|kr||dzd|kDrC|dz }|t|kr|S)zFinds 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'. r paragraphtyper5s::rr4s ::N .. literal)r/endswithr0 startswithfind _bulletrematchend)r<ir? adjustmentms rfindliteralblocksrS`sV A c&k/*q ' !9X r " + +E 2q1us6{7JAYy)FAy1F:Jay"ug-1IQ8$R(11&9+1)H*=b*A#2*Fq (#B'F1Ih'(A-1Ih'*11$7BB6J1Ih'*//a8B>Q+1)H*=b*A#2*Fq (#B' q ( 3A 67A!%%'!aeeg% a%#f+%&Q- *BV*K)3q1u g&q1u i(J6(Qa%#f+%&Q- *BV*K Qc c&k/d Mrs+(\*|-|[0-9A-Za-z]+\.|\(?[0-9A-Za-z]+\)|\|) s0^(-([a-zA-Z0-9]), )?(--[a-z0-9-]+)((.*) +)(.*)$s&:(?![: ])((?:\:|[^:])*)(?rPitemre singlelineline1line2s rrNzsplitparagraphs..matchs| aAE "3uQU|:s||E" C<L51:#5Le9L L##D) )rrrCrBr5r4)rCr5r4rDr)rM _optionre_fieldre _definitionrer/ enumerater;) r< listtypesrNrPr>typerZr[itemsjlines rsplitparagraphsrgs It$ It$ 8T"  u- I * A c&k/ !9W  -1Ih'E,5(fj6:6E#,U#34 6:>!LL-1.0/5ay/C!"b (+2248$4).F1q1u%-6 Q% c&k/& Mrcd}|t|kr||ddk7r|dz }|}|t|kr~||ddk(rstj||dd}|j\}}|||dd<|j dd||d<|dz }|t|kr ||ddk(rs|dz}|t|kr|S) zFind key for field lists.rrCrWrr5s\::key)r/r_rNgroupsr$)r<rPrerRkeyrests rupdatefieldlistsros A c&k/ !9W  ) FA  #f+o&)G"4"@vay2156A IC%)F1Ih  " # FD 9F1If  FA #f+o&)G"4"@ E c&k/ Mrcd}|t|kre||ddk7r|dz } d}|}|t|kr||ddk(rtj||dd}|jd}|jd}|ddj }|jdj }|jd j } |||dd<d } |sd } d |xrd |zxsd d| || fzfz} | j } | ||d<t |tj| }|dz }|t|kr ||ddk(r|||D]} || d< |dz}|t|kre|S)NrrCrVrr5rHr s%s%ss-%s s %s--%s %soptstr optstrwidth) r/r^rNgroupstripr8maxrr ) r<rP optstrwidthrerR shortoptiongroup3 longoptiondesc longoptionarg noshortopoptblocks rupdateoptionlistsrs A c&k/ !9W  * FA  #f+o&)G"4 "Aq ( 3A 67A''!*KWWQZF))+J771:##%DGGAJ,,.M%)F1Ih  "I" 5+ 5< :}EEC**,C#&F1Ii k8+<+rs^([-=`:.'"~^_*+#])\1+$c|D]g}|ddk(s t|ddkDstj|dds;|dd|ddk(sMd|d<d|d <|dd}tt|Dcgc]}|||d zd k(r|dk(s ||d z |d k(r|!}}g}|dd dD]}||k(rd |d <g}|d}t |D]\} } | d zt|krP|| d z| z } t j ||| } |t| z }|j| jg|j||dj|j|||d<j|Scc}w)zNFind simple tables Only simple one-line table elements are supported rCrBr5rqrrDtableFheaderrrrFTN) r/_tablererNrangerargetcolsr;rx) r<rdivxcolumnsrowsr2rowposnstartwidthvs r findtablesrCs  'Nl *E(O$q(uXq12h"eHob&99%E'N$E) /!$C s3x(Aq1q5>T)qAvQUQ49O(  D8_Qr*8'+E)$aj )' 2HAu1us7|+ 'A 6$,,QU;s1v  1779- 1ST7==?3!3 C !+$#E(O[^ M5s8$E0c|D]}|ddk(s t|ddk(stj|ddt|ddk(sLtj |ddsh|dddd|d<d|d<|dd=|S) zFinds sections. The blocks must have a 'type' field, i.e., they should have been run through findliteralblocks first. rCrBr5rqrr underlinesection)r/rr _sectionrerN)r<rs r findsectionsr{s  'Nl *E(O$)!!%/!"45U8_Q=O9PP  x!34"'/!"4Qq"9E, 'E'Nh" Mrctdg}|D]*}|ddvs |dDcgc]}t||c}|d<,|Scc}w)N)s``r rCrBrr5r$r<r'r=r2s rinlineliteralsrsP_F  W:3 378{C{!71f-{CAhK MDs5cvddg}|D]*}|ddvs |dDcgc]}t||c}|d<,|Scc}w)N)s:hg:`s'hg )`rrCrr5rrs rhgrolersU!< 0F  W:3 3 89{C{!71f-{CAhK  MDs6cd}|t|kr`||d||dz dk(r||ddvr|dz }n-||dz ds|dz }n|j|dgddd|d z }|t|kr`|S) zAdds 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. rrC)rUrVrWr5rrmargin)r5r4rCrq)r/insert)r<rPs r addmarginsrs A c&k/ !9W Aw!7 7F1I =  =  FAAx( FA MMseIF  FA! c&k/" Mrcd}|t|kra||}|ddk(r@|ddjds |ddgk(r ||=|t|kr||ddk(r ||=n|dz }|t|kra|S) zRemove comments.rrCrBr5rGs..rr)r/rK)r<rPr=s r prunecommentsrs A c&k/ 1I W: % hKN % %f -81Gq 3v;6!9W#5#B1I FA c&k/ Mrc:|xstj}tjddj t |ztj }d}|t|kr|j||dd}|rd||d<||ddd|jd z j}||dd|jd zd }|r||djd d |z|||d <||dd=|d z}|t|kr|S)zj Makes the type of the block an admonition block if the first line is an admonition directive s \.\. (%s)::|)flagsrr5 admonitionrCrHrqrNrtadmonitiontitle) _admonitiontitleskeysrecompilejoinsorted IGNORECASEr/rNrOlowerr)r< admonitions admonitionrerPrRadmonitiontitle firstlines rfindadmonitionsrs2 9!2!7!7!9K::$))F;$788 L A c&k/   vay215 6 !.F1Ig $Qi1!4Q1EKKMOq (+A.quuw{}=Iq (#**1fy.@A,;F1I( )q (#A& E c&k/ Mrs Attention:sCaution:s!Danger!sError:sHint:s Important:sNote:sTip:sWarning!) s attentionscautionsdangerserrorshints importantsnotestipswarningc,djttj|d}t j |d}|dz }|d}d|dd||z zfz}dt j |dzz}dt j||||zS) NrFr5rurrvs%s%s s %s ) initindent hangindent)rmapbytesrxrr rwrap)rrr~r usablewidthhangingrrs r formatoptionrs 99SeHo6 7D  y!12H!)KN#GeI.89K0MNNJ**:6:;J  +*  rc 6|dkrd}d|dz}|ddk(rt|d}|ds||zd zSt|dd t|dd jz }||dzz}djt t j |d}d ||ztj|||| fzS|dd k(ry |ddk(r"|dz }|d |zj|dzd zS|ddk(r0tj|dd|dz}d||dd||fzS|ddk(r$|d}t|D cgc].} t| D cgc]} tj| c} 0} } } d}t| t| zdz } d|dz}dt|| z| d z z}|D]} g}t| | D]4\}}d|tj|z z}|j||z6dj|}tj|||| }|s!|dr|d z|zdt|| zzd z}||d zz }|S|ddk(r||ddz}t|dd t|dd jz }||dzz}djt t j |ddd}d |tj|||| fzS|}|ddk(r[|ddj!dr|dddd|dd<nt"j%|dd}||j'dzz}n{|ddk(r_|d}|t(dzz}t|dzt(kDr|j+|}n|j+t(}||ddz|dd<n|ddk(r t-||Sdjt t j |d}tj|||| d zScc} wcc} } w) z"Format a block according to width.rNrFr4rCrrr5r,rDs%s %s )rrrrrIs rrs %s%s %s%s rrrrrrXNrUs| rqrWrkrV)rr/r0rrrrxrrrr ziprysumr;r:rKrMrNrO _fieldwidthljustr)rrr? admonitionhang defindentr& underlinetablerewidthsspanrr2wrpadterm subindentrRrms r formatblockr s z E)$ $F W~&&u-?'@A XJ&. .5?2&'#eHob.A.H.H.J*KKTD[( yyU[[%/:; Z  OOEiI     W~" W~#%--eHo>>FF W~#%%eHoa&89E,?  OOEiI    I W~" ?1  ( ( /"'x!3AB!7E(OA h 23A4/I w8 #Fm[4// s8a<+ %))E"C))K(C 5?1#55h w9 $E5)) 99SeHo6 7D &Y   m8Ns;P P% PPc pgd}gd}fd}|Dcgc] }|ddk7s |}}t|D]\}}|d}|d}|d}|dk(rY|t|d } |d jttj |} j d | | fzn|d k(r+j d |dj|zn|dk(rn|dk(r+j d|dj|zn|dk(rD|d} | |vr|| z }|j| dz}j d|||d|fzn=|dk(r|d} j d| D]} j d| D]L}j dj ||j dj dNjj dj dn|dk(r^|d|||d}|d jttj |dd} j d || fzn"|d!k(r`|djd d\}}|d"vr |d#|n |d$|j d%|d j|g|ddzzn|d&k(rZ|d|||d'}|d jttj |} j d || fzn^|d(k(rY|d|||d)}|d jttj |}j d ||fzsed*\}}|t|dz k(r&j d+|zj||dz}|d}||ks||k(s|dd,vsƉj d+|zjdjScc}w)-zFormat RST blocks as HTMLrc.tj|dS)NT)rescapers rrzformathtml..escapemszz!T""rcpr dd|k7r(j||fjd|zyy)NrDrs<%s> )r;)rlevellistnestouts ropenlistzformathtml..openlistps;8B<?e3 OOUEN + JJy5( )4rrCrr4r5rrrFs

%s %s

rBs

%s

r,rIs
%s
rrrs%s rrs sss s
s
rXsdlNs
%s
%s rU)*rsulsols
  • %s rWrkrVrurDs sdefinition bullet field option) rarrrrrxr;indexpopr7r/)r< headernestrrr=rbtyperr>rr&rPrrrrbulletheadrmrr~rnbnirrs @@r formathtmlrfs CJH#*  ;A1W:#:aF ;F#Q' ) (  M ! 1!4F2G HIJ$))C U$;<=D JJ3z46HH I l " JJ)F5::e3D,EE F i   j JJ-uzz%7H0II J j ,A "a $$Q'!+E JJ)UF584De,LL M h hKE JJ| $ 7#AJJw'JJvay)JJx(JJu%    :& JJ} % m # UE "%(#D$))C U12Y$?@AD JJ,d|; < i  8>>$2LFD%&& JJ}vdiiqr8J.K'LL M h  UE "6#C$))C U$;<=D JJ,T{: ; i  UE "9&C$))C U$;<=D JJ,T{: ; #Brc<djfd|D}|S)Nrc36K|]}t|ywr.rr1r=rs rr3zformatblocks..:6aK5)6r)r<rr&s ` r formatblocksrs 88:6: :D Krc8djfd|DS)z"Format parsed blocks as plain textrc36K|]}t|ywr.rrs rr3zformatplain..rrr)r<rs `r formatplainrs 88:6: ::rct|||xsg\}}|r t||}|dk(r t|St||S)z-Parse and format the text according to width.shtml)r)rfiltersectionsrr)r&rr?rstylerr<rs rformatrsG44NFF0 &!!6//rcg}t|}g}d}g}g}d}|t|kri||\}} } || d=|j|||k(s|jd|zr||k7rt|} t|} | r| | k7rd}g} t d| dz D]_}||}|| k\s |||k7s| jt|||d}|j|d|j|d a| r|j| |dd}|j | |dzt|krJ||dzd| kDr<|dz }|j ||d|dzt|kr||dzd| kDr<|dz }|t|kri|ru|j |D]`} | Dcgc] }||d d}}| d dz}||d }d dj||dgzjd d z|d<|| d|=b|Scc}w)zSelect parsed blocks under the specified section The section name is separated by a dot, and matches the suffix of the full section path. rTNrFrHrrqrDr5s"%s"r r) _getsectionsr/r;rJrextendreverserr$)r<rparentssectionsrP lastparents syntheticcollapsepathnestr=llenplenrreparentsecsynrealreallines rrrsc GF#H F AKIH c(m   dA DENq 7?dmmD7N;g%;'7|DDL$Hq$(+A$QZFDyKNf$<V-&v.q1 c!f- c"g. ,$$Q'!!*K MM! a%#h-'HQUOA,>,EQ hqk!n-a%#h-'HQUOA,>,E Q9 c(m :A89:F3K)!,D:R519Dd|H-H!DIIdhqk].B$C$K$Kc%HQKqtd{# M;s+H chd}d}g}d}|D]}|ddk(r[|d}||vr||z }|j|dz}|d|}|d|||fz}|jd j|||gfg|dd vrd }||vr||z }|j|dz}|d|}tdt |dzD]U}|| }|d|krnE|d D cgc] } | dd k(s | } } | s1| dd} |d} | | kr|dz }n| | k(sP|d}n|d|||fz}|jd j|||gf7|sddgfg}|ddk7rd} |d}| t |kry|| d d}|ddk7rQ|d}t |ddkDr5|t |ddt |ddj d z z }||k\rn| dz } | t |kry| dkDr-|| d}d|dk7r|dz }|jd|gf|dd j| |Scc} w)z=return a list of (section path, nesting level, blocks) tuplesrc|ddk(r|d}n|dd}tj|jd}d|vr|jdd}|S)NrCrWrkr5rr ()rrrxr7)r=rs rgetnamez_getsections..getname*s[ W: !& A( AA NN1  # #D ) 19 a ArrCrrrNr)rXrWrFrqrXrDr4rrr5)rr;rrr/r0)r<r namessecsrr=rPrrasiblings siblingindentr?pointerbindentrsindentblevels rrr$s D E D W: #,A} JJqMA%E'*1vMv!7}1LAvM$,RL$;My\F$v- &&0 #A-&5MWQZM1E KK5)51#6 7a ~zY&I,D )"G8nQ/2Gw'94"))"4wx01A5#s78+.qs21(##A&s!rFc3&K|] }d|z yw)rNr)r1rs rr3zmaketable..ss6v!TAXvsr,c3<K|]}|jywr.)r0r#s rr3zmaketable..|sA.Qahhj.srrq) rryrr7rr r;r/r) datar?headerrrrrrr2rrrs r maketabler(ns=@J GJqc222JF G F]F 4996v66 6 >C %C $DAqzIIA!''%.AA!h//223C HHQW  % 6DIIaL(501#d)a- 1cJJsO J%HsDr.)rNN)PrNsplainN)rF)1__doc__ri18nrrrrutilsrrrrrrr$rr6r@rSrMr^r_r`rrgrrorrrrrrrrrrrrrrrrrrrrr(rrrr.s   =<<<<<0 2::& '  9x BJJF G BJJ=   2::@ A 8$ 2::n %/d *#L(VRZZ6 7 5p2 6  :M"+~ l x[M" x[ gJ+  YxZz( ; 05pGTr