k7i e(%SrSSKJr SrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r Sr \ (aSSK JrJrJrJrJrJr SSK Jr SS KJr \ R."5 \ R0"S 5 \R2"5S =(d \R4"5S R75rS \S 'SSS5 \R<"\5 "SS\!5r""SS\!5r#S*Sjr$S+Sjr%"SS\ 5r&"SS\ 5r'"SS5r("SS\&5r)"SS\'5r*"SS\*5r+"S S!\&5r,"S"S#\'5r-"S$S%\&5r."S&S'\'5r/"S(S)\&5r0g!,(df  N=f! SrN=f!\\ 4a SrNf=f),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\rSrSrSrg) InputError4N__name__ __module__ __qualname____firstlineno____static_attributes__rE/home/james-whalen/.local/lib/python3.13/site-packages/docutils/io.pyrr4s4rrc\rSrSrSrg) OutputError5rNrrrrrr5sDrrc[R"UR5[R"U5:H$![[[ 4a gf=f)a6Test, 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  3s69AAc8URRSU3$)z5Return string representation of Exception `err`. z: ) __class__r)errs r error_stringr-Hs mm$$ %Ru --rcR\rSrSr%SrSrS\S'SrS\S'SSS jjrSS jr SS jr SS jr \ R"S 5rS\S'\R S4\R"S4\R$S4\R&S4\R(S44rS\S'SSjrSSjrSrg)InputNaO 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_pathczX0lX@lXlX lU(dURUlSUlgN)r$ error_handlersource source_pathr4successful_encoding)selfr8r9r$r7s r__init__Input.__init__^sB! 1** '&-#77D #' ErcXUR<SUR<SUR<3$)Nz : source=z, source_path=)r+r8r9r;s r__repr__Input.__repr__ws$26..$++262B2BD Drc[e)z,Return input as `str`. Define in subclasses.NotImplementedErrorr?s rread Input.read{!!rcUR(a:URR5S:Xa[U[5(dS5e[U[5(aU$UR(aUR/nO[R "5 [R "S[S9 URU5nSSS5 W(aU/nOpS/n[RSSS:a[R"5nO[R"S S 9nU(a%UR5S:waURU5 UR(d#US S:wa[R"S [SS 9 UH"n[XUR 5nXPlUs $ [%SSR)SU55S[+W5S35e!,(df  GN=f![$[&4a nUnSnAMSnAff=f)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, c38# UHn[U5v M g7fr6)repr).0encs r Input.decode..sB.Asc.As. ())r$lower isinstancestrwarningscatch_warningsfilterwarningsDeprecationWarningdetermine_encoding_from_datasys version_infolocale getencodinggetpreferredencodingappendwarnr7r: UnicodeErrorr%joinr-) r;dataencoding_candidates data_encodingfallbackrUdecodedr,errors rdecode Input.decodes" ==T]]002i?dC(( N,M N( dC K ==$(==/ ((*'';MN $ A A$ G +'4o# (/i###BQ'72%113H%::NH 0G ;'..x8}}!4Q!77!B MM./Aa Q'C d););<+.( ' KyyB.ABBCDU#$A '( (=+*6!+.  s$+G?G$ G!$H4G<<Hscoding[:=]\s*([-\w.]+)zClassVar[re.Pattern[bytes]] coding_slugzutf-32z utf-8-sigzutf-16z'ClassVar[tuple[tuple[bytes, str], ...]]byte_order_markscR[R"S[SS9 URHup#UR U5(dMUs $ UR 5SSHGnUR RU5nU(dM'URS5RS5s $ g)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.rLrPNrascii) r]rhr`rt startswith splitlinesrssearchgrouprq)r;rk start_bytesr$linematchs rra"Input.determine_encoding_from_datas  :(Q 8&*%:%: !K{++&;OO%bq)D$$++D1Eu{{1~,,W55*rcXURR5$![a gf=f)z>Return True, if the input source is connected to a TTY device.F)r8isattyr&r?s rr Input.isattys, ;;%%' '    )))r$r7r8r9r:)NNrKstrict) r8z$str | TextIO | nodes.document | Noner9StrPath | Noner$str | Literal['unicode'] | Noner7rreturnNonerr\)rk str | bytesrr\)rkbytesrrrbool)rrrr__doc__r2__annotations__r4r<r@rErqrecompilersr" BOM_UTF32_BE BOM_UTF32_LEBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErtrarrrrrr/r/Ns $NE#04-48<&*4;$, F4F$F2 F " F  F2D"=(~02zz"0K,(   h'   h' +&   h'   h' A=*rr/c|\rSrSr%SrSrS\S'SrS\S'SSS jjrSS jr SS jr SS jr S r g)OutputaR 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 r2Nr3default_destination_pathcX0lU=(d SUlXlX lU(dURUlgg)Nr)r$r7 destinationdestination_pathr)r;rrr$r7s rr<Output.__init__sD%- 7"/";8*8C.0@2$($A$AD ! rcXUR<SUR<SUR<3$)Nz: destination=z, destination_path=)r+rrr?s rr@Output.__repr__s%>>4#3#3T5J5JL Mrc[e)z#Write `data`. Define in subclasses.rCr;rks rwrite Output.writerGrcUR(a<URR5S:Xa[U[5(dS5eU$[U[5(dU$UR URUR 5$)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. rIzAFAFFcUR[R[R4;agURR 5 g![ a gf=f)zv Close the error-output stream. Ignored if the destination is` sys.stderr` or `sys.stdout` or has no close() method. N)rrbrrcloser&r?s rrErrorOutput.closesK    CJJ7 7      " " $   sA AAcXURR5$![a gf=f)z=Return True, if the destination is connected to a TTY device.F)rrr&r?s rrErrorOutput.isattys. ##**, ,  r)rrr$r)NNbackslashreplacereplace) rz/TextIO | BinaryIO | str | Literal[False] | Noner$rrr\rr\rr)rkzstr | bytes | Exceptionrrrrr) rrrrrr<rrrrrrrrr1s]HL#1( '&D'&'& '&  '&  '&R/@ rrcx^\rSrSrSrSS U4SjjjrS SjrS SjrS SjrSr U=r $) FileInputiz- Input for single, simple file-like objects. cT>[TU]XX45 XPl[5UlUcCU(a&[ X&UR URS9UlOk[RUlOU[URUR 5SLa2[!SUR <SURR <S35eU(dURR"Ulgg![a&n[URURU5eSnAff=f![&a gf=f)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'). Nr$errorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)superr< autocloser_stderrrr$r7r8OSErrorrerrnostrerrorrbstdinr)rinamer9r&) r;r8r9r$r7rmoderpr+s rr<FileInput.__init__s* hF""} >O"&{04 .2.@.@#BDK "ii DKK 75 @ $ t{{/C/C EF F #';;#3#3 O$U[[%..+NNO"  s)$C' D' D1!DD D'&D'cUR(dt[URS5(aYURRR 5nUR U5nSR UR5S/-5nOURR 5nUR(aUR5 U$!UR(aUR5 ff=f)z1 Read and decode a single file, return as `str`. r ) r$hasattrr8rrErqrjrxrrrs rrEFileInput.reads ==WT[[(%C%C{{))..0{{4(yy!2B4!78{{'')~~  ~~ s BC$C(c@UR5RS5$)z3 Return lines of a single file as list of strings. T)rErxr?s r readlinesFileInput.readlinessyy{%%d++rctUR[RLaURR5 ggr6)r8rbrrr?s rrFileInput.closes' ;;cii ' KK    (r)rrr8r9)NNrKrTr)r8 TextIO | Noner9rr$rr7rrrrzLiteral['r', 'rb', 'br']rrr)rz list[str]r) rrrrrr<rErrr __classcell__r+s@rrrs !%&*4;$,),,,$,2 , " ,  ,', ,,\&,   rrc^\rSrSr%SrSrS\S'SrS\S'SSU4S jjjrSS jr SS jr SS jr S r U=r $) FileOutputiz,Output for single, simple file-like objects.zr rrz:Literal['w', 'a', 'x', 'wb', 'ab', 'xb', 'bw', 'ba', 'bx']rc:>[TU]XX45 SUlXPlUb[R "S[ SS9 UbXpl[5Ul Uc%U(aSUlO[RUl OlU(ae[URS5(aJXpRR:wa1[SURR<S U<S 3URS 9 U(dURRUlgg!["a gf=f) a :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.rLrPFrzWarning: Destination mode "z" differs from specified mode "")file)rr<openedrr]rhr`rrrrbrrrprintrrr&) r;rrr$r7rhandle_io_errorsrr+s rr<FileOutput.__init__s2  8 D "  ' MM*+=! M  I"}  # #&:: wt//88**/// !%!1!1!6!6>|| %  (,(8(8(=(=% "  s0D DDc2SUR;aURURS.nO0n[URUR40UD6UlSUl g![ a0n[URURUR5eSnAff=f)NbrT) rr$r7rrrrrrrr)r;kwargsrps rrFileOutput.open(s dii "&-- $ 2 24FF 5#D$9$9499OOD   5ekk5>>"335 5 5s&A B&+BBc UR(dUR5 [U[5(ah[ UR UR 5SLaE[RS:wa URS[R5nURU5nUR RU5 UR*(aUR-5 U$![an[U[5(aUR RRU5 SnANm![ac [ UR UR 5SLa=[!SUR"SUR R SUR S35eUef=fSnANSnAf[$[&4a*n[%SUR S [)U5S35eSnAff=f!UR*(aUR-5 ff=f) aWrite `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 (rYNz2Unable to encode output data. output-encoding is: rX)rrr[r\r)rr$oslineseprrrr'rrr& ValueErrorrrir%r-rr)r;rkr,s rrFileOutput.write6s{{ IIK tS ! !t//?5HzzT!||D"**5;;t$D     " "4 (&~~  ) "$&& "$$++11$77%"%d&6&6&*mm58=>(*4+@+@*AB $ 0 0 9 9:;::>--KLL " "'k* <D==/l3&7%8;< < < ~~ sO C G(F>%D(#G(A-FFGG0%GGG$HcUR[R[R4;a"URR 5 SUlgg)NF)rrbrrrrr?s rrFileOutput.closeds;   CJJ #; ;    " " $DK [R"S[SS9 [TU]"U0UD6 g)NzU"BinaryFileOutput" is obsoleted by "FileOutput" and will be removed in Docutils 0.24.rLrP)r]rhr`rr<)r;argsrr+s rr<BinaryFileOutput.__init__ts- ?(Q 8 $)&)rr)rrrrrr) rrrrrrr<rrrs@rrrjs D**rrc<\rSrSr%SrS\S'SrS\S'S SjrS rg ) StringInputi{z'Input from a `str` or `bytes` instance.rr8r r4c8URUR5$)zPReturn the source as `str` instance. Decode, if required (see `Input.decode`). )rqr8r?s rrEStringInput.reads {{4;;''rrNr rrrrrrr4rErrrrrr{s1 !++(rrc<\rSrSr%SrS\S'SrS\S'S SjrS rg ) StringOutputiz5Output to a `bytes` or `str` instance. Provisional. rrrr rcFURU5UlUR$)a&Store `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 rrStringOutput.writes! ;;t,r)rNr rrrrrrrrrrrrrrs &0e0 rrc<\rSrSr%SrS\S'SrS\S'S SjrS rg ) NullInputizDegenerate input: read nothing.rr8z null inputr r4cg)zReturn an empty string.rrr?s rrENullInput.readsrrNrrrrrrrs) L!--rrc<\rSrSr%SrS\S'SrS\S'S SjrS rg ) NullOutputiz!Degenerate output: write nothing.rrz null outputr rcg)zDo nothing, return None.Nrrs rrNullOutput.writesrrN)rkrrrrrrrr r s+&3e3'rr c<\rSrSr%SrS\S'SrS\S'S SjrS rg ) DocTreeInputiza Adapter for document tree input. The document tree must be passed in the ``source`` parameter. nodes.documentr8z doctree inputr r4cUR$)zReturn the document tree.)r8r?s rrEDocTreeInput.reads {{rrN)rrrrrrrrs !00rr)r(r r$r\rz bool | None)r, BaseExceptionrr\)1r __future__r __docformat__r"rdrrrbr]docutilsr TYPE_CHECKINGtypingrrrr r r r docutils.nodesr r^ simplefilter getlocalegetdefaultlocalerZrrr#r%r'rrrr)r-r/rrrrrrrrr rrrrrs  #" " FF&   "h'(.(8(8(:1(=)H+1+B+B+DQ+G*/%' * 2 # MM"#   '   . ]M]@@B]@BFbbJN N b@ @ F*z*" (% ( 6 :   ' '5u # "  Ys=E;!AE*6E;?F* E84E;8E;;F FF