:?h{~SrSSKrSSKrSSKrSSKrSSKrSSKJrJrJ r J r J r SSK J r Jr SSKJr SSKJrJr \\4r\\\R24rSS\S \S \4S jjrSS\S \S \4S jjrS \S\S \4SjrS\S \ \\ \44Sjr SS\S\S \4Sjjr!SS\ \S\ \S \4Sjjr"S\S\ \S \ \4Sjr#S\S \4Sjr$g) z&This module contains helper functions.N)AnyCallableListOptionalUnion)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceError) EscapeTypes StrOrBytesvalueencodingreturncR[U[5(aU$URU5$)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 V/var/www/ev-aguas/ev-aguas-proceso/venv/lib/python3.13/site-packages/mysqlx/helpers.pyencode_to_bytesr/s$ue,,5H%,,x2HHcR[U[5(aURU5$U$)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<< !H5HrobjkeycJ[U[5(aX$[X5$)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,,38C'#2CCrargscS[S[4Sjn[U5S:aUVs/sH o!"U5PM sn$U"US5$s snf)zEscapes 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(UcU$[U[5(aU$[U[[45(anUR SS5nUR SS5nUR SS5nUR SS5nUR S S 5nUR S S 5nU$UR S S5nUR SS5nUR SS5nUR SS5nUR SS5nUR SS5nU$)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_escapeescape.._escapeas =L e] + +L eeY/ 0 0MM%1EMM%0EMM%0EMM';7EMM';7EMM';7E MM$/EMM$.EMM$.EMM&*5EMM&*5EMM&*5E rrr)r len)r"r4args rescaper8UsO{{, 4y1}(,- -- 47 .sA identifiersql_modecnUS:XaURSS5nSUS3$URSS5nSUS3$)aGQuote 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)r9r:quoteds rquote_identifierr?|sL= ##C.6(!}   T *F vha=rversionreasonc4^^S[S[4UU4SjjnU$)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 funcrct>^[R"T5S[S[S[4UUU4Sjj5nU$)zDecorate function.r"kwargsrc>STRS3/nT(aURST35 T(aURST35 [R"5Rn[ R "SRU5[[R"UR5URS9 T"U0UD6$)znWrapper 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"rEmessageframerCrAr@s rwrapper-deprecated..decorate..wrappers4==/9:G :;F8}-((*11E  " " + 6~~   (( (r) functoolswrapsrr)rCrYrAr@s` rdecoratedeprecated..decoratesA   )3 )# )( ) )  )*r)r)r@rAr]s`` r deprecatedr_s"*xH6 Or tls_versioncipher_suites_namesc0/n0n[[R"U5S-5H"nUR[[U5 M$ UHCnSU;aUR U5 MXS;aUR X55 M6[ SUS35e U$)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 rLr )r`ratranslated_names cipher_suitesrenames riani_to_openssl_cs_namerjsM|))+6:;.|E/BCD<$ $;  # #D )  "  # #M$7 8 vKL  $ rdatacL[R"U5RS5$)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)rks rroros    D ! ( ( 11r)rm)rG)NN)%__doc__rndecimalr[rMrPtypingrrrrr constantsr r errorsr typesr r r2r BYTE_TYPESintfloatDecimalr1strrrobjectr!r8r?r_rjrorrr}s5:-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