Ic!dZddlZddlZ ddlZ ejdpejdZn$#e$rZdej vrdZndZYdZ[n dZ[wdZYnxYw ej epdn#e $rdZYnwxYw#e $rdZYnwxYwej dkreZGdd eZGd d eZGd d eZdS)u Provisional module to handle Exceptions across Python versions. This module will be deprecated with the end of support for Python 2.7 and be removed in Docutils 1.2. Error reporting should be safe from encoding/decoding errors. However, implicit conversions of strings and exceptions like >>> u'%s world: %s' % ('Hällo', Exception(u'Hällo') fail in some Python versions: * In Python <= 2.6, ``unicode()`` uses `__str__` and fails with non-ASCII chars in`unicode` arguments. (work around http://bugs.python.org/issue2517): * In Python 2, unicode() fails, with non-ASCII chars in arguments. (Use case: in some locales, the errstr argument of IOError contains non-ASCII chars.) * In Python 2, str() fails, with non-ASCII chars in `unicode` arguments. The `SafeString`, `ErrorString` and `ErrorOutput` classes handle common exceptions. Nzunknown locale: UTF-8zUTF-8rc*eZdZdZ ddZdZdZdS) SafeStringzG A wrapper providing robust conversion to `str` and `unicode`. Nbackslashreplacereplacecr||_|pt|ddptpd|_||_||_dS)Nencodingascii)datagetattrlocale_encodingr encoding_errorsdecoding_errors)selfrr rrs >lib/python3.11/site-packages/docutils/utils/error_reporting.py__init__zSafeString.__init__RsL !4WT:t%D%D4(4,3 ..c tjS#t$rtjtr/fdjjD}d|cYStjtr@tj dkr jcYSj j j cYSwxYw)Nc `g|]*}tt|jj+S)strrr r.0argrs r z&SafeString.__str__..`sK333JsDM(,(<>>??333r, r) rrUnicodeEncodeError isinstance Exceptionargsjoinunicodesys version_infoencoder r)rr#s` r__str__zSafeString.__str__[s ty>> !!   $)Y// '3333#'9>333yy&&&$)W-- B#f,B9$$$9++DM,0,@BBBBB  sAC*1C%CCc  tj}tjtr|dd}|S#t $r}tjtradjjdtjjj j dtjj j j dcYd}~Stjtr2fdjj D}d|cYd}~St|tr%tjj j cYd}~Sd}~wwxYw) af Return unicode representation of `self.data`. Try ``unicode(self.data)``, catch `UnicodeError` and * if `self.data` is an Exception instance, work around http://bugs.python.org/issue2517 with an emulation of Exception.__unicode__, * else decode with `self.encoding` and `self.decoding_errors`. z: u'z: 'z[Errno z] 'Nc bg|]+}tt|jj,S))r)r%rr rrs rrz*SafeString.__unicode__..sU333 3 ,0,@!B!B!BCC333rr)r%rr!EnvironmentErrorr UnicodeErrorerrnorstrerrorr rfilenamer"r#r$UnicodeDecodeError)ruerrorr#s` r __unicode__zSafeString.__unicode__ls  ""A$)%566 -IIfe,,H   $)%566 6 626)///ty14=#35555ty14=#355556666666 $)Y// (3333#'9>333zz$''''''''%!344 Oty$-9MNNNNNNNN  s>AA EA5E EAEE4EEEE)Nr r )__name__ __module__ __qualname____doc__rr)r5rrrrrMsY=O!*////"rrc,eZdZdZfdZfdZxZS) ErrorStringz3 Safely report exception type and message. cz|jjjdtt|SNz: )r __class__r6superr;r)rr>s rr)zErrorString.__str__s<9.777!+t44<<>>>@ @rcz|jjjdtt|Sr=)rr>r6r?r;r5r@s rr5zErrorString.__unicode__s< I/888!+t44@@BBBD Dr)r6r7r8r9r)r5 __classcell__)r>s@rr;r;si@@@@@DDDDDDDDDrr;c,eZdZdZ ddZdZdZdS) ErrorOutputz Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. Nr r c~| tj}nt|sd}not|trt |d}nIt|t r4t |tjd}||_ |pt|ddptpd|_ ||_ ||_ dS)a :Parameters: - `stream`: 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`: `stream` text encoding. Guessed if None. - `encoding_errors`: how to treat encoding errors. NFwr r )r&stderrr!ropenr%r(getfilesystemencodingstreamrrr rr)rrJr rrs rrzErrorOutput.__init__s  KZFF KFF  $ $ K&#&&FF  ( ( K&--(A(C(CDDcJJF +!4WVZ%F%F4(4,3 ,.%.%%rc |jdurdSt|tr.tt ||j|j|j} |j|dS#t$r<|j| |j|jYdSt$rt|tr;|j| |j|jYdS|jtj tjfvr"|jj|YdS|jt||j|jYdSwxYw)z Write `data` to self.stream. Ignore, if self.stream is False. `data` can be a `string`, `unicode`, or `Exception` instance. FN)rJr!r"r%rr rrwriter r( TypeErrorr&rGstdoutbuffer)rrs rrLzErrorOutput.writes ;%   F dI & & O:dDM"&"68LNNOOD A K  d # # # # #! P P P K  dkk$-9MNN O O O O O O A A A$((  !!$++dm.2.B#D#DEEE{sz3:66 A "((...... !!'$ *.*>#@#@AAAAAA As&A,,AF1AF >F 3FFc|jtjtjfvrdS |jdS#t $rYdSwxYw)z Close the error-output stream. Ignored if the stream is` sys.stderr` or `sys.stdout` or has no close() method. N)rJr&rNrGcloseAttributeError)rs rrQzErrorOutput.closesb ;3:sz2 2  F  K           DD s> A  A )NNr r )r6r7r8r9rrLrQrrrrDrDs_ .2!3!*!&!&!&!&FAAA4     rrD)r9codecsr&locale getlocalegetdefaultlocaler ValueErrorr4r#lookup LookupError ImportErrorr'rr%objectrr;rDrrrr\s8 MMM *&*,,Q/O3J63J3L3LQ3O ### #ej 0 #%OO"O o+,,,, 'OOO.vG>>>>>>>>@ D D D D D* D D DPPPPP&PPPPPs8B*<AAA!A44A>=A>B  B