-PhLhdZdZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZdd lmZmZmZdd lmZmZdd lmZd'dZGddeZGddeZGddeZGddeZGddeZGddeZ GddeZ!GddeZ"Gdd ej#Z$Gd!d"eZ%Gd#d$eZ&Gd%d&eZ'dS)(zMiscellaneous directives.reStructuredText)PathN)urlopen)URLError)ionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)misc/c|drt|}|dd}nt|j}tjd||z S)Nr) startswithrparentr relative_path)pathsource root_prefixbases d/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/docutils/parsers/rst/directives/misc.py adapt_pathrsY  s#K  ABBxF||"  tT$Y / //c eZdZdZdZdZdZejej ej ej e e e ej ej ej ejej d Zeejjdz ZdZdS) 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 rrT) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec |jjj}|js|d|jz|jd|j}|jjj }tj |j d}| dr*|drd|ddz}|j}n|j}t#|||}|jd |j}|j} t)j||| }|j|no#t0$r"|d |jd |d t4$r8} |d |jdt)j| dd} ~ wwxYw|jdd} |jdd} | s| 2|} d| | | } n|} nE#t>$r8} |d|jdt)j| zd} ~ wwxYw|jdd}|rR| |}|dkr|d|jz| |tC|zd} |jdd}|rB| |}|dkr|d|jz| d|} tEj#| |d}tI|D]:\}}tC||j%kr|d||dzfz;d|jvrP|dkr| &|}n| }tOj(| ||jdg}d|_)|*|d |jvr tW|jd pd} n##tX$r|-d!wxYw| tC|z} |d"r |dd}t]g|fg| | }|D]9\}}|r|tOj/|||#z }"|tOj0|z }:n|tOj0|z }|gSd$|jvr||jd%<|dkr| 1}te|j|j3d$g|j||j4|j5|j6|j|j7 }|8S| | ||f}|jjj9}|s*|:twj<d|d&f||f|vrRd't{|D}d(|g|R}|d)|jd|d*|jvrtwj>||}|||fgz|_9|jd*} | ?d"|||j@A| f|j@B|jCS|dd+|zgz }|j7D|||:||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.r'r<>rrr% source_pathr% error_handlerProblems with "z1" directive path: Cannot encode input file path "z" (wrong locale?)." directive path: .Nr(r)rProblem with " " directive: r*zDProblem with "start-after" option of "%s" directive: Text not found.r+zCProblem with "end-before" option of "%s" directive: Text not found.T)convert_whitespacez,"%s": line %d exceeds the line-length-limit.r#r-)rclassesr,z+:number-lines: with non-integer start value )r>r$r)NNNNc3 K|] \}}|V dS)N).0pthopts r zInclude.run..s&HHJS#CHHHHHHr z > zcircular inclusion in "r&z.. end of inclusion from "%s")Estatedocumentsettingsfile_insertion_enabledwarningr.optionsget tab_widthcurrent_sourcer r argumentsrendswithstandard_include_pathrrinput_encodinginput_encoding_error_handlerr FileInputrecord_dependenciesaddUnicodeEncodeErrorsevereOSError error_string readlinesjoinread UnicodeErrorfindlenr string2lines enumerateline_length_limit expandtabsr literal_blocklineadd_nameint ValueErrorerrorrinlineText splitlinesrpoplinenocontent_offset block_text state_machinerun include_logappendr rreversed new_documentparse transformerpopulate_from_componentsapply_transformschildren insert_input)!selfrHrMrNrrr%r7 include_filerj startlineendlinelinesrawtext after_text after_index before_text before_index include_linesirftextretokensr>value codeblock clip_optionsrt master_pathsinclusion_chainrGr&s! rrsz Include.runEs< :&/. G,,9DIEFF FL$$[(2DEE ,;t~a011 ??3   /DMM#$6$6 /ad#D4KK".K$ <<<##J0GHH =  3(>BBBCC C CL$$\488 ,"":t44 8 .W0$..00''% '(9":;;&++-- 8 8 8++HtyHHH " 6 6788 8 8 \%%mT::  >!,,z22KQkk#@BF)#LMMMkC OO;<<=Gl&&|T::  -"<< 44Lakk#@BF)#LMMMm|m,G$1'9EIKKK  // H HGAt4yy8555ll$9<@!A#;$GHHH6  $ $A~~)))44!/ '(, (8(8"(E(EGGGM"#M  MM- ( ( (--4 #DL$@$EA F FII!444**&34444$c-&8&88==&&%9D$r4j\9gFF&,;;NGU;%eU>E*G*G*GG &E):):: ;D!1!11 !? " T\ ! !%)DL "1}} ' 2 2 4 4 !$)#'<#3#3F#;#;"<"&,"/"&+"&"5"&/"&*"&"466I==?? ""7KD j)5  ;    3D. I I 8 : ; ; ; , ; . .HH(;2G2GHHHL$kk4*?,*?*?@@O,,,"&)))__ >?? ? t| # #)$99H#.42F1G#GH +T\(+--F LL=118 < < <  9 96) D D D  1 1 3 3 3$ $ "=DEE  '' t<<<D,/000 s=D774F#+3FF#A H(( I*23I%%I*P77 QN)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flag unchangedr% parser_namerhunchanged_required class_option option_specrr__file__rrQrsrAr rr"r"$s   $(o%/)2'3 #!$"","?!+!>#-#7&3%/ 1 1K!D1189DVVVVVr r"c^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)fileurlr%r-c |jjj}|jr|js/d|jvs d|jvr|d|jzdd|j d i}|j d|j }|j}|jrKd|jvs d|jvr|d|jzd |j}n[d|jvr0d|jvr|d |jzt#|jd|jjj|j} t)j||| }|j|nE#t0$r8}|d |jd t)j|dd}~wwxYw |}nE#t8$r8}|d|jdt)j|zd}~wwxYw||d<n!d|jvr|jd} t;| } nZ#t<t0f$rF}|d |jd|jddt)j|dd}~wwxYwt)j| | ||} |}nE#t8$r8}|d|jdt)j|zd}~wwxYw| |d<n| tCj"d|fd|j dgi|} |j#$|j%\| _&| _'| gS)Nrrr1format rr%zF"%s" directive may not both specify an external file and have content.r?zXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.r5r8r9r:r;r<rz" directive URL "z": )rr6r%r7rr>r-)(rFrGrH raw_enabledrIrKrJr.r\rOlowersplitrLrRrScontentrjrrNrrrTrUrVrYrXrZr]r^rr StringInputassert_has_contentrrawrrget_source_and_linerorrf) r~rH attributesr%r7rrraw_filerjrraw_textraw_nodes rrszRaw.runs:&/$ G3 Gt|++u /D/D,,9DIEFF F):)@)@)B)B)H)H)J)J K KL <##J0GHH = <2 &%%$,)>)>jj(*.)455599T\**DD t| # # $$jj8:>)DEEEdl62"j1@&244D 73H99H> !JKAKK5L M 3MM N)rrrrrrrr rurir%rr has_contentrsrAr rrrso $%?$.)2&355KK@@@@@r rceZdZdZdZdS)ReplaceTcxt|jtjs|d|jz|d|j}tj |}|j |j|j |d}g}|D]}|st|tj r|}!t|tjrg|d<||V|jd|jd|jgcS|r ||jzS|S)NVInvalid context: the "%s" directive can only be used within a substitution definition.r?backrefs Error in "z1" directive: may contain a single paragraph only.rf) isinstancerFrSubstitutionDefrjr.rr\rrElement nested_parserp paragraphsystem_messagerureporterror|)r~relementnodemessageselems rrsz Replace.run9s$*f&<== :**-/3y9:: : !!!yy&&-%%  d.A ' ) ) ) G GD GJtU_== GD%"677 G#%Z %%%%M''3TY3339=(FFGGGG  ,dm+ +r NrrrrrsrAr rrr5s(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]n} tj|}n?#t"$r2}|d|dt%j|d}~wwxYw|tj|z }o|jS) NrrrrrrzInvalid character code: r?)rrFrrrjr.rrrrKrcomment_patternrrOrrr unicode_coderirrZrlr|)r~substitution_definitioncodesrr$decodedrjs rrsz Unicode.runis$*f&<== :**-/3y9:: :#'"4"9 T\ ! !:; # .w 7:; # .w 7 dl " ":; # .w 7 dl " ":; # .w 7$**4>!+<==a@FFHH-// + +D C$1$77 C C Cjjj$(DD"/%*@*@*@"BCCC C uz'** *GGs!C66 D2-D--D2N)rrrrrrrr rrrecompilerrsrAr rrrVsp $%?&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: "".r>)r- directive)r rrOrirjr.rrrrFrrpextendr|pendingrClassAttributerqrrrG note_pendingru)r~ class_value node_list containerrrs rrsz 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) rrrrrrrrrsrAr rrrsF  $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\} } } } nm#t*j$r[} |j d|jd| dtj|j|j|j }||gzcYd} ~ Sd} ~ wwxYwd| vr t/j|| d<nh#t2$r[} |j d|jd| 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: "rrN#Unknown interpreted text role "%s".rrOz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsrr<r:r-zInvalid argument for ")rprorrjr.argument_patternmatchgrouprrolerrlanguagerFrrrerqgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorr rri CustomRoleregister_local_role)r~argsr new_role_namebase_role_namer base_rolerjconverted_rolerOrKrrpdetailrs rrszRole.runsY   , ,DL ,**%'+y122 2|A%++D11 :***(, 4449:: : A Q  2"'* 2 ;T[ ##%#% Ix  +119NJ'II2&& 5')) !1I9k22 L L L59YYY  K L L L &7 BBN11L$d&9"2277 Y..! & & &M'''37999fffE#DOT_EE[(""Eug% % % % % % %  & ' ! ! *#-#:=#I#I   * * * +++yyy&&&*'II ,&&  5')))))))  * y'7KK !-666s?#AF((H7AH H HH22 J,>*@*@AAY %%*D-$$1D8%dD1133C $ $ % 3F1I>>qALGS$'D ! !# % % %!!9DLLL %ABBZ ) )E )$7>>qA (+W]]__%%' ) ) )).m)))().)r<s  "  """"""!!!!!!333333333333FFFFFFFF::::::::::GGGGGGGG$$$$$$ 0 0 0 0wwwwwiwwwtTTTTT)TTTniB) ) ) ) ) i) ) ) X#####I###L;;;;;9;;;|)4I&"&"&"&"&"v%&"&"&"R96"""""9"""<Ir