U ZShf@sZdZdZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZdd lmZmZmZdd lmZmZdd lmZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZ GdddeZ!Gdddej"Z#GdddeZ$Gd d!d!eZ%Gd"d#d#eZ&dS)$zMiscellaneous directives.reStructuredText)PathN)urlopen)URLError)ionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)miscc @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 rT) literalcodeencodingparser tab-width start-lineend-line start-after end-before number-linesclassnameincludec CsL|jjjjs|d|j|jjj}t|j d}| dr^| dr^|j }|dd}n t |j}td||}|jd|jjjj}|jjjj}|jd |jjjj}ztj|||d }Wnptk r|d |jd |d YnVtk r4}z$|d |jdt|dW5d}~XYnX|jjjj||jdd} |jdd} z8| sv| dk r|} d| | | } n| } WnBt!k r}z"|d|jdt|W5d}~XYnX|jdd} | r,| "| }|dkr|d|j| |t#| d} |jdd}|rp| "|}|dkrd|d|j| d|} t$j%| |dd}t&|D]6\}}t#||jjjj'kr|d||dfqd|jkr|dkr| (|}n| }t)j*| ||jdgd}d|_+|,|d|jkrzt-|jdp.d} Wn t.k rT|/d YnX| t#|} | d!rz|dd}t0g|fg| | }|D]4\}}|r|t)j1|||d"7}n|t)2|7}qn|t)2|7}|gSd#|jkr<||jd$<|dkr| 3}t4|j|j5d#g|j||j6|j7|j8|j|j9 }|:S| | || f}|jjj;}|sn|||jjj}|||fg|_;|jd*}|?d!|||j@A|f|j@B|jCS|dd+|g7}|j9D|||<||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<>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)Zconvert_whitespacez,"%s": line %d exceeds the line-length-limit.rr)sourceclassesrz+:number-lines: with non-integer start value )r/rr.)NNNNcss|]\}}|VqdS)N).0pthoptr1r1W/root/rtd-docs/venv/lib/python3.8/site-packages/docutils/parsers/rst/directives/misc.py szInclude.run..z > z(circular inclusion in "%s" directive: %srz.. end of inclusion from "%s")Estatedocumentsettingsfile_insertion_enabledwarningrcurrent_sourcer path arguments startswithendswithstandard_include_pathrparentr relative_pathoptionsgetinput_encodinginput_encoding_error_handler tab_widthr FileInputUnicodeEncodeErrorsevereOSError error_stringrecord_dependenciesadd readlinesjoinread UnicodeErrorfindlenrZ string2lines enumerateZline_length_limit expandtabsr literal_blocklineZadd_nameint ValueErrorerrorrinlineText splitlinesrpoplinenocontent_offset block_text state_machinerun include_logappendreversedZ new_documentparseZ transformerZpopulate_from_componentsZapply_transformschildrenZ insert_input) selfr<r=_baser e_handlerrHZ include_filer\ startlineendlinelinesZrawtextZ after_textZ after_indexZ before_textZ before_indexZ include_linesirYtextrXtokensr/valueZ codeblockZ clip_optionsrfZ master_pathsZinclusion_chainr8rr1r1r5re7s       2                             z Include.runN)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacer flagZ unchangedr parser_namerZunchanged_required class_option option_specrr__file__rBrArer1r1r1r5rs& 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,|jjjjslowersplitrErFrGcontentr\rr<rBr rCrrIrLrKrMrNrOrRrSrrZ StringInputassert_has_contentrrawrdZget_source_and_linerar.rY) rk attributesrrmrrr=rlZraw_filer\r.Zraw_textZraw_noder1r1r5res        2    >   zRaw.runN)rurvrwrxryrzr{r r=urirrr has_contentrer1r1r1r5rs rc@seZdZdZddZdS)ReplaceTcCst|jtjs|d|j|d|j}t |}|j |j|j |d}g}|D]\}|svt|t j rv|}q\t|t jrg|d<||q\|jjd|jd|jdgSq\|r||jS|S)NVInvalid context: the "%s" directive can only be used within a substitution definition.r0Zbackrefsz Error in "z1" directive: may contain a single paragraph only.rY) isinstancer7rSubstitutionDefr\rrrQrrElement nested_parserbZ paragraphZsystem_messagergreporterrarj)rkrrelementnodemessageselemr1r1r5re-s8       z Replace.runNrurvrwrrer1r1r1r5r)src@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|jkrDd|j d<d|j d<d|jkrXd|j d<d|jkrld|j d<|j |j dd }t }|D]\}zt|}Wn:tk r}z|d|t|fW5d}~XYnX|t |7}q|jS)NrrrrrrzInvalid character code: %s %s)rr7rrr\rrdrrDrcomment_patternrr>rrr Z unicode_coder[rrMr^rj)rkZsubstitution_definitioncodesrrdecodedr\r1r1r5re]s2        z Unicode.runN)rurvrwrxryrzr{r r|rrecompilerrer1r1r1r5rJs 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 Cszt|jd}Wn.tk rB|d|j|jdfYnXg}|jrt}|j |j|j ||D]}|d |qn| |j n2ttj||jd|j}|jj||||S)Nrz7Invalid class attribute value for "%s" directive: "%s".r/)r directive)r rr>r[r\rrrrr7rrbextendrjpendingrZClassAttributercrdr8Z note_pendingrg)rkZ class_valueZ node_list containerrrr1r1r5res2   z Class.runN) rurvrwrxryrzr{rrer1r1r1r5rvs rc@s0eZdZdZedejjfdZ ddZ dS)RoleTz(%s)\s*(\(\s*(%s)\s*\)\s*)?$c Cs|j|jks|js"|d|j|jd}|j|}|sP|d|j|f|d}|d}g}|rt ||j j |j|j j \}}|dkr|j j jd|t|j|j|jd}||gSntj}t|d rtd |j|fz4t|}|j j|jdd|j|id \} } } } Wn^tjk rx} z<|j jd |j| ft|j|j|jd}||gWYSd} ~ XYnXd | krzt|| d <Wn\tk r} z<|j jd|j| ft|j|j|jd}||gWYSd} ~ XYnXt||| | }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".rr>z[Supplemental directive arguments for "%s" directive not supported (specified by "%r" role).)Zoption_presetszError in "%s" directive: %s.rz(Invalid argument for "%s" directive: %s.)rbrarr\rargument_patternmatchgroupr rolerdlanguager7rrrXrcZgeneric_custom_rolehasattrAssertionErrorr Zparse_directive_blockr MarkupErrorr rr[Z CustomRoleZregister_local_role)rkargsrZ new_role_nameZbase_role_namerZ base_roler\Zconverted_roler>rDrrbdetailrr1r1r5res            zRole.runN) rurvrwrrrrZInlinerZ simplenamerrer1r1r1r5rs  rc@s eZdZdZdZdZddZdS) DefaultRolez&Set the default interpreted text role.rFcCs|jsdtjkrtjd=gS|jd}t||jj|j|jj\}}|dkr||jjj d|t |j |j |jd}||gS|tjd<|S)Nr+rrr) r>r Z_rolesrrdrrar7rr\rrXrc)rkZ role_namerrr\r1r1r5res$     zDefaultRole.runN)rurvrwrxrzr{rer1r1r1r5rsrc@s eZdZdZdZdZddZdS)TitlerrTcCs|jd|jjd<gS)Nrtitle)r>rdr8)rkr1r1r5resz Title.runN)rurvrwryrzr{rer1r1r1r5rsrc@seZdZddZddZdS)MetaBodycCs&||\}}|j|7_g|gfS)z Meta element.) parsemetarB)rkrcontextZ next_stater blank_finishr1r1r5 field_markerszMetaBody.field_markerc Csn||}tt|}|j|\}}}}t}ttd ||d<|s|jj }|j d|t ||} | |fS|} z&t| dd\} } | || <Wn"tjk r| d|d<YnX| ddD]} z"t| d\} } | || <Wqtjk rb}z:|jj }|j d| |ft ||} | |fWYSd}~XYqXq||fS)NrrzNo content for meta tag "%s".rrrz*Error parsing meta tag attribute "%s": %s.)Zparse_field_markerrunescaper Z escape2nullrdZget_first_known_indentedendmetarQrYrinforXrZextract_name_valuerZNameValueErrorr\)rkrrZindentedindent line_offsetrrrYmsgrsZattnamevaltokenrr1r1r5rsF     $zMetaBody.parsemetaN)rurvrwrrr1r1r1r5rsrc@s"eZdZdZdefiZddZdS)MetaTZ state_classescCs|t}|jj|j|j|dd|jd\}}||jt|jkrn|j j dt |j |j |j d}||7}|jjtjtjfpd}|j|jj||<gS)NrT)Z initial_staterZstate_machine_kwargszInvalid meta directive.rr)rrrr7Znested_list_parserrbSMkwargsrUrr\rXrcrar8Zfirst_child_not_matching_classZTitularrrj)rkrZnew_line_offsetrr\indexr1r1r5re.s0  zMeta.runN)rurvrwrrrrer1r1r1r5r(s rc@seZdZdZddZdS)DateTcCsDt|jtjs|d|jd|jp,d}t |}t |gS)Nrr0z%Y-%m-%d) rr7rrr\rrQrtimestrftimerr^)rk format_strrrr1r1r5reGs zDate.runNrr1r1r1r5rCsrc@s.eZdZdZdZdZdejiZdZ ddZ dS) TestDirectivez3This directive is useful only for testing purposes.rToptioncCsh|jr@d|j}|jjd|j|j|jft|||j d}n"|jjd|j|j|jf|j d}|gS)Nr0zBDirective processed. Type="%s", arguments=%r, options=%r, content:rzGDirective processed. Type="%s", arguments=%r, options=%r, content: None) rrQrrrr>rDrrXra)rkrrrr1r1r5rejs   zTestDirective.runN) rurvrwrxrzr{r r~rrrer1r1r1r5ras  r)'rx __docformat__pathlibrrrurllib.requestr urllib.errorrZdocutilsrrrr Zdocutils.parsers.rstr r r r rZ$docutils.parsers.rst.directives.bodyrrZdocutils.transformsrrrrrrrrrZSpecializedBodyrrrrr1r1r1r5s0    <X!,&> )