>WBeBdZddlmZdZddlZddlZddlZddlZddlZddl m Z ddl m Z m Z mZejdk\reZGdd eZGd d eZd ZGd de ZGdde ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZy)!z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. )print_functionreStructuredTextN) TransformSpec)locale_encoding ErrorString ErrorOutputrc eZdZy) InputErrorN__name__ __module__ __qualname__+lib/python3.12/site-packages/docutils/io.pyr r rr c eZdZy) OutputErrorNr rrrrrrrrc 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_encodingrsA}}V__-x1HHH  3s47A AceZdZdZdZdZ d dZdZdZdZ e jdZ e jd fe jd fe j d ffZ d Zy)Inputz1 Abstract base class for input wrappers. inputNcx||_ ||_ ||_ ||_ |s|j|_d|_yN)r error_handlersource source_pathdefault_source_pathsuccessful_encoding)selfr&r'rr%s r__init__zInput.__init__6sH  1** '&-#77D #' ErcR|jd|jd|jS)Nz : source=z, source_path=) __class__r&r'r*s r__repr__zInput.__repr__Js$26..$++262B2BD Drctr$NotImplementedErrorr.s rreadz Input.readNs!!rc |jr4|jjdk(rt|tsJdt|tr|S|jr|jg}n7|j |}|r|g}n ddg}t r|j dt |D]4} t|||j}||_|jddcStd d j|Dcgc] }t|c}d td #ttf$r }|}Yd}~d}~wwxYwcc}w) a Decode a string, `data`, heuristically. Raise UnicodeError if unsuccessful. The client application should call ``locale.setlocale`` at the beginning of processing:: locale.setlocale(locale.LC_ALL, '') unicodez=input encoding is "unicode" but input is not a unicode objectutf-8zlatin-1uNz=Unable to decode input data. Tried the following encodings: z, . ())rlower isinstancer5determine_encoding_from_datarinsertr%r)replace UnicodeErrorrjoinreprr)r*data encodings data_encodingencdecodederrerrors rdecodez Input.decodeQs1 ==T]]002i?dG, 54 5 dG $K ==I ==dCM+O %i0 "$$Q8 C !$T-?-?@+.(y#66  999%ECd3i%EF$U+ -. .!+.   &Fs*/D2D<D9-D44D9scoding[:=]\s*([-\w.]+)r6z 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. Nr7ascii)byte_order_marks startswith splitlines coding_slugsearchgrouprJ)r*rC start_bytesrlinematchs rr=z"Input.determine_encoding_from_datas &*%:%: !K{+ OO%bq) 6D$$++D1E{{1~,,W55 6rNNNstrict)rrr__doc__component_typer(r+r/r3rJrecompilerQrBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErNr=rrrr!r!,sN?C'F(D"..`"**78K''2,,k:,,k:=-rr!c6eZdZdZdZdZ ddZdZdZdZ y) Outputz2 Abstract base class for output wrappers. outputNct||_ |xsd|_ ||_ ||_ |s|j|_yy)NrX)rr% destinationdestination_pathdefault_destination_path)r*rdrerr%s rr+zOutput.__init__sH  7*6h*&. 02$($A$AD ! rcR|jd|jd|jS)Nz: destination=z, destination_path=)r-rdrer.s rr/zOutput.__repr__s%>>4#3#3T5J5JL Mrct)z;`data` is a Unicode string, to be encoded by `self.encode`.r1r*rCs rwritez Output.writes!!rc|jr6|jjdk(rt|tsJd|St|ts|S|j |j|j S)Nr5zFthe encoding given is "unicode" but the output is not a Unicode string)rr;r<r5encoder%ris rrlz Output.encodesg ==T]]002i?dG, $# $K$(K;;t}}d.@.@A ArrW) rrrrYrZrfr+r/rjrlrrrraras1N#:>.6B"M" BrracXeZdZdZdddddej dk\rdndfdZd Zd Zd Z y) FileInputz5 Input for single, simple file-like objects. NrXTr rrUctj|||||||_t|_|[|rCt j dk\r|j|jd}ni} t||fi||_ n{t j|_ net j dk\rRt!|j|jdur0t#d|jd|jjd|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 'rU' provides universal newline support for text files with Python 2.x. Nr rerrorsFz#Encoding clash: encoding given is "z&" but source is opened with encoding "z".)r!r+ autocloser_stderrsys version_inforr%openr&IOErrorr errnostrerrorstdinrr@namer'r) r*r&r'rr%rtmodekwargsrIs rr+zFileInput.__init__s." tV[(MJ""} >##v-*.--(,(:(:"&-- $ 2 24FF 5#D$9$9499OOD   5ekk5>>"335 5 5s&A-- B&6+B!!B&c L|js|jd|jvrtjdks"t |j |jdura|j|}tjdk\r=tjdk7r*|jdttjd} |j j||j.r|j1|S#t$r}tjdk\rt|tr |j j j|nr#t"$rft |j |jdurAt%d|j&xsdd |j jd |jd |wxYwYd }~d }~wt(t*f$r*}t)d |jdt-|d d }~wwxYw#|j.r|j1wwxYw)zEncode `data`, write it to a single file, and return it. With Python 3 or binary output mode, `data` is returned unchanged, except when specified encoding and output encoding differ. rr F rrMz Encoding of rdz (z&) differs from specified encoding (r:Nz2Unable to encode output data. output-encoding is: r9)rrxr~rvrwrrdrrloslinesepr?bytesrjrr<rr ValueErrorrer@rrrtr)r*rCrHs rrjzFileOutput.writeos {{ IIK tyy S%5%5%>d.. >%G;;t$D6)bjjD.@||E5W+EF     " "4 (&~~  ) "6)ju.E "$$++11$7%"%d&6&6&*mm58=>(!22CmC ,,55t}}*FGG " "k* A#}}k#.>@A A A ~~ sOC;; H#G(%E GA/F==GHH%G<<HHH#c|jtjtjfvr"|jj d|_yy)NF)rdrvrstderrrrr.s rrzFileOutput.closes;   CJJ #; ;    " " $DK c8|j|jS)z$Decode and return the source string.)rJr&r.s rr3zStringInput.reads{{4;;''rNrrrrYr(r3rrrrrs%(rrceZdZdZdZdZy) StringOutputz Direct string output. rcF|j||_|jS)z=Encode `data`, store it in `self.destination`, and return it.)rlrdris rrjzStringOutput.writes;;t,rNrrrrYrfrjrrrrrs * rrceZdZdZdZdZy) NullInputz) Degenerate input: read nothing. z null inputcy)zReturn a null string.r8rr.s rr3zNullInput.readsrNrrrrrrs'rrceZdZdZdZdZy) NullOutputz+ Degenerate output: write nothing. z null outputcy)z6Do nothing ([don't even] send data to the bit bucket).Nrris rrjzNullOutput.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) rY __future__r __docformat__rrr[rvrdocutilsrdocutils.utils.error_reportingrrrrwstrr5ryr rrr!rarnrrrrrrrrrrrs &" "TTvG '   mMm`-B]-B`W W ts s lz (% (  6         5 r