| Server IP : 3.96.16.70 / Your IP : 216.73.216.15 Web Server : Apache System : Linux ip-172-31-26-103.ca-central-1.compute.internal 6.1.163-186.299.amzn2023.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Feb 24 16:35:42 UTC 2026 x86_64 User : ec2-user ( 1000) PHP Version : 8.4.18 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python3.9/site-packages/docutils/__pycache__/ |
Upload File : |
a
�?�]}A � @ s. d Z ddlmZ dZddlZddlZddlZddlZddlm Z ddl
m Z m Z m
Z
ejdkrbeZG dd � d e�ZG d
d � d e�Zd d
� ZG dd� de �ZG dd� de �ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG d d � d e�Z G d d � d e�Z G d 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.
� )�print_functionZreStructuredTextN)�
TransformSpec)�locale_encoding� ErrorString� ErrorOutput�� r c @ s e Zd ZdS )�
InputErrorN��__name__�
__module__� __qualname__� r r �//usr/lib/python3.9/site-packages/docutils/io.pyr � r c @ s e Zd ZdS )� OutputErrorNr
r r r r r r r c
C s8 zt �| j�t �|�kW S tttfy2 Y dS 0 dS )aN Test, 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 r r r �check_encoding s
r c @ sh e Zd ZdZdZdZddd�Zdd� Zd d
� Zd d � Z e
� d
�Z e
jdfe
jdfe
jdffZdd� ZdS )�Inputz1
Abstract base class for input wrappers.
�inputN�strictc C s. || _ || _|| _|| _|s$| j| _d | _d S �N)r �
error_handler�source� source_path�default_source_path�successful_encoding)�selfr r r r r r r �__init__5 s zInput.__init__c C s d| j | j| jf S )Nz %s: source=%r, source_path=%r)� __class__r r �r# r r r �__repr__I s
�zInput.__repr__c C s t �d S r ��NotImplementedErrorr& r r r �readM s z
Input.readc C s� | j r| j �� dkrt|t�r"|S | j r2| j g}n.| �|�}|rH|g}nddg}tr`|�dt� |D ]X}z&t||| j�}|| _|� dd�W S t
t fy� } z|}W Y d}~qdd}~0 0 qdt
dd � d
d � |D ��t
|�f ��dS ) a
Decode a string, `data`, heuristically.
Raise UnicodeError if unsuccessful.
The client application should call ``locale.setlocale`` at the
beginning of processing::
locale.setlocale(locale.LC_ALL, '')
�unicode�utf-8zlatin-1� u � NzEUnable to decode input data. Tried the following encodings: %s.
(%s)z, c S s g | ] }t |��qS r )�repr)�.0�encr r r �
<listcomp>} r z Input.decode.<locals>.<listcomp>)r �lower�
isinstancer+ � determine_encoding_from_datar �insertr r" �replace� UnicodeErrorr �joinr )r# �dataZ encodings�
data_encodingr1 Zdecoded�err�errorr r r �decodeP s2
���z Input.decodes coding[:=]\s*([-\w.]+)r, z utf-16-bez utf-16-lec C s` | j D ]\}}|�|�r| S q|�� dd� D ](}| j�|�}|r2|�d��d� S q2dS )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�groupr> )r# r: Z start_bytesr �line�matchr r r r5 � s
z"Input.determine_encoding_from_data)NNNr )r r r
�__doc__�component_typer! r$ r' r* r> �re�compilerD r �BOM_UTF8� BOM_UTF16_BE� BOM_UTF16_LErA r5 r r r r r + s �
0
�r c @ s: e Zd ZdZdZdZd
dd�Zdd� Zd d
� Zd d � Z dS )�Outputz2
Abstract base class for output wrappers.
�outputNr c C s, || _ |p d| _|| _|| _|s(| j| _d S )Nr )r r � destination�destination_path�default_destination_path)r# rR rS r r r r r r$ � s
zOutput.__init__c C s d| j | j| jf S )Nz'%s: destination=%r, destination_path=%r)r% rR rS r& r r r r' � s �zOutput.__repr__c C s t �dS )z;`data` is a Unicode string, to be encoded by `self.encode`.Nr( �r# r: r r r �write� s z Output.writec C s: | j r| j �� dkr|S t|t�s&|S |�| j | j�S d S )Nr+ )r r3 r4 r+ �encoder rU r r r rW � s
z
Output.encode)NNNr )
r r r
rI rJ rT r$ r' rV rW r r r r rP � s �
rP c @ sL e Zd ZdZdddddejdkr$dndfdd �Zd
d � Zd d
� Zdd� Z dS )� FileInputz5
Input for single, simple file-like objects.
Nr Tr �rZrUc
C s t �| ||||� || _t� | _|du r�|r�tjdkrF| j| jd�}ni }zt ||fi |��| _
W q� t y� } z t |j
|j|��W Y d}~q�d}~0 0 q�tj| _
n2tjdkr�t| j
| j�du r�td| j| j
jf ��|s�z| j
j| _W n ty� Y n0 dS )a�
:Parameters:
- `source`: either a file-like object (which is read directly), or
`None` (which implies `sys.stdin` if no `source_path` given).
- `source_path`: a path to a file, which is opened and then read.
- `encoding`: the expected text encoding of the input file.
- `error_handler`: the encoding error handler to use.
- `autoclose`: close automatically after read (except when
`sys.stdin` is the source).
- `mode`: how the file is to be opened (see standard function
`open`). The default 'rU' provides universal newline support
for text files with Python 2.x.
Nr �r �errorsFzOEncoding clash: encoding given is "%s" but source is opened with encoding "%s".)r r$ � autocloser �_stderr�sys� version_infor r �openr �IOErrorr �errno�strerror�stdinr r8 �namer r ) r# r r r r r\ �mode�kwargsr= r r r r$ � s4
�(
� � zFileInput.__init__c
C s� z�zD| j tju r:tjdkr:| j j�� }d�|�� �d }n
| j �� }W nf tt fy� } zJ| j
s�| j r�t | j d�}|�� }|�
� d�|�� �d }n� W Y d}~n
d}~0 0 W | jr�| �
� n| jr�| �
� 0 | �|�S )zU
Read and decode a single file and return the data (Unicode string).
r �
�rbN)r r^ rd r_ �bufferr* r9 rC r8 r r r r` �closer\ r> )r# r: r< Zb_sourcer r r r* � s"
�
zFileInput.readc C s | � � �d�S )zK
Return lines of a single file as list of Unicode strings.
T)r* rC r& r r r � readlines s zFileInput.readlinesc C s | j tjur| j �� d S r )r r^ rd rk r& r r r rk s zFileInput.close)
r r r
rI r^ r_ r$ r* rl rk r r r r rX � s �
/rX c @ s6 e Zd ZdZdZddd�Zdd � Zd
d � Zd d
� ZdS )�
FileOutputz6
Output for single, simple file-like objects.
�wNr Tc C s� t �| ||||� d| _|| _|dur,|| _t� | _|du rR|rHd| _q�tj| _ n6|r�t
| j d�r�|| j jkr�t d| j j|f | jd� |s�z| j j | _
W n ty� Y n0 dS )aA
:Parameters:
- `destination`: either a file-like object (which is written
directly) or `None` (which implies `sys.stdout` if no
`destination_path` given).
- `destination_path`: a path to a file, which is opened and then
written.
- `encoding`: the text encoding of the output file.
- `error_handler`: the encoding error handler to use.
- `autoclose`: close automatically after write (except when
`sys.stdout` or `sys.stderr` is the destination).
- `handle_io_errors`: ignored, deprecated, will be removed.
- `mode`: how the file is to be opened (see standard function
`open`). The default is 'w', providing universal newline
support for text files.
TNFrf z?Warning: Destination mode "%s" differs from specified mode "%s")�file)rP r$ �openedr\ rf r r] r^ �stdoutrR �hasattr�printre rS r )r# rR rS r r r\ Zhandle_io_errorsrf r r r r$ 1 s8
�
�
�
�
�� zFileOutput.__init__c
C s� t jdkr$d| jvr$| j| jd�}ni }z t| j| jfi |��| _W n6 tyz } z t |j
|j | j��W Y d }~n
d }~0 0 d| _ d S )Nr �brZ T)
r^ r_ rf r r r` rS rR ra r rb rc rp )r# rg r= r r r r` \ s �
�zFileOutput.openc C sx | j s| �� d| jvr"tjdk s4t| j| j�du rf| �|�}tjdkrft j
dkrf|� dt t j
d��}z�z| j�
|� W n� t�y } z|tjdkr�t|t �r�z| jj�
|� W nH ty� t| j| j�du r�td| jp�d| jj| jf ��n|�Y n0 W Y d }~nHd }~0 ttf�yL } z"td
| jt|�f ��W Y d }~n
d }~0 0 W | j�rt| �� n| j�rr| �� 0 |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.
rt r F�
rh r@ z;Encoding of %s (%s) differs
from specified encoding (%s)rR Nz:Unable to encode output data. output-encoding is: %s.
(%s))rp r` rf r^ r_ r rR r rW �os�linesepr7 �bytesrV r r4 rj r �
ValueErrorrS r8 r r r\ rk )r# r: �er< r r r rV j sJ �
��
�� ��
�
zFileOutput.writec C s& | j tjtjfvr"| j �� d| _d S )NF)rR r^ rq �stderrrk rp r& r r r rk � s
zFileOutput.close)NNNr TNN) r r r
rI rf r$ r` rV rk r r r r rm % s �
+'rm c @ s e Zd ZdZdZdS )�BinaryFileOutputzL
A version of docutils.io.FileOutput which writes to a binary file.
�wbN)r r r
rI rf r r r r r| � s r| c @ s e Zd ZdZdZdd� ZdS )� StringInputz
Direct string input.
�<string>c C s | � | j�S )z$Decode and return the source string.)r> r r& r r r r* � s zStringInput.readN�r r r
rI r! r* r r r r r~ � s r~ c @ s e Zd ZdZdZdd� ZdS )� StringOutputz
Direct string output.
r c C s | � |�| _| jS )z=Encode `data`, store it in `self.destination`, and return it.)rW rR rU r r r rV � s zStringOutput.writeN�r r r
rI rT rV r r r r r� � s r� c @ s e Zd ZdZdZdd� ZdS )� NullInputz)
Degenerate input: read nothing.
z
null inputc C s dS )zReturn a null string.r. r r& r r r r* � s zNullInput.readNr� r r r r r� � s r� c @ s e Zd ZdZdZdd� ZdS )�
NullOutputz+
Degenerate output: write nothing.
z null outputc C s dS )z6Do nothing ([don't even] send data to the bit bucket).Nr rU r r r rV � s zNullOutput.writeNr� r r r r r� � s r� c @ s e Zd ZdZdZdd� ZdS )� DocTreeInputzm
Adapter for document tree input.
The document tree must be passed in the ``source`` parameter.
z
doctree inputc C s | j S )zReturn the document tree.)r r& r r r r* � s zDocTreeInput.readNr� r r r r r� � s r� ) rI Z
__future__r Z
__docformat__r^ rv rK r Zdocutilsr Z docutils.utils.error_reportingr r r r_ �strr+ ra r r r r rP rX rm r| r~ r� r� r� r� r r r r �<module> s.
p0Zr