N&i&odZdZddlZddlZddlZddlZddlmZm Z m Z m Z ddl m Z mZddl mZddlmZmZddlmZmZmZdd lmZmZdd lmZdd lmZGd d eZGddeZGddeZGddeZ GddeZ!GddeZ"GddeZ#GddeZ$Gddej%Z&GddeZ'Gd d!eZ(Gd"d#eZ)dS)$zMiscellaneous directives.reStructuredTextN)ionodes statemachineutils) SafeString ErrorString)locale_encoding) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines) set_classes)miscc eZdZdZdZdZdZejej ej ej e e e ej ej ej ejej d ZejejejdZdZdS) Includea] Include content read from a separate source file. Content may be parsed by the parser, or included as a literal block. The encoding of the included file can be specified. Only a part of the given file argument may be included by specifying start and end line or text to match before and/or after the text to be used. rT) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec |jjjjs|d|jz|jj|j |jj z dz }tj tj |}tj |jd}|drB|dr-tj |j|dd}tj tj ||}t-jd|}t1j|}|jd|jjjj}|jjjj}|jd |jjjj} |jjjj |tCj"||| }n{#tF$r3}|$d |jd tK|d d}~wtL$r3}|$d |jdtO|dd}~wwxYw|jdd} |jdd} | s| 2|(} d| | | } n|)} n?#tT$r2}|$d|jdtO|d}~wwxYw|jdd} | rR| +| }|dkr|$d|jz| |tY| zd} |jdd}|rB| +|}|dkr|$d|jz| d|} t[j.| |d}t_|D]I\}}tY||jjjj0kr|d||dzfzJd|jvrP|dkr| 1|}n| }t1j2| ||jdg}d|_3|4|d|jvr tk|jdpd} n##tl$r|7d wxYw| tY|z} |d!r |dd}tqg|fg| | }|D]9\}}|r|t1j9|||"z }"|t1j:|z }:n|t1j:|z }|gSd#|jvr||jd$<|dkr| ;}ty|j|j=d#g|j||j |j>|j?|j|j }|@S| | || f}|jjjA}|s*|Bt-jd|d%f||f|vrJ|d&|jd'd(|gd)|dddDzd*|jvrv|jd*}t-jC||jjj}|||fgz|_A|Dd!|||jES|dd+|zgz }|jF|||B||fgS),zInclude a file as part of the content of this reST file. Depending on the options, the file (or a clipping) is converted to nodes and returned or inserted into the input stream. "%s" directive disabled.rr<>Nrr source_pathr error_handlerProblems with "z1" directive path: Cannot encode input file path "z" (wrong locale?)." directive path: .rrProblem with " " directive: rzDProblem with "start-after" option of "%s" directive: Text not found.rzCProblem with "end-before" option of "%s" directive: Text not found.T)convert_whitespacez,"%s": line %d exceeds the line-length-limit.rr!)sourceclassesr z+:number-lines: with non-integer start value )r4rr3)NNNNzcircular inclusion in "z " directive: z < cg|]\}}|Sr7).0pthopts q/home/geonatureadmin/si_en_reseau/tutos/venv/lib/python3.11/site-packages/docutils/parsers/rst/directives/misc.py zInclude.run..s.3I3I3I:C33I3I3Irz.. end of inclusion from "%s")Gstatedocumentsettingsfile_insertion_enabledwarningr" state_machine input_linesr3lineno input_offsetospathdirnameabspathr arguments startswithendswithjoinstandard_include_pathnormpathr relative_pathr reprunicodeoptionsgetinput_encodinginput_encoding_error_handler tab_widthrecord_dependenciesaddr FileInputUnicodeEncodeErrorsevererIOErrorr readlinesread UnicodeErrorfindlenr string2lines enumerateline_length_limit expandtabs literal_blocklineadd_nameint ValueErrorerrorrinlineText splitlinesrpopcontent_offset block_textrun include_logappend new_documentparsechildren insert_input)selfr3 source_dirrHr e_handlerrW include_filerl startlineendlinelinesrawtext after_text after_index before_text before_index include_linesirhtextrgtokensr4value codeblock clip_optionsrtrr?s r;rsz Include.run6s z"+B G,,9DIEFF F#/66 K$,9 9A =??W__RW__V%<%<== t~a011 ??3   HDMM#$6$6 H7<< :D2JGGDw Z > >??"4.. &&<##  +4CEE*%.K L$$ ,5?AA  7 J  ( < @ @ F F F?? ? ? \%%mT::  >!,,z22KQkk#@BF)#LMMMkC OO;<<=Gl&&|T::  -"<< 44Lakk#@BF)#LMMMm|m,G$1'9EIKKK  // H HGAt4yy4:.7IIIll$9<@!A#;$GHHHJ  $ $A~~)))44!/,0L,<,E*G*G*GG &E):):: ;D!1!11 !? " T\ ! !%)DL "1}} ' 2 2 4 4 !$)#'<#3#3F#;#;"<"&,"/"&+"&"5"&/"&*"&"466I==?? ""7KD j)5  ;    3D& A A 8 : ; ; ; , ; . .,,,999ejj$3I3I6A$$B$6G3I3I3I*IJJJ KLL L t| # #+T\(+--F)$ 0C0LMMH#.42F1G#GH LL=118 < < <$ $ "=DEE  '' t<<<D,/000 sJ5AH66 J..I.. J.;.J))J.(A L33 M/=-M**M/.U U+N)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flag unchangedr parser_namerjunchanged_required class_option option_specrGrHrNrIr__file__rOrsr7r=r;rrs $(o%/)2'3 #!$"","?!+!>#-#7&3%/ 1 1KGLL)I)I)244SSSSSr=rc^eZdZdZdZdZdZejej ej ej dZ dZ dZdS)Rawz Pass through content unchanged Content is included in output based on type argument Content may be included inline (content section of directive) or imported from a file or url. rrT)fileurlrr!c  |jjjjr(|jjjjs/d|jvs d|jvr|d|jzdd|j d i}|j d|jjjj }|jjjj}|jrKd|jvs d|jvr|d|jzd |j}nd|jvrd|jvr|d |jzt"jt"j|jjj}t"jt"j||jd}t/jd|} t3j||| }|jjjj|n@#t:$r3}|d |jd t?|dd}~wwxYw | }n?#tB$r2}|d|jdt?|d}~wwxYw||d<n8d|jvr|jd} tDj#dkr ddl$m%} ddl&m'} nddl(m%} m'}  | |  } nV#| t:tRf$rA}|d |jd|jddt?|dd}~wwxYwt3j*| | ||} | }n?#tB$r2}|d|jdt?|d}~wwxYw| |d<n|+tYj-d|fd|j dgi|} |j./|j0\| _1| _2| gS)Nrrr%format rrzF"%s" directive may not both specify an external file and have content.r5zXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.r)r,r-r.r0r1r3r)urlopen)URLError)rrz" directive URL "z": )r3r*rr+r/r4r!)3r>r?r@ raw_enabledrArSrBr"rNrKlowersplitrTrUrVcontentrlrGrHrIrJcurrent_sourcerPrrQrrZrXrYr]r\r r_r`sys version_infourllib.requestr urllib.errorrurllib2OSError StringInputassert_has_contentrrawrCget_source_and_linerEr3rh)rz attributesrr|rr{rHraw_filerlr3rrraw_textraw_nodes r;rszRaw.runs! #,8 GJ'0G Gt|++--,,9DIEFF F):)@)@)B)B)H)H)J)J K KL <##  +4CEE*%.K <: &%%$,)>)>jj(*.)455599T\**DD t| # # $$jj8:>)DEEE 3 BCCEEJ7##BGLL15f1E%G%GHHD&tT22D ErSubstitutionDefrlr"rrNrrElement nested_parserq paragraphsystem_messagerurCreporterrErx)rzrelementnodemessageselems r;rsz Replace.run0sz$*f&<== :**-/3y9:: : !!!yy&&-%%  d.A ' ) ) ) C CD CJtU_== CD%"677 C#%Z %%%%&/55 #'9.48K6AACCCC  ,dm+ +r=Nrrrrrsr7r=r;rr,s(Kr=rcneZdZdZdZdZdZejejejdZ e j dZ dZ dS) Unicodea{ Convert Unicode character codes (numbers) to characters. Codes may be decimal numbers, hexadecimal numbers (prefixed by ``0x``, ``x``, ``\x``, ``U+``, ``u``, or ``\u``; e.g. ``U+262E``), or XML-style numeric character entities (e.g. ``☮``). Text following ".." is a comment and is ignored. Spaces are ignored, and any other text remains as-is. rrT)trimltrimrtrimz ( |\n|^)\.\. c t|jtjs|d|jz|jj}d|jvrd|j d<d|j d<d|jvr d|j d<d|jvr d|j d<|j |j dd }tj}|D]i} tj|}n:#t"$r-}|d|dt%|d}~wwxYw|tj|z }j|jS) NrrrrrrzInvalid character code: r5)rr>rrrlr"rCrrSrcomment_patternrrKrrr unicode_coderkr rnrx)rzsubstitution_definitioncodesrrdecodedrls r;rsz Unicode.run_s{$*f&<== :**-/3y9:: :#'"4"9 T\ ! !:; # .w 7:; # .w 7 dl " ":; # .w 7 dl " ":; # .w 7$**4>!+<==a@FFHH-// + +D 2$1$77 2 2 2jjjtt[///"1222 2 uz'** *GGs!C66 D-(D((D-N)rrrrrrrr rrrecompilerrsr7r=r;rrLsp $%?&O&O--K!bj!122O     r=rc(eZdZdZdZdZdZdZdZdS)Classz Set a "class" attribute on the directive content or the next element. When applied to the next element, a "pending" element is inserted, and a transform does the work later. rrTcx tj|jd}n:#t$r-|d|jd|jddwxYwg}|jrttj}|j |j|j ||D]}|d || |j natjtj||jd|j}|jj||||S)Nrz#Invalid class attribute value for "z" directive: "".r4)r! directive)r rrKrkrlr"rrrr>rrqextendrxpendingrClassAttributerrrCr? note_pendingru)rz class_value node_list containerrrs r;rsz Class.runsU 2$1$.2CDDKK 2 2 2***999dnQ///122 2 2 < & I J # #DL$2E$- / / /! 4 4Y&&{3333   Y/ 0 0 0 0m#%DI>>!!G   ' 4 4W = = =   W % % %s "7AN) rrrrrrrrrsr7r=r;rrxsF  $Kr=rcZeZdZdZejdejjfdzzZ dZ dS)RoleTz(%s)\s*(\(\s*(%s)\s*\)\s*)?$c |j|jks|js|d|jz|jd}|j|}|s!|d|jd|d|d}|d}g}|rtj ||j j |j|j j \}}|M|j j d |ztj|j|j|j }||gzSn tj}t%|d rJd |jd |d t'|}|j |jdd|j|i\} } } } nr#t*j$r`} |j j d|jd| dtj|j|j|j }||gzcYd} ~ Sd} ~ wwxYwd| vr t/j|| d<nz#t2$rm} |j j d|jdt5| dtj|j|j|j }||gzcYd} ~ Sd} ~ wwxYwtj||| | }tj|||S)z?Dynamically create and register a custom interpreted text role.z4"%s" directive requires arguments on the first line.r"z-" directive arguments not valid role names: "rrrN#Unknown interpreted text role "%s".rrKz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsz Error in "r1r.r!zInvalid argument for ")rqrErrlr"argument_patternmatchgrouprrolerClanguager>rrrgrrgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorr rrkr CustomRoleregister_local_role)rzargsr new_role_namebase_role_namer base_rolerlconverted_rolerKrSrrqdetailrs r;rszRole.runsr   , ,DL ,**%'+y122 2|A%++D11 :***(, 4449:: : A Q  2"'* 2 ;T[ ##%#% Ix  +119NJ'II2&& 5')) !1I9k22 L L L59YYY  K L L L &7 BBN 00 QRR $"5~!1## :Y..! & & &&/55537999fffE#DOT_EE[6""Eug% % % % % % %  & ' ! ! *#-#:=#I#I   * * **3999yyy*V"4"4"4"467<7JOT_8686<@K:II 5')))))))  *  y'7KK !-666s?#AF((H7AH HHH77 J.A"J)#J.)J.N) rrrrrrrInliner simplenamerrsr7r=r;rrsWK!rz"A&,n&?%AA%E#GHH33333r=rc eZdZdZdZdZdZdS) DefaultRolez&Set the default interpreted text role.rFc|jsdtjvr tjd=gS|jd}tj||jj|j|jj\}}|M|jj d|ztj |j |j |j}||gzS|tjd<|S)Nr/rrr) rKr_rolesrrCrrEr>rrlrrgrr)rz role_namerrrls r;rszDefaultRole.runs~ U\!!L$IN1% It/A/J$(K1DFFh <J'--5 A#DOT_EE[.""Eug% % Rr=N)rrrrrrrsr7r=r;rrs500 %r=rc eZdZdZdZdZdZdS)TitlerrTc:|jd|jjd<gS)Nrtitle)rKrCr?)rzs r;rsz Title.runs/3~a/@#G, r=N)rrrrrrrsr7r=r;rrs5 $r=rceZdZdZdZdS)MetaBodyc\||\}}|xj|z c_g|gfS)z Meta element.) parsemetaparent)rzrcontext next_stater blank_finishs r; field_markerzMetaBody.field_markers5!^^E22l t :r!!r=c 0||}tjtj|}|j|\}}}}tj}tjtjd ||d<|sA|jj }|j d|ztj ||} | |fS|} tj| dd\} } | || <n #tj$r| d|d<YnwxYw| ddD]} tj| d\} } | || <8#tj$rQ}|jj }|j d| d|d tj ||} | |fcYd}~cSd}~wwxYw||fS) NrrzNo content for meta tag "%s".rr"rz"Error parsing meta tag attribute "z": r.)parse_field_markerrunescape escape2nullrCget_first_known_indentedendrmetarNrhrinforgrextract_name_valuerNameValueErrorrl)rzrr"indentedindent line_offsetrrrhmsgrattnamevaltokenrs r;r zMetaBody.parsemetas@&&u--~e/5566 99%))++FF 4&+|z||.):,/HHX,>,>*@*@AAY %%*D-$$1D8%dD1133C $ $ % 3F1I>>qALGS$'D ! !# % % %!!9DLLL %ABBZ ) )E )$7>>qA (+W]]__%%' ) ) )).m)))().)nested_list_parserrqSMkwargsrbrCrrlrgrrrEr?first_child_not_matching_classTitularrrx)rzrnew_line_offsetrrlindexs r;rszMeta.run/s  !!!}(, (D(D L$-t$4!%)E)0)0% d1 1c$,6G6G G G&/55)#DOT_EE[6""E EMD #BB). (CEEJHI +/= E%K( r=N)rrrrr r*rsr7r=r;r$r$)s4K(-Hr=r$ceZdZdZdZdS)DateTct|jtjs|d|jzd|jpd}tj dkrI | tpd}n+#t$r| dtzwxYwtj|}tj dkrj |tpd}nL#t"$r?|tpdd}| d|d td wxYwt%j|gS) Nrr5z%Y-%m-%drzutf-8z;Cannot encode date format string with locale encoding "%s".replacezError decoding "z"with locale encoding "r)rr>rrrlr"rNrrrencoder r[rBtimestrftimedecodeUnicodeDecodeErrorrrn)rz format_strrs r;rszDate.runHs$*f&<== :**-/3y9:: :YYt|,,:  V # # E'../I'JJ % E E Ell$24C$DEEE E&}Z((  V # # M{{?#=g>>% M M M{{?#=gyIIlll59TT???$LMMM M 4  !!s*B(B/C44A D=Nrr7r=r;r0r0Ds(K%"%"%"%"%"r=r0c6eZdZdZdZdZdejiZdZ dZ dS) TestDirectivez3This directive is useful only for testing purposes.rToptionc p|jrnd|j}|jjd|jd|jd|jdtj |||j }n?|jjd|jd|jd|jd|j }|gS)Nr5zDirective processed. Type="z ", arguments=z , options=z , content:rz, content: None) rrNrCrrr"rKrSrrgrE)rzrrs r;rszTestDirective.runys < "99T\**D%.333"iiiG#D$//dk4CCDD %.333#'999dnnndlllL[4""Dv r=N) rrrrrrr rrrrsr7r=r;r:r:psG== $Z:;KK     r=r:)*r __docformat__ros.pathrGrr4docutilsrrrrdocutils.utils.error_reportingrr r docutils.parsers.rstr r r rr$docutils.parsers.rst.directives.bodyrrdocutils.parsers.rst.rolesrdocutils.transformsrrrrrrrrrSpecializedBodyr r$r0r:r7r=r;rFs  "  333333333333BBBBBBBB::::::FFFFFFFF::::::::::GGGGGGGG222222$$$$$$sssssisssl]]]]])]]]@i@) ) ) ) ) i) ) ) X#####I###L:::::9:::z)4I&"&"&"&"&"v%&"&"&"R96)")")")")"9)")")"XIr=