r8Sy d Z ddlZddlZddlmZ ej ded ej dk re Z
G d d Z G d
d e Z G 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"). )
stacklevel r c * e Zd ZdZ ddZd Zd ZdS )
SafeStringzG
A wrapper providing robust conversion to `str` and `unicode`.
Nbackslashreplacereplacec r || _ |pt |dd pt pd| _ || _ || _ d S )Nencodingascii)datagetattrlocale_encodingr
encoding_errorsdecoding_errors)selfr r
r r s ~/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/docutils/utils/error_reporting.py__init__zSafeString.__init__C sL ! 7WT:t%D%D 7 +7/6
. . c t j S # t $ r t j t r/ fd j j D }d | cY S t j t r@t j dk r j cY S j
j j cY S w xY w)Nc ` g | ]*}t t |j j +S )strr r
r .0argr s r
z&SafeString.__str__..P sK 3 3 3 JsDM'+'; = = > > 3 3 3r , r )
r r UnicodeEncodeError
isinstance Exceptionargsjoinunicodesys version_infoencoder
r )r r$ s ` r __str__zSafeString.__str__K s ty>> !! $)Y//
'3 3 3 3#'9>3 3 3 yy&&&$)W--
B#f,, 9$$$ 9++DM,0,@ B B B B B s AC*1C %CCc t j }t j t r| dd }|S # t
$ r}t j t rad j j dt j j j j
dt j j j j
dcY d}~S t j t r2 fd j j
D }d | cY d}~S t |t r%t j j j
cY d}~S d}~ww xY w) 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 b g | ]+}t t |j j ,S ))r )r& r r
r r s r r z*SafeString.__unicode__..v sX 3 3 3
$' 484H!J !J !J K K 3 3 3r r )r& r r" EnvironmentErrorr UnicodeErrorerrnor strerrorr
r filenamer# r$ r% UnicodeDecodeError)r uerrorr$ s ` r __unicode__zSafeString.__unicode__\ s ""A$)%566
-IIfe,,H $)%566
6
6IOOO ty 14= # 35 5 5 5 ty 14= # 35 5 5 5 6 6 6 6 6 6 6 $)Y//
(3 3 3 3 $(9>3 3 3 zz$''''''''%!344
O ty$-9MNNNNNNNN ! s> AA EA5E EAEE4EEEE)Nr
r )__name__
__module__ __qualname____doc__r r* r6 r r r r r > sY =O!*/ / / / "! ! ! ! !r r c , e Zd ZdZ fdZ fdZ xZS ) ErrorStringz3
Safely report exception type and message.
c z | j j j dt t | S Nz: )r __class__r7 superr< r* r r? s r r* zErrorString.__str__ s: 9.777 d33;;===? ?r c z | j j j dt t | S r> )r r? r7 r@ r< r6 rA s r r6 zErrorString.__unicode__ s< I / 8 8 8 !+t 4 4 @ @ B B BD Dr )r7 r8 r9 r: r* r6
__classcell__)r? s @r r< r< sd ? ? ? ? ?D D D D D D D D Dr r< c , e Zd ZdZ ddZd Zd ZdS ) ErrorOutputz
Wrapper class for file-like error streams with
failsafe de- and encoding of `str`, `bytes`, `unicode` and
`Exception` instances.
Nr
r c ~ |
t j }nt|sd}not |t rt |d }nIt |t
r4t | t j d }|| _ |pt |dd pt pd| _ || _ || _
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" r openr& r) getfilesystemencodingstreamr r r
r r )r rK r
r r s r r zErrorOutput.__init__ s >ZFF KFF
$
$ K&#&&FF
(
( K&--(A(C(CDDcJJF +! 7WVZ%F%F 7 +7/6
, . % . %%r c
| j du rdS t |t r.t t || j | j | j } | j | dS # t $ r< | j |
| j | j Y dS t $ r t |t r;| j |
| j | j Y dS | j t j
t j fv r"| j j | Y dS | j t || j | j Y dS w xY w)z
Write `data` to self.stream. Ignore, if self.stream is False.
`data` can be a `string`, `unicode`, or `Exception` instance.
FN)rK r" r# r& r r
r r writer! r) TypeErrorr' rH stdoutbuffer)r r s r rM zErrorOutput.write s ;% F dI & & =:dDM&*&:&*&: < < = =D
A K d # # # # #! P P P K dkk$-9M N N O O O O O O A A A$((
!!$++dm.2.B#D #D E E E{sz3: 666 "((...... !!'$
*.*>#@ #@ A A A A A A As& A, ,AF1AF
>F 3FFc | j t j t j fv rdS | j dS # t
$ r Y dS w xY w)z
Close the error-output stream.
Ignored if the stream is` sys.stderr` or `sys.stdout` or has no
close() method.
N)rK r' rO rH closeAttributeError)r s r rR zErrorOutput.close s` ;3:sz2 2 2 F K DD s >
A A )NNr
r )r7 r8 r9 r: r rM rR r r r rE rE s_ .2!3!*!& !& !& !&FA A A6 r rE )r: r' warnings docutils.ior r warnDeprecationWarningr( r r& r r< rE r r r rX s
D
; ; ; ; ; ;
E !Q0 0 0 0 v G? ? ? ? ? ? ? ?D
D
D
D
D
D*
D
D
DQ Q Q Q Q Q Q Q Q Qr