U
|
¤ý°d{ ã @ s< d Z ddlZddlZddlZddlZddlZddlmZmZm Z m
|
Z
|
m Z ddl m Z mZ ddlmZ ddlmZmZ eefZeeejfZd!eeed d
|
d Z d"eeed d d Z e eedddZ ee ee e f dddZ d#eeedddZ!d$e
|
e e
|
e edddZ"ee e e e dd d Z#eed d d Z$dS )%z&This module contains helper functions.é N)ÚAnyÚCallableÚListÚOptionalÚUnioné )ÚTLS_CIPHER_SUITESÚ TLS_VERSIONS)ÚInterfaceError)Ú EscapeTypesÚ
|
StrOrBytesúutf-8)ÚvalueÚencodingÚreturnc C s t | tr| S | |¡S )zÄReturns an encoded version of the string as a bytes object.
|
|
Args:
|
encoding (str): The encoding.
|
|
Resturns:
|
bytes: The encoded version of the string as a bytes object.
|
)Ú
|
isinstanceÚbytesÚencode©r r © r úEd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\mysqlx/helpers.pyÚencode_to_bytes/ s r c C s t | tr| |¡S | S )zÍReturns a string decoded from the given bytes.
|
|
Args:
|
value (bytes): The value to be decoded.
|
encoding (str): The encoding.
|
|
Returns:
|
str: The value decoded from bytes.
|
)r r Údecoder r r r Údecode_from_bytes; s
|
r )ÚobjÚkeyr c C s t | tr| | S t| |S )zÅGet item from dictionary or attribute from object.
|
|
Args:
|
obj (object): Dictionary or object.
|
key (str): Key.
|
|
Returns:
|
object: The object for the provided key.
|
)r ÚdictÚgetattr)r r r r r Úget_item_or_attrH s
|
r )Úargsr c s: t t ddd t| dkr. fdd| D S | d S )a
|
Escapes special characters as they are expected to be when MySQL
|
receives them.
|
As found in MySQL source mysys/charset.c
|
|
Args:
|
value (object): Value to be escaped.
|
|
Returns:
|
str: The value if not a string, or the escaped string.
|
)r r c S s¾ | dkr | S t | tr| S t | ttfrr| dd¡} | dd¡} | dd¡} | dd ¡} | d
|
d ¡} | d d ¡} nH| dd¡} | dd¡} | dd¡} | dd¡} | dd¡} | dd¡} | S )zEscapes special characters.Nó \s \\ó
|
s \nó s \ró 's \'ó "s \"ó s \ú\z\\Ú
|
z\nú z\rú'z\'ú"z\"úz\)r Ú NUMERIC_TYPESr Ú bytearrayÚreplace)r r r r Ú_escapea s$
|
zescape.<locals>._escaper c s g | ] } |qS r r )Ú.0Úarg©r/ r r Ú
|
<listcomp>x s zescape.<locals>.<listcomp>r )r Úlen)r r r2 r ÚescapeU s r5 Ú )Ú
|
identifierÚsql_moder c C s8 |dkr | dd¡}d| dS | dd¡}d| dS )ac Quote the given identifier with backticks, converting backticks (`)
|
in the identifier name with the correct escape sequence (``) unless the
|
identifier is quoted (") as in sql_mode set to ANSI_QUOTES.
|
|
Args:
|
identifier (str): Identifier to quote.
|
|
Returns:
|
str: Returns string with the identifier quoted with backticks.
|
Z ANSI_QUOTESr* z""ú`z``)r. )r7 r8 Úquotedr r r Úquote_identifier| s
|
r; )ÚversionÚreasonr c s t t d fdd }|S )a This is a decorator used to mark functions as deprecated.
|
|
Args:
|
version (Optional[string]): Version when was deprecated.
|
reason (Optional[string]): Reason or extra information to be shown.
|
|
Returns:
|
Callable: A decorator used to mark functions as deprecated.
|
|
Usage:
|
|
.. code-block:: python
|
|
from mysqlx.helpers import deprecated
|
|
@deprecated('8.0.12', 'Please use other_function() instead')
|
def deprecated_function(x, y):
|
return x + y
|
)Úfuncr c s( t ¡tttd fdd }|S )zDecorate function.)r Úkwargsr c sn d j dg}r$| d ¡ r8| d ¡ t ¡ j}tjd |¡tt |j
|
¡|j d | |S )zWrapper function.
|
|
Args:
|
*args: Variable length argument list.
|
**kwargs: Arbitrary keyword arguments.
|
r) z' is deprecatedz since version z. r6 )ÚcategoryÚfilenameÚlineno) Ú__name__ÚappendÚinspectÚ currentframeÚf_backÚwarningsÚ warn_explicitÚjoinÚDeprecationWarningÚgetfileÚf_codeÚf_lineno)r r? ÚmessageÚframe)r> r= r< r r Úwrapper¦ s
|
|
üz-deprecated.<locals>.decorate.<locals>.wrapper)Ú functoolsÚwrapsr r )r> rQ ©r= r< )r> r Údecorate£ s z deprecated.<locals>.decorate)r )r< r= rU r rT r Ú
|
deprecated s rV )Ú tls_versionÚcipher_suites_namesr c C s| g }i }t t | ¡d D ]}| tt| ¡ q|D ]@}d|krN| |¡ q6||krf| || ¡ q6td| dq6|S )a Translates a cipher suites names list; from IANI names to OpenSSL names.
|
|
Args:
|
TLS_version (str): The TLS version to look at for a translation.
|
cipher_suite_names (list): A list of cipher suites names.
|
|
Returns:
|
List[str]: List of translated names.
|
r ú-zThe 'z.' in cipher suites is not a valid cipher suite)Úranger ÚindexÚupdater rD r
|
)rW rX Ztranslated_namesZ cipher_suitesr[ Únamer r r Úiani_to_openssl_cs_nameÁ s
|
ÿr^ )Údatar c C s t | ¡ d¡S )z»Return the hexadecimal representation of the binary data.
|
|
Args:
|
data (bytes): The binary data.
|
|
Returns:
|
str: The decoded hexadecimal representation of data.
|
r )ÚbinasciiÚhexlifyr )r_ r r r ra á s ra )r )r )r6 )NN)%Ú__doc__r` ÚdecimalrR rE rH Útypingr r r r r Ú constantsr r Úerrorsr
|
Útypesr r r- r Z
|
BYTE_TYPESÚintÚfloatÚDecimalr, Ústrr r Úobjectr r5 r; rV r^ ra r r r r Ú<module> s, ' 4 þ
|
