h{dZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z mZddlmZddlmZmZeefZeeejfZdd ed ed efd Zdd ed ed efd Zdeded efdZded e ee effdZ d deded efdZ!d!de ede ed efdZ"dede ed e efdZ#ded efdZ$dS)"z&This module contains helper functions.N)AnyCallableListOptionalUnion)TLS_CIPHER_SUITES TLS_VERSIONS)InterfaceError) EscapeTypes StrOrBytesutf-8valueencodingreturncZt|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. ) isinstancebytesencoderrs V/var/www/html/services/rag-service/venv/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. )rrdecoders rdecode_from_bytesr;s*&0u%=%= H5<< ! ! !5Hrobjkeyc\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. )rdictgetattr)rrs rget_item_or_attrr"Hs+"#t,, C3s88'#s2C2CCrargscdtdtfdt|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. rrc||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)rs r_escapezescape.._escapeas% =L e] + + L eeY/ 0 0 6MM%11EMM%00EMM%00EMM';77EMM';77EMM';77EEMM$//EMM$..EMM$..EMM&*55EMM&*55EMM&*55E rrc&g|] }|Sr7).0argr5s r zescape..xs!--- ---rr)r len)r#r5s @rescaper<Usd{{, 4yy1}}-------- 747  r identifiersql_modec~|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. ANSI_QUOTESr0z""`z``)r4)r>r?quoteds rquote_identifierrD|sU=  ##C..6}}}   T * *F v===rversionreasonc4dtdtffd }|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 funcrcxtjdtdtdtffd }|S)zDecorate function.r#kwargsrc\djdg}r|dr|dtjj}t jd|ttj |j |j |i|S)zWrapper function. Args: *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. r/z' is deprecatedz since version z. r=)categoryfilenamelineno) __name__appendinspect currentframef_backwarnings warn_explicitjoinDeprecationWarninggetfilef_codef_lineno)r#rJmessageframerHrFrEs rwrapperz-deprecated..decorate..wrappers:4=999:G <:::;;; .}F}}---(**1E  "  + 66~      4((( (r) functoolswrapsrr)rHr]rFrEs` rdecoratezdeprecated..decorates_    )3 )# )( ) ) ) ) ) ) )   )*r)r)rErFr`s`` r deprecatedras<*xH6 Or tls_versioncipher_suites_namescTg}i}ttj|dzD]-}|tt|.|D]N}d|vr||||vr|||r}sU:-,7777777777777766666666""""""********  eW_-  I I: I I5 I I I I I IZ I3 IS I I I I D& Ds Ds D D D D$+$% T+5F(F"G$$$$NS$00 0hsm0x0000f+/9 #Y@ 2% 2C 2 2 2 2 2 2r