dddZddlZddlZddlmZej dedejdk\re Z Gdd Z Gd d e Z Gd d Z y)u9 Deprecated module to handle Exceptions across Python versions. .. warning:: This module is deprecated with the end of support for Python 2.7 and will be removed in Docutils 0.21 or later. Replacements: | SafeString -> str | ErrorString -> docutils.io.error_string() | ErrorOutput -> docutils.io.ErrorOutput 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. N)_locale_encodingzThe `docutils.utils.error_reporting` module is deprecated and will be removed in Docutils 0.21 or later. Details with help("docutils.utils.error_reporting").) stacklevelrc(eZdZdZ ddZdZdZy) SafeStringzG A wrapper providing robust conversion to `str` and `unicode`. Ncr||_|xst|ddxs txsd|_||_||_y)Nencodingascii)datagetattrlocale_encodingr encoding_errorsdecoding_errors)selfr r rrs @/usr/lib/python3/dist-packages/docutils/utils/error_reporting.py__init__zSafeString.__init__CsC !7WT:t%D7+7/6 ..c   t|jS#t$rt|jtrd|jj Dcgc],}tt ||j|j.ncc}w}}dj|cYSt|jtrStjdkDr|jcYS|jj|j|jcYSwxYw)N, r)strr UnicodeEncodeError isinstance Exceptionargsr r rjoinunicodesys version_infoencode)rargrs r__str__zSafeString.__str__Ks tyy> !! $))Y/$(99>>3JsDMM'+';';=>333yy&$))W-##f,99$99++DMM,0,@,@BB  s';D 1BD 9D 0D  D c ~ t|j}t|jtr|j dd}|S#t $rm}t|jtrd|jj dt|jj|j|jdt|jj|j|jdcYd}~St|jtrh|jjDcgc]-}tt||j|j/ncc}w}}dj|cYd}~St|tr0t|j|j|jcYd}~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] 'N)rr)rr rEnvironmentErrorreplace UnicodeErrorerrnor strerrorr rfilenamerrrUnicodeDecodeError)ruerrorr"rs r __unicode__zSafeString.__unicode__\sM  "A$))%56IIfe,H $))%56IIOOtyy114==#335tyy114==#335 66 $))Y/$(99>>3  $'484H4H!JK333zz$''%!34tyy$--9M9MNN ! sIAA F<BF7.F<42F7&2EF70F<6:F70F<6F77F<)Nbackslashreplacer')__name__ __module__ __qualname____doc__rr#r/rrr r >s=O!*/"!rr c,eZdZdZfdZfdZxZS) ErrorStringz3 Safely report exception type and message. cn|jjjdtt|SNz: )r __class__r1superr7r#rr:s rr#zErrorString.__str__s-99..77 d;=? ?rcn|jjjdtt|Sr9)r r:r1r;r7r/r<s rr/zErrorString.__unicode__s/ II//88!+t@BD Dr)r1r2r3r4r#r/ __classcell__)r:s@rr7r7s?DDrr7c*eZdZdZ ddZdZdZy) ErrorOutputz Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. Nc\|tj}n_|sd}nZt|tr t |d}n=t|t r-t |j tjd}||_ |xst|ddxs txsd|_ ||_ ||_ y)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 )rstderrrropenrr!getfilesystemencodingstreamrrr rr)rrFr rrs rrzErrorOutput.__init__s >ZZFF  $&#&F  (&--(A(A(CDcJF +!7WVZ%F7+7/6 ,.%.%rcP|jduryt|tr5tt ||j |j |j} |jj|y#t$rB|jj|j|j |j Yyt$rt|trA|jj|j|j |j Yy|jtjtjfvr'|jjj|Yy|jjt||j |jYywxYw)z Write `data` to self.stream. Ignore, if self.stream is False. `data` can be a `string`, `unicode`, or `Exception` instance. FN)rFrrrr r rrwriterr! TypeErrorrrCstdoutbuffer)rr s rrHzErrorOutput.writes9 ;;%   dI &:dDMM&*&:&:&*&:&:<=D A KK  d #! P KK  dkk$--9M9MN O A$( !!$++dmm.2.B.B#DE{{szz3::66 ""((. !!'$ *.*>*>#@A As'A22AF%rSsk D ;  E!Q0 vG??D D* DQQr