"ijdZddlZddlZddlZddlZddlZddlmZmZddl m Z e e fZ eeejfZddZddZd Zd Zdd Zdd ZdZdZdS)z&This module contains helper functions.N)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceErrorutf-8cZt|tr|n||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. ) isinstancebytesencodevalueencodings F/srv/django_bis/venv311/lib/python3.11/site-packages/mysqlx/helpers.pyencode_to_bytesr-s)ue,, H55%,,x2H2HHcZt|tr||n|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. )r r decoder s rdecode_from_bytesr9s*&0u%=%= H5<< ! ! !5Hrc\t|tr||nt||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. )r dictgetattr)objkeys rget_item_or_attrrFs+"#t,, C3s88'#s2C2CCrcndt|dkrfd|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. c||St|tr|St|ttfr|dd}|dd}|dd}|dd }|d d }|d d }n|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 bytearrayreplace)r s r_escapezescape.._escape^s% =L } - - L eeY/ 0 0 6MM%11EMM%00EMM%00EMM';77EMM';77EMM';77EEMM$//EMM$..EMM$..EMM&*55EMM&*55EMM&*55E rrc&g|] }|Sr.).0argr,s r zescape..ts!--- ---rr)len)argsr,s @rescaper4SsQ* 4yy1}}-------- 747  rc|dkr)d|ddSd|ddS)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. ANSI_QUOTESz"{0}"r'z""z`{0}``z``)formatr+) identifiersql_modes rquote_identifierr<xsS=  ~~j00d;;<<< >>*,,S$77 8 88rcfd}|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 cLtjfd}|S)zDecorate function.cdjg}r(|dr(|dtjj}t jd|ttj |j |j |i|S)zWrapper function. Args: *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. z'{}' is deprecatedz since version {}z. {}r5)categoryfilenamelineno) r9__name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)r3kwargsmessageframefuncreasonversions rwrapperz-deprecated..decorate..wrappers,224=AABG D299'BBCCC 6v}}V44555(**1E  "2777#3#3,>,3OEL,I,I*/. : : : :4((( (r) functoolswraps)rRrUrSrTs` rdecoratezdeprecated..decoratesC    ) ) ) ) ) )   )$rr.)rTrSrXs`` r deprecatedrYs)", Orcrg}i}ttj|dzD]-}|tt|.|D]]}d|vr||||vr|||> $;;  # #D ) ) ) ) ] " "  # #M$$7 8 8 8 8 "006t >> > rcPtj|dS)zReturn the hexadecimal representation of the binary data. Args: data (str): The binary data. Returns: bytes: The hexadecimal representation of data. r)binasciihexlifyr)datas rrgrgs#  D ! ! ( ( 1 11r)r)r5)NN)__doc__rfdecimalrVrErH constantsrrerrorsrr*r BYTE_TYPESintfloatDecimalr)rrrr4r<rYrdrgr.rrrqs$:-,66666666"""""" eW_.  I I I I I I I I D D D"""J 9 9 9 9 ''''T4 2 2 2 2 2r