KidUdZddlmZdZddlZddlZddlZddlZddlZddl Z ddl m Z dZ e rddl mZmZmZmZmZmZddl mZdd lmZ e j.5e j0d ej2d xsej4d j7Zd ed <ddd ej<eGdde!Z"Gdde!Z#d*dZ$d+dZ%Gdde Z&Gdde Z'GddZ(Gdde&Z)Gdde'Z*Gdde*Z+Gd d!e&Z,Gd"d#e'Z-Gd$d%e&Z.Gd&d'e'Z/Gd(d)e&Z0y#1swYxYw#dZYxYw#ee f$rdZYwxYw),z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. ) annotationsreStructuredTextN) TransformSpecF)AnyBinaryIOClassVarFinalLiteralTextIO)nodes)StrPathignore str | None_locale_encodingc eZdZy) InputErrorN__name__ __module__ __qualname__W/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/docutils/io.pyrr4rrc eZdZy) OutputErrorNrrrrrr5rrrc 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)streamr!s rcheck_encodingr&8sA}}V__-x1HHH  3s47A Ac8|jjd|S)z5Return string representation of Exception `err`. z: ) __class__r)errs r error_stringr*Hs mm$$ %Ru --rc<eZdZUdZdZded<dZded< d ddZdd Zdd Z dd Z e jd Z d ed< ejdfej dfej"dfej$dfej&dffZded< ddZddZy)Inputak 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" to the "Transformer". (Since Docutils 0.19, input objects are no longer required to be `TransformSpec` instances.) inputr component_typeNClassVar[str | None]default_source_pathcx||_ ||_ ||_ ||_ |s|j|_d|_yN)r! error_handlersource source_pathr0successful_encoding)selfr4r5r!r3s r__init__zInput.__init__^sJ! 1** '&-#77D #' ErcR|jd|jd|jS)Nz : source=z, source_path=)r(r4r5r7s r__repr__zInput.__repr__ws$26..$++262B2BD Drct)z,Return input as `str`. Define in subclasses.NotImplementedErrorr:s rreadz Input.read{!!rc~t|tr|S|jr2|jjdk7sJd|jg}nt j 5t j dt|j|}dddr|g}njdg}tjdddk\rtj}ntjd }|r$|jdk7r|j||js$|d dk7rt jd td |D]$} t|||j }||_|cSt%ddj)d|Ddt+d#1swYxYw#t$t&f$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 and the locale's preferred encoding. The client application should call ``locale.setlocale()`` at the beginning of processing:: locale.setlocale(locale.LC_ALL, '') Raise UnicodeError if unsuccessful. Provisional: encoding detection will be removed in Docutils 1.0. unicodez;input encoding is "unicode" but `data` is no `str` instancer)categoryNutf-8) F) do_setlocalerurInput encoding auto-detection will be removed and the encoding values None and "" become invalid in Docutils 1.0. stacklevelz=Unable to decode input data. Tried the following encodings: z, c32K|]}t|ywr2)repr).0encs r zInput.decode..sBscBs. ()) isinstancestrr!lowerwarningscatch_warningsfilterwarningsDeprecationWarningdetermine_encoding_from_datasys version_infolocale getencodinggetpreferredencodingappendwarnr3r6 UnicodeErrorr"joinr*) r7dataencoding_candidates data_encodingfallbackrNdecodedr)errors rdecodez Input.decodes" dC K ====&&(I5 OM O5#'==/ ((* H'';MN $ A A$ G  H'4o# (/i###BQ'72%113H%::NH 0G ;'..x8}}!4Q!77!B MM./Aa Q' C dC););<+.(   KyyB.ABBCDU#$A '( (= H H6!+.  s$%-FF!F!F<0F77F<scoding[:=]\s*([-\w.]+)zClassVar[re.Pattern[bytes]] coding_slugzutf-32z utf-8-sigzutf-16z'ClassVar[tuple[tuple[bytes, str], ...]]byte_order_marksc<tjdtd|jD]\}}|j |s|cS|j ddD]A}|j j|}|s!|jdjdcSy)z Try to determine the encoding of `data` by looking *in* `data`. Check for a byte order mark (BOM) or an encoding declaration. Deprecated. Will be removed in Docutils 1.0. uRdocutils.io.Input.determine_encoding_from_data() will be removed in Docutils 1.0.rErINrascii) rUr`rXrk startswith splitlinesrjsearchgroupri)r7rc start_bytesr!linematchs rrYz"Input.determine_encoding_from_datas  :(Q 8&*%:%: !K{+ OO%bq) 6D$$++D1E{{1~,,W55 6rcV |jjS#t$rYywxYw)z>Return True, if the input source is connected to a TTY device.F)r4isattyr#r:s rrvz Input.isattys, ;;%%' '    (()NNrDstrict) r4z$str | TextIO | nodes.document | Noner5StrPath | Noner!str | Literal['unicode'] | Noner3rreturnNoner{rS)rc str | bytesr{rS)rcbytesr{rr{bool)rrr__doc__r.__annotations__r0r8r;r?rirecompilerjr BOM_UTF32_BE BOM_UTF32_LEBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErkrYrvrrrr,r,Ns $NE#04-48<&*4;$, F4F$F2 F " F  F2D";(z0:rzz"0K,(   h'   h' +&   h'   h' A=*rr,cjeZdZUdZdZded<dZded< d d dZdd Zdd Z dd Z y)Outputan 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" to the "Transformer". (Since Docutils 0.19, output objects are no longer required to be `TransformSpec` instances.) outputr r.Nr/default_destination_pathct||_ |xsd|_ ||_ ||_ |s|j|_yy)Nrx)r!r3 destinationdestination_pathr)r7rrr!r3s rr8zOutput.__init__sJ%- 7"/";8*8C.0@2$($A$AD ! rcR|jd|jd|jS)Nz: destination=z, destination_path=)r(rrr:s rr;zOutput.__repr__s%>>4#3#3T5J5JL Mrct)z#Write `data`. Define in subclasses.r=r7rcs rwritez Output.writer@rc|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. rBzO"&{D04 .2.@.@#BDK "ii DKK 75 @ $ t{{/C/C EF F #';;#3#3 O$U[[%..+NNO"  s)(C D D)!D  D DDc |jsot|jdrY|jjj }|j |}dj |jdgz}n)|j |jj }|jr|j|S#|jr|jwwxYw)zA Read and decode a single file, return as `str`. r ) r!hasattrr4rr?rirbrorrrs rr?zFileInput.reads ==WT[[(%C{{))..0{{4(yy!2B4!78{{4;;#3#3#56~~  ~~ s B$CC#c@|jjdS)zC Return lines of a single file as list of strings. T)r?ror:s r readlineszFileInput.readlinessyy{%%d++rcr|jtjur|jjyyr2)r4rZrrr:s rrzFileInput.closes' ;;cii ' KK    (r)NNrDrxTr)r4 TextIO | Noner5ryr!rzr3rrrrzLiteral['r', 'rb', 'br']r{r|r})r{z list[str]r) rrrrr8r?rr __classcell__r(s@rrrsu !%&*4;$,),,,$,2 , " ,  ,', ,\&,  rrceZdZUdZdZded<dZded< d d fd Zdd Zdd Z dd Z xZ S) FileOutputz,Output for single, simple file-like objects.zr rrz:Literal['w', 'a', 'x', 'wb', 'ab', 'xb', 'bw', 'ba', 'bx']rct|||||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.rErIFrzWarning: Destination mode "z" differs from specified mode "")file)rr8openedrrUr`rXrrrrZrrrprintrrr#) r7rrr!r3rhandle_io_errorsrr(s rr8zFileOutput.__init__s2  )8] D "  ' MM*+=! M  DI"}  # #&:: wt//8$**/// !%!1!1!6!6>|| %  (,(8(8(=(=% "  s C== D D c,d|jvr|j|jd}ni} t|j|jfi||_d|_ y#t $r0}t|j|j|jd}~wwxYw)NbrT) rr!r3rrrrrrrr)r7kwargsrhs rrzFileOutput.open&s 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 (rQNz2Unable to encode output data. output-encoding is: rP)rrrRrSr&rr!oslineseprrrr$rrr# ValueErrorrrar"r*rr)r7rcr)s rrzFileOutput.write4s{{ 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)rrZrrrrr:s rrzFileOutput.closebs;   CJJ #; ;    " " $DK r r0c8|j|jS)z`Return the source as `str` instance. Decode, if required (see `Input.decode`). )rir4r:s rr?zStringInput.reads {{4;;''rNr}rrrrrr0r?rrrrrys1 !++(rrc2eZdZUdZded<dZded<d dZy) StringOutputz=Output to a `bytes` or `str` instance. Provisional. r~rrr 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). )rrrs rrzStringOutput.writes! ;;t,rNrrrrrrrrrrrrrs &0e0 rrc2eZdZUdZded<dZded<d dZy) NullInputzDegenerate input: read nothing.r|r4z null inputr r0cy)zReturn an empty string.rrr:s rr?zNullInput.readsrNr}rrrrrrs) L!--rrc2eZdZUdZded<dZded<d dZy) NullOutputz!Degenerate output: write nothing.r|rz null outputr rcy)zDo nothing, return None.Nrrs rrzNullOutput.writesrN)rcr~r{r|rrrrrrs+&3e3'rrc2eZdZUdZded<dZded<d dZy) DocTreeInputzm Adapter for document tree input. The document tree must be passed in the ``source`` parameter. nodes.documentr4z doctree inputr r0c|jS)zReturn the document tree.)r4r:s rr?zDocTreeInput.reads {{rN)r{rrrrrrrs !00rr)r%r r!rSr{z bool | None)r) BaseExceptionr{rS)1r __future__r __docformat__rr\rrrZrUdocutilsr TYPE_CHECKINGtypingrrrr r r r docutils.nodesr rV simplefilter getlocalegetdefaultlocalerTrrr r"r$rrrr&r*r,rrrrrrrrrrrrrrs  #" " FF&   "2h'(8(8(8(:1(=)H+B6+B+B+DQ+G*/%' * 22FMM"#   '   . [M[|@B]@BFbbJN N b@ @ F*z*" (% ( 6 :   ' '5q22  Ys7 E*AE,E*5E3E'#E**E03 E?>E?