U 4Je{@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||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. ) isinstancebytesencoderrr2/tmp/pip-unpacked-wheel-7_167w8m/mysqlx/helpers.pyencode_to_bytes/s rcCst|tr||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. )rrdecoderrrrdecode_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|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 bytearrayreplace)rrrr_escapeas$            zescape.._escapercsg|] }|qSrr).0argr/rr xszescape..r)r len)rrr2rescapeUs  r5) identifiersql_modercCs8|dkr |dd}d|dS|dd}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.)r7r8quotedrrrquote_identifier|s    r;)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(ttttdfdd }|S)zDecorate function.)rkwargsrcsndjdg}r$|dr8|dtj}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)categoryfilenamelineno) __name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)rr?messageframe)r>r=r<rrwrappers  z-deprecated..decorate..wrapper) functoolswrapsrr)r>rQr=r<)r>rdecorateszdeprecated..decorate)r)r<r=rUrrTr deprecatedsrV) tls_versioncipher_suites_namesrcCs|g}i}tt|dD]}|tt|q|D]@}d|krN||q6||krf|||q6td|dq6|S)aTranslates 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 indexupdaterrDr )rWrXZtranslated_namesZ cipher_suitesr[namerrriani_to_openssl_cs_names   r^)datarcCst|dS)zReturn the hexadecimal representation of the binary data. Args: data (bytes): The binary data. Returns: str: The decoded hexadecimal representation of data. r )binasciihexlifyr)r_rrrras ra)r )r )r6)NN)%__doc__r`decimalrRrErHtypingrrrrr constantsrr errorsr typesr r r-rZ BYTE_TYPESintfloatDecimalr,strrrobjectrr5r;rVr^rarrrrs,     '4