+ VBi e^a0t$Rt^RIHtRt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t Rt ] 'd^RIHtHtHtHtHtHt^RI Ht^RIHt] P0!4;_uu_4] P2!R 4]P4!4^,;'g]P6!4^,P94tR ]R &RRR4]P>!]4!R R ]"4t#!RR]"4t$RRlt%RRlt&!RR] 4t'!RR] 4t(!RR4t)!RR]'4t*!RR](4t+!RR]+4t,!R R!]'4t-!R"R#](4t.!R$R%]'4t/!R&R'](4t0!R(R)]'4t1R# +'giL;i RtL;i ] ]!3dRtLi;i)*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]tRt^4tRtR#) InputErrorN__name__ __module__ __qualname____firstlineno____static_attributes__r0/usr/lib/python3.14/site-packages/docutils/io.pyrr4s4rrc]tRt^5tRtR#) OutputErrorrNrrrrrr5sDrrc$V^8dQhRRRRRR/#)streamr encodingstrreturnz bool | Noner)formats"r __annotate__r$8s!  6 S [ rc\P!VP4\P!V48H# \\\ 3dR#i;i)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)codecslookupr LookupErrorAttributeError TypeError)rr s&&rcheck_encodingr+8sA}}V__-x1HHH  3s69AAc V^8dQhRRRR/#)rerr BaseExceptionr"r!r)r#s"rr$r$Hs..m..rc8VPP RV 2#)z5Return string representation of Exception `err`. z: ) __class__r)r-s&r error_stringr1Hs mm$$ %Ru --rcF]tRt^Nt$RtRtR]R&RtR]R&RRR lltR R lt R R lt RRlt ] P!R4tR]R&]P R3]P"R3]P$R3]P&R3]P(R33tR]R&RRltRRltRtR#)InputaO 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.) inputrcomponent_typeNClassVar[str | None]default_source_pathc ,V^8dQhRRRRRRRRR R /#) rsourcez$str | TextIO | nodes.document | None source_pathStrPath | Noner str | Literal['unicode'] | None error_handlerrr"Noner)r#s"rr$Input.__annotate__^sCFF4F$F2 F " F  Frc ~W0nW@nWnW nV'gVPVnRVnR#N)r r=r9r:r7successful_encoding)selfr9r:r r=s&&&&&r__init__Input.__init__^sB! 1** '&-#77D #' ErcV^8dQhRR/#rr"r!r)r#s"rr$r?wsDD#Drc XVP: RVP: RVP: 2#)z : source=z, source_path=)r0r9r:rCs&r__repr__Input.__repr__ws$26..$++262B2BD DrcV^8dQhRR/#rGr)r#s"rr$r?{s""c"rc \h)z,Return input as `str`. Define in subclasses.NotImplementedErrorrIs&rread Input.read{!!rc V^8dQhRRRR/#)rdata str | bytesr"r!r)r#s"rr$r?s=(=(;=(3=(rc VVP'd=VPP4R8Xd\V\4'gQR4h\V\4'dV#VP'dVP.pM\P !4;_uu_4\P !R\R7VPV4pRRR4X'dV.pMzR.p\PR,R8d\P!4pM\P!RR 7pV'd'VP4R8wdVPV4VP'g,V^,R8wd\P!R \^R 7VF"p\WVP 4pWPnVu# \%R R P)RV44 R\+X4 R24h +'giEL-;i \$\&3dpTpRp?KRp?ii;i)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-8NrNF) do_setlocaleurInput 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"TFp\V4xK R#5irA)repr).0encs& r Input.decode..sB.Asc.As. ()) )r lower isinstancer!warningscatch_warningsfilterwarningsDeprecationWarningdetermine_encoding_from_datasys version_infolocale getencodinggetpreferredencodingappendwarnr=rB UnicodeErrorr(joinr1) rCrTencoding_candidates data_encodingfallbackradecodedr-errors && rdecode Input.decodes" ===T]]002i?dC(( N,M N( dC K ===$(==/ ((**'';MN $ A A$ G +'4o# (/i###B'72%113H%::NH 0G ;'..x8}}}!4Q!77!B MM./Aa Q'C d););<+.( ' KyyB.ABBCDU#$A '( (=+**6!+.  s$$.G6#H 6 H H(H##H(scoding[:=]\s*([-\w.]+)zClassVar[re.Pattern[bytes]] coding_slugzutf-32z utf-8-sigzutf-16z'ClassVar[tuple[tuple[bytes, str], ...]]byte_order_marksc V^8dQhRRRR/#)rrTbytesr"rr)r#s"rr$r?s:rc f\P!R\^R7VPF wr#VP V4'gKVu# VP 4R,FHpVP PV4pV'gK(VP^4PR4u# R#)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.r\rZasciiN) rjrurmr startswith splitlinesrsearchgroupr})rCrT start_bytesr linematchs&& rrn"Input.determine_encoding_from_datas  :(Q 8&*%:%: !K{++&;OO%b))D$$++D1Eu{{1~,,W55*rcV^8dQhRR/#rr"boolr)r#s"rr$r?rc \VPP4# \dR#i;i)z>Return True, if the input source is connected to a TTY device.F)r9isattyr)rIs&rr Input.isattys, ;;%%' '    ++)r r=r9r:rB)NNrYstrict)rrrr__doc__r5__annotations__r7rDrJrPr}recompilerr& BOM_UTF32_BE BOM_UTF32_LEBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErrnrrrrrr3r3Ns $NE#04-4F2D"=(~02zz"0K,(   h'   h' +&   h'   h' A=*rr3cl]tRt^t$RtRtR]R&RtR]R&RRR lltR R lt R R lt RRlt Rt R#)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.) outputrr5Nr6default_destination_pathc ,V^8dQhRRRRRRRRRR /#) r destinationzTextIO | str | bytes | Nonedestination_pathr;r rr=r"r>r)r#s"rr$Output.__annotate__sCBB0B)B B " B  Brc W0nT;'gRVnWnW nV'gVPVnR#R#)rN)r r=rrr)rCrrr r=s&&&&&rrDOutput.__init__sG%- 7"/";";8*8C.0@2$($A$AD ! rcV^8dQhRR/#rGr)r#s"rr$rsMM#Mrc XVP: RVP: RVP: 2#)z: destination=z, destination_path=)r0rrrIs&rrJOutput.__repr__s%>>4#3#3T5J5JL Mrc V^8dQhRRRR/#)rrTrUr"zstr | bytes | Noner)r#s"rr$rs""+"*<"rc \h)z#Write `data`. Define in subclasses.rNrCrTs&&rwrite Output.writerRrc V^8dQhRRRR/#rrTrUr"r)r#s"rr$rsBB;B;Brc VP'd?VPP4R8Xd \V\4'gQR4hV#\V\4'gV#VP VPVP 4#)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. rWzr)r#s"rr$ErrorOutput.__annotate__7s<'&'&D'&'& '&  '&  '&rc Vf\PpM-V'gRpM"\V\4'd \ VR4pWnT;'g&\ VRR4;'g\;'gRVnW0n W@n R#)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. NFwr r) rostderrrir!openrgetattrrr rr)rCrr rrs&&&&&rrDErrorOutput.__init__7s  **KK  S ) ){C0K?J+   {J5     -$3%$3%rc V^8dQhRRRR/#)rrTzstr | bytes | Exceptionr"r>r)r#s"rr$r`s//1/d/rc LVP'gR#\V\4'd \V4pVPP V4R# \ dFTP TPTP4pTPP T4R#\d\T\4'dETP TPTP4pTPP T4R#TP\P\P39d)TPPP T4R#TPTPTP4pTPP T4R#i;i)z Write `data` to self.destination. Ignore, if self.destination is False. `data` can be a `bytes`, `str`, or `Exception` instance. N)rri Exceptionr!rUnicodeEncodeErrorrr rr*rorstdoutbufferr}r)rCrTbinarystrings&& rrErrorOutput.write`s)   dI & &t9D /    " "4 (! +[[0D0DEF    " "6 * /$$$T]]D4H4HI  &&v.!!cjj#**%==  ''--d3T]]D4H4HI  &&v. /s-AA F##F#,AF#AF#AF#"F#cV^8dQhRR/#rr"r>r)r#s"rr$rs  t rc VP\P\P39dR#VPP 4R# \ dR#i;i)zv Close the error-output stream. Ignored if the destination is` sys.stderr` or `sys.stdout` or has no close() method. N)rrorrcloser)rIs&rrErrorOutput.closesK    CJJ7 7      " " $   sA AAcV^8dQhRR/#rr)r#s"rr$rrrc \VPP4# \dR#i;i)z=Return True, if the destination is connected to a TTY device.F)rrr)rIs&rrErrorOutput.isattys. ##**, ,  r)rrr r)NNbackslashreplacereplace) rrrrrrDrrrrrrrrr1s" '&R/@ rrcZa]tRtRtRtR RV3RllltRRltRRltR R ltR t V;t #) FileInputiz- Input for single, simple file-like objects. c4V^8dQhRRRRRRRRR R R R R R/#)rr9 TextIO | Noner:r;r r<r=r autoclosermodezLiteral['r', 'rb', 'br']r"r>r)r#s"rr$FileInput.__annotate__sP,,,$,2 , " ,  ,', ,rc l<\SV`WW44WPn\4VnVfHV'd*\ W&VP VPR7VnMl\PVnMV\VPVP 4RJd3\!RVP : RVPP : R24hV'gVPP"VnR#R# \d'p\TPTPT4hRp?ii;i \&dR#i;i)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'). N)r errorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)superrDrr_stderrrr r=r9OSErrorrerrnostrerrorrostdinr+rvnamer:r)) rCr9r:r r=rrr|r0s &&&&&&& rrDFileInput.__init__s* hF""} >O"&{04 .2.@.@#BDK "ii DKK 75 @ $ t{{/C/C EF F #';;#3#3 O$U[[%..+NNO"  s)'C0D$0 D!;!DD!$ D32D3cV^8dQhRR/#rGr)r#s"rr$rscrc VP'gz\VPR4'd^VPPP 4pVP V4pRP VP4R.,4pMVPP 4pVP'dVP4V# TP'dTP4ii;i)z1 Read and decode a single file, return as `str`. r ) r hasattrr9rrPr}rwrrrrs& rrPFileInput.reads ===WT[[(%C%C{{))..0{{4(yy!2B4!78{{'')~~~  ~~~ sC BC %C0cV^8dQhRR/#)rr"z list[str]r)r#s"rr$rs,,9,rc @VP4PR4#)z3 Return lines of a single file as list of strings. T)rPrrIs&r readlinesFileInput.readlinessyy{%%d++rcV^8dQhRR/#rr)r#s"rr$rs  t rc zVP\PJdVPP4R#R#rA)r9rorrrIs&rrFileInput.closes' ;;cii ' KK    (r)rrr9r:)NNrYrTr) rrrrrrDrPrrr __classcell__r0s@rrrs',,\&,   rrcza]tRtRt$RtRtR]R&RtR]R&RR V3R llltR R lt R Rlt RRlt Rt V;t #) FileOutputiz,Output for single, simple file-like objects.zrrrz:Literal['w', 'a', 'x', 'wb', 'ab', 'xb', 'bw', 'ba', 'bx']rc4V^8dQhRRRRRRRRRR R R R R /#) rrrrr;r rr=rrhandle_io_errorsr>r"r)r#s"rr$FileOutput.__annotate__sN33+3#13&3!+ 3 ! 3 $( 33rc ^<\SV`WW44RVnWPnVe\P !R\ ^R7VeWpn\4Vn Vf'V'd RVnM\PVn MrV'dk\VPR4'dOWpPP8wd5\RVPP: RV: R 2VPR 7V'gVPPVnR#R# \"dR#i;i) 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.r\FrzWarning: Destination mode "z" differs from specified mode "")file)rrDopenedrrjrurmrrrrorrrprintrrr)) rCrrr r=rrrr0s &&&&&&&&rrDFileOutput.__init__s2  8 D "  ' MM*+=! M  I"}  # #&:: wt//88**/// !%!1!1!6!6>|| %  (,(8(8(=(=% "  s>D D,+D,cV^8dQhRR/#rr)r#s"rr$r(s  d rc :RVP9dRVPRVP/pM/p\VPVP3/VBVnRTn R# \ d1p\TPTPTP4hRp?ii;i)br rNT) rr r=rrrrrrrr)rCkwargsr|s& rrFileOutput.open(s dii  $-- 2 24FF 5#D$9$9499OOD   5ekk5>>"335 5 5s&A B*+BBc V^8dQhRRRR/#rr)r#s"rr$r6s,,+,+,rc  VP'gVP4\V\4'dk\ VP VP 4RJdG\PR8wd!VPR\P4pVPV4pVP PV4TP*'dTP-4T# \dp\T\4'dTP PPT4Rp?Lp \de\ TP TP 4RJd>\!RTP" RTP P RTP R24hThi;iRp?LRp?i\$\&3d+p\%RTP R \)T4 R24hRp?ii;i TP*'dTP-4ii;i) 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 (reNz2Unable to encode output data. output-encoding is: rd)rrrir!r+rr oslineseprrrr*rrr) ValueErrorrrvr(r1rr)rCrTr-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;< < < ~~~ sU$C## G$.F&%D/*G'/A/FF&!G'&G$9G$:%GG$$G''%H cV^8dQhRR/#rr)r#s"rr$rds  t rc VP\P\P39d$VPP 4RVnR#R#)FN)rrorrrrrIs&rrFileOutput.closeds;   CJJ #; ;    " " $DK r)r#s"rr$BinaryFileOutput.__annotate__ts!**c*S*T*rc b<\P!R\^R7\SV`!V/VBR#)zU"BinaryFileOutput" is obsoleted by "FileOutput" and will be removed in Docutils 0.24.r\N)rjrurmrrD)rCrrr0s&*,rrDBinaryFileOutput.__init__ts- ?(Q 8 $)&)rr) rrrrrrrDrrrs@rrrjs D**rrc@]tRtRt$RtR]R&RtR]R&RR ltR tR #) StringInputi{z'Input from a `str` or `bytes` instance.rUr9rr7cV^8dQhRR/#rGr)r#s"rr$StringInput.__annotate__s((c(rc 8VPVP4#)zPReturn the source as `str` instance. Decode, if required (see `Input.decode`). )r}r9rIs&rrPStringInput.reads {{4;;''rrN rrrrrrr7rPrrrrrr{s 1 !++((rrc@]tRtRt$RtR]R&RtR]R&RR ltR tR #) StringOutputiz5Output to a `bytes` or `str` instance. Provisional. rUrrrrc V^8dQhRRRR/#rr)r#s"rr$StringOutput.__annotate__s  + + rc FVPV4VnVP#)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)rN rrrrrrrrrrrrr r s$ &0e0  rr c@]tRtRt$RtR]R&RtR]R&RR ltR tR #) NullInputizDegenerate input: read nothing.r>r9z null inputrr7cV^8dQhRR/#rGr)r#s"rr$NullInput.__annotate__scrc R#)zReturn an empty string.rrrIs&rrPNullInput.readsrrNrrrrr'r's) L!--rr'c@]tRtRt$RtR]R&RtR]R&RR ltR tR #) NullOutputiz!Degenerate output: write nothing.r>rz null outputrrc V^8dQhRRRR/#)rrTrUr"r>r)r#s"rr$NullOutput.__annotate__s''+'$'rc R#)zDo nothing, return None.Nrrs&&rrNullOutput.writesrrNr%rrrr-r-s +&3e3''rr-c@]tRtRt$RtR]R&RtR]R&RR ltR tR #) DocTreeInputiza Adapter for document tree input. The document tree must be passed in the ``source`` parameter. nodes.documentr9z doctree inputrr7cV^8dQhRR/#)rr"r4r)r#s"rr$DocTreeInput.__annotate__snrc VP#)zReturn the document tree.)r9rIs&rrPDocTreeInput.reads {{rrNrrrrr3r3s$ !00rr3)2__conditional_annotations__r __future__r __docformat__r&rqrrrorjdocutilsr TYPE_CHECKINGtypingrrrrr r r docutils.nodesr rk simplefilter getlocalegetdefaultlocalerhrrr'r(r*rrrr+r1r3rrrrrrr r'r-r3)r9s@rrCs  #" " FF&   " "h'(.(8(8(:1(=)H)H+1+B+B+DQ+G*/%' * 2 # MM"#   '   . ]M]@@B]@BFbbJN N b@ @ F*z*" (% ( 6 :   ' '5u # "  Ys=F-AF FF F FFF F,+F,