?????????? ????????? - ??????????????? - /home/agenciai/.local/lib/python3.9/site-packages/mysql/connector/__pycache__/utils.cpython-39.pyc
???????
a ��Jh�\ � @ s� U d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZmZmZmZmZmZmZmZmZmZmZmZmZ ddl m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z% e r�ddl&m'Z' dd l(m)Z) dd l*m+Z+m,Z, dd l-m.Z. d Z/e0e1d < e2e3e e)fZ4e#e$e2 e$e3 e$e e$e) f e1d< e%e2e5f e2d�dd�Z6e2e5d�dd�Z7e2e5d�dd�Z8e2e5d�dd�Z9e2e5d�dd�Z:e2e5d�dd �Z;e2e5d�d d �Z<e2e5d�d d �Z=e5e2e#e5e5f d!�d"d#�Z>e5e#e5e"e5 f d�d$d%�Z?e5e"e#e"e5 d&f d�d'd(�Z@d\e5e"e5 e"e2 e#e5e5f d)�d*d+�ZAe5e2e#e5e2f d!�d,d-�ZBe5e#e5e"e2 f d�d.d/�ZCe.eDd�d0d1�ZEd]e.e"eD e2dd3�d4d5�ZFe eDeDf d6�d7d8�ZGe eDeDf d6�d9d:�ZHe"e eDeDf d6�d;d<�ZIe#eDeDeDf d6�d=d>�ZJeDeDd?�d@dA�ZKeDe eDe eDge0f f d?�dBdC�ZLeDe"e#eDeDf dD�dEdF�ZMeDeDdG�dHdI�ZNd^e%e2e.f eDeOdL�dMdN�ZPe � e eDe%eDe#eDeDf f f d6�dOdP��ZQeDe dQ�dRdS�ZReDeDddT�dUdV�ZSeDddW�dXdY�ZTG dZd[� d[�ZUdS )_z Utilities.� N)�Decimal)� lru_cache)� in_table_a1� in_table_b1� in_table_c3� in_table_c4� in_table_c5� in_table_c6� in_table_c7� in_table_c8� in_table_c9� in_table_c11� in_table_c12�in_table_c21_c22� in_table_d1� in_table_d2) � TYPE_CHECKING�Any�Callable�Dict�List�Optional�Tuple�Type�Union)�MySQLConnectionAbstract� )� HexLiteral)�DEPRECATED_TLS_CIPHERSUITES�DEPRECATED_TLS_VERSIONS)� StrOrBytesF�__MYSQL_DEBUG__� NUMERIC_TYPES)�buf�returnc C s� t | t�r| S t| �t� }}|dkr.| d S |dkr^|| dd| 7 }tt�d|�d �S || dd| 7 }tt�d|�d �S )z&Unpacks the given buffer to an integerr r � � �<I� �<Q)� isinstance�int�len� bytearray�struct�unpack)r# �length�tmp� r2 �J/home/agenciai/.local/lib/python3.9/site-packages/mysql/connector/utils.py�intreadW s r4 )�ir$ c C s$ | dk s| dkrt d��t�d| �S )z^ Takes an unsigned byte (1 byte) and packs it as a bytes-object. Returns string. r � z int1store requires 0 <= i <= 255�<B�� ValueErrorr. �pack�r5 r2 r2 r3 � int1storee s r< c C s$ | dk s| dkrt d��t�d| �S )z` Takes an unsigned short (2 bytes) and packs it as a bytes-object. Returns string. r � z"int2store requires 0 <= i <= 65535�<Hr8 r; r2 r2 r3 � int2storep s r? c C s, | dk s| dkrt d��t�d| �dd� S )zb Takes an unsigned integer (3 bytes) and packs it as a bytes-object. Returns string. r �� z%int3store requires 0 <= i <= 16777215r' � r8 r; r2 r2 r3 � int3store{ s rB c C s$ | dk s| dkrt d��t�d| �S )zb Takes an unsigned integer (4 bytes) and packs it as a bytes-object. Returns string. r � �� z'int4store requires 0 <= i <= 4294967295r' r8 r; r2 r2 r3 � int4store� s rD c C s$ | dk s| dkrt d��t�d| �S )zZ Takes an unsigned integer (8 bytes) and packs it as string. Returns string. r � z!int8store requires 0 <= i <= 2^64r) r8 r; r2 r2 r3 � int8store� s rF c C s\ | dk s| dkrt d��| dkr&t}n.| dkr4t}n | dkrBt}n| dkrPt}nt}|| �S )z� Takes an unsigned integers and packs it as a bytes-object. This function uses int1store, int2store, int3store, int4store or int8store depending on the integer value. returns string. r rE z!intstore requires 0 <= i <= 2^64r6 r= r@ rC )r9 r< r? rB rD rF )r5 Z formed_stringr2 r2 r3 �intstore� s rG c C st | dk s| dkrt d��| dk r,t�d| �S | dkrDdt�d| � S | d krdd t�d | �dd � S d t�d| � S )z| Takes an unsigned integer and packs it as bytes, with the information of how much bytes the encoded int takes. r rE zRequires 0 <= i <= 2^64� r7 r= � �r> r@ � �r' rA � �r) r8 r; r2 r2 r3 �lc_int� s rL )r# �sizer$ c C s | d|� }| |d� |fS )zi Reads bytes from a buffer. Returns a tuple with buffer less the read bytes, and the bytes. r Nr2 �r# rM �resr2 r2 r3 � read_bytes� s rP c C s� | d dkr | dd� dfS d }}| d }|dkrX|}| d| d� | d|d � fS |dkrfd}n|dkrtd }n |d kr�d }t | d|d � �}| || d d� | |d || d � fS ) u� Takes a buffer and reads a length coded string from the start. This is how Length coded strings work If the string is 250 bytes long or smaller, then it looks like this: <-- 1b --> +----------+------------------------- | length | a string goes here +----------+------------------------- If the string is bigger than 250, then it looks like this: <- 1b -><- 2/3/8 -> +------+-----------+------------------------- | type | length | a string goes here +------+-----------+------------------------- if type == ü: length is code in next 2 bytes elif type == ý: length is code in next 3 bytes elif type == þ: length is code in next 8 bytes NULL has a special value. If the buffer starts with û then it's a NULL and we return None as value. Returns a tuple (trucated buffer, bytes). r rH r N� � � � rA � r( �r4 )r# r0 �lsizeZfstr2 r2 r3 �read_lc_string� s rX .c C s g }dddd�}t | �}d}||k �r| | }|dkr:dS |dkrV|�d� |d 7 }q |d kr�|}|�| |d ||d � � |d | 7 }q d}z || }W n ty� Y dS 0 t| |d ||d � �}|�| |d | || |d � � |d | | 7 }q t|�S ) zXReads all length encoded strings from the given buffer Returns a list of bytes rS rA r( )rR rT rU r r6 NrH r rQ )r, �append�KeyErrorr4 �tuple)r# Zbyteslst�sizes�buf_len�pos�firstr0 rW r2 r2 r3 �read_lc_string_list s0 &r` )r# �endrM r$ c C s� |du r|du rt d��|durzz| �|�}W n. t y\ } zt d�|�W Y d}~n d}~0 0 | |d d� | d|� fS |dur�t| |�S t d��dS )zr Reads a string up until a character or for a given size. Returns a tuple (trucated buffer, string). Nz&read_string() needs either end or sizez end byte not present in bufferr r z.read_string() needs either end or size (weird))r9 �indexrP )r# ra rM �idx�errr2 r2 r3 � read_string/ s re c C s t | d|� �}| |d� |fS )zMRead an integer from buffer Returns a tuple (truncated buffer, int) r NrV rN r2 r2 r3 �read_intH s rf c C s� | s t d��| d }|dkr,| dd� dfS |dk rH| dd� t|�fS |dkrt| dd� t�d| dd� �d fS |d kr�| d d� t�d | dd � d �d fS |d kr�| dd� t�d| dd� �d fS t d��dS )z� Takes a buffer and reads an length code string from the start. Returns a tuple with buffer less the integer and the integer read. z Empty buffer.r rH r NrR rA z<xHrT r% r' r& rU � z<xQz%Failed reading length encoded integer)r9 r+ r. r/ )r# Zlcbyter2 r2 r3 � read_lc_intQ s $($rh c C s2 t | t�s d�dd� | D ��S d�dd� | D ��S )z"Debug function for showing buffers� c S s g | ]}d |d���qS �z\xZ02xr2 ��.0�cr2 r2 r3 � <listcomp>n � z"_digest_buffer.<locals>.<listcomp>c S s g | ]}d t |�d���qS rj )�ordrk r2 r2 r3 rn o ro )r* �str�join)r# r2 r2 r3 �_digest_bufferk s rs � )�abuffer�prefix�limitr$ c C sL |r<|r"|dkr"t | d|� �}nt | �}t|d | � n tt | �� dS )z2Debug function printing output of _digest_buffer()r z: N)rs �print)ru rv rw �digestr2 r2 r3 � print_bufferr s rz �r$ c C s� i } t j�dd�}t j�|�s"| S t|dd��Z}|D ]D}|�d�}t|�dkrPq4|d �� }|d �d �� d �}|| |< q4W d � n1 s�0 Y | S ) zsParse the contents of /etc/os-release file. Returns: A dictionary containing release information. �/etcz os-release�utf-8��encoding�=rS r r � �"N� �os�pathrr �exists�open�splitr, �lower�rstrip�strip)�distro�os_release_file�file_obj�line� key_value�key�valuer2 r2 r3 �_parse_os_release� s (r� c C s� i } t j�dd�}t j�|�r�t|dd��Z}|D ]D}|�d�}t|�dkrLq0|d �� }|d �d �� d �}|| |< q0W d � n1 s�0 Y | S ) ztParse the contents of /etc/lsb-release file. Returns: A dictionary containing release information. r| z lsb-releaser} r~ r� rS r r r� r� Nr� )r� Zlsb_release_filer� r� r� r� r� r2 r2 r3 �_parse_lsb_release� s (r� c C s� i } t tjddd���}ztjd|d�}W n tyH Y W d � dS 0 |�t�� �� � }|D ]F}|� d�}t |�dkr|q`|d � d d �� � }|d �d �}|| |< q`W d � n1 s�0 Y | S )ztParse the output of the lsb_release command. Returns: A dictionary containing release information. �wr} r~ )� lsb_releasez-a)�stderrN�:rS r � �_r � )r� r� �devnull� subprocess� check_output�OSError�decode�sys�getfilesystemencoding� splitlinesr� r, �replacer� r� )r� r� �stdout�linesr� r� r� r� r2 r2 r3 �_parse_lsb_release_command� s (r� c C s� t � } | r,| �dd�| �dd�| �dd�fS t� } | rX| �dd�| �dd�| �dd�fS t� } | r�| �dd�| �d d�| �d d�fS d S ) aN Tries to determine the name of the Linux OS distribution name. First tries to get information from ``/etc/os-release`` file. If fails, tries to get the information of ``/etc/lsb-release`` file. And finally the information of ``lsb-release`` command. Returns: A tuple with (`name`, `version`, `codename`) Z distrib_idri Zdistrib_releaseZdistrib_codename�distributor_id�release�codename�name� version_id�version_codename)ri ri ri )r� �getr� r� )r� r2 r2 r3 �linux_distribution� s& � � �r� )� unicode_strr$ c C s | rt �| d �dv rdS dS )z�Get the readiness direction of the unicode string. We assume that the direction is "L-to-R" if the first character does not indicate the direction is "R-to-L" or an "AL" (Arabic Letter). r )�R�AL�R-to-LzL-to-R)� unicodedata� bidirectional)r� r2 r2 r3 �_get_unicode_read_direction� s r� c C s@ t | �}|dkr8t| d �r(t| d �s0td��dtiS dtiS )at 1) The characters in section 5.8 MUST be prohibited. 2) If a string contains any RandALCat character, the string MUST NOT contain any LCat character. 3) If a string contains any RandALCat character, a RandALCat character MUST be the first character of the string, and a RandALCat character MUST be the last character of the string. r� r ���zvInvalid unicode Bidirectional sequence, if the first character is RandALCat, the final charactermust be RandALCat too.z7Bidirectional Characters requirement 2 [StringPrep, d2])r� r r9 r )r� Zread_dirr2 r2 r3 �_get_unicode_direction_rule� s �r� )�normalized_strr$ c C s� t tttttttttt t d� }z|� t | �� W n0 t y` } z| t|�fW Y d}~S d}~0 0 | D ]6}|�� D ](\}}||�rr|dkrr||f S qrqfdS )a� Check for Prohibited Output according to rfc4013 profile. This profile specifies the following characters as prohibited input: - Non-ASCII space characters [StringPrep, C.1.2] - ASCII control characters [StringPrep, C.2.1] - Non-ASCII control characters [StringPrep, C.2.2] - Private Use characters [StringPrep, C.3] - Non-character code points [StringPrep, C.4] - Surrogate code points [StringPrep, C.5] - Inappropriate for plain text characters [StringPrep, C.6] - Inappropriate for canonical representation characters [StringPrep, C.7] - Change display properties or deprecated characters [StringPrep, C.8] - Tagging characters [StringPrep, C.9] In addition of checking of Bidirectional Characters [StringPrep, Section 6] and the Unassigned Code Points [StringPrep, A.1]. Returns: A tuple with ("probited character", "breaked_rule") ) z4Space characters that contains the ASCII code pointsz&Space characters non-ASCII code pointsz(Unassigned Code Points [StringPrep, A.1]z.Non-ASCII space characters [StringPrep, C.1.2]z,ASCII control characters [StringPrep, C.2.1]z(Private Use characters [StringPrep, C.3]z+Non-character code points [StringPrep, C.4]z'Surrogate code points [StringPrep, C.5]z9Inappropriate for plain text characters [StringPrep, C.6]zGInappropriate for canonical representation characters [StringPrep, C.7]zDChange display properties or deprecated characters [StringPrep, C.8]z$Tagging characters [StringPrep, C.9]Nr� )r r r r r r r r r r r �updater� r9 rq �items)r� �rulesrd �charZrule�funcr2 r2 r3 �"validate_normalized_unicode_string s, �"r� )�a_stringr$ c C s0 dd� | D �}d� |�}t�d|�}|s,dS |S )a( normalizes a unicode string according to rfc4013 Normalization of a unicode string according to rfc4013: The SASLprep profile of the "stringprep" algorithm. Normalization Unicode equivalence is the specification by the Unicode character encoding standard that some sequences of code points represent essentially the same character. This method normalizes using the Normalization Form Compatibility Composition (NFKC), as described in rfc4013 2.2. Returns: Normalized unicode string according to rfc4013. c S s( g | ] }t |�rd nt|�r dn|�qS )r� ri )r r )rl r� r2 r2 r3 rn V s �z,normalize_unicode_string.<locals>.<listcomp>ri �NFKC)rr r� � normalize)r� Z nstr_listZnstrr2 r2 r3 �normalize_unicode_stringC s � r� ro r} )�payloadr r$ c C st t | t�r| S t | t�r t| �S t | t�slzt| j|d��W S tyj } ztd�|�W Y d}~n d}~0 0 t| �S )z(Initialize a bytearray from the payload.r~ z payload must be a str or bytesN)r* r- r+ �bytes�encode�AttributeErrorr9 )r� r rd r2 r2 r3 �init_bytearrayh s r� c C s� ddd�} t jdkrldt�� d v r.d| d< n&dt�� d v rHd | d< n t�� | d< d t�� d � �| d < nHt�� | d< t�� d kr�dt�� d � �| d < nd�t � dd� �| d < | S )z4Return a dict with the platform arch and OS version.ri )�arch�version�ntZ64r �x86_64r� Z32�i386zWindows-r r� �DarwinzmacOS-�-rS ) r� r� �platform� architecture� win32_ver�machine�system�mac_verrr r� )�platr2 r2 r3 � get_platformy s r� )�fullpathr$ c C s� t | t�std��z(| �dd�\}}t�|�}t||�}W nV ty^ td| � d��d�Y n4 ttfy� } zt|� �|�W Y d}~n d}~0 0 |S )a( Import an object from a fully qualified module path. Args: obj (str): A string representing the fully qualified name of the object. Returns: Object: The imported object. Raises: ValueError: If the object can't be imported. .. versionadded:: 8.0.33 z]'fullpath' should be a str representing the fully qualified name of the object to be imported�.r zNo callable named '�'N) r* rq r9 �rsplit� importlib� import_module�getattrr� �ModuleNotFoundError)r� Z module_strZ callable_str�module�objrd r2 r2 r3 � import_object� s � "r� )�cipher_as_ossl� tls_versionr$ c C s0 | t �|i ��� v r,d| � d�}t�|t� dS )aI Emits a warning if a deprecated cipher is being utilized. Args: cipher: Must be ingested as OpenSSL name. tls_versions: TLS version to check the cipher against. Raises: DeprecationWarning: If the cipher is flagged as deprecated according to the OSSA cipher list. z$This connection is using TLS cipher �[ which is now deprecated and will be removed in a future release of MySQL Connector/Python.N)r r� �values�warnings�warn�DeprecationWarning)r� r� �warn_msgr2 r2 r3 � warn_ciphersuites_deprecated� s �r� )r� r$ c C s$ | t v r d| � d�}t�|t� dS )a Emits a warning if a deprecated TLS version is being utilized. Args: tls_versions: TLS version to check. Raises: DeprecationWarning: If the TLS version is flagged as deprecated according to the OSSA cipher list. z%This connection is using TLS version r� N)r r� r� r� )r� r� r2 r2 r3 �warn_tls_version_deprecated� s �r� c sX e Zd ZdZedd�dd�Zeed�dd�Zeedd �� fd d � Zed �d d�Z � Z S )�GenericWrapperz<Base class that provides basic object wrapper functionality.N)�wrappedr$ c C s || _ dS )z Constructor.N)�_wrapped)�selfr� r2 r2 r3 �__init__� s zGenericWrapper.__init__)�attrr$ c C s || j v rt| |�S t| j|�S )z�Gets an attribute. Attributes defined in the wrapper object have higher precedence than those wrapped object equivalent. Attributes not found in the wrapper are then searched in the wrapped object. )�__dict__r� r� )r� r� r2 r2 r3 � __getattr__� s zGenericWrapper.__getattr__)r� r� r$ c sF d| j vr|| j d< dS || j v r4t� �||� dS | j�||� dS )zSets an attribute.r� N)r� �super� __setattr__r� )r� r� r� �� __class__r2 r3 r� � s zGenericWrapper.__setattr__r{ c C s | j jjS )z Gets the wrapped class name.)r� r� �__name__)r� r2 r2 r3 �get_wrapped_class� s z GenericWrapper.get_wrapped_class) r� � __module__� __qualname__�__doc__r r� rq r� r� r� � __classcell__r2 r2 r� r3 r� � s r� )NN)Nrt )ro r} )Vr� r� r� r� r. r� r� r� r� �decimalr � functoolsr � stringprepr r r r r r r r r r r r r r �typingr r r r r r r r r Zmysql.connector.abstractsr Z custom_typesr Z tls_ciphersr r �typesr r! �bool�__annotations__r+ �floatr" r� r4 r< r? rB rD rF rG rL rP rX r` re rf rh rq rs rz r� r� r� r� r� r� r� r� r- r� r� r� r� r� r� r2 r2 r2 r3 �<module> s� @, �( 5 * � � � � %" � 4& � � (
| ver. 1.6 |
Github
|
.
| PHP 8.2.30 | ??????????? ?????????: 0 |
proxy
|
phpinfo
|
???????????