`΄XdZdZddlZddlZddlZddlZddlZddlZddlm Z  ej5ejdejdxsejdZejZddd ej&eGd d eZGd d eZd ZdZGdde ZGdde ZGddZGddeZGddeZGddeZ GddeZ!GddeZ"Gdd eZ#Gd!d"eZ$Gd#d$eZ%y#1swYxYw#e$rZdej$vrdZndZYdZ[dZ[wdZYxYw#eef$rdZYwxYw)%z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. reStructuredTextN) TransformSpecignorezunknown locale: UTF-8utf-8c eZdZy) InputErrorN__name__ __module__ __qualname__0/usr/lib/python3.12/site-packages/docutils/io.pyr r 3rr c eZdZy) OutputErrorNr rrrrr4rrrc tj|jtj|k(S#ttt f$rYywxYw)aNTest, whether the encoding of `stream` matches `encoding`. Returns :None: if `encoding` or `stream.encoding` are not a valid encoding argument (e.g. ``None``) or `stream.encoding is missing. :True: if the encoding argument resolves to the same value as `encoding`, :False: if the encodings differ. N)codecslookupencoding LookupErrorAttributeError TypeError)streamrs rcheck_encodingr7sA}}V__-x1HHH  3s47A Ac8|jjd|S)z5Return string representation of Exception `err`. z: ) __class__r )errs r error_stringr Gs mm$$ %Ru --rceZdZdZdZdZ ddZdZdZdZ e jdZ e jd fe jd fe j d ffZ d Zd Zy)Inputah Abstract base class for input wrappers. Docutils input objects must provide a `read()` method that returns the source, typically as `str` instance. Inheriting `TransformSpec` allows input objects to add "transforms" and "unknown_reference_resolvers" to the "Transformer". (Optional for custom input objects since Docutils 0.19.) inputNcx||_ ||_ ||_ ||_ |s|j|_d|_yN)r error_handlersource source_pathdefault_source_pathsuccessful_encoding)selfr'r(rr&s r__init__zInput.__init__]sH  1** '&-#77D #' ErcR|jd|jd|jS)Nz : source=z, source_path=)rr'r(r+s r__repr__zInput.__repr__qs$26..$++262B2BD Drct)z,Return input as `str`. Define in subclasses.NotImplementedErrorr.s rreadz Input.readu!!rc|jr4|jjdk(rt|tsJdt|tr|S|jr|jg}nO|j |}|r|g}n8dg}t rt dk7r|j t |j d|D]4} t|||j}||_|jddcStdd jd |Dd td #ttf$r }|}Yd}~~d}~wwxYw) a Decode `data` if required. Return Unicode `str` instances unchanged (nothing to decode). If `self.encoding` is None, determine encoding from data or try UTF-8, locale encoding, and (as last ressort) 'latin-1'. The client application should call ``locale.setlocale`` at the beginning of processing:: locale.setlocale(locale.LC_ALL, '') Raise UnicodeError if unsuccessful. Provisional: - Raise UnicodeError (instead of falling back to the locale encoding) if decoding the source with the default encoding (UTF-8) fails and Python is started in `UTF-8 mode`. Raise UnicodeError (instead of falling back to "latin1") if both, default and locale encoding, fail. - Only remove BOM (U+FEFF ZWNBSP at start of data), no other ZWNBSPs. unicodez;input encoding is "unicode" but `data` is no `str` instancerzlatin-1uNz=Unable to decode input data. Tried the following encodings: z, c32K|]}t|ywr%)repr).0encs r zInput.decode..sB.Asc.As. ())rlower isinstancestrdetermine_encoding_from_data_locale_encodingappendr&r*replace UnicodeErrorrjoinr )r+dataencoding_candidates data_encodingr;decodedrerrors rdecodez Input.decodeysM4 ==T]]002i?dC( N,M N( dC K ==$(==/  ==dCM(5o# (/i#$(8G(C'../?@#**95&C dC););<+.(x44' KyyB.ABBCDU#$A '( (!+.  s/D&&E5D<<Escoding[:=]\s*([-\w.]+)rz utf-16-bez utf-16-lec|jD]\}}|j|s|cS|jddD]A}|jj |}|s!|j dj dcSy)z Try to determine the encoding of `data` by looking *in* `data`. Check for a byte order mark (BOM) or an encoding declaration. Nrascii)byte_order_marks startswith splitlines coding_slugsearchgrouprM)r+rH start_bytesrlinematchs rrBz"Input.determine_encoding_from_datas{ &*%:%: !K{+&;OO%bq)D$$++D1E{{1~,,W55*rcV |jjS#t$rYywxYw)z>Return True, if the input source is connected to a TTY device.F)r'isattyrr.s rr[z Input.isattys, ;;%%' '    ((NNNstrict)r r r __doc__component_typer)r,r/r3rMrecompilerTrBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErQrBr[rrrr"r"Ms N?C'F(D"D(L"**78K''2,,k:,,k:=- rr"c6eZdZdZdZdZ ddZdZdZdZ y) Outputak Abstract base class for output wrappers. Docutils output objects must provide a `write()` method that expects and handles one argument (the output). Inheriting `TransformSpec` allows output objects to add "transforms" and "unknown_reference_resolvers" to the "Transformer". (Optional for custom output objects since Docutils 0.19.) outputNct||_ |xsd|_ ||_ ||_ |s|j|_yy)Nr^)rr& destinationdestination_pathdefault_destination_path)r+rjrkrr&s rr,zOutput.__init__sH  7*6h*&. 02$($A$AD ! rcR|jd|jd|jS)Nz: destination=z, destination_path=)rrjrkr.s rr/zOutput.__repr__s%>>4#3#3T5J5JL Mrct)z#Write `data`. Define in subclasses.r1r+rHs rwritez Output.writer4rc|jr6|jjdk(rt|tsJd|St|ts|S|j |j|j S)a? Encode and return `data`. If `data` is a `bytes` instance, it is returned unchanged. Otherwise it is encoded with `self.encoding`. Provisional: If `self.encoding` is set to the pseudo encoding name "unicode", `data` must be a `str` instance and is returned unchanged. r6z.6B"M"Brrgc0eZdZdZ ddZdZdZdZy) ErrorOutputz Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. Nc|tj}n!|sd}nt|tr t |d}||_ |xst |ddxs txsd|_ ||_ ||_ y)a :Parameters: - `destination`: a file-like object, a string (path to a file), `None` (write to `sys.stderr`, default), or evaluating to `False` (write() requests are ignored). - `encoding`: `destination` text encoding. Guessed if None. - `encoding_errors`: how to treat encoding errors. NFwrrP) sysstderrr@rAopenrjgetattrrCrencoding_errorsdecoding_errors)r+rjrr{r|s rr,zErrorOutput.__init__&s  **KK  S ){C0K&+!8W[*d%K8,807 ,.%.%rc|jsyt|tr t|} |jj |y#t $rB|jj |j |j|jYyt$rt|trA|jj |j |j|jYy|jtjtjfvr'|jjj |Yy|jj t||j|jYywxYw)z Write `data` to self.destination. Ignore, if self.destination is False. `data` can be a `bytes`, `str`, or `Exception` instance. N)rjr@ ExceptionrArpUnicodeEncodeErrorrrrr{rrwrxstdoutbufferr|ros rrpzErrorOutput.writeGs$   dI &t9D B    " "4 (! F    " "4;;t}}/3/C/C$E F B$$  &&t{{4==373G3G(IJ!!cjj#**%==  ''--d3  &&s4+/+?+?(AB Bs&AAE9AE9)AE9<:E98E9c|jtjtjfvry |jj y#t $rYywxYw)z Close the error-output stream. Ignored if the destination is` sys.stderr` or `sys.stdout` or has no close() method. N)rjrwrrxcloserr.s rrzErrorOutput.closeasK    CJJ7 7      " " $   sA AAcV |jjS#t$rYywxYw)z=Return True, if the destination is connected to a TTY device.F)rjr[rr.s rr[zErrorOutput.isattyos. ##**, ,  r\)NNbackslashreplacerE)r r r r_r,rprr[rrrrtrts( 37!3!*&BB4 rrtc0eZdZdZ ddZdZdZdZy) FileInputz5 Input for single, simple file-like objects. NcVtj|||||||_t|_|F|r. t |||j xsd|j|_nhtj|_nRt|j|j dur0t!d|j d|jj d|s |jj"|_yy#t$r&}t|j|j|d}~wwxYw#t&$rYywxYw)a :Parameters: - `source`: either a file-like object (which is read directly), or `None` (which implies `sys.stdin` if no `source_path` given). - `source_path`: a path to a file, which is opened and then read. - `encoding`: the expected text encoding of the input file. - `error_handler`: the encoding error handler to use. - `autoclose`: close automatically after read (except when `sys.stdin` is the source). - `mode`: how the file is to be opened (see standard function `open`). The default is read only ('r'). Nz utf-8-sigrerrorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)r"r, autoclosert_stderrryrr&r'OSErrorr errnostrerrorrwstdinrrFnamer(r)r+r'r(rr&rmoderLs rr,zFileInput.__init__|s tV[(MJ""} >O"&{D04 0L.2.@.@#BDK "ii DKK 75 @ $ t{{/C/C EF F #';;#3#3 O$U[[%..+NNO"  s),C* D* D3!DD D('D(cj |jtjur%|jjj }n|jj }|jr|j |j|}dj|jdgzS#t t f$rS|jsC|jr7t|jd}|j }|jnYwxYw#|jr|jwwxYw)zU Read and decode a single file and return the data (Unicode string). rb r7)r'rwrrr3rFrrr(ryrrrMrGrS)r+rHb_sources rr3zFileInput.reads {{cii'{{))..0{{'')~~ {{4 yy*B4/00k* ==T%5%5 0 0$7}} !  ~~ s%AB..AD DDDD2c@|jjdS)zK Return lines of a single file as list of Unicode strings. T)r3rSr.s r readlineszFileInput.readlinessyy{%%d++rcr|jtjur|jjyyr%)r'rwrrr.s rrzFileInput.closes' ;;cii ' KK    (r)NNNr^Tr)r r r r_r,r3rrrrrrrws'15.6&)&P12,  rrc:eZdZdZdZdZ d dZdZdZdZ y) FileOutputz,Output for single, simple file-like objects.zrvNc$tj|||||d|_||_|t j dt d|||_t|_ | |rd|_nytj|_ nc|rat|jdrK||jjk7r2td|jjd |d |j |s |jj|_yy#t"$rYywxYw) aA :Parameters: - `destination`: either a file-like object (which is written directly) or `None` (which implies `sys.stdout` if no `destination_path` given). - `destination_path`: a path to a file, which is opened and then written. - `encoding`: the text encoding of the output file. - `error_handler`: the encoding error handler to use. - `autoclose`: close automatically after write (except when `sys.stdout` or `sys.stderr` is the destination). - `handle_io_errors`: ignored, deprecated, will be removed. - `mode`: how the file is to be opened (see standard function `open`). The default is 'w', providing universal newline support for text files. TNz_io.FileOutput: init argument "handle_io_errors" is ignored and will be removed in Docutils 2.0.rO) stacklevelFrzWarning: Destination mode "z" differs from specified mode "")file)rgr,openedrwarningswarnDeprecationWarningrrtrrwrrjhasattrprintrrkr)r+rjrkrr&rhandle_io_errorsrs rr,zFileOutput.__init__s& k+; - 1 "  ' MM*+=! M  DI"}  # #&:: wt//8$**/// !%!1!1!6!6>|| %  (,(8(8(=(=% "  s&D DDc,d|jvr|j|jd}ni} t|j|jfi||_d|_ y#t $r0}t|j|j|jd}~wwxYw)NbrT) rrr&ryrkrjrrrrr)r+kwargsrLs rryzFileOutput.opens dii "&-- $ 2 24FF 5#D$9$9499OOD   5ekk5>>"335 5 5s&A B#+BBc |js|jt|trft |j |j durDtjdk7r |jdtj}|j|} |j j||j*r|j-|S#t$r}t|tr |j jj|nn#t$rbt |j |j dur=t!d|j"d|j j d|j d|wxYwYd}~d}~wt$t&f$r*}t%d|j d t)|dd}~wwxYw#|j*r|j-wwxYw) aBWrite `data` to a single file, also return it. `data` can be a `str` or `bytes` instance. If writing `bytes` fails, an attempt is made to write to the low-level interface ``self.destination.buffer``. If `data` is a `str` instance and `self.encoding` and `self.destination.encoding` are set to different values, `data` is encoded to a `bytes` instance using `self.encoding`. Provisional: future versions may raise an error if `self.encoding` and `self.destination.encoding` are set to different values. Frz Encoding of z (z&) differs from specified encoding (r>Nz2Unable to encode output data. output-encoding is: r=)rryr@rArrjroslineseprErrrprbytesrr ValueErrorrkrFrr rr)r+rHrs rrpzFileOutput.writes{{ IIK tS !t//?5HzzT!||D"**5;;t$D     " "4 (&~~  ) "$& "$$++11$7%"%d&6&6&*mm58=>(*4+@+@*AB $ 0 0 9 9:;::>--KLL " "k* <D==/l3&7%8;< < < ~~ sOC F<F'%D  F A+E88F;F?F<%F77F<<F??Gc|jtjtjfvr"|jj d|_yy)NF)rjrwrrxrrr.s rrzFileOutput.close?s;   CJJ #; ;    " " $DK c8|j|jS)z`Return the source as `str` instance. Decode, if required (see `Input.decode`). )rMr'r.s rr3zStringInput.readSs {{4;;''rNr r r r_r)r3rrrrrNs1$(rrceZdZdZdZdZy) StringOutputz=Output to a `bytes` or `str` instance. Provisional. rcF|j||_|jS)avStore `data` in `self.destination`, and return it. If `self.encoding` is set to the pseudo encoding name "unicode", `data` must be a `str` instance and is stored/returned unchanged (cf. `Output.encode`). Otherwise, `data` can be a `bytes` or `str` instance and is stored/returned as a `bytes` instance (`str` data is encoded with `self.encode()`). Attention: the `output_encoding`_ setting may affect the content of the output (e.g. an encoding declaration in HTML or XML or the representation of characters as LaTeX macro vs. literal character). )rrrjros rrpzStringOutput.writecs! ;;t,rNr r r r_rlrprrrrr[s * rrceZdZdZdZdZy) NullInputzDegenerate input: read nothing.z null inputcy)zReturn an empty string.r7rr.s rr3zNullInput.read|srNrrrrrrvs)&rrceZdZdZdZdZy) NullOutputz!Degenerate output: write nothing.z null outputcy)zDo nothing, return None.Nrros rrpzNullOutput.writes rNrrrrrrs+, rrceZdZdZdZdZy) DocTreeInputzm Adapter for document tree input. The document tree must be passed in the ``source`` parameter. z doctree inputc|jS)zReturn the document tree.)r'r.s rr3zDocTreeInput.reads {{rNrrrrrrs *rr)&r_ __docformat__rlocalerrarwrdocutilsrcatch_warnings simplefilter getlocalegetdefaultlocalerCr?rrLargsrrrrr rrr r"rgrtrrrrrrrrrrrrs  # "  "h',F,,.q1<6v668; +113 #FMM"#   '   . QMQh;B];B|UUpN N bz z zz (% ( 6 6   5 ] # "  %**," YsAD>A D2D> E'2D;7D>>E$EE$' E32E3