ohefdZdZddlmZddlZddlZddlZddlmZddl m Z ddl Z ddl m Z m Z mZmZddlmZmZdd lmZmZmZdd lmZmZdd lmZGd d eZGddeZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"GddejFZ$GddeZ%Gd d!eZ&Gd"d#eZ'y)$zMiscellaneous directives.reStructuredText)PathN)urlopen)URLError)ionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)miscc >eZdZdZdZdZdZejejejeje e e ejejejejejd Zeej$ej(dz ZdZy) 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. https://docutils.sourceforge.io/docs/ref/rst/directives.html#including-an-external-document-fragment rT) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec |jjjjs|j d|j z|jjj }tj|jd}|jdr#|jdr|j}|dd}nt|j}tj d||z }|j"j%d|jjjj&}|jjjj(}|j"j%d |jjjj*} t-j.||| }|jjjj0j3||j"j%dd} |j"j%dd} | s| %|j=} dj?| | | } n|jA} |j"j%dd} | rE| jE| }|dkr|j7d|j z| |tG| zd} |j"j%dd}|r9| jE|}|dkr|j7d|j z| d|} tIjJ| |d}tM|D]T\}}tG||jjjjNkDs=|j d||dzfzd|j"vr |dk\r| jQ|}n| }tSjT| ||j"j%dg}d|_+|jY|d|j"vr t[|j"dxsd} | tG|z} |jd!r|dd}tag|fg| | }|D];\}}|r|tSjb|||"z }$|tSjd|z }=|gS|tSjd|z }|gSd#|j"vr||j"d$<|dkr| jg}ti|j |j"jkd#g|j"||jl|jn|jp|j|jr }|juS| | || f}|jjjv}|s'|jytj d|d%f||f|vrHd&t{|D}d'j?|g|}|j d(|j d|d)|j"vrtj|||jjj}|||fgz|_;|j"d)}|jd!j?|||jj|f|jj|jS|dd*|zgz }|jrj|||jy||fgS#t4$r#|j7d |j d |d t8$r:}|j7d |j dt-j:|dd}~wwxYw#tB$r:}|j7d|j dt-j:|zd}~wwxYw#t\$r|j_d wxYw)+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.r<>rNrr 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 )sourceclassesrz+:number-lines: with non-integer start value )r3rr2)NNNNc3&K|] \}}| yw)N).0pthopts F/usr/lib/python3/dist-packages/docutils/parsers/rst/directives/misc.py zInclude.run..sHJS#CHsz > zcircular inclusion in "rz.. end of inclusion from "%s")Estatedocumentsettingsfile_insertion_enabledwarningr!current_sourcer path arguments startswithendswithstandard_include_pathrparentr relative_pathoptionsgetinput_encodinginput_encoding_error_handler tab_widthr FileInputrecord_dependenciesaddUnicodeEncodeErrorsevereOSError error_string readlinesjoinread UnicodeErrorfindlenr string2lines enumerateline_length_limit expandtabsr literal_blocklineadd_nameint ValueErrorerrorrinlineText splitlinesrpoplinenocontent_offset block_text state_machinerun include_logappendreversed new_documentparse transformerpopulate_from_componentsapply_transformschildren insert_input) selfrArB_baser e_handlerrM include_filerd startlineendlinelinesrawtext after_text after_index before_text before_index include_linesir`textr_tokensr3value codeblock clip_optionsrn master_pathsinclusion_chainr=rs r:rmz Include.run9ss zz""++BB,,9DIIEF F,,;;t~~a01 ??3 DMM#$6..E":D(//E""4t4<<##  ++44CCEJJ''00MM LL$$ ,,55??A  G<E*GG &E):: ;"? "D!11 !? " T\\ !%)DLL "1} ' 2 2 4 !$))#'<<#3#3F#;"<"&,,"/"&++"&"5"5"&//"&**"&"4"46I==? ""7KD jj))55     3 3D. I 8 : ; , ; .H(;2GHL$kk4*?,*?@O,,"&))_ >? ? t|| #))$ 0C0C0L0LMH#.42F1G#GH +T\\(+-F LL=18 <  9 96) D  1 1 3$$ $ "=DEE  '' t<D,/0 }" 2++ {;@@DvF112 2 C++ {;((*(>'?qBC C C 8++tyykH " 678 8 8V"4**&3444s< \*9^ _3^ 5^^ _ 5__ _*N)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flag unchangedr parser_namerbunchanged_required class_option option_specrdocutils_datadirr__file__rFrmr6r:rrs  $(oo%//)22'33 #!$"","?"?!+!>!>#-#7#7&33%// 1K!!2!2!26??!CDyPWrrceZdZdZdZdZdZejejejejdZ dZ dZy)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 N |jjjjrF|jjjjs:d|j vsd|j vr|j d|jzddj|jdjji}|j jd|jjjj}|jjjj}|jrWd|j vsd|j vr|j!d|jzd j|j}nud|j vrd|j vr|j!d |jz|j d}t#|jjj$j&}t)j*d||z } t-j.||| }|jjjj0j3| |j;}||d<nwd|j vrY|j d} t?| j;} t-jB| | ||} |j;}| |d<n|jEtGjHdfd|j jdgi|} |jJjM|jN\| _(| _)| gS#t4$r:}|j7d |jd t-j8|dd}~wwxYw#t<$r:}|j7d|jdt-j8|zd}~wwxYw#t@t4f$rJ}|j7d |jd|j ddt-j8|dd}~wwxYw#t<$r:}|j7d|jdt-j8|zd}~wwxYw)Nrrr$format rrzF"%s" directive may not both specify an external file and have content.r4zXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.r(r+r,r-r/r0r2z" directive URL "z": )r2r)rr*r.r3r )*r<r=r> raw_enabledr?rIr@r!rVrClowersplitrJrKrLcontentrdrrArGr rHrrNrOrPrSrRrTrWrXrr StringInputassert_has_contentrrawrlget_source_and_linerir2r`) rx attributesrrzrrBryraw_filerdr2raw_textraw_nodes r:rmzRaw.runs ##,,88JJ''00GGt||+-,,9DIIEF F):)@)@)B)H)H)J KL <<##  ++44CCEJJ''00MM <<%$,,)>jj(*.))45599T\\*D t|| # $jj8:>))DEE<<'D,,;;<CCE&&tU4Z8D K<>!+<=a@FFH--/ +D C$11$7 uzz'* *G  +  Cjj$("//%*@"BCC CsE  F*FFN)rrrrrrrr rrrecompilerrmr6rr:rrLsO $%??&OO&OO-K!bjj!12O rrc&eZdZdZdZdZdZdZdZy)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. rrTc tj|jd}g}|j r}tj}|jj|j |j||D]}|dj||j|j|Stjtj ||j d|j"}|j$j&j)||j+||S#t$r0|j d|j d|jddwxYw)Nrz#Invalid class attribute value for "z" directive: "".r3)r directive)r rrCrcrdr!rrrr<rrjextendrvpendingrClassAttributerkrlr= note_pendingro)rx class_value node_list containerrrs r:rmz Class.runs. 2$11$..2CDK  << I JJ # #DLL$2E2E$- /! 4Y&&{3 4   Y// 0 mm##%DII>!G    ' ' 4 4W =   W %' 2**99dnnQ/12 2 2s "D##9EN) rrrrrrrrrmr6rr:rrxs%  $KrrcpeZdZdZej dejjfdzzZ dZ y)RoleTz(%s)\s*(\(\s*(%s)\s*\)\s*)?$cl|j|jkDs |js|jd|jz|jd}|j j |}|s"|jd|jd|d|jd}|jd}g}|rtj||jj|j|jj\}}|s|jjjd |ztj|j |j |j }||gzStj"}t%|d rJd |jd |d t'|}|jj)|jdd|j|i\} } } } d| vr t/j0|| d<tj4||| | }tj6|||S#t*j,$rq} |jjd|jd| dtj|j |j |j }||gzcYd} ~ Sd} ~ wwxYw#t2$rq} |jjd|jd| dtj|j |j |j }||gzcYd} ~ Sd} ~ wwxYw)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: "rrN#Unknown interpreted text role "%s".rrCz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsrr0r-r zInvalid argument for ")rjrirrdr!argument_patternmatchgrouprrolerllanguager<rrr_rkgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorr rrc CustomRoleregister_local_role)rxargsr new_role_namebase_role_namer base_rolerdconverted_rolerCrIrrjdetailrs r:rmzRole.runs    ,DLL**%'+yy12 2||A%%++D1**(, 49: : A Q "'** 2 2 ; ;T[[ ###% Ix  ++119NJ''I2& 5'))11I9k2 L59YY  K L2 &7 BN11LL$d&9&9"227 Y. ' ! *#-#:#:=#I  y'7K !!-6%!! &MM''3799fE##DOOT__E[[("Eug% %  & * ++yy&*''I ,&  5'))  *s?AH2*J92J6A&J1+J61J69 L3A&L.(L3.L3N) rrrrrrrInliner simplenamerrmr6rr:rrs<K!rzz"A&,nn&?&?%AA%E#GH4rrceZdZdZdZdZdZy) DefaultRolez&Set the default interpreted text role.rFc|js%dtjvrtjd=gS|jd}tj||jj |j |jj\}}|c|jjjd|ztj|j|j|j }||gzS|tjd<|S)Nr.rrr) rCr_rolesrrlrrir<rrdrr_rk)rx role_namerrrds r:rmzDefaultRole.runs~~U\\!LL$INN1% It/A/A/J/J$(KK1D1DFh <JJ''--5 A##DOOT__E[[."Eug% % RrN)rrrrrrrmr6rr:rrs0 %rrceZdZdZdZdZdZy)TitlerrTcR|jd|jjd<gS)Nrtitle)rCrlr=)rxs r:rmz Title.runs&/3~~a/@##G, rN)rrrrrrrmr6rr:rrs $rrceZdZdZdZy)MetaBodyc^|j|\}}|xj|z c_g|gfS)z Meta element.) parsemetarG)rxrcontext next_stater blank_finishs r: field_markerzMetaBody.field_markers0!^^E2l t :r!!rc 0|j|}tjtj|}|j j |j\}}}}tj}tjtjdj||d<|sM|j j}|jjd|ztj||} | |fS|j} tj| dd\} } | || j!<| ddD]1} tj| d\} } | || j!<3||fS#tj"$r | d|d<YZwxYw#tj"$r]}|j j}|jj%d| d|d tj||} | |fcYd}~cSd}~wwxYw) NrrzNo content for meta tag "%s".rr!rz"Error parsing meta tag attribute "z": r-)parse_field_markerrunescaper escape2nullrlget_first_known_indentedendmetarVr`rinfor_rextract_name_valuerNameValueErrorrd)rxrr!indentedindent line_offsetr rr`msgrattnamevaltokenrs r:rzMetaBody.parsemeta s&&u-~~e//56    8 8 E 6; zz|..):):,/HHX,>*@AY%%**D--$$1D8%%dD13C $ $ % 33F1I>qALGS$'D !ABZ )E )$77>qA (+W]]_% )\!!## %!!9DL % '' )))..mm))().)<)? ==!%S1B-C!DFD==,D 4 !!rNrr6rr:r)r)Es K"rr)c>eZdZdZdZdZdejiZdZ dZ y) TestDirectivez3This directive is useful only for testing purposes.rToptionc |jrdj|j}|jjd|jd|j d|j dtj|||j}|gS|jjd|jd|j d|j d|j}|gS)Nr4zDirective processed. Type="z ", arguments=z , options=z , content:rz, content: None) rrVrrr!rCrIrr_ri)rxrrs r:rmzTestDirective.runls <<99T\\*D==%%"iiG##D$/dkk&CDv ==%%#'99dnndllL[[&"Dv rN) rrrrrrr rrrrmr6rr:r4r4cs+= $Z::;KK rr4)(r __docformat__pathlibrr,rr.urllib.requestr urllib.errorrrrrr r docutils.parsers.rstr r r rr$docutils.parsers.rst.directives.bodyrrdocutils.transformsrrrrrrrrrSpecializedBodyrrr)r4r6rr:r?s  "  "!33F::G$xixvU)UpiB) i) X#I#L;9;|)4I&"v%%&"R96"9"<Ir