3 de{@s<dZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z mZddlmZddlmZmZeefZeeejfZd!eeed d d Zd"eeed d d ZeeedddZee ee efdddZ d#eeedddZ!d$e ee eedddZ"ee ee edddZ#eeddd Z$dS)%z&This module contains helper functions.N)AnyCallableListOptionalUnion)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceError) EscapeTypes StrOrBytesutf-8)valueencodingreturncCst|tr|S|j|S)zReturns 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. ) isinstancebytesencode)rrrE/var/www/agendate/envp3/lib/python3.6/site-packages/mysqlx/helpers.pyencode_to_bytes/s rcCst|tr|j|S|S)zReturns 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. )rrdecode)rrrrrdecode_from_bytes;s r)objkeyrcCst|tr||St||S)zGet item from dictionary or attribute from object. Args: obj (object): Dictionary or object. key (str): Key. Returns: object: The object for the provided key. )rdictgetattr)rrrrrget_item_or_attrHs r)argsrcs:ttdddt|dkr.fdd|DS|dS)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. )rrcSs|dkr |St|tr|St|ttfrr|jdd}|jdd}|jdd}|jdd }|jd d }|jd d }nH|jdd}|jdd}|jdd}|jdd}|jdd}|jdd}|S)zEscapes special characters.N\s\\ s\n s\r's\'"s\"s\\z\\ z\n z\r'z\'"z\"z\)r NUMERIC_TYPESr bytearrayreplace)rrrr_escapeas$            zescape.._escapercsg|] }|qSrr).0arg)r.rr xszescape..r)r len)rr)r.rescapeUs  r3) identifiersql_modercCs8|dkr |jdd}d|dS|jdd}d|dS)acQuote 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-)r5r6quotedrrrquote_identifier|s    r9)versionreasonrcsttdfdd }|S)aThis 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 )funcrcs(tjtttdfdd }|S)zDecorate function.)rkwargsrcsndjdg}r$|jdr8|jdtjj}tjdj|ttj |j |j d||S)zWrapper function. Args: *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. r(z' is deprecatedz since version z. r4)categoryfilenamelineno) __name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)rr=messageframe)r<r;r:rrwrappers   z-deprecated..decorate..wrapper) functoolswrapsrr)r<rO)r;r:)r<rdecorateszdeprecated..decorate)r)r:r;rRr)r;r:r deprecatedsrS) tls_versioncipher_suites_namesrcCsg}i}x,ttj|dD]}|jtt|qWxH|D]@}d|krT|j|q<||krl|j||qs(     '4