o NiLh@sddZdZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZdd lmZmZmZdd lmZmZdd lmZd(ddZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"Gd d!d!ej#Z$Gd"d#d#eZ%Gd$d%d%eZ&Gd&d'd'eZ'dS))zMiscellaneous directives.reStructuredText)PathN)urlopen)URLError)ionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)misc/cCs:|drt|}|dd}nt|j}td||S)Nr) startswithrparentr relative_path)pathsource root_prefixbaserX/home/ubuntu/.local/lib/python3.10/site-packages/docutils/parsers/rst/directives/misc.py adapt_paths  rc @sdeZdZdZdZdZdZejej ej ej e e e ej ej ej ejej d ZeejjdZddZd S) 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! Cs|jjj}|js|d|j|jd|j}|jjj }t |j d}| dr;|dr;d|dd}|j}n|j}t|||}|jd |j}|j}z tj|||d }Wn/tym|d |jd |d ty} z|d |jdt| dd} ~ ww|j||jdd} |jdd} z| s| dur|} d| | | } n|} Wnty} z|d|jdt| d} ~ ww|jdd}|r| |}|dkr|d|j| |t!|d} |jdd}|r| |}|dkr|d|j| d|} t"j#| |dd}t$|D]\}}t!||j%kr<|d||dfq%d|jvr|dkrO| &|}n| }t'j(| ||jdgd}d|_)|*|d |jvrz t+|jd pud} Wn t,y|-d!w| t!|} |d"r|dd}t.g|fg| | }|D]\}}|r|t'j/|||d#7}q|t'0|7}q|gS|t'0|7}|gSd$|jvr||jd%<|dkr| 1}t2|j|j3d$g|j||j4|j5|j6|j|j7 }|8S| | ||f}|jjj9}|s|:t;||}|||fg|_9|jd+} | ?d"|||j@A| f|j@B|jCS|dd,|g7}|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)NNNNcss|]\}}|VqdS)Nr).0pthoptrrr szInclude.run..z > z(circular inclusion in "%s" directive: %sr#z.. end of inclusion from "%s")Estatedocumentsettingsfile_insertion_enabledwarningr+optionsget tab_widthcurrent_sourcer r argumentsrendswithstandard_include_pathrrinput_encodinginput_encoding_error_handlerr FileInputUnicodeEncodeErrorsevereOSError error_stringrecord_dependenciesadd 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)!selfrBrGrHrrr"r3 include_filerd startlineendlinelinesrawtext after_text after_index before_text before_index include_linesir`textr_tokensr:value codeblock clip_optionsrn master_pathsinclusion_chainrAr#rrrrmEs                                    z Include.runN)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flag unchangedr" parser_namerbunchanged_required class_option option_specrr__file__rrKrmrrrrr$s(  rc@s>eZdZdZdZdZdZejej ej ej dZ dZ ddZdS) 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 Cs|jjj}|jr|jsd|jvsd|jvr|d|jdd|j d i}|j d|j }|j}|jrRd|jvsCd|jvrK|d|jd |j}nd|jvrd|jvrd|d |jt|jd|jjj|j}z tj|||d }Wnty}z|d |jd t|dd}~ww|j|z|}Wnty}z|d|jdt|d}~ww||d<nmd|jvr.|jd} zt| } Wn$ttfy}z|d |jd|jddt|dd}~wwtj| | ||d}z|}Wnty(}z|d|jdt|d}~ww| |d<n| t!j"d|fd|j dgi|} |j#$|j%\| _&| _'| gS)Nrrr-format 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.r1r4r5r6r7r8rz" directive URL "z": )rr2r"r3rr:r*)(r@rArB raw_enabledrCrErDr+rVrIlowersplitrFrLrMcontentrdrrHrrrNrQrPrRrSrTrWrXrr StringInputassert_has_contentrrawrlget_source_and_linerirr`) rxrB attributesr"r3rrraw_filerdrraw_textraw_noderrrrms               zRaw.runN)rrrrrrrr rurir"rr has_contentrmrrrrrs  rc@eZdZdZddZdS)ReplaceTcCst|jtjs|d|j|d|j}t |}|j |j|j |d}g}|D]-}|s;t|t j r;|}q.t|t jrKg|d<||q.|jjd|jd|jdgS|rc||jS|S)NVInvalid context: the "%s" directive can only be used within a substitution definition.r;backrefsz Error in "z1" directive: may contain a single paragraph only.r`) isinstancer@rSubstitutionDefrdr+rrVrrElement nested_parserj paragraphsystem_messageroreporterrirv)rxrelementnodemessageselemrrrrm9s8      z Replace.runNrrrrrmrrrrr5 rc@s@eZdZdZdZdZdZejejejdZ e dZ ddZ d S) 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 Cst|jtjs|d|j|jj}d|jvr"d|j d<d|j d<d|jvr,d|j d<d|jvr6d|j d<|j |j dd }t }|D])}zt|}Wntyj}z |d|t|fd}~ww|t |7}qI|jS)NrrrrrrzInvalid character code: %s %s)rr@rrrdr+rlrrErcomment_patternrrIrrr unicode_codercrrRrfrv)rxsubstitution_definitioncodesrr!decodedrdrrrrmis6        z Unicode.runN)rrrrrrrr rrrecompilerrmrrrrrVs  rc@s(eZdZdZdZdZdZdZddZdS)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 Csz t|jd}Wnty|d|j|jdfwg}|jrFt}|j |j|j ||D] }|d |q4| |j |Sttj||jd|j}|jj||||S)Nrz7Invalid class attribute value for "%s" directive: "%s".r:)r* directive)r rrIrcrdr+rrrr@rrjextendrvpendingrClassAttributerkrlrA note_pendingro)rx class_value node_list containerrrrrrrms6    z Class.runN) rrrrrrrrrmrrrrrs rc@s0eZdZdZedejjfdZ ddZ dS)RoleTz(%s)\s*(\(\s*(%s)\s*\)\s*)?$c Cs |j|jks |js|d|j|jd}|j|}|s(|d|j|f|d}|d}g}|rbt ||j j |j|j j \}}|dura|j j jd|t|j|j|jd}||gSntj}t|d rsJd |j|fzt|}|j j|jdd|j|id \} } } } Wn-tjy} z |j jd |j| ft|j|j|jd}||gWYd} ~ Sd} ~ wwd | vrz t|| d <Wn,ty} z |j jd|j| ft|j|j|jd}||gWYd} ~ Sd} ~ wwt||| | }t|||S)z?Dynamically create and register a custom interpreted text role.z4"%s" directive requires arguments on the first line.rz4"%s" directive arguments not valid role names: "%s".rN#Unknown interpreted text role "%s".rrIz[Supplemental directive arguments for "%s" directive not supported (specified by "%r" role).)option_presetszError in "%s" directive: %s.r*z(Invalid argument for "%s" directive: %s.)rjrirrdr+argument_patternmatchgroupr rolerllanguager@rrr_rkgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorr rrc CustomRoleregister_local_role)rxargsr new_role_namebase_role_namer base_rolerdconverted_rolerIrErrjdetailrrrrrms         zRole.runN) rrrrrrrInliner simplenamerrmrrrrrs   rc@ eZdZdZdZdZddZdS) DefaultRolez&Set the default interpreted text role.rFcCs|jsdtjvr tjd=gS|jd}t||jj|j|jj\}}|dur>|jjj d|t |j |j |jd}||gS|tjd<|S)Nrrrr) rIr _rolesrrlrrir@rrdrr_rk)rx role_namerrrdrrrrms"      zDefaultRole.runN)rrrrrrrmrrrrrs  rc@r)TitlerrTcCs|jd|jjd<gS)Nrtitle)rIrlrA)rxrrrrmsz Title.runN)rrrrrrrmrrrrrs  rc@seZdZddZddZdS)MetaBodycCs&||\}}|j|7_g|gfS)z Meta element.) parsemetar)rxrcontext next_stater blank_finishrrr field_marker s zMetaBody.field_markerc Csf||}tt|}|j|\}}}}t}ttd ||d<|sA|jj }|j d|t ||} | |fS|} zt| dd\} } | || <Wntjyh| d|d<Ynw| ddD]?} zt| d\} } | || <Wqotjy}z|jj }|j d| |ft ||} | |fWYd}~Sd}~ww||fS)NrrzNo content for meta tag "%s".rr+rz*Error parsing meta tag attribute "%s": %s.)parse_field_markerrunescaper escape2nullrlget_first_known_indentedendmetarVr`rinfor_rextract_name_valuerNameValueErrorrd)rxrr+indentedindent line_offsetrrr`msgrattnamevaltokenrrrrrsL     zMetaBody.parsemetaN)rrrrrrrrrr s rc@s"eZdZdZdefiZddZdS)MetaT state_classescCs|t}|jj|j|j|dd|jd\}}||jt|jkr7|j j dt |j |j |j d}||7}|jjtjtjfpCd}|j|jj||<gS)NrT) initial_staterstate_machine_kwargszInvalid meta directive.rr)rrrr@nested_list_parserrjSMkwargsrZrrdr_rkrirAfirst_child_not_matching_classTitularrrv)rxrnew_line_offsetrrdindexrrrrm:s*   zMeta.runN)rrrrrr rmrrrrr4s  rc@r)DateTcCsDt|jtjs|d|jd|jpd}t |}t |gS)Nrr;z%Y-%m-%d) rr@rrrdr+rVrtimestrftimerrf)rx format_strrrrrrmSs  zDate.runNrrrrrrOrrc@s.eZdZdZdZdZdejiZdZ ddZ dS) TestDirectivez3This directive is useful only for testing purposes.rToptioncCsl|jr"d|j}|jjd|j|j|jft|||j d}|gS|jjd|j|j|jf|j d}|gS)Nr;zBDirective processed. Type="%s", arguments=%r, options=%r, content:rzGDirective processed. Type="%s", arguments=%r, options=%r, content: None) rrVrrr+rIrErr_ri)rxrrrrrrmvs   zTestDirective.runN) rrrrrrr rrrrmrrrrrms  r)rr)(r __docformat__pathlibrrrurllib.requestr urllib.errorrdocutilsrrrr docutils.parsers.rstr r r r r$docutils.parsers.rst.directives.bodyrrdocutils.transformsrrrrrrrrrrSpecializedBodyrrrrrrrrs4     ;W!,&> )