o g&o@sndZdZddlZddlZddlZddlZddlmZm Z m Z m Z ddl m Z mZddl mZddlmZmZddlmZmZmZdd lmZmZdd lmZdd lmZGd d d eZGdddeZGdddeZGdddeZ GdddeZ!GdddeZ"GdddeZ#GdddeZ$Gdddej%Z&GdddeZ'Gd d!d!eZ(Gd"d#d#eZ)dS)$zMiscellaneous directives.reStructuredTextN)ionodes statemachineutils) SafeString ErrorString)locale_encoding) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines) set_classes)miscc @sleZdZdZdZdZdZejej ej ej e e e ej ej ej ejej d ZejejejdZddZd 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. rT) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec CsF|jjjjs|d|j|jj|j |jj d}t j t j |}t |jd}|drD|drDt j |j|dd}t j t j ||}td|}t|}|jd|jjjj}|jjjj}|jd |jjjj}z|jjjj |t!j"|||d }Wn/t#y}z |$d |jt%|fd}~wt&y}z |$d |jt'|fd}~ww|jd d} |jdd} z| s| dur|(} d| | | } n|)} Wnt*y}z |$d|jt'|fd}~ww|jdd} | r | +| }|dkr|$d|j| |t,| d} |jdd}|rB| +|}|dkr<|$d|j| d|} t-j.| |dd}t/|D]\}}t,||jjjj0krh|d||dfqNd|jvr|dkr{| 1|}n| }tj2| ||jdgd}d|_3|4|d|jvrz t5|jdpd} Wn t6y|7dw| t,|} |dr|dd}t8g|fg| | }|D]\}}|r|tj9|||d7}q|t:|7}q|gS|t:|7}|gSd|jvr(||jd <|dkr | ;}t<|j|j=dg|j||j |j>|j?|j|j }|@S| | || f}|jjjA}|sA|Btd|d!f||f|vrb|d"|jd#|gd$d%|dddDfd&|jvr|jd&}tC||jjj}|||fg|_A|Dd|||jES|dd'|g7}|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_handlerzVProblems with "%s" directive path: Cannot encode input file path "%s" (wrong locale?).&Problems with "%s" directive path: %s.rrProblem with "%s" directive: %srzDProblem 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 )r.rr-)NNNNz(circular inclusion in "%s" directive: %sz < cSsg|]\}}|qSr0).0pthoptr0r0b/home/ubuntu/cloudmapper/venv/lib/python3.10/site-packages/docutils/parsers/rst/directives/misc.py szInclude.run..rz.. end of inclusion from "%s")Gstatedocumentsettingsfile_insertion_enabledwarningr state_machine input_linesr-lineno 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)selfr- source_dirr@r e_handlerrO include_filerd startlineendlinelinesrawtext after_text after_index before_text before_index include_linesir`textr_tokensr.value codeblock clip_optionsrlrr7r0r0r4rk6s                                        z Include.runN)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flag unchangedr parser_namerbunchanged_required class_option option_specr?r@rFrAr__file__rGrkr0r0r0r4rs,  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)fileurlrrc Cs|jjjjr|jjjjsd|jvsd|jvr|d|jdd|j d i}|j d|jjjj }|jjjj}|jrZd|jvsJd|jvrR|d|jd |j}nd|jvrd|jvrl|d |jtjtj|jjj}tjtj||jd}td|}ztj|||d }|jjjj|Wnty}z |d |jt|fd}~wwz| }Wnt!y}z |d |jt|fd}~ww||d<nd|jvrY|jd} t"j#dkrddl$m%} ddl&m'} nddl(m%} m'} z| |  } Wn | tt)fy*}z|d|j|jdt|fd}~wwtj*| | ||d}z| }Wnt!yS}z |d |jt|fd}~ww| |d<n|+t,j-d|fd|j dgi|} |j./|j0\| _1| _2| gS)Nrrr"format rrzF"%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.r&r)r+r-r)urlopen)URLError)rrz*Problems with "%s" directive URL "%s": %s.)r-r'rr(r*r.r)3r6r7r8 raw_enabledr9rKr:r rFrClowersplitrLrMrNcontentrdr?r@rArBcurrent_sourcerHrrIrrRrPrQrUrTrrWrXsys version_infourllib.requestr urllib.errorrurllib2OSError StringInputassert_has_contentrrawr;get_source_and_liner=r-r`)rr attributesrrtrrsr@raw_filerdr-rrraw_textraw_noder0r0r4rks                     zRaw.runN)rrrrrrrr r@urirrr has_contentrkr0r0r0r4rs  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.|jjjd|j|jdgS|rb||jS|S)NVInvalid context: the "%s" directive can only be used within a substitution definition.r/backrefsz=Error in "%s" directive: may contain a single paragraph only.r`) isinstancer6rSubstitutionDefrdr rrFrrElement nested_parseri paragraphsystem_messagermr;reporterr=rp)rrrelementnodemessageselemr0r0r4rk0s<     z Replace.runNrrrrrkr0r0r0r4r, 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|}Wntyi}z |d|t|fd}~ww|t |7}qI|jS)NrrrrrrzInvalid character code: %s %s)rr6rrrdr r;rrKrcomment_patternrrCrrr unicode_codercrrfrp)rrsubstitution_definitioncodesrrdecodedrdr0r0r4rk_s6        z Unicode.runN)rrrrrrrr rrrecompilerrkr0r0r0r4rLs  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 rrCrcrdr rrrr6rriextendrppendingrClassAttributerjr;r7 note_pendingrm)rr class_value node_list containerrrr0r0r4rks6    z Class.runN) rrrrrrrrrkr0r0r0r4rxs 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 j jd |j| ft|j|j|jd}||gWYd} ~ Sd} ~ wwd | vrz t|| d <Wn/ty} z#|j j jd|jt| 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".rrN#Unknown interpreted text role "%s".rrCz[Supplemental directive arguments for "%s" directive not supported (specified by "%r" role).)option_presetszError in "%s" directive: %s.rz(Invalid argument for "%s" directive: %s.)rir=rrdr argument_patternmatchgroupr roler;languager6rrr_rjgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorr rrcr CustomRoleregister_local_role)rrargsr new_role_namebase_role_namer base_rolerdconverted_rolerCrKrridetailrr0r0r4rks          zRole.runN) rrrrrrrInliner simplenamerrkr0r0r0r4rs   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)Nr*rrr) rCr _rolesrr;rr=r6rrdrr_rj)rr role_namerrrdr0r0r4rks"      zDefaultRole.runN)rrrrrrrkr0r0r0r4rs  rc@r)TitlerrTcCs|jd|jjd<gS)Nrtitle)rCr;r7)rrr0r0r4rksz Title.runN)rrrrrrrkr0r0r0r4rs  rc@seZdZddZddZdS)MetaBodycCs&||\}}|j|7_g|gfS)z Meta element.) parsemetaparent)rrrcontext next_stater blank_finishr0r0r4 field_markers 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_markerrunescape escape2nullr;get_first_known_indentedendrmetarFr`rinfor_rextract_name_valuerNameValueErrorrd)rrrr indentedindent line_offsetrrr`msgrattnamevaltokenrr0r0r4rsL     zMetaBody.parsemetaN)rrrrrr0r0r0r4rs rc@s"eZdZdZdefiZddZdS)MetaT state_classescCs|t}|jj|j|j|dd|jd\}}||jt|jkr8|j j j dt |j |j |jd}||7}|jjtjtjfpDd}|j|jj||<gS)NrT) initial_staterstate_machine_kwargszInvalid meta directive.rr)rrrr6nested_list_parserriSMkwargsrZr;rrdr_rjr=r7first_child_not_matching_classTitularrrp)rrrnew_line_offsetrrdindexr0r0r4rk/s*   zMeta.runN)rrrrrrrkr0r0r0r4r )s  r c@r)DateTcCst|jtjs|d|jd|jpd}tj dkr4z | t p"d}Wnt y3| dt wt|}tj dkr`z |t pDd}Wnty_|t pSdd}| d|t fwt|gS) Nrr/z%Y-%m-%drzutf-8z;Cannot encode date format string with locale encoding "%s".replacez-Error decoding "%s"with locale encoding "%s".)rr6rrrdr rFrrrencoder rSr:timestrftimedecodeUnicodeDecodeErrorrrf)rr format_strrr0r0r4rkHs4      zDate.runNrr0r0r0r4rDrrc@s.eZdZdZdZdZdejiZdZ ddZ dS) TestDirectivez3This directive is useful only for testing purposes.rToptioncCsp|jr#d|j}|jjjd|j|j|jft |||j d}|gS|jjjd|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) rrFr;rrr rCrKrr_r=)rrrrr0r0r4rkys   zTestDirective.runN) rrrrrrr rrrrkr0r0r0r4rps  r)*r __docformat__ros.pathr?rrdocutilsrrrrdocutils.utils.error_reportingrrr docutils.parsers.rstr r r r r$docutils.parsers.rst.directives.bodyrrdocutils.parsers.rst.rolesrdocutils.transformsrrrrrrrrrSpecializedBodyrr rrr0r0r0r4s6   7` ,&= ),