o in@sdZddlmZdZddlZddlZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZdd lmZmZdd lmZmZmZdd lmZmZdd lmZd Zer\ddlmZd-d.ddZ GdddeZ!GdddeZ"GdddeZ#GdddeZ$GdddeZ%Gdd d eZ&Gd!d"d"eZ'Gd#d$d$eZ(Gd%d&d&ej)Z*Gd'd(d(eZ+Gd)d*d*eZ,Gd+d,d,eZ-dS)/zMiscellaneous directives.) annotationsreStructuredTextN)Path)urlopen)URLError)frontendionodes statemachineutils) Directiveconvert_directive_function) directivesrolesstates) CodeBlock NumberLines)miscF)StrPathpathstrreturncCs>|r|drt|}|dd}nt|j}td||S)N/) startswithrparentr relative_path)rsource root_prefixbaser!j/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/docutils/parsers/rst/directives/misc.py adapt_paths  r#c @seZdZdZdZdZdZejej ej ej e e e ej ej ede ejej d ZeejjdZdd d ZdddZdddZdddZd ddZd!ddZdS)"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-linesclassnameincluderlistcCs |jjj|_}|js|d|j|jd|j|_|jdd|jdd|jdd|jddf|_ t |j d }| d rU|d rUd |d d}|j}n|j}t||jjj|}||jd<||}d|jvru||Sd|jvr||Sd|jvr||S||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-rr.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 inputstringr!r!r"runKs8             z Include.runrrrc Cs|jd|jj}|jj}z tj|||d}Wn/ty+|d|j d|dt yF}z|d|j dt |dd}~ww|jj |z|}Wntyo}z|d |j d t |d}~ww|j\}}} } |s}|dur|} d | ||}| r|| } | d kr|d |j d|| t| d}| r|| } | d kr|d|j d|d| }|S)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 FileInputUnicodeEncodeErrorseverer1OSError error_stringrecord_dependenciesaddread UnicodeErrorr@ splitlinesjoinfindlen)rJrr(rO include_fileerrortext startlineendline starttextendtextlines after_index before_indexr!r!r"rEosZ         zInclude.read_filerglist[nodes.literal_block]c Cs|jd}|jdkr||j}tjd||jdgd}||_|jddd|_||d|jvro|jdp:d}| d }|t | }t g|fg||}|D]\}}|rd|tj d||d 7}qS|t|7}qS|gS|t|7}|gS) zOReturn list with literal_block containing `text`. Provisional rrrr0)rclassesr+rr/rU)rp)r=r? expandtabsr literal_blockr>rlineadd_name removesuffixrdrarinlineText) rJrgrrr firstlinelastlinetokensrpvaluer!r!r"rFs*       zInclude.as_literal_blockc CsV|jdkr ||j}t|j|jdg|j|dg|j|j|j |j |j }| S)zNPass `text` to the `CodeBlock` directive class. Provisional. rr'rU) r?rqrr1r=poprulinenocontent_offset block_textr8 state_machinerL)rJrg codeblockr!r!r"rGs     zInclude.as_code_blockcCs|jd}t|}|jjD] \}}t|||q|jd|_t |j|}|j j j |_ |j j j |_ |j j j|_|j j j|_||||j j j|j|j|f|j|j j j|j|jS)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_documentr8r9 include_logidsnameids nametypesparseparse_messagesextend transformerpopulate_from_componentsapply_transformstransform_messageschildren)rJrgr)r:kvr9r!r!r"rHs$         zInclude.custom_parseNonec Cs|jd}tj||jdd}t|D]#\}}t||jjkr5|d|jdd}| d|d|d q|j j j }|sMt d |j j j}||d f||jf|vrrd d t|D} d|g| R} | d|jd| |||jf|dd|dg7}|j||d S)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)NNrrcss|]\}}|VqdSr%r!).0pthoptr!r!r" sz2Include.insert_into_input_lines..z > zcircular inclusion in "rTrz.. end of inclusion from ")r=r string2linesr? enumeraterdr:line_length_limitr>r<r8r9rr rrDappendr@reversedrbr1r insert_input) rJrgr textlinesirsline_norrD source_chaininclusion_chainr!r!r"rIs0    zInclude.insert_into_input_linesN)rr3)rrrr)rgrrro)rgrrr3)rgrrr)__name__ __module__ __qualname____doc__required_argumentsoptional_argumentsfinal_argument_whitespacerflag unchangedr( parser_nameintunchanged_requiredvalue_or class_option option_specrr__file__rrCrLrErFrGrHrIr!r!r!r"r$*s2    $ 0  r$c@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(r0c 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)Nrrr4format rr(zF"%s" directive may not both specify an external file and have content.rUzXThe "file" and "url" options may not be simultaneously specified for the "%s" directive.rMrPrQrRrSrTrz" directive URL "z": )rrNr(rOrrpr0)(r8r9r: raw_enabledr;r=r<r1rbrAlowersplitr>rVrWcontentrfr#rDrrrXr[rZr\r]r^r_r`rr StringInputassert_has_contentr rawrget_source_and_liner}rrs) rJr: attributesr(rOrgrraw_filerfrraw_textraw_noder!r!r"rL"s               zRaw.runN)rrrrrrrrrurir(rr has_contentrLr!r!r!r"rs  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.rUbackrefsz Error in "z1" directive: may contain a single paragraph only.rs) isinstancer8rSubstitutionDefrfr1rrbrr Element nested_parser~ paragraphsystem_messagerreporterr}r)rJrgelementnodemessageselemr!r!r"rLis8      z Replace.runNrrrrrLr!r!r!r"re 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)rr8rrrfr1rrr=rcomment_patternrrAr rr unicode_code ValueErrorrr\rwr)rJsubstitution_definitioncodesrr'decodedrfr!r!r"rLs6        z Unicode.runN)rrrrrrrrrrrecompilerrLr!r!r!r"rs  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".rp)r0 directive)rrrArrfr1rr rr8rr~rrpendingrClassAttributerrr9 note_pendingr)rJ class_value node_list containerrrr!r!r"rLs6    z Class.runN) rrrrrrrrrLr!r!r!r"rs 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".rrAz[Supplemental directive arguments for "%s" directive not supported (specified by "%r" role).)option_presetszError in "%s" directive: %s.r0z(Invalid argument for "%s" directive: %s.)r~r}rrfr1argument_patternmatchgrouprrolerlanguager8rr rrrgeneric_custom_rolehasattrr parse_directive_blockr MarkupErrorrrr CustomRoleregister_local_role)rJargsr new_role_namebase_role_namer base_rolerfconverted_rolerAr=rr~detailrr!r!r"rLs         zRole.runN) rrrrrrrInliner simplenamerrLr!r!r!r"rs   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) rAr_rolesrrrr}r8rrfr rrr)rJ role_namerrrfr!r!r"rLs"      zDefaultRole.runN)rrrrrrrLr!r!r!r"r s  r c@r )TitlerrTcCs|jd|jjd<gS)Nrtitle)rArr9)rJr!r!r"rL6sz Title.runN)rrrrrrrLr!r!r!r"r 0s  r c@seZdZddZddZdS)MetaBodycCs&||\}}|j|7_g|gfS)z Meta element.) parsemetar)rJrcontext next_stater blank_finishr!r!r" 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".rr1rz*Error parsing meta tag attribute "%s": %s.)parse_field_markerr unescaper escape2nullrget_first_known_indentedendmetarbrsrinforrrextract_name_valuerNameValueErrorrf)rJrr1indentedindent line_offsetrrrsmsgrzattnamevaltokenrr!r!r"rCsL     zMetaBody.parsemetaN)rrrrrr!r!r!r"r;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)rr rr8nested_list_parserr~SMkwargsrdrrfrrrr}r9first_child_not_matching_classTitularrr)rJrnew_line_offsetrrfindexr!r!r"rLjs*   zMeta.runN)rrrrrr*rLr!r!r!r"r%ds  r%c@r)DateTcCsDt|jtjs|d|jd|jpd}t |}t |gS)NrrUz%Y-%m-%d) rr8rrrfr1rbrtimestrftimer rw)rJ format_strrgr!r!r"rLs  zDate.runNrr!r!r!r"r/rr/c@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)NrUzBDirective processed. Type="%s", arguments=%r, options=%r, content:rzGDirective processed. Type="%s", arguments=%r, options=%r, content: None) rrbrrr1rAr=r rrr})rJrgrr!r!r"rLs   zTestDirective.runN) rrrrrrrrrrrLr!r!r!r"r3s  r3)rr)rrrr).r __future__r __docformat__rr0pathlibrurllib.requestr urllib.errorrdocutilsrrr r r docutils.parsers.rstr r rrr$docutils.parsers.rst.directives.bodyrrdocutils.transformsr TYPE_CHECKINGdocutils.nodesrr#r$rrrrrr r SpecializedBodyrr%r/r3r!r!r!r"s<       eW!,&> )