U [Sh@sndZddlZddlZddlmZejdeddejdkr>e Z Gdd d Z Gd d d e Z Gd d d Z dS)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@s*eZdZdZd ddZddZd d ZdS) SafeStringzG A wrapper providing robust conversion to `str` and `unicode`. NbackslashreplacereplacecCs0||_|pt|ddptpd|_||_||_dS)Nencodingascii)datagetattrlocale_encodingr encoding_errorsdecoding_errors)selfr r rrrQ/root/rtd-docs/venv/lib/python3.8/site-packages/docutils/utils/error_reporting.py__init__CszSafeString.__init__csz tjWStk rtjtrLfddjjD}d|YStjtrtj dkrljYSj j j YSYnXdS)Ncs g|]}tt|jjqSr)strrr r.0argrrr Ps z&SafeString.__str__.., r) rr UnicodeEncodeError isinstance Exceptionargsjoinunicodesys version_infoencoder r)rrrrr__str__Ks       zSafeString.__str__c sz(tj}tjtr$|dd}|WStk r}ztjtrdjjtjjj j tjj j j fWY`Stjt rfddjj D}d|WY,St|trtjj j WYSW5d}~XYnXdS)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 %s] %s: '%s'cs"g|]}tt|jjdqS))r)r!rr rrrrrrvs z*SafeString.__unicode__..rN)r!r rEnvironmentErrorr UnicodeErrorerrnorstrerrorr rfilenamerrr UnicodeDecodeError)ruerrorrrrr __unicode__\s0          zSafeString.__unicode__)Nrr )__name__ __module__ __qualname____doc__rr%r.rrrrr>s  rcs,eZdZdZfddZfddZZS) ErrorStringz3 Safely report exception type and message. csd|jjjtt|fSNz%s: %s)r __class__r/superr3r%rr5rrr%s  zErrorString.__str__csd|jjjtt|fSr4)r r5r/r6r3r.rr7rrr.s  zErrorString.__unicode__)r/r0r1r2r%r. __classcell__rrr7rr3s r3c@s*eZdZdZd ddZddZd d ZdS) ErrorOutputz Wrapper class for file-like error streams with failsafe de- and encoding of `str`, `bytes`, `unicode` and `Exception` instances. Nrr cCs~|dkrtj}n>|sd}n4t|tr0t|d}nt|trNt|td}||_|pjt |ddpjt pjd|_ ||_ ||_ 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"stderrrropenr!r$getfilesystemencodingstreamr rr rr)rr>r rrrrrrs"    zErrorOutput.__init__c Cs|jdkrdSt|tr0tt||j|j|j}z|j|Wnt k rl|j| |j|jYnvt k rt|tr|j| |j|jYdS|jt j t jfkr|jj|n|jt||j|jYnXdS)z Write `data` to self.stream. Ignore, if self.stream is False. `data` can be a `string`, `unicode`, or `Exception` instance. FN)r>rrr!rr rrwriterr$ TypeErrorr"r;stdoutbuffer)rr rrrr?s,    zErrorOutput.writecCs>|jtjtjfkrdSz|jWntk r8YnXdS)z Close the error-output stream. Ignored if the stream is` sys.stderr` or `sys.stdout` or has no close() method. N)r>r"rAr;closeAttributeErrorrrrrrCs zErrorOutput.close)NNrr )r/r0r1r2rr?rCrrrrr9s #r9)r2r"warningsZ docutils.iorrwarnDeprecationWarningr#rr!rr3r9rrrr s"  B