a mߛ`A@s.dZddlmZdZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z ejdkrbeZGdd d eZGd d d eZd d ZGddde ZGddde ZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGd d!d!eZdS)"z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. )print_functionZreStructuredTextN) TransformSpec)locale_encoding ErrorString ErrorOutputrc@s eZdZdS) InputErrorN__name__ __module__ __qualname__rr*lib/python3.9/site-packages/docutils/io.pyr r c@s eZdZdS) OutputErrorNr rrrrrrrc Cs8zt|jt|kWStttfy2YdS0dS)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)streamrrrrcheck_encodings rc@sheZdZdZdZdZdddZddZd d Zd d Z e d Z e jdfe jdfe jdffZddZdS)Inputz1 Abstract base class for input wrappers. inputNstrictcCs.||_||_||_||_|s$|j|_d|_dSN)r error_handlersource source_pathdefault_source_pathsuccessful_encoding)selfrr rrrrr__init__5szInput.__init__cCsd|j|j|jfS)Nz%s: source=%r, source_path=%r) __class__rr r#rrr__repr__Is zInput.__repr__cCstdSrNotImplementedErrorr&rrrreadMsz Input.readc Cs|jr&|jdkr&t|ts&Jdt|tr4|S|jrD|jg}n.||}|rZ|g}nddg}trr|dt|D]X}z&t|||j}||_| ddWSt t fy}z|}WYd}~qvd}~00qvt d d d d |Dt |fdS) 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-1uNzEUnable to decode input data. Tried the following encodings: %s. (%s)z, cSsg|] }t|qSr)repr).0encrrr }rz Input.decode..)rlower isinstancer+determine_encoding_from_datarinsertrr"replace UnicodeErrorrjoinr)r#dataZ encodings data_encodingr1ZdecodederrerrorrrrdecodePs8      z Input.decodescoding[:=]\s*([-\w.]+)r,z utf-16-bez utf-16-lecCs`|jD]\}}||r|Sq|ddD](}|j|}|r2|ddSq2dS)z Try to determine the encoding of `data` by looking *in* `data`. Check for a byte order mark (BOM) or an encoding declaration. Nr-ascii)byte_order_marks startswith splitlines coding_slugsearchgroupr>)r#r:Z start_bytesrlinematchrrrr5s   z"Input.determine_encoding_from_data)NNNr)r r r __doc__component_typer!r$r'r*r>recompilerDrBOM_UTF8 BOM_UTF16_BE BOM_UTF16_LErAr5rrrrr+s 0 rc@s:eZdZdZdZdZd ddZddZd d Zd d Z dS)Outputz2 Abstract base class for output wrappers. outputNrcCs,||_|p d|_||_||_|s(|j|_dS)Nr)rr destinationdestination_pathdefault_destination_path)r#rRrSrrrrrr$s  zOutput.__init__cCsd|j|j|jfS)Nz'%s: destination=%r, destination_path=%r)r%rRrSr&rrrr'szOutput.__repr__cCstdS)z;`data` is a Unicode string, to be encoded by `self.encode`.Nr(r#r:rrrwritesz Output.writecCsL|jr*|jdkr*t|ts&Jd|St|ts8|S||j|jSdS)Nr+zFthe encoding given is "unicode" but the output is not a Unicode string)rr3r4r+encoderrUrrrrWs  z Output.encode)NNNr) r r r rIrJrTr$r'rVrWrrrrrPs rPc@sLeZdZdZdddddejdkr$dndfdd Zd d Zd d ZddZ dS) FileInputz5 Input for single, simple file-like objects. NrTrrZrUc Cst|||||||_t|_|dur|rtjdkrF|j|jd}ni}zt ||fi||_ Wqt y}zt |j |j|WYd}~qd}~00qtj|_ n2tjdkrt|j |jdurtd|j|j jf|sz|j j|_WntyYn0dS)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. NrrerrorsFzOEncoding clash: encoding given is "%s" but source is opened with encoding "%s".)rr$ autocloser_stderrsys version_inforropenrIOErrorr errnostrerrorstdinrr8namer r) r#rr rrr\modekwargsr=rrrr$s4 (    zFileInput.__init__c CszzD|jtjur:tjdkr:|jj}d|d}n |j}Wnftt fy}zJ|j s|j rt |j d}|}| d|d}nWYd}~n d}~00W|jr| n|jr| 0||S)zU Read and decode a single file and return the data (Unicode string). r rbN)rr^rdr_bufferr*r9rCr8rrr r`closer\r>)r#r:r<Zb_sourcerrrr*s"     zFileInput.readcCs|dS)zK Return lines of a single file as list of Unicode strings. T)r*rCr&rrr readlinesszFileInput.readlinescCs|jtjur|jdSr)rr^rdrkr&rrrrk s zFileInput.close) r r r rIr^r_r$r*rlrkrrrrrXs /rXc@s6eZdZdZdZdddZdd Zd d Zd d ZdS) FileOutputz6 Output for single, simple file-like objects. wNrTcCst|||||d|_||_|dur,||_t|_|durR|rHd|_qtj|_ n6|rt |j dr||j jkrt d|j j|f|jd|sz|j j |_ WntyYn0dS)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. TNFrfz?Warning: Destination mode "%s" differs from specified mode "%s")file)rPr$openedr\rfrr]r^stdoutrRhasattrprintrerSr)r#rRrSrrr\Zhandle_io_errorsrfrrrr$1s8      zFileOutput.__init__c Cstjdkr$d|jvr$|j|jd}ni}zt|j|jfi||_Wn6tyz}zt |j |j |jWYd}~n d}~00d|_ dS)NrbrZT) r^r_rfrrr`rSrRrarrbrcrp)r#rgr=rrrr`\s zFileOutput.openc Csx|js|d|jvr"tjdks4t|j|jdurf||}tjdkrft j dkrf| dt t j d}zz|j |Wnty}z|tjdkrt|t rz|jj |WnHtyt|j|jdurtd|jpd|jj|jfn|Yn0WYd }~nHd }~0ttfyL}z"td |jt|fWYd }~n d }~00W|jrt|n|jrr|0|S) 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. rtrF rhr@z;Encoding of %s (%s) differs from specified encoding (%s)rRNz:Unable to encode output data. output-encoding is: %s. (%s))rpr`rfr^r_rrRrrWoslinesepr7bytesrVrr4rjr ValueErrorrSr8rrr\rk)r#r:r<rrrrVjsJ      zFileOutput.writecCs&|jtjtjfvr"|jd|_dS)NF)rRr^rqstderrrkrpr&rrrrks zFileOutput.close)NNNrTNN) r r r rIrfr$r`rVrkrrrrrm%s +'rmc@seZdZdZdZdS)BinaryFileOutputzL A version of docutils.io.FileOutput which writes to a binary file. wbN)r r r rIrfrrrrr{sr{c@seZdZdZdZddZdS) StringInputz Direct string input. cCs ||jS)z$Decode and return the source string.)r>rr&rrrr*szStringInput.readNr r r rIr!r*rrrrr}sr}c@seZdZdZdZddZdS) StringOutputz Direct string output. r~cCs|||_|jS)z=Encode `data`, store it in `self.destination`, and return it.)rWrRrUrrrrVs zStringOutput.writeNr r r rIrTrVrrrrrsrc@seZdZdZdZddZdS) NullInputz) Degenerate input: read nothing. z null inputcCsdS)zReturn a null string.r.rr&rrrr*szNullInput.readNrrrrrrsrc@seZdZdZdZddZdS) NullOutputz+ Degenerate output: write nothing. z null outputcCsdS)z6Do nothing ([don't even] send data to the bit bucket).NrrUrrrrVszNullOutput.writeNrrrrrrsrc@seZdZdZdZddZdS) DocTreeInputzm Adapter for document tree input. The document tree must be passed in the ``source`` parameter. z doctree inputcCs|jS)zReturn the document tree.)rr&rrrr*szDocTreeInput.readNrrrrrrsr)rIZ __future__rZ __docformat__r^rvrKrZdocutilsrZdocutils.utils.error_reportingrrrr_strr+rar rrrrPrXrmr{r}rrrrrrrrs.   p0Zr