mysqlx-connector-python 9.1.0__cp313-cp313-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. _mysqlxpb.cp313-win_amd64.pyd +0 -0
  2. mysqlx/__init__.py +136 -0
  3. mysqlx/authentication.py +186 -0
  4. mysqlx/charsets.py +620 -0
  5. mysqlx/connection.py +3374 -0
  6. mysqlx/constants.py +240 -0
  7. mysqlx/crud.py +776 -0
  8. mysqlx/dbdoc.py +120 -0
  9. mysqlx/errorcode.py +1877 -0
  10. mysqlx/errors.py +257 -0
  11. mysqlx/expr.py +1366 -0
  12. mysqlx/helpers.py +234 -0
  13. mysqlx/locales/__init__.py +80 -0
  14. mysqlx/locales/eng/__init__.py +30 -0
  15. mysqlx/locales/eng/client_error.py +152 -0
  16. mysqlx/logger.py +33 -0
  17. mysqlx/protobuf/__init__.py +627 -0
  18. mysqlx/protobuf/mysqlx_connection_pb2.py +74 -0
  19. mysqlx/protobuf/mysqlx_crud_pb2.py +108 -0
  20. mysqlx/protobuf/mysqlx_cursor_pb2.py +68 -0
  21. mysqlx/protobuf/mysqlx_datatypes_pb2.py +75 -0
  22. mysqlx/protobuf/mysqlx_expect_pb2.py +69 -0
  23. mysqlx/protobuf/mysqlx_expr_pb2.py +81 -0
  24. mysqlx/protobuf/mysqlx_notice_pb2.py +81 -0
  25. mysqlx/protobuf/mysqlx_pb2.py +71 -0
  26. mysqlx/protobuf/mysqlx_prepare_pb2.py +73 -0
  27. mysqlx/protobuf/mysqlx_resultset_pb2.py +75 -0
  28. mysqlx/protobuf/mysqlx_session_pb2.py +67 -0
  29. mysqlx/protobuf/mysqlx_sql_pb2.py +63 -0
  30. mysqlx/protocol.py +1214 -0
  31. mysqlx/py.typed +0 -0
  32. mysqlx/result.py +1177 -0
  33. mysqlx/statement.py +1542 -0
  34. mysqlx/tls_ciphers.py +169 -0
  35. mysqlx/types.py +120 -0
  36. mysqlx/utils.py +178 -0
  37. mysqlx/version.py +46 -0
  38. mysqlx_connector_python-9.1.0.dist-info/LICENSE.txt +4247 -0
  39. mysqlx_connector_python-9.1.0.dist-info/METADATA +187 -0
  40. mysqlx_connector_python-9.1.0.dist-info/RECORD +42 -0
  41. mysqlx_connector_python-9.1.0.dist-info/WHEEL +5 -0
  42. mysqlx_connector_python-9.1.0.dist-info/top_level.txt +2 -0
mysqlx/constants.py ADDED
@@ -0,0 +1,240 @@
1
+ # Copyright (c) 2016, 2024, Oracle and/or its affiliates.
2
+ #
3
+ # This program is free software; you can redistribute it and/or modify
4
+ # it under the terms of the GNU General Public License, version 2.0, as
5
+ # published by the Free Software Foundation.
6
+ #
7
+ # This program is designed to work with certain software (including
8
+ # but not limited to OpenSSL) that is licensed under separate terms,
9
+ # as designated in a particular file or component or in included license
10
+ # documentation. The authors of MySQL hereby grant you an
11
+ # additional permission to link the program and your derivative works
12
+ # with the separately licensed software that they have either included with
13
+ # the program or referenced in the documentation.
14
+ #
15
+ # Without limiting anything contained in the foregoing, this file,
16
+ # which is part of MySQL Connector/Python, is also subject to the
17
+ # Universal FOSS Exception, version 1.0, a copy of which can be found at
18
+ # http://oss.oracle.com/licenses/universal-foss-exception.
19
+ #
20
+ # This program is distributed in the hope that it will be useful, but
21
+ # WITHOUT ANY WARRANTY; without even the implied warranty of
22
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
23
+ # See the GNU General Public License, version 2.0, for more details.
24
+ #
25
+ # You should have received a copy of the GNU General Public License
26
+ # along with this program; if not, write to the Free Software Foundation, Inc.,
27
+ # 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
28
+
29
+ """Constants."""
30
+
31
+ from enum import Enum
32
+
33
+ from . import tls_ciphers
34
+
35
+
36
+ class Auth(Enum):
37
+ """Enum to identify the authentication mechanisms."""
38
+
39
+ PLAIN = "plain"
40
+ MYSQL41 = "mysql41"
41
+ SHA256_MEMORY = "sha256_memory"
42
+
43
+
44
+ class Compression(Enum):
45
+ """Enum to identify the compression options."""
46
+
47
+ PREFERRED = "preferred"
48
+ REQUIRED = "required"
49
+ DISABLED = "disabled"
50
+
51
+
52
+ class LockContention(Enum):
53
+ """Enum to identify the row locking modes."""
54
+
55
+ DEFAULT = 0
56
+ NOWAIT = 1
57
+ SKIP_LOCKED = 2
58
+
59
+
60
+ class SSLMode(Enum):
61
+ """Enum to identify the SSL modes."""
62
+
63
+ REQUIRED = "required"
64
+ DISABLED = "disabled"
65
+ VERIFY_CA = "verify_ca"
66
+ VERIFY_IDENTITY = "verify_identity"
67
+
68
+
69
+ # Compression algorithms and aliases
70
+ COMPRESSION_ALGORITHMS = {
71
+ "deflate": "deflate_stream",
72
+ "deflate_stream": "deflate_stream",
73
+ "lz4": "lz4_message",
74
+ "lz4_message": "lz4_message",
75
+ "zstd": "zstd_stream",
76
+ "zstd_stream": "zstd_stream",
77
+ }
78
+
79
+
80
+ SUPPORTED_TLS_VERSIONS = (
81
+ tls_ciphers.APPROVED_TLS_VERSIONS + tls_ciphers.DEPRECATED_TLS_VERSIONS
82
+ )
83
+
84
+
85
+ # TLS v1.2 cipher suites IANI to OpenSSL name translation
86
+ TLSV1_2_CIPHER_SUITES = {
87
+ "TLS_RSA_WITH_NULL_SHA256": "NULL-SHA256",
88
+ "TLS_RSA_WITH_AES_128_CBC_SHA256": "AES128-SHA256",
89
+ "TLS_RSA_WITH_AES_256_CBC_SHA256": "AES256-SHA256",
90
+ "TLS_RSA_WITH_AES_128_GCM_SHA256": "AES128-GCM-SHA256",
91
+ "TLS_RSA_WITH_AES_256_GCM_SHA384": "AES256-GCM-SHA384",
92
+ "TLS_DH_RSA_WITH_AES_128_CBC_SHA256": "DH-RSA-AES128-SHA256",
93
+ "TLS_DH_RSA_WITH_AES_256_CBC_SHA256": "DH-RSA-AES256-SHA256",
94
+ "TLS_DH_RSA_WITH_AES_128_GCM_SHA256": "DH-RSA-AES128-GCM-SHA256",
95
+ "TLS_DH_RSA_WITH_AES_256_GCM_SHA384": "DH-RSA-AES256-GCM-SHA384",
96
+ "TLS_DH_DSS_WITH_AES_128_CBC_SHA256": "DH-DSS-AES128-SHA256",
97
+ "TLS_DH_DSS_WITH_AES_256_CBC_SHA256": "DH-DSS-AES256-SHA256",
98
+ "TLS_DH_DSS_WITH_AES_128_GCM_SHA256": "DH-DSS-AES128-GCM-SHA256",
99
+ "TLS_DH_DSS_WITH_AES_256_GCM_SHA384": "DH-DSS-AES256-GCM-SHA384",
100
+ "TLS_DHE_RSA_WITH_AES_128_CBC_SHA256": "DHE-RSA-AES128-SHA256",
101
+ "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256": "DHE-RSA-AES256-SHA256",
102
+ "TLS_DHE_RSA_WITH_AES_128_GCM_SHA256": "DHE-RSA-AES128-GCM-SHA256",
103
+ "TLS_DHE_RSA_WITH_AES_256_GCM_SHA384": "DHE-RSA-AES256-GCM-SHA384",
104
+ "TLS_DHE_DSS_WITH_AES_128_CBC_SHA256": "DHE-DSS-AES128-SHA256",
105
+ "TLS_DHE_DSS_WITH_AES_256_CBC_SHA256": "DHE-DSS-AES256-SHA256",
106
+ "TLS_DHE_DSS_WITH_AES_128_GCM_SHA256": "DHE-DSS-AES128-GCM-SHA256",
107
+ "TLS_DHE_DSS_WITH_AES_256_GCM_SHA384": "DHE-DSS-AES256-GCM-SHA384",
108
+ "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256": "ECDHE-RSA-AES128-SHA256",
109
+ "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384": "ECDHE-RSA-AES256-SHA384",
110
+ "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256": "ECDHE-RSA-AES128-GCM-SHA256",
111
+ "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384": "ECDHE-RSA-AES256-GCM-SHA384",
112
+ "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256": "ECDHE-ECDSA-AES128-SHA256",
113
+ "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384": "ECDHE-ECDSA-AES256-SHA384",
114
+ "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256": "ECDHE-ECDSA-AES128-GCM-SHA256",
115
+ "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384": "ECDHE-ECDSA-AES256-GCM-SHA384",
116
+ "TLS_DH_anon_WITH_AES_128_CBC_SHA256": "ADH-AES128-SHA256",
117
+ "TLS_DH_anon_WITH_AES_256_CBC_SHA256": "ADH-AES256-SHA256",
118
+ "TLS_DH_anon_WITH_AES_128_GCM_SHA256": "ADH-AES128-GCM-SHA256",
119
+ "TLS_DH_anon_WITH_AES_256_GCM_SHA384": "ADH-AES256-GCM-SHA384",
120
+ "RSA_WITH_AES_128_CCM": "AES128-CCM",
121
+ "RSA_WITH_AES_256_CCM": "AES256-CCM",
122
+ "DHE_RSA_WITH_AES_128_CCM": "DHE-RSA-AES128-CCM",
123
+ "DHE_RSA_WITH_AES_256_CCM": "DHE-RSA-AES256-CCM",
124
+ "RSA_WITH_AES_128_CCM_8": "AES128-CCM8",
125
+ "RSA_WITH_AES_256_CCM_8": "AES256-CCM8",
126
+ "DHE_RSA_WITH_AES_128_CCM_8": "DHE-RSA-AES128-CCM8",
127
+ "DHE_RSA_WITH_AES_256_CCM_8": "DHE-RSA-AES256-CCM8",
128
+ "ECDHE_ECDSA_WITH_AES_128_CCM": "ECDHE-ECDSA-AES128-CCM",
129
+ "ECDHE_ECDSA_WITH_AES_256_CCM": "ECDHE-ECDSA-AES256-CCM",
130
+ "ECDHE_ECDSA_WITH_AES_128_CCM_8": "ECDHE-ECDSA-AES128-CCM8",
131
+ "ECDHE_ECDSA_WITH_AES_256_CCM_8": "ECDHE-ECDSA-AES256-CCM8",
132
+ # ARIA cipher suites from RFC6209, extending TLS v1.2
133
+ "TLS_RSA_WITH_ARIA_128_GCM_SHA256": "ARIA128-GCM-SHA256",
134
+ "TLS_RSA_WITH_ARIA_256_GCM_SHA384": "ARIA256-GCM-SHA384",
135
+ "TLS_DHE_RSA_WITH_ARIA_128_GCM_SHA256": "DHE-RSA-ARIA128-GCM-SHA256",
136
+ "TLS_DHE_RSA_WITH_ARIA_256_GCM_SHA384": "DHE-RSA-ARIA256-GCM-SHA384",
137
+ "TLS_DHE_DSS_WITH_ARIA_128_GCM_SHA256": "DHE-DSS-ARIA128-GCM-SHA256",
138
+ "TLS_DHE_DSS_WITH_ARIA_256_GCM_SHA384": "DHE-DSS-ARIA256-GCM-SHA384",
139
+ "TLS_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256": "ECDHE-ECDSA-ARIA128-GCM-SHA256",
140
+ "TLS_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384": "ECDHE-ECDSA-ARIA256-GCM-SHA384",
141
+ "TLS_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256": "ECDHE-ARIA128-GCM-SHA256",
142
+ "TLS_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384": "ECDHE-ARIA256-GCM-SHA384",
143
+ "TLS_PSK_WITH_ARIA_128_GCM_SHA256": "PSK-ARIA128-GCM-SHA256",
144
+ "TLS_PSK_WITH_ARIA_256_GCM_SHA384": "PSK-ARIA256-GCM-SHA384",
145
+ "TLS_DHE_PSK_WITH_ARIA_128_GCM_SHA256": "DHE-PSK-ARIA128-GCM-SHA256",
146
+ "TLS_DHE_PSK_WITH_ARIA_256_GCM_SHA384": "DHE-PSK-ARIA256-GCM-SHA384",
147
+ "TLS_RSA_PSK_WITH_ARIA_128_GCM_SHA256": "RSA-PSK-ARIA128-GCM-SHA256",
148
+ "TLS_RSA_PSK_WITH_ARIA_256_GCM_SHA384": "RSA-PSK-ARIA256-GCM-SHA384",
149
+ # Camellia HMAC-Based cipher suites from RFC6367, extending TLS v1.2
150
+ "TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256": "ECDHE-ECDSA-CAMELLIA128-SHA256",
151
+ "TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384": "ECDHE-ECDSA-CAMELLIA256-SHA384",
152
+ "TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256": "ECDHE-RSA-CAMELLIA128-SHA256",
153
+ "TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384": "ECDHE-RSA-CAMELLIA256-SHA384",
154
+ # Pre-shared keying (PSK) cipher suites",
155
+ "PSK_WITH_NULL_SHA": "PSK-NULL-SHA",
156
+ "DHE_PSK_WITH_NULL_SHA": "DHE-PSK-NULL-SHA",
157
+ "RSA_PSK_WITH_NULL_SHA": "RSA-PSK-NULL-SHA",
158
+ "PSK_WITH_RC4_128_SHA": "PSK-RC4-SHA",
159
+ "PSK_WITH_3DES_EDE_CBC_SHA": "PSK-3DES-EDE-CBC-SHA",
160
+ "PSK_WITH_AES_128_CBC_SHA": "PSK-AES128-CBC-SHA",
161
+ "PSK_WITH_AES_256_CBC_SHA": "PSK-AES256-CBC-SHA",
162
+ "DHE_PSK_WITH_RC4_128_SHA": "DHE-PSK-RC4-SHA",
163
+ "DHE_PSK_WITH_3DES_EDE_CBC_SHA": "DHE-PSK-3DES-EDE-CBC-SHA",
164
+ "DHE_PSK_WITH_AES_128_CBC_SHA": "DHE-PSK-AES128-CBC-SHA",
165
+ "DHE_PSK_WITH_AES_256_CBC_SHA": "DHE-PSK-AES256-CBC-SHA",
166
+ "RSA_PSK_WITH_RC4_128_SHA": "RSA-PSK-RC4-SHA",
167
+ "RSA_PSK_WITH_3DES_EDE_CBC_SHA": "RSA-PSK-3DES-EDE-CBC-SHA",
168
+ "RSA_PSK_WITH_AES_128_CBC_SHA": "RSA-PSK-AES128-CBC-SHA",
169
+ "RSA_PSK_WITH_AES_256_CBC_SHA": "RSA-PSK-AES256-CBC-SHA",
170
+ "PSK_WITH_AES_128_GCM_SHA256": "PSK-AES128-GCM-SHA256",
171
+ "PSK_WITH_AES_256_GCM_SHA384": "PSK-AES256-GCM-SHA384",
172
+ "DHE_PSK_WITH_AES_128_GCM_SHA256": "DHE-PSK-AES128-GCM-SHA256",
173
+ "DHE_PSK_WITH_AES_256_GCM_SHA384": "DHE-PSK-AES256-GCM-SHA384",
174
+ "RSA_PSK_WITH_AES_128_GCM_SHA256": "RSA-PSK-AES128-GCM-SHA256",
175
+ "RSA_PSK_WITH_AES_256_GCM_SHA384": "RSA-PSK-AES256-GCM-SHA384",
176
+ "PSK_WITH_AES_128_CBC_SHA256": "PSK-AES128-CBC-SHA256",
177
+ "PSK_WITH_AES_256_CBC_SHA384": "PSK-AES256-CBC-SHA384",
178
+ "PSK_WITH_NULL_SHA256": "PSK-NULL-SHA256",
179
+ "PSK_WITH_NULL_SHA384": "PSK-NULL-SHA384",
180
+ "DHE_PSK_WITH_AES_128_CBC_SHA256": "DHE-PSK-AES128-CBC-SHA256",
181
+ "DHE_PSK_WITH_AES_256_CBC_SHA384": "DHE-PSK-AES256-CBC-SHA384",
182
+ "DHE_PSK_WITH_NULL_SHA256": "DHE-PSK-NULL-SHA256",
183
+ "DHE_PSK_WITH_NULL_SHA384": "DHE-PSK-NULL-SHA384",
184
+ "RSA_PSK_WITH_AES_128_CBC_SHA256": "RSA-PSK-AES128-CBC-SHA256",
185
+ "RSA_PSK_WITH_AES_256_CBC_SHA384": "RSA-PSK-AES256-CBC-SHA384",
186
+ "RSA_PSK_WITH_NULL_SHA256": "RSA-PSK-NULL-SHA256",
187
+ "RSA_PSK_WITH_NULL_SHA384": "RSA-PSK-NULL-SHA384",
188
+ "ECDHE_PSK_WITH_RC4_128_SHA": "ECDHE-PSK-RC4-SHA",
189
+ "ECDHE_PSK_WITH_3DES_EDE_CBC_SHA": "ECDHE-PSK-3DES-EDE-CBC-SHA",
190
+ "ECDHE_PSK_WITH_AES_128_CBC_SHA": "ECDHE-PSK-AES128-CBC-SHA",
191
+ "ECDHE_PSK_WITH_AES_256_CBC_SHA": "ECDHE-PSK-AES256-CBC-SHA",
192
+ "ECDHE_PSK_WITH_AES_128_CBC_SHA256": "ECDHE-PSK-AES128-CBC-SHA256",
193
+ "ECDHE_PSK_WITH_AES_256_CBC_SHA384": "ECDHE-PSK-AES256-CBC-SHA384",
194
+ "ECDHE_PSK_WITH_NULL_SHA": "ECDHE-PSK-NULL-SHA",
195
+ "ECDHE_PSK_WITH_NULL_SHA256": "ECDHE-PSK-NULL-SHA256",
196
+ "ECDHE_PSK_WITH_NULL_SHA384": "ECDHE-PSK-NULL-SHA384",
197
+ "PSK_WITH_CAMELLIA_128_CBC_SHA256": "PSK-CAMELLIA128-SHA256",
198
+ "PSK_WITH_CAMELLIA_256_CBC_SHA384": "PSK-CAMELLIA256-SHA384",
199
+ "DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256": "DHE-PSK-CAMELLIA128-SHA256",
200
+ "DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384": "DHE-PSK-CAMELLIA256-SHA384",
201
+ "RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256": "RSA-PSK-CAMELLIA128-SHA256",
202
+ "RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384": "RSA-PSK-CAMELLIA256-SHA384",
203
+ "ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256": "ECDHE-PSK-CAMELLIA128-SHA256",
204
+ "ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384": "ECDHE-PSK-CAMELLIA256-SHA384",
205
+ "PSK_WITH_AES_128_CCM": "PSK-AES128-CCM",
206
+ "PSK_WITH_AES_256_CCM": "PSK-AES256-CCM",
207
+ "DHE_PSK_WITH_AES_128_CCM": "DHE-PSK-AES128-CCM",
208
+ "DHE_PSK_WITH_AES_256_CCM": "DHE-PSK-AES256-CCM",
209
+ "PSK_WITH_AES_128_CCM_8": "PSK-AES128-CCM8",
210
+ "PSK_WITH_AES_256_CCM_8": "PSK-AES256-CCM8",
211
+ "DHE_PSK_WITH_AES_128_CCM_8": "DHE-PSK-AES128-CCM8",
212
+ "DHE_PSK_WITH_AES_256_CCM_8": "DHE-PSK-AES256-CCM8",
213
+ # ChaCha20-Poly1305 cipher suites, extending TLS v1.2
214
+ "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256": "ECDHE-RSA-CHACHA20-POLY1305",
215
+ "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256": "ECDHE-ECDSA-CHACHA20-POLY1305",
216
+ "TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256": "DHE-RSA-CHACHA20-POLY1305",
217
+ "TLS_PSK_WITH_CHACHA20_POLY1305_SHA256": "PSK-CHACHA20-POLY1305",
218
+ "TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256": "ECDHE-PSK-CHACHA20-POLY1305",
219
+ "TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256": "DHE-PSK-CHACHA20-POLY1305",
220
+ "TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256": "RSA-PSK-CHACHA20-POLY1305",
221
+ }
222
+
223
+ # TLS v1.3 cipher suites IANI to OpenSSL name translation
224
+ TLSV1_3_CIPHER_SUITES = {
225
+ "TLS_AES_128_GCM_SHA256": "TLS_AES_128_GCM_SHA256",
226
+ "TLS_AES_256_GCM_SHA384": "TLS_AES_256_GCM_SHA384",
227
+ "TLS_CHACHA20_POLY1305_SHA256": "TLS_CHACHA20_POLY1305_SHA256",
228
+ "TLS_AES_128_CCM_SHA256": "TLS_AES_128_CCM_SHA256",
229
+ "TLS_AES_128_CCM_8_SHA256": "TLS_AES_128_CCM_8_SHA256",
230
+ }
231
+
232
+ TLS_CIPHER_SUITES = {
233
+ "TLSv1.2": TLSV1_2_CIPHER_SUITES,
234
+ "TLSv1.3": TLSV1_3_CIPHER_SUITES,
235
+ }
236
+
237
+ OPENSSL_CS_NAMES = {
238
+ "TLSv1.2": TLSV1_2_CIPHER_SUITES.values(),
239
+ "TLSv1.3": TLSV1_3_CIPHER_SUITES.values(),
240
+ }