B ûgÅbSã @s¼dZdZddlZddlZddlZddlZddlZddlZddlm Z y$e  ¡dp\e  ¡dZ e   ¡Z WnDek ržZzdejkrŠdZ ndZ WddZ[XYndZ YnXye e ¡Wneefk rØdZ YnXGdd „d eƒZGd d „d eƒZd d „Zdd„ZGdd„de ƒZGdd„de ƒZGdd„dƒZGdd„deƒZGdd„deƒZGdd„deƒZGdd„deƒZGdd„deƒZ Gd d!„d!eƒZ!Gd"d#„d#eƒZ"Gd$d%„d%eƒZ#dS)&z I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms. ZreStructuredTextéN)Ú TransformSpecézunknown locale: UTF-8zutf-8c@s eZdZdS)Ú InputErrorN)Ú__name__Ú __module__Ú __qualname__©rrú*lib/python3.7/site-packages/docutils/io.pyr0src@s eZdZdS)Ú OutputErrorN)rrrrrrr r 1sr c Cs6yt |j¡t |¡kStttfk r0dSXdS)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)ÚcodecsÚlookupÚencodingÚ LookupErrorÚAttributeErrorÚ TypeError)Ústreamr rrr Úcheck_encoding4s rcCs|jj›d|›S)z5Return string representation of Exception `err`. z: )Ú __class__r)Úerrrrr Ú error_stringDsrc@speZdZdZdZdZddd„Zdd„Zd d „Zd d „Z e   d ¡Z e jdfe jdfe jdffZdd„Zdd„ZdS)ÚInputz1 Abstract base class for input wrappers. ÚinputNÚstrictcCs.||_||_||_||_|s$|j|_d|_dS)N)r Ú error_handlerÚsourceÚ source_pathÚdefault_source_pathÚsuccessful_encoding)Úselfrrr rrrr Ú__init__TszInput.__init__cCsd|j|j|jfS)Nz%s: source=%r, source_path=%r)rrr)rrrr Ú__repr__hs zInput.__repr__cCst‚dS)N)ÚNotImplementedError)rrrr Úreadlsz Input.readc Cs|jr&|j ¡dkr&t|tƒs&tdƒ‚t|tƒr4|S|jrD|jg}n<| |¡}|rZ|g}n&dg}trvtdkrv| t¡| d¡xX|D]P}y t|||jƒ}||_ |  dd¡St t fk rÔ}z|}Wdd}~XYq†Xq†Wt dd   d d „|Dƒ¡›d t|ƒ›d ƒ‚dS)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, locale encoding, and (as last ressort) 'latin-1'. The client application should call ``locale.setlocale`` at the beginning of processing:: locale.setlocale(locale.LC_ALL, '') Raise UnicodeError if unsuccessful. Úunicodez;input encoding is "unicode" but input is not a `str` objectzutf-8zlatin-1uÚNz=Unable to decode input data. Tried the following encodings: z, css|]}t|ƒVqdS)N)Úrepr)Ú.0Úencrrr ú ¥szInput.decode..z. (ú))r ÚlowerÚ isinstanceÚstrÚAssertionErrorÚdetermine_encoding_from_dataÚ_locale_encodingÚappendrrÚreplaceÚ UnicodeErrorrÚjoinr)rÚdataZencoding_candidatesÚ data_encodingr'ZdecodedrÚerrorrrr Údecodeos,        z Input.decodescoding[:=]\s*([-\w.]+)zutf-8z utf-16-bez utf-16-lecCs`x |jD]\}}| |¡r|SqWx8| ¡dd…D]$}|j |¡}|r4| d¡ d¡Sq4WdS)z— Try to determine the encoding of `data` by looking *in* `data`. Check for a byte order mark (BOM) or an encoding declaration. NérÚascii)Úbyte_order_marksÚ startswithÚ splitlinesÚ coding_slugÚsearchÚgroupr7)rr4Z start_bytesr ÚlineÚmatchrrr r.³s  z"Input.determine_encoding_from_datacCs$y |j ¡Stk rdSXdS)NF)rÚisattyr)rrrr rBÃs z Input.isatty)NNNr)rrrÚ__doc__Úcomponent_typerrr r"r7ÚreÚcompiler=r ÚBOM_UTF8Ú BOM_UTF16_BEÚ BOM_UTF16_LEr:r.rBrrrr rJs :  rc@s:eZdZdZdZdZd dd„Zdd„Zd d „Zd d „Z dS)ÚOutputz2 Abstract base class for output wrappers. ÚoutputNrcCs,||_|p d|_||_||_|s(|j|_dS)Nr)r rÚ destinationÚdestination_pathÚdefault_destination_path)rrLrMr rrrr rÔs  zOutput.__init__cCsd|j|j|jfS)Nz'%s: destination=%r, destination_path=%r)rrLrM)rrrr r åszOutput.__repr__cCst‚dS)z;`data` is a Unicode string, to be encoded by `self.encode`.N)r!)rr4rrr Úwriteész Output.writecCsL|jr*|j ¡dkr*t|tƒs&tdƒ‚|St|tƒs8|S| |j|j¡SdS)Nr#zFthe encoding given is "unicode" but the output is not a Unicode string)r r*r+r,r-Úencoder)rr4rrr rPís  z Output.encode)NNNr) rrrrCrDrNrr rOrPrrrr rJÊs rJc@s2eZdZdZd dd„Zdd„Zd d „Zd d „ZdS)Ú ErrorOutputz’ Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. NÚbackslashreplacer1cCs^|dkrtj}n|sd}nt|tƒr.t|dƒ}||_|pJt|ddƒpJtpJd|_||_ ||_ dS)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. NFÚwr r9) ÚsysÚstderrr+r,ÚopenrLÚgetattrr/r Úencoding_errorsÚdecoding_errors)rrLr rXrYrrr rs    zErrorOutput.__init__c CsÎ|js dSt|tƒrt|ƒ}y|j |¡Wnœtk rX|j | |j|j¡¡Ynrt k rÈt|tƒrŠ|j | |j|j¡¡n:|jt j t j fkr¬|jj  |¡n|j t||j|jƒ¡YnXdS)z› Write `data` to self.destination. Ignore, if self.destination is False. `data` can be a `bytes`, `str`, or `Exception` instance. N)rLr+Ú Exceptionr,rOÚUnicodeEncodeErrorrPr rXrrTrUÚstdoutÚbufferrY)rr4rrr rO"s"   zErrorOutput.writecCs>|jtjtjfkrdSy|j ¡Wntk r8YnXdS)z– Close the error-output stream. Ignored if the destination is` sys.stderr` or `sys.stdout` or has no close() method. N)rLrTr\rUÚcloser)rrrr r^<s zErrorOutput.closecCs$y |j ¡Stk rdSXdS)NF)rLrBr)rrrr rBJs zErrorOutput.isatty)NNrRr1)rrrrCrrOr^rBrrrr rQús rQc@s2eZdZdZddd„Zdd „Zd d „Zd d „ZdS)Ú FileInputz5 Input for single, simple file-like objects. NrTÚrc CsÞt |||||¡||_tƒ|_|dkrŠ|r€yt|||jpttfk r*}ztd |jt|ƒfƒ‚Wdd}~XYnXWd|jr@| ¡X|S) zÐEncode `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. rvFrkó r9z;Encoding of %s (%s) differs from specified encoding (%s)rLNz:Unable to encode output data. output-encoding is: %s. (%s))rprVrirrLr rPÚosÚlinesepr1ÚbytesrOrr+r]rÚ ValueErrorrMr2rrrbr^)rr4rrrr rOës:     ( zFileOutput.writecCs&|jtjtjfkr"|j ¡d|_dS)NF)rLrTr\rUr^rp)rrrr r^s zFileOutput.close)NNNrTNN) rrrrCrirrVrOr^rrrr rm¢s -(rmc@seZdZdZdZdS)ÚBinaryFileOutputzL A version of docutils.io.FileOutput which writes to a binary file. ÚwbN)rrrrCrirrrr r}sr}c@seZdZdZdZdd„ZdS)Ú StringInputz Direct string input. zcCs | |j¡S)z$Decode and return the source string.)r7r)rrrr r"*szStringInput.readN)rrrrCrr"rrrr r"src@seZdZdZdZdd„ZdS)Ú StringOutputz Direct string output. zcCs| |¡|_|jS)z=Encode `data`, store it in `self.destination`, and return it.)rPrL)rr4rrr rO7s zStringOutput.writeN)rrrrCrNrOrrrr r€/sr€c@seZdZdZdZdd„ZdS)Ú NullInputz) Degenerate input: read nothing. z null inputcCsdS)zReturn a null string.r$r)rrrr r"EszNullInput.readN)rrrrCrr"rrrr r=src@seZdZdZdZdd„ZdS)Ú NullOutputz+ Degenerate output: write nothing. z null outputcCsdS)z6Do nothing ([don't even] send data to the bit bucket).Nr)rr4rrr rORszNullOutput.writeN)rrrrCrNrOrrrr r‚Jsr‚c@seZdZdZdZdd„ZdS)Ú DocTreeInputzm Adapter for document tree input. The document tree must be passed in the ``source`` parameter. z doctree inputcCs|jS)zReturn the document tree.)r)rrrr r"aszDocTreeInput.readN)rrrrCrr"rrrr rƒWsrƒ)$rCZ __docformat__r ZlocaleryrErTrqZdocutilsrZ getlocaleZgetdefaultlocaler/r*r|r6Úargsr rrrdrr rrrrJrQr_rmr}rr€rr‚rƒrrrr ÚsJ     0WQw