3 (h@sdZddlZddlZddlZddlmZddlmZmZddl m Z ddd Z dd d Z d d Z ddZdddZdddZddZdS)z&This module contains helper functions.N) NUMERIC_TYPES)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceErrorutf-8cCst|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)valueencodingr B/tmp/pip-install-q3hcpn_q/mysql-connector-python/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. )rr decode)r r r r rdecode_from_bytes3s rcCst|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)objkeyr r rget_item_or_attr@s rcs2ddt|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. cSs|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\)rrr bytearrayreplace)r r r r_escapeXs$            zescape.._escapercsg|] }|qSr r ).0arg)r%r r nszescape..r)len)argsr )r%rescapeMs  r+cCs,|dkrdj|jddSdj|jddS)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_QUOTESz"{0}"r!z""z`{0}``z``)formatr$) identifierZsql_moder r rquote_identifierrs r0csfdd}|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. 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 cstjfdd}|S)zDecorate function.csldjjg}r"|jdjr6|jdjtjj}tjdj|t tj |j |j d||S)zWrapper function. Args: *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. z'{}' is deprecatedz since version {}z. {}r,)categoryfilenamelineno) r.__name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)r*kwargsmessageframe)funcreasonversionr rwrappers    z-deprecated..decorate..wrapper) functoolswraps)rCrF)rDrE)rCrdecorateszdeprecated..decorater )rErDrIr )rDrEr deprecatedsrJcCsg}i}x,ttj|dD]}|jtt|qWxF|D]>}d|krT|j|q<||krl|j||qs    %  )