-Ph7XdZdZddlZddlZddlZddlZddlZddlZddlm Z  ej 5ej dej dpej dZeZdddn #1swxYwYn #dZYnxYw ejen#eef$rdZYnwxYwGddeZGd d eZd Zd ZGd de ZGdde ZGddZGddeZGddeZGddeZGddeZGddeZGddeZ Gdd eZ!Gd!d"eZ"dS)#z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. reStructuredTextN) TransformSpecignoreceZdZdS) InputErrorN__name__ __module__ __qualname__K/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/docutils/io.pyrr+rrceZdZdS) OutputErrorNr r rrrr,rrrc tj|jtj|kS#ttt f$rYdSwxYw)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_encodingr/sQ}V_--x1H1HHH  3tts.1A  A c$|jjd|S)z5Return string representation of Exception `err`. z: ) __class__r )errs r error_stringr?sm$ - - - --rceZdZdZdZdZ ddZdZdZdZ e j d Z e jd fe jd fe jd fe jd fe jd ffZ d ZdZdS)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.) inputNstrictcp||_ ||_ ||_ ||_ |s |j|_d|_dSN)r error_handlersource source_pathdefault_source_pathsuccessful_encoding)selfr'r(rr&s r__init__zInput.__init__UsM  1** '&- 8#7D #' EErc4|jd|jd|jS)Nz : source=z, source_path=)rr'r(r+s r__repr__zInput.__repr__is(26...$+++262B2BD Drct)z,Return input as `str`. Define in subclasses.NotImplementedErrorr.s rreadz Input.readm!!rc|jr<|jdkrt|ts Jdt|tr|S|jr |jg}nb||}|r|g}nGdg}t jd}|r-|dkr|||D]C} t|||j}||_ |cS#ttf$r }|}Yd}~zInput.decode..s(BBscBBBBBBr. ())rlower isinstancestrdetermine_encoding_from_datalocalegetpreferredencodingappendr&r* UnicodeErrorrjoinr) r+dataencoding_candidates data_encodingfallbackr;decodedrerrors rdecodez Input.decodeqs" = NT]0022i??dC(( N N,M N N N dC  K = 9$(=/   ==dCCM 9'4o## (/i#!6EJJJ9 0 0G ; ;'..x888&  C dC);<<+.( +.     'yyBB.ABBBBB ' 'U## ' ' '(( (sC33DD  Dscoding[:=]\s*([-\w.]+)zutf-32z utf-8-sigzutf-16c|jD]\}}||r|cS|ddD]H}|j|}|r*|ddcSIdS)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_slugsearchgrouprN)r+rH start_bytesrlinematchs rrBz"Input.determine_encoding_from_datas &*%:  !K{++  OO%%bqb) 6 6D$++D11E 6{{1~~,,W55555 6trcX |jS#t$rYdSwxYw)z>Return True, if the input source is connected to a TTY device.F)r'isattyrr.s rr\z Input.isattys= ;%%'' '   55   ))NNNr#)r r r __doc__component_typer)r,r/r3rNrecompilerUr BOM_UTF32_BE BOM_UTF32_LEBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErRrBr\r rrr!r!Es  N?C'FFFF(DDD"""4(4(4(l"*788K',h7,h7+6,h7,h7  - rr!c8eZdZdZdZdZ d dZdZdZdZ dS) 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.) outputNr#cj||_ |pd|_ ||_ ||_ |s|j|_dSdS)Nr#)rr& destinationdestination_pathdefault_destination_path)r+rlrmrr&s rr,zOutput.__init__sX  7*6h*&. 02 B$($AD ! ! ! B Brc4|jd|jd|jS)Nz: destination=z, destination_path=)rrlrmr.s rr/zOutput.__repr__s*>>>4#3#3#3T5J5JL Mrct)z#Write `data`. Define in subclasses.r1r+rHs rwritez Output.writer4rc|jr>|jdkr!t|ts Jd|St|ts|S||j|jS)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.6BBBB"MMM"""BBBBBrric2eZdZdZ d dZdZdZdZdS) ErrorOutputz Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. Nbackslashreplacereplacec| tj}n*|sd}n%t|trt |d}||_ |pt |ddptpd|_ ||_ ||_ dS)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. NFwrrQ) sysstderrr@rAopenrlgetattr_locale_encodingrencoding_errorsdecoding_errors)r+rlrrrs rr,zErrorOutput.__init__s  *KK 1KK  S ) ) 1{C00K&+!8W[*d%K%K8,807 ,.%.%%rc|jsdSt|trt|} |j|dS#t $r<|j||j|jYdSt$rt|tr;|j||j|jYdS|jtj tj fvr"|jj |YdS|jt||j|jYdSwxYw)z Write `data` to self.destination. Ignore, if self.destination is False. `data` can be a `bytes`, `str`, or `Exception` instance. N)rlr@ ExceptionrArrUnicodeEncodeErrorrtrrrr{r|stdoutbufferrrqs rrrzErrorOutput.write2s   F dI & & t99D B   " "4 ( ( ( ( (! F F F   " "4;;t}/3/C$E$E F F F F F F B B B$$$ B &&t{{4=373G(I(IJJJJJJ!cj#*%=== '--d333333 &&s4+/+?(A(ABBBBBB Bs%A AE!AE!)>E!*3E! E!c|jtjtjfvrdS |jdS#t $rYdSwxYw)z Close the error-output stream. Ignored if the destination is` sys.stderr` or `sys.stdout` or has no close() method. N)rlr{rr|closerr.s rrzErrorOutput.closeLsb   CJ7 7 7 F    " " $ $ $ $ $    DD s> A  A cX |jS#t$rYdSwxYw)z=Return True, if the destination is connected to a TTY device.F)rlr\rr.s rr\zErrorOutput.isattyZs> #**,, ,   55 r])NNrwrx)r r r r_r,rrrr\r rrrvrv sn 37!3!*&&&&BBBB4   rrvc2eZdZdZ d dZdZdZd ZdS) FileInputz5 Input for single, simple file-like objects. Nr#Trct|||||||_t|_|e|rQ t |||j|j|_n#t$r }t|j |j |d}~wwxYwtj|_nAt|j|jdur%t!d|jd|jjd|s% |jj|_dS#t&$rYdSwxYwdS)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 for reading. - `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'). NrerrorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)r!r, autocloserv_stderrr}rr&r'OSErrorrerrnostrerrorr{stdinrrFnamer(r)r+r'r(rr&rmoderMs rr,zFileInput.__init__gsO tV[(MJJJ""}} > (O"&{D04 .2.@#B#B#BDKKOOO$U[%.+NNNO"i DK 7 75 @ @, $ t{/C/C/C EFF F  #';#3   !      s)"A!! B +BB $C77 DDc |jstt|jdr_|jj}||}d|dgz}n|j}|jr| n!#|jr| wwxYw|S)zA Read and decode a single file, return as `str`. r ) rhasattrr'rr3rNrGrTrrrqs rr3zFileInput.reads = *WT[(%C%C *{)..00{{4((yy!2!2B4!788{''))~  ~    s BB22CcP|dS)zC Return lines of a single file as list of strings. T)r3rTr.s r readlineszFileInput.readliness yy{{%%d+++rcb|jtjur|jdSdSr%)r'r{rrr.s rrzFileInput.closes3 ;ci ' ' K        ( 'r)NNNr#Tr)r r r r_r,r3rrr rrrrbsk15.6&)&&&&P&,,,      rrc<eZdZdZdZdZ d dZdZd Zd Z dS) FileOutputz,Output for single, simple file-like objects.zrzNr#Tct|||||d|_||_|t jdt d|||_t|_ ||rd|_n`tj |_ nN|rLt|j dr7||j jkr'td|j jd |d |j |s% |j j|_dS#t"$rYdSwxYwdS) 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.rP) stacklevelFrzWarning: Destination mode "z" differs from specified mode "")file)rir,openedrwarningswarnDeprecationWarningrrvrr{rrlrprintrrmr)r+rlrmrr&rhandle_io_errorsrs rr,zFileOutput.__init__sT& k+; - 1 1 1 "  ' M*+=! M M M M  DI"}}   .# #&:   %t/88 %$*/// E!%!1!6!6!6>| % % % %   (,(8(=%%%!      sC)) C76C7cd|jvr|j|jd}ni} t|j|jfi||_n2#t $r%}t|j|j |jd}~wwxYwd|_ dS)NbrT) rrr&r}rmrlrrrrr)r+kwargsrMs rr}zFileOutput.opens di  "&- $ 244FFF 5#D$949OOOOD   5 5 5ek5>"355 5 5 s; A* A%%A*c |js|t|trat |j|jdurEtjdkr | dtj}| |} |j |n#t$r}t|trz |jj |nY#t$rLt |j|jdur-t!d|jd|jjd|jd|wxYwYd}~nDd}~wt$t&f$r-}t%d|jd t)|dd}~wwxYw|jr|n!#|jr|wwxYw|S) 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=)rr}r@rArrlroslineseprxrtrrrbytesrr ValueErrorrmrFrrrr)r+rHrs rrrzFileOutput.writes/{  IIKKK tS ! ! %t/??5HHzT!!||D"*55;;t$$D    " "4 ( ( ( ( " " "$&& " "$+11$7777%"""%d&6&*m558=>>(K4+@KK $ 0 9KK:>-KKKLLL " "k* < < <;=;;&23&7&7;;;<< < < ~  ~    sUB.-F,. F 8E C.-E .AEE F, F  (FF  F,,G c|jtjtjfvr"|jd|_dSdS)NF)rlr{rr|rrr.s rrzFileOutput.close$sA  CJ #; ; ;   " " $ $ $DKKK < ;r)NNNr#TNN) r r r r_rnrr,r}rrrr rrrrsv66' D) ;?BF-1----^   ,,,\     rrceZdZdZdZdS)BinaryFileOutputzL A version of docutils.io.FileOutput which writes to a binary file. wbN)r r r r_rr rrrr*s DDDrrceZdZdZdZdZdS) StringInputz'Input from a `str` or `bytes` instance.c6||jS)z`Return the source as `str` instance. Decode, if required (see `Input.decode`). )rNr'r.s rr3zStringInput.read8s {{4;'''rNr r r r_r)r3r rrrr3s/11$(((((rrceZdZdZdZdZdS) StringOutputz=Output to a `bytes` or `str` instance. Provisional. rcD|||_|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). )rtrlrqs rrrzStringOutput.writeHs! ;;t,,rNr r r r_rnrrr rrrr@s5 *     rrceZdZdZdZdZdS) NullInputzDegenerate input: read nothing.z null inputcdS)zReturn an empty string.rr r.s rr3zNullInput.readasrrNrr rrrr[s/))&rrceZdZdZdZdZdS) NullOutputz!Degenerate output: write nothing.z null outputcdS)zDo nothing, return None.Nr rqs rrrzNullOutput.writels rNrr rrrrfs/++,     rrceZdZdZdZdZdS) 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.read{s {rNrr rrrrqs5 *rr)#r_ __docformat__rrCrrar{rdocutilsrcatch_warnings simplefilter getlocalegetdefaultlocalerr?rrrrrrrrr!rirvrrrrrrrrr rrrs  # """"""  " "44h''',F,..q1<6v688; +1133 444444444444444 FM"####Y  '     ... DDDDDMDDDN;B;B;B;B;B];B;B;B|UUUUUUUUpH H H H H H H H Vz z z z z z z z zz ( ( ( ( (% ( ( (     6   6             5     sABAB BBBBBB $B55 CC