KindZddlmZdZddlZddlZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZdd lmZmZdd lmZmZmZdd lmZmZdd lmZd ZerddlmZd(d)dZ GddeZ!GddeZ"GddeZ#GddeZ$GddeZ%GddeZ&GddeZ'GddeZ(Gd d!ejRZ*Gd"d#eZ+Gd$d%eZ,Gd&d'eZ-y)*zMiscellaneous directives.) annotationsreStructuredTextN)Path)urlopen)URLError)frontendionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)miscF)StrPathc|r"|jdrt|}|dd}nt|j}tjd||z S)N/) startswithrparentr relative_path)pathsource root_prefixbases p/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/docutils/parsers/rst/directives/misc.py adapt_pathr!sM ts+K ABxF|""   tT$Y //c jeZdZdZdZdZdZejejejeje e e ejejejde ejejd Zeej&j(dz ZddZdd Zdd Zdd Zdd Zdd Zy)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#include rrTN) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec |jjjx|_}|js|j d|j z|j jd|j|_|j jdd|j jdd|j jdd|j jddf|_ tj|jd }|jd r&|jd rd |d dz}|j}n |j }t#||jjj$|}||j d<|j'|}d|j vr|j)|Sd|j vr|j+|Sd|j vr|j-|S|j/|gS)zInclude a file as part of the content of this reST file. Depending on the options, the file content (or a clipping) is converted to nodes and returned or inserted into the input stream. "%s" directive disabled.r*r+Nr,r-r.r<>rrrr&r'r))statedocumentsettingsfile_insertion_enabledwarningr1optionsget tab_width clip_optionsrr argumentsrendswithstandard_include_pathrr!current_source read_fileas_literal_block as_code_block custom_parseinsert_into_input_lines)selfr;rr inputstrings r runz Include.runKs $(::#6#6#?#?? ..,,9DIIEF F))+x7I7IJ!\\--lDA!\\--j$?!\\--mR@!\\--lB?At~~a01 ??3 DMM#$6a#D44K"..K$**--<<%'"& XnnT*  $((5 5 T\\ !%%k2 2 t|| #$$[1 1 $$[1 r"c |jjd|jj}|jj} t j |||}|jjj| |j}|j \}}} } |s|$|j#} d j%| ||}| rF|j'| } | d kr|jd |jd|| t)| zd}| r:|j'| } | d kr|jd|jd|d| }|S#t$r#|jd|jd|dt$r:}|jd|jdt j|dd}~wwxYw#t$r:}|jd |jd t j|zd}~wwxYw)zQRead text file at `path`. Clip and return content. Provisional. r( source_pathr( error_handlerProblems with "z1" directive path: Cannot encode input file path "z" (wrong locale?)." directive path: .NProblem with " " directive:  rz&Problem with "start-after" option of "z" directive: Text not found.z%Problem with "end-before" option of ")r>r?r;input_encodinginput_encoding_error_handlerr FileInputrecord_dependenciesaddUnicodeEncodeErrorseverer1OSError error_stringread UnicodeErrorrA splitlinesjoinfindlen)rKrr(rQ include_fileerrortext startlineendline starttextendtextlines after_index before_indexs r rFzInclude.read_fileos- <<##J 0L0LM BB  8<r@ expandtabsr literal_blockr?rlineadd_name removesuffixrfrcrinlineText) rKrirrt firstlinelastlinetokensrrvalues r rGzInclude.as_literal_blocksK h' >>Q ??4>>2D++ vt||'7'7'DF % !\\--lA>B  m$ T\\ ) ^49I$$T*D 3t'8#99H 2t*y(CF"( 7!U\\"eW%MMM!UZZ%66M  7 UZZ- -Mr"c ||jdk\r|j|j}t|j|jj dg|j|j dg|j|j|j|j|j }|jS)zNPass `text` to the `CodeBlock` directive class. Provisional. rr'rW) r@rsrr1r>poprwlinenocontent_offset block_textr9 state_machinerM)rKri codeblocks r rHzInclude.as_code_blocks >>Q ??4>>2Ddii#||//78"ll#0067"kk"11"oo"jj"00  }}r"c|jd}tj|}|jjj D]\}}t ||||jd|_tj|j|}|jjj|_ |jjj|_ |jjj|_|jjj|_|j!|||jjj"j%|j"|j&j)|f|j&j+|jjj,j%|j,|j.S)zParse with custom parser. Parse with ``self.options['parser']`` into a new (dummy) document, apply the parser's default transforms, return child elements. Provisional. r)r)r>rget_default_settingsr;__dict__itemssetattr_sourcer new_documentr9r: include_logidsnameids nametypesparseparse_messagesextend transformerpopulate_from_componentsapply_transformstransform_messageschildren)rKrir)r;kvr:s r rIzInclude.custom_parsesn(h')008MM**002 $DAq Ha # $<<1%%h&6&6A#zz22>>zz**.. ::..66!ZZ00:: T8$ **11(2I2IJ55vi@--/ ..55  ' ' )   r"cN|jd}tj||jd}t |D]a\}}t ||j jkDs)|dz|jjddz}|jd|d|d |jjj}|sGtjd |jjj}|j!|d f||j"f|vrHd t%|D} d j'|g| } |jd|j(d| |j!||j"f|dd|dgz }|j*j-||y )z\Insert file content into the rST input of the calling parser. Provisional. rT)convert_whitespacerr+r"z": line z exceeds the line-length-limit.N)NNr5r5c3&K|] \}}| ywr%).0pthopts r z2Include.insert_into_input_lines..sHJS#CHsz > zcircular inclusion in "rVr5z.. end of inclusion from ")r>r string2linesr@ enumeraterfr;line_length_limitr?r=r9r:rr rrEappendrAreversedrdr1r insert_input) rKrir textlinesiruline_norrE source_chaininclusion_chains r rJzInclude.insert_into_input_liness h' --dDNNAEG !+ :GAt4y4==:::a%$,,"2"2<"CCllQvhhwi@9$9:: : jj))55 "00 $djj&9&9&H&HJN   0DE F D%% &+ 5H(;2GHL$kk6*AL*ABO,,!8 D//>.? AB BFD$5$567b6vha@AA  '' 6:r"N)returnlist)rrrstr)rirrzlist[nodes.literal_block])rirrr)rirrNone)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacerflag unchangedr( parser_nameintunchanged_requiredvalue_or class_option option_specrr__file__rrDrMrFrGrHrIrJrr"r r$r$*s  $(oo%//)22'33 #!$"","?"?!+!>!>#6:#6#6w#D&33%// 1K!1889D"H.`8(!:;r"r$ceZdZdZdZdZdZejejejejdZ 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)fileurlr(r0c 0|jjj}|jr(|js:d|j vsd|j vr|j d|jzddj|jdjji}|j jd|j}|j}|jrWd|j vsd|j vr|j!d|jzd j|j}n>d|j vrd|j vr|j!d |jzt#|j d|jjj$|j&} t)j*||| }|j,j/| |j7}||d<nwd|j vrY|j d} t;| j7} t)j>| | ||} |j7}| |d<n|jAtCjDdfd|j jdgi|} |jFjI|jJ\| _&| _'| gS#t0$r:}|j3d |jd t)j4|dd}~wwxYw#t8$r:}|j3d|jdt)j4|zd}~wwxYw#t<t0f$rJ}|j3d |jd|j ddt)j4|dd}~wwxYw#t8$r:}|j3d|jdt)j4|zd}~wwxYw)Nrrr4format rr(zF"%s" directive may not both specify an external file and have content.rWzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.rOrRrSrTrUrVrz" directive URL "z": )rrPr(rQr5rrr0)(r9r:r; raw_enabledr<r>r=r1rdrBlowersplitr?rXrYcontentrhr!rErr rZr[r\r_r^r`rarbrr StringInputassert_has_contentr rawrget_source_and_linerrru) rKr; attributesr(rQrirraw_filerhrraw_textraw_nodes r rMzRaw.run"s::&&//$$33t||+u /D,,9DIIEF F):)@)@)B)H)H)J KL <<##J0G0GH == <<%$,,)>jj(*.))45599T\\*D t|| # $jj8:>))DEEdll62"jj11@@&224D 7<rcomment_patternrrBr rr unicode_code ValueErrorr r`ryr)rKsubstitution_definitioncodesrr'decodedrhs r rMz Unicode.runso$**f&<&<=**-/3yy9: :#'"4"4"9"9 T\\ !:; # . .w 7:; # . .w 7 dll ":; # . .w 7 dll ":; # . .w 7$$**4>>!+<=a@FFH--/ +D C$11$7 uzz'* *G  +  Cjj$("//%*@"BCC CsE  F*FFN)rrrrrrrrrrrecompilerrMrr"r rrsO $%??&OO&OO-K!bjj!12O r"rc&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: "".rr)r0 directive)rrrBrrhr1rr rr9rrrrpendingrClassAttributerrr: note_pendingr)rK 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) rrrrrrrrrMrr"r rrs%  $Kr"rcpeZdZdZej 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.rrz-" directive arguments not valid role names: "rrN#Unknown interpreted text role "%s".rrBz&Supplemental directive arguments for "z)" directive not supported (specified by "z" role).)option_presetsrrVrTr0zInvalid argument for ")rrrrhr1argument_patternmatchgrouprrolerlanguager9rr rtrgeneric_custom_rolehasattrrparse_directive_blockr MarkupErrorrrr CustomRoleregister_local_role)rKargsr  new_role_namebase_role_namer base_rolerhconverted_rolerBr>rrdetailr s 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 simplenamer rMrr"r rrs<K!rzz"A&,nn&?&?%AA%E#GH4r"rceZdZdZdZdZdZy) 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)Nr5rrr) rBr_rolesr rrrr9rrhr rtr)rK role_namer rrhs r rMzDefaultRole.runs~~U\\!LL$INN1% It/A/A/J/J$(KK1D1DFh <JJ''--5 A##DOOT__E[[."Eug% % Rr"N)rrrrrrrMrr"r rrs0 %r"rceZdZdZdZdZdZy)TitlerrTcR|jd|jjd<gS)Nrtitle)rBrr:)rKs r rMz Title.run6s&/3~~a/@##G, r"N)rrrrrrrMrr"r r#r#0s $r"r#ceZdZdZdZy)MetaBodyc^|j|\}}|xj|z c_g|gfS)z Meta element.) parsemetar)rKr context next_stater blank_finishs r field_markerzMetaBody.field_marker=s0!^^E2l t :r!!r"c 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".rr1rz"Error parsing meta tag attribute "z": rT)parse_field_markerr unescaper escape2nullrget_first_known_indentedendmetardrurinfortrextract_name_valuerNameValueErrorrh)rKr r1indentedindent line_offsetr,rrumsgr|attnamevaltokenrs r r)zMetaBody.parsemetaCs&&u-~~e//56    8 8 E 6; zz|..):):,/HHX,>*@AY%%**D--$$1D8%%dD13C $ $ % 33F1I>qALGS$'D !ABZ )E )$77>qA (+W]]_% )\!!## %!!9DL % '' )))..mm))().)<)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)NrWzDirective processed. Type="z ", arguments=z , options=z , content:rz, content: None) rrdrr5r1rBr>r rtr)rKrir5s r rMzTestDirective.runs <<99T\\*D==%%"iiG##D$/dkk&CDv ==%%#'99dnndllL[[&"Dv r"N) rrrrrrrrrrrMrr"r rRrRs+= $Z::;KK r"rR)r5r5)rrrr).r __future__r __docformat__rrNpathlibrurllib.requestr urllib.errorrdocutilsrr r r r docutils.parsers.rstr rrrr$docutils.parsers.rst.directives.bodyrrdocutils.transformsr TYPE_CHECKINGdocutils.nodesrr!r$rrrrrrr#SpecializedBodyr'r@rLrRrr"r ras  "" "!==F::G$ & 0`;i`;HT)TniB) i) X#I#L;9;|)4I&"v%%&"R96"9"<Ir"