|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/docutils/__pycache__/ |
Upload File : |
o
!5p`�A � @ s. d Z ddlmZ dZddlZddlZddlZddlZddlm Z ddl
m Z m Z m
Z
ejdkr1eZG 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_function�reStructuredTextN)�
TransformSpec)�locale_encoding� ErrorString� ErrorOutput�� r c @ � e Zd ZdS )�
InputErrorN��__name__�
__module__� __qualname__� r r �-/usr/lib/python3/dist-packages/docutils/io.pyr � r c @ r
)� OutputErrorNr r r r r r r r c
C s4 z t �| j�t �|�kW S tttfy Y dS w )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 @ sp e Zd ZdZdZdZ ddd�Zdd� Zd d
� Zd d � Z e
� d
�Z e
jdfe
jdfe
jdffZ dd� ZdS )�Inputz1
Abstract base class for input wrappers.
�inputN�strictc C s6 || _ || _ || _ || _ |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 � 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 � t �r ��NotImplementedErrorr) r r r �readM s z
Input.readc C s� | j r| j �� dkrt|t�sJ d��t|t�r|S | j r"| j g}n| �|�}|r-|g}n ddg}tr9|�dt� |D ]+}zt||| j�}|| _|� dd�W S t
t fyf } z|}W Y d}~q;d}~ww t
d d
� d d � |D ��t
|�f ��)
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, '')
�unicodez=input encoding is "unicode" but input is not a unicode object�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>} s z Input.decode.<locals>.<listcomp>)r �lower�
isinstancer/ � determine_encoding_from_datar �insertr r$ �replace� UnicodeErrorr �joinr )r% �data� encodings�
data_encodingr5 �decoded�err�errorr r r �decodeP s<
�
�����z Input.decodes coding[:=]\s*([-\w.]+)r0 z utf-16-bez utf-16-lec C s` | j D ]
\}}|�|�r| S q|�� dd� D ]}| j�|�}|r-|�d��d� S qdS )z�
Try to determine the encoding of `data` by looking *in* `data`.
Check for a byte order mark (BOM) or an encoding declaration.
N� r1 �ascii)�byte_order_marks�
startswith�
splitlines� coding_slug�search�grouprD )r% r> � start_bytesr �line�matchr r r r9 � s
� �z"Input.determine_encoding_from_data�NNNr )r
r r �__doc__�component_typer# r& r* r. rD �re�compilerJ r �BOM_UTF8� BOM_UTF16_BE� BOM_UTF16_LErG r9 r r r r r + s$
�
0� r c @ s> e Zd ZdZdZdZ d
dd�Zdd� Zd d
� Zd d � Z dS )�Outputz2
Abstract base class for output wrappers.
�outputNr c C s8 || _ |pd| _ || _ || _ |s| j| _d S d S )Nr )r r � destination�destination_path�default_destination_path)r% rZ r[ r r r r r r& � s
�zOutput.__init__c C r' )Nz'%s: destination=%r, destination_path=%r)r( rZ r[ r) r r r r* � s �zOutput.__repr__c C r+ )z;`data` is a Unicode string, to be encoded by `self.encode`.r, �r% r> r r r �write� � z Output.writec C sH | j r| j �� dkrt|t�sJ d��|S t|t�s |S |�| j | j�S )Nr/ zFthe encoding given is "unicode" but the output is not a Unicode string)r r7 r8 r/ �encoder r] r r r r` � s �
z
Output.encoderP )
r
r r rQ rR r\ r& r* r^ r` r r r r rX � s
� rX c @ sL e Zd ZdZdddddejdkrdndfdd �Zd
d � Zd d
� Zdd� Z dS )� FileInputz5
Input for single, simple file-like objects.
Nr Tr �r�rUc
C s� t �| ||||� || _t� | _|du rK|rFtjdkr#| j| jd�}ni }z t ||fi |��| _
W n2 t yE } zt |j
|j|��d}~ww tj| _
ntjdkrdt| j
| j�du rdtd| j| j
jf ��|syz| j
j| _W dS tyx Y dS w 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 r< �namer" r ) r% r! r" r r rf �mode�kwargsrC r r r r& � s:
���
� ��zFileInput.__init__c
C s� z_z"| j tju r tjdkr | j j�� }d�|�� �d }n| j �� }W n3 tt fyV } z%| j
sK| j rKt | j d�}|�� }|�
� d�|�� �d }n� W Y d}~nd}~ww W | jr_| �
� n | jrh| �
� w w | �|�S )zU
Read and decode a single file and return the data (Unicode string).
r �
�rbN)r! rh rn ri �bufferr. r= rI r< r r r" rj �closerf rD )r% r> rB �b_sourcer r r r. � s0
� ���� ��
�
zFileInput.readc C s | � � �d�S )zK
Return lines of a single file as list of Unicode strings.
T)r. rI r) r r r � readlines s zFileInput.readlinesc C s | j tjur
| j �� d S d S r )r! rh rn ru r) r r r ru s �zFileInput.close)
r
r r rQ rh ri r& r. rw ru r r r r ra � s
�/ ra c @ s> e Zd ZdZdZ ddd�Zdd � Zd
d � Zd d
� ZdS )�
FileOutputz6
Output for single, simple file-like objects.
�wNr Tc C s� t �| ||||� d| _|| _|dur|| _t� | _|du r)|r$d| _n tj| _ n|rDt
| j d�rD|| j jkrDt d| j j|f | jd� |sYz| j j | _
W dS tyX Y dS w 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.
TNFrp z?Warning: Destination mode "%s" differs from specified mode "%s")�file)rX r& �openedrf rp r rg rh �stdoutrZ �hasattr�printro r[ r )r% rZ r[ r r rf �handle_io_errorsrp r r r r& 1 s:
�
�
�
�� ��zFileOutput.__init__c
C sz t jdkrd| jvr| j| jd�}ni }zt| j| jfi |��| _W n ty7 } z t |j
|j | j��d }~ww d| _ d S )Nr �brd T)
rh ri rp r r rj r[ rZ rk r rl rm r{ )r% rq rC r r r rj \ s �
���
zFileOutput.openc C s^ | j s| �� d| jvrtjdk st| j| j�du r3| �|�}tjdkr3t j
dkr3|� dt t j
d��}zrz| j�
|� W n_ ty� } z;tjdkryt|t �ryz | jj�
|� W n! tyx t| j| j�du rvtd| jpmd| jj| jf ��|�w W Y d }~n d }~w ttfy� } z td
| jt|�f ��d }~ww W | jr�| �� |S | jr�| �� w w ) 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.
r� r F�
rr rF z;Encoding of %s (%s) differs
from specified encoding (%s)rZ Nz:Unable to encode output data. output-encoding is: %s.
(%s))r{ rj rp rh ri r rZ r r` �os�linesepr; �bytesr^ r r8 rt r �
ValueErrorr[ r< r r rf ru )r% r> rB r r r r^ j sT
��
���� ������
�zFileOutput.writec C s* | j tjtjfvr| j �� d| _d S d S )NF)rZ rh r| �stderrru r{ r) r r r ru � s
�zFileOutput.close)NNNr TNN) r
r r rQ rp r& rj r^ ru r r r r rx % s
�+ 'rx c @ s e Zd ZdZdZdS )�BinaryFileOutputzL
A version of docutils.io.FileOutput which writes to a binary file.
�wbN)r
r r rQ rp r r r r r� � s r� c @ � e Zd ZdZdZdd� ZdS )� StringInputz
Direct string input.
�<string>c C s | � | j�S )z$Decode and return the source string.)rD r! r) r r r r. � s zStringInput.readN�r
r r rQ r# r. r r r r r� � � r� c @ r� )� StringOutputz
Direct string output.
r� c C s | � |�| _| jS )z=Encode `data`, store it in `self.destination`, and return it.)r` rZ r] r r r r^ � s zStringOutput.writeN�r
r r rQ r\ r^ r r r r r� � r� r� c @ r� )� NullInputz)
Degenerate input: read nothing.
z
null inputc C � dS )zReturn a null string.r2 r r) r r r r. � r_ zNullInput.readNr� r r r r r� � r� r� c @ r� )�
NullOutputz+
Degenerate output: write nothing.
z null outputc C r� )z6Do nothing ([don't even] send data to the bit bucket).Nr r] r r r r^ � r_ zNullOutput.writeNr� r r r r r� � r� r� c @ r� )� 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� ) rQ �
__future__r �
__docformat__rh r� rS r �docutilsr � docutils.utils.error_reportingr r r ri �strr/ rk r r r r rX ra rx r� r� r� r� r� r� r r r r �<module> s0
p0Zr