@i{fdZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z mZddlmZddlmZmZeefZeeej2fZdded ed efd Zdded ed efd Zd eded efdZded e ee effdZ ddeded efdZ!dde ede ed efdZ"dede ed e efdZ#ded efdZ$y) z&This module contains helper functions.N)AnyCallableListOptionalUnion)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceError) EscapeTypes StrOrBytesvalueencodingreturncHt|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. ) isinstancebytesencoderrs H/var/www/html/aiagents/fe/lib/python3.12/site-packages/mysqlx/helpers.pyencode_to_bytesr/s!ue,5H%,,x2HHcHt|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. )rrdecoders rdecode_from_bytesr;s!&0u%=5<< !H5HrobjkeycDt|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)rrs rget_item_or_attrr!Hs#"#t,3s8C'#s2CCrargscdtdtfd}t|dkDr|Dcgc] }|| c}S||dScc}w)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. rrc||St|tr|St|ttfrn|j dd}|j dd}|j dd}|j dd}|j d d }|j d d }|S|j d d}|j dd}|j dd}|j dd}|j dd}|j dd}|S)zEscapes special characters.\s\\ s\n s\r's\'"s\"s\\z\\ z\n z\r'z\'"z\"z\)r NUMERIC_TYPESr bytearrayreplace)rs r_escapezescape.._escapeas =L e] +L eeY/ 0MM%1EMM%0EMM%0EMM';7EMM';7EMM';7E MM$/EMM$.EMM$.EMM&*5EMM&*5EMM&*5E rrr)r len)r"r4args rescaper7UsK{{, 4y1}(,- -- 47 .sA identifiersql_modecl|dk(r|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. ANSI_QUOTESr/z""`z``)r3)r8r9quoteds rquote_identifierr>|sL= ##C.6(!}   T *F vha=rversionreasonc0dtdtffd }|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 funcrcntjdtdtdtffd }|S)zDecorate function.r"kwargsrcpdjdg}r|jdr|jdtjj}t j dj|ttj|j|j|i|S)zWrapper function. Args: *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. r.z' is deprecatedz since version z. )categoryfilenamelineno) __name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)r"rDmessageframerBr@r?s rwrapperz-deprecated..decorate..wrappers4==/9:G :;F8}-((*11E  " " + 6~~   (( (r) functoolswrapsrr)rBrXr@r?s` rdecoratezdeprecated..decorates<   )3 )# )( )  )*r)r)r?r@r[s`` r deprecatedr\s*xH6 Or tls_versioncipher_suites_namesc g}i}ttj|dzD]!}|jtt|#|D]?}d|vr|j |||vr|j ||2t d|d|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 indexupdater rKr )r]r^translated_names cipher_suitesrbnames riani_to_openssl_cs_namergsM|))+6:;E.|E/BCDE$ $;  # #D ) ] "  # #M$$7 8 vKL   rdatacJtj|jdS)zReturn the hexadecimal representation of the binary data. Args: data (bytes): The binary data. Returns: str: The decoded hexadecimal representation of data. utf-8)binasciihexlifyr)rhs rrlrls    D ! ( ( 11r)rj)rF)NN)%__doc__rkdecimalrYrLrOtypingrrrrr constantsr r errorsr typesr r r2r BYTE_TYPESintfloatDecimalr1strrrobjectr!r7r>r\rgrlrrrzs5:-776"*  eW__-  I: I I5 I IZ I3 IS I D& Ds Ds D$+$% T+5F(F"G$NS$0 0hsm0x0f+/9 #Y@ 2% 2C 2r