singlestoredb 1.16.1__py3-none-any.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 (183) hide show
  1. singlestoredb/__init__.py +75 -0
  2. singlestoredb/ai/__init__.py +2 -0
  3. singlestoredb/ai/chat.py +139 -0
  4. singlestoredb/ai/embeddings.py +128 -0
  5. singlestoredb/alchemy/__init__.py +90 -0
  6. singlestoredb/apps/__init__.py +3 -0
  7. singlestoredb/apps/_cloud_functions.py +90 -0
  8. singlestoredb/apps/_config.py +72 -0
  9. singlestoredb/apps/_connection_info.py +18 -0
  10. singlestoredb/apps/_dashboards.py +47 -0
  11. singlestoredb/apps/_process.py +32 -0
  12. singlestoredb/apps/_python_udfs.py +100 -0
  13. singlestoredb/apps/_stdout_supress.py +30 -0
  14. singlestoredb/apps/_uvicorn_util.py +36 -0
  15. singlestoredb/auth.py +245 -0
  16. singlestoredb/config.py +484 -0
  17. singlestoredb/connection.py +1487 -0
  18. singlestoredb/converters.py +950 -0
  19. singlestoredb/docstring/__init__.py +33 -0
  20. singlestoredb/docstring/attrdoc.py +126 -0
  21. singlestoredb/docstring/common.py +230 -0
  22. singlestoredb/docstring/epydoc.py +267 -0
  23. singlestoredb/docstring/google.py +412 -0
  24. singlestoredb/docstring/numpydoc.py +562 -0
  25. singlestoredb/docstring/parser.py +100 -0
  26. singlestoredb/docstring/py.typed +1 -0
  27. singlestoredb/docstring/rest.py +256 -0
  28. singlestoredb/docstring/tests/__init__.py +1 -0
  29. singlestoredb/docstring/tests/_pydoctor.py +21 -0
  30. singlestoredb/docstring/tests/test_epydoc.py +729 -0
  31. singlestoredb/docstring/tests/test_google.py +1007 -0
  32. singlestoredb/docstring/tests/test_numpydoc.py +1100 -0
  33. singlestoredb/docstring/tests/test_parse_from_object.py +109 -0
  34. singlestoredb/docstring/tests/test_parser.py +248 -0
  35. singlestoredb/docstring/tests/test_rest.py +547 -0
  36. singlestoredb/docstring/tests/test_util.py +70 -0
  37. singlestoredb/docstring/util.py +141 -0
  38. singlestoredb/exceptions.py +120 -0
  39. singlestoredb/functions/__init__.py +16 -0
  40. singlestoredb/functions/decorator.py +201 -0
  41. singlestoredb/functions/dtypes.py +1793 -0
  42. singlestoredb/functions/ext/__init__.py +1 -0
  43. singlestoredb/functions/ext/arrow.py +375 -0
  44. singlestoredb/functions/ext/asgi.py +2133 -0
  45. singlestoredb/functions/ext/json.py +420 -0
  46. singlestoredb/functions/ext/mmap.py +413 -0
  47. singlestoredb/functions/ext/rowdat_1.py +724 -0
  48. singlestoredb/functions/ext/timer.py +89 -0
  49. singlestoredb/functions/ext/utils.py +218 -0
  50. singlestoredb/functions/signature.py +1578 -0
  51. singlestoredb/functions/typing/__init__.py +41 -0
  52. singlestoredb/functions/typing/numpy.py +20 -0
  53. singlestoredb/functions/typing/pandas.py +2 -0
  54. singlestoredb/functions/typing/polars.py +2 -0
  55. singlestoredb/functions/typing/pyarrow.py +2 -0
  56. singlestoredb/functions/utils.py +421 -0
  57. singlestoredb/fusion/__init__.py +11 -0
  58. singlestoredb/fusion/graphql.py +213 -0
  59. singlestoredb/fusion/handler.py +916 -0
  60. singlestoredb/fusion/handlers/__init__.py +0 -0
  61. singlestoredb/fusion/handlers/export.py +525 -0
  62. singlestoredb/fusion/handlers/files.py +690 -0
  63. singlestoredb/fusion/handlers/job.py +660 -0
  64. singlestoredb/fusion/handlers/models.py +250 -0
  65. singlestoredb/fusion/handlers/stage.py +502 -0
  66. singlestoredb/fusion/handlers/utils.py +324 -0
  67. singlestoredb/fusion/handlers/workspace.py +956 -0
  68. singlestoredb/fusion/registry.py +249 -0
  69. singlestoredb/fusion/result.py +399 -0
  70. singlestoredb/http/__init__.py +27 -0
  71. singlestoredb/http/connection.py +1267 -0
  72. singlestoredb/magics/__init__.py +34 -0
  73. singlestoredb/magics/run_personal.py +137 -0
  74. singlestoredb/magics/run_shared.py +134 -0
  75. singlestoredb/management/__init__.py +9 -0
  76. singlestoredb/management/billing_usage.py +148 -0
  77. singlestoredb/management/cluster.py +462 -0
  78. singlestoredb/management/export.py +295 -0
  79. singlestoredb/management/files.py +1102 -0
  80. singlestoredb/management/inference_api.py +105 -0
  81. singlestoredb/management/job.py +887 -0
  82. singlestoredb/management/manager.py +373 -0
  83. singlestoredb/management/organization.py +226 -0
  84. singlestoredb/management/region.py +169 -0
  85. singlestoredb/management/utils.py +423 -0
  86. singlestoredb/management/workspace.py +1927 -0
  87. singlestoredb/mysql/__init__.py +177 -0
  88. singlestoredb/mysql/_auth.py +298 -0
  89. singlestoredb/mysql/charset.py +214 -0
  90. singlestoredb/mysql/connection.py +2032 -0
  91. singlestoredb/mysql/constants/CLIENT.py +38 -0
  92. singlestoredb/mysql/constants/COMMAND.py +32 -0
  93. singlestoredb/mysql/constants/CR.py +78 -0
  94. singlestoredb/mysql/constants/ER.py +474 -0
  95. singlestoredb/mysql/constants/EXTENDED_TYPE.py +3 -0
  96. singlestoredb/mysql/constants/FIELD_TYPE.py +48 -0
  97. singlestoredb/mysql/constants/FLAG.py +15 -0
  98. singlestoredb/mysql/constants/SERVER_STATUS.py +10 -0
  99. singlestoredb/mysql/constants/VECTOR_TYPE.py +6 -0
  100. singlestoredb/mysql/constants/__init__.py +0 -0
  101. singlestoredb/mysql/converters.py +271 -0
  102. singlestoredb/mysql/cursors.py +896 -0
  103. singlestoredb/mysql/err.py +92 -0
  104. singlestoredb/mysql/optionfile.py +20 -0
  105. singlestoredb/mysql/protocol.py +450 -0
  106. singlestoredb/mysql/tests/__init__.py +19 -0
  107. singlestoredb/mysql/tests/base.py +126 -0
  108. singlestoredb/mysql/tests/conftest.py +37 -0
  109. singlestoredb/mysql/tests/test_DictCursor.py +132 -0
  110. singlestoredb/mysql/tests/test_SSCursor.py +141 -0
  111. singlestoredb/mysql/tests/test_basic.py +452 -0
  112. singlestoredb/mysql/tests/test_connection.py +851 -0
  113. singlestoredb/mysql/tests/test_converters.py +58 -0
  114. singlestoredb/mysql/tests/test_cursor.py +141 -0
  115. singlestoredb/mysql/tests/test_err.py +16 -0
  116. singlestoredb/mysql/tests/test_issues.py +514 -0
  117. singlestoredb/mysql/tests/test_load_local.py +75 -0
  118. singlestoredb/mysql/tests/test_nextset.py +88 -0
  119. singlestoredb/mysql/tests/test_optionfile.py +27 -0
  120. singlestoredb/mysql/tests/thirdparty/__init__.py +6 -0
  121. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/__init__.py +9 -0
  122. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/capabilities.py +323 -0
  123. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/dbapi20.py +865 -0
  124. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/test_MySQLdb_capabilities.py +110 -0
  125. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/test_MySQLdb_dbapi20.py +224 -0
  126. singlestoredb/mysql/tests/thirdparty/test_MySQLdb/test_MySQLdb_nonstandard.py +101 -0
  127. singlestoredb/mysql/times.py +23 -0
  128. singlestoredb/notebook/__init__.py +16 -0
  129. singlestoredb/notebook/_objects.py +213 -0
  130. singlestoredb/notebook/_portal.py +352 -0
  131. singlestoredb/py.typed +0 -0
  132. singlestoredb/pytest.py +352 -0
  133. singlestoredb/server/__init__.py +0 -0
  134. singlestoredb/server/docker.py +452 -0
  135. singlestoredb/server/free_tier.py +267 -0
  136. singlestoredb/tests/__init__.py +0 -0
  137. singlestoredb/tests/alltypes.sql +307 -0
  138. singlestoredb/tests/alltypes_no_nulls.sql +208 -0
  139. singlestoredb/tests/empty.sql +0 -0
  140. singlestoredb/tests/ext_funcs/__init__.py +702 -0
  141. singlestoredb/tests/local_infile.csv +3 -0
  142. singlestoredb/tests/test.ipynb +18 -0
  143. singlestoredb/tests/test.sql +680 -0
  144. singlestoredb/tests/test2.ipynb +18 -0
  145. singlestoredb/tests/test2.sql +1 -0
  146. singlestoredb/tests/test_basics.py +1332 -0
  147. singlestoredb/tests/test_config.py +318 -0
  148. singlestoredb/tests/test_connection.py +3103 -0
  149. singlestoredb/tests/test_dbapi.py +27 -0
  150. singlestoredb/tests/test_exceptions.py +45 -0
  151. singlestoredb/tests/test_ext_func.py +1472 -0
  152. singlestoredb/tests/test_ext_func_data.py +1101 -0
  153. singlestoredb/tests/test_fusion.py +1527 -0
  154. singlestoredb/tests/test_http.py +288 -0
  155. singlestoredb/tests/test_management.py +1599 -0
  156. singlestoredb/tests/test_plugin.py +33 -0
  157. singlestoredb/tests/test_results.py +171 -0
  158. singlestoredb/tests/test_types.py +132 -0
  159. singlestoredb/tests/test_udf.py +737 -0
  160. singlestoredb/tests/test_udf_returns.py +459 -0
  161. singlestoredb/tests/test_vectorstore.py +51 -0
  162. singlestoredb/tests/test_xdict.py +333 -0
  163. singlestoredb/tests/utils.py +141 -0
  164. singlestoredb/types.py +373 -0
  165. singlestoredb/utils/__init__.py +0 -0
  166. singlestoredb/utils/config.py +950 -0
  167. singlestoredb/utils/convert_rows.py +69 -0
  168. singlestoredb/utils/debug.py +13 -0
  169. singlestoredb/utils/dtypes.py +205 -0
  170. singlestoredb/utils/events.py +65 -0
  171. singlestoredb/utils/mogrify.py +151 -0
  172. singlestoredb/utils/results.py +585 -0
  173. singlestoredb/utils/xdict.py +425 -0
  174. singlestoredb/vectorstore.py +192 -0
  175. singlestoredb/warnings.py +5 -0
  176. singlestoredb-1.16.1.dist-info/METADATA +165 -0
  177. singlestoredb-1.16.1.dist-info/RECORD +183 -0
  178. singlestoredb-1.16.1.dist-info/WHEEL +5 -0
  179. singlestoredb-1.16.1.dist-info/entry_points.txt +2 -0
  180. singlestoredb-1.16.1.dist-info/licenses/LICENSE +201 -0
  181. singlestoredb-1.16.1.dist-info/top_level.txt +3 -0
  182. sqlx/__init__.py +4 -0
  183. sqlx/magic.py +113 -0
@@ -0,0 +1,318 @@
1
+ #!/usr/bin/env python
2
+ # type: ignore
3
+ # encoding: utf-8
4
+ #
5
+ # Copyright SAS Institute
6
+ #
7
+ # Licensed under the Apache License, Version 2.0 (the License);
8
+ # you may not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing, software
14
+ # distributed under the License is distributed on an "AS IS" BASIS,
15
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16
+ # See the License for the specific language governing permissions and
17
+ # limitations under the License.
18
+ #
19
+ # This file originally copied from https://github.com/sassoftware/python-swat
20
+ #
21
+ import unittest
22
+
23
+ from singlestoredb.config import check_bool
24
+ from singlestoredb.config import check_float
25
+ from singlestoredb.config import check_int
26
+ from singlestoredb.config import check_str
27
+ from singlestoredb.config import check_url
28
+ from singlestoredb.config import describe_option
29
+ from singlestoredb.config import get_default
30
+ from singlestoredb.config import get_option
31
+ from singlestoredb.config import get_suboptions
32
+ from singlestoredb.config import options
33
+ from singlestoredb.config import reset_option
34
+ from singlestoredb.config import set_option
35
+
36
+
37
+ class TestConfig(unittest.TestCase):
38
+
39
+ def setUp(self):
40
+ reset_option()
41
+
42
+ def tearDown(self):
43
+ reset_option()
44
+
45
+ def test_basic(self):
46
+ self.assertEqual(get_option('local_infile'), False)
47
+
48
+ set_option('local_infile', True)
49
+
50
+ self.assertEqual(get_option('local_infile'), True)
51
+
52
+ with self.assertRaises(ValueError):
53
+ options.local_infile = 'foo'
54
+
55
+ options.local_infile = False
56
+ self.assertEqual(options.local_infile, False)
57
+
58
+ with self.assertRaises(ValueError):
59
+ options.local_infile = 10
60
+
61
+ self.assertEqual(options.local_infile, False)
62
+
63
+ self.assertEqual(type(options.results), type(options))
64
+
65
+ options.local_infile = False
66
+
67
+ reset_option('local_infile')
68
+
69
+ self.assertEqual(options.local_infile, False)
70
+
71
+ with self.assertRaises(KeyError):
72
+ reset_option('results.foo')
73
+
74
+ with self.assertRaises(TypeError):
75
+ reset_option('results')
76
+
77
+ def test_shortcut_options(self):
78
+ asize = get_option('results.arraysize')
79
+ token = get_option('management.token')
80
+
81
+ self.assertEqual(get_option('arraysize'), asize)
82
+ self.assertEqual(options.arraysize, asize)
83
+
84
+ options.arraysize = 20
85
+
86
+ self.assertEqual(get_option('results.arraysize'), 20)
87
+ self.assertEqual(options.results.arraysize, 20)
88
+ self.assertEqual(options.arraysize, 20)
89
+
90
+ self.assertEqual(get_option('token'), token)
91
+ self.assertEqual(get_option('management.token'), token)
92
+ self.assertEqual(options.token, token)
93
+
94
+ options.token = 'Foo'
95
+
96
+ self.assertEqual(get_option('token'), 'Foo')
97
+ self.assertEqual(get_option('management.token'), 'Foo')
98
+ self.assertEqual(options.token, 'Foo')
99
+
100
+ reset_option('token')
101
+
102
+ self.assertEqual(get_option('token'), token)
103
+ self.assertEqual(get_option('management.token'), token)
104
+ self.assertEqual(options.token, token)
105
+
106
+ def test_missing_options(self):
107
+ with self.assertRaises(KeyError):
108
+ set_option('results.foo', 10)
109
+
110
+ with self.assertRaises(KeyError):
111
+ options.results.foo = 10
112
+
113
+ with self.assertRaises(KeyError):
114
+ get_option('results.foo')
115
+
116
+ with self.assertRaises(KeyError):
117
+ print(options.results.foo)
118
+
119
+ # You can not access a midpoint in the hierarchy with (s|g)et_option
120
+ with self.assertRaises(TypeError):
121
+ set_option('results', 10)
122
+
123
+ with self.assertRaises(TypeError):
124
+ get_option('results')
125
+
126
+ def test_errors(self):
127
+ with self.assertRaises(ValueError):
128
+ set_option('credential_type', 'foo')
129
+
130
+ def test_doc(self):
131
+ out = describe_option('results.arraysize', 'local_infile', _print_desc=False)
132
+ for line in out.split('\n'):
133
+ if not line or line.startswith(' '):
134
+ continue
135
+ self.assertRegex(line, r'^(results\.arraysize|local_infile)')
136
+
137
+ # Displays entire option hierarchy
138
+ out = describe_option('management', _print_desc=False)
139
+ for line in out.split('\n'):
140
+ if not line or line.startswith(' '):
141
+ continue
142
+ self.assertRegex(line, r'^management\.')
143
+
144
+ with self.assertRaises(KeyError):
145
+ describe_option('management.foo')
146
+
147
+ out = describe_option(_print_desc=False)
148
+ self.assertRegex(out, r'\bmanagement\.token :')
149
+ self.assertRegex(out, r'\bhost :')
150
+ self.assertRegex(out, r'\bport :')
151
+ self.assertRegex(out, r'\buser :')
152
+ self.assertRegex(out, r'\bpassword :')
153
+ self.assertRegex(out, r'\bcharset :')
154
+
155
+ def test_suboptions(self):
156
+ self.assertEqual(
157
+ list(sorted(get_suboptions('results').keys())),
158
+ ['arraysize', 'type'],
159
+ )
160
+
161
+ with self.assertRaises(KeyError):
162
+ get_suboptions('results.foo')
163
+
164
+ # This is an option, not a level in the hierarchy
165
+ with self.assertRaises(TypeError):
166
+ get_suboptions('results.arraysize')
167
+
168
+ def test_get_default(self):
169
+ self.assertEqual(get_default('results.arraysize'), 1)
170
+
171
+ with self.assertRaises(KeyError):
172
+ get_default('results.foo')
173
+
174
+ # This is a level in the hierarchy, not an option
175
+ with self.assertRaises(TypeError):
176
+ get_default('results')
177
+
178
+ def test_check_int(self):
179
+ self.assertEqual(check_int(10), 10)
180
+ self.assertEqual(check_int(999999999999), 999999999999)
181
+ self.assertEqual(check_int('10'), 10)
182
+
183
+ with self.assertRaises(ValueError):
184
+ check_int('foo')
185
+
186
+ self.assertEqual(check_int(10, minimum=9), 10)
187
+ self.assertEqual(check_int(10, minimum=10), 10)
188
+ with self.assertRaises(ValueError):
189
+ check_int(10, minimum=11)
190
+
191
+ self.assertEqual(check_int(10, minimum=9, exclusive_minimum=True), 10)
192
+ with self.assertRaises(ValueError):
193
+ check_int(10, minimum=10, exclusive_minimum=True)
194
+ with self.assertRaises(ValueError):
195
+ check_int(10, minimum=11, exclusive_minimum=True)
196
+
197
+ self.assertEqual(check_int(10, maximum=11), 10)
198
+ self.assertEqual(check_int(10, maximum=10), 10)
199
+ with self.assertRaises(ValueError):
200
+ check_int(10, maximum=9)
201
+
202
+ self.assertEqual(check_int(10, maximum=11, exclusive_minimum=True), 10)
203
+ with self.assertRaises(ValueError):
204
+ check_int(10, maximum=10, exclusive_maximum=True)
205
+ with self.assertRaises(ValueError):
206
+ check_int(10, maximum=9, exclusive_maximum=True)
207
+
208
+ self.assertEqual(check_int(10, multiple_of=5), 10)
209
+ with self.assertRaises(ValueError):
210
+ check_int(10, multiple_of=3)
211
+
212
+ def test_check_float(self):
213
+ self.assertEqual(check_float(123.567), 123.567)
214
+ self.assertEqual(check_float(999999999999.999), 999999999999.999)
215
+ self.assertEqual(check_float('123.567'), 123.567)
216
+
217
+ with self.assertRaises(ValueError):
218
+ check_float('foo')
219
+
220
+ self.assertEqual(check_float(123.567, minimum=123.566), 123.567)
221
+ self.assertEqual(check_float(123.567, minimum=123.567), 123.567)
222
+ with self.assertRaises(ValueError):
223
+ check_float(123.567, minimum=123.577)
224
+
225
+ self.assertEqual(
226
+ check_float(
227
+ 123.567, minimum=123.566,
228
+ exclusive_minimum=True,
229
+ ), 123.567,
230
+ )
231
+ with self.assertRaises(ValueError):
232
+ check_float(123.567, minimum=123.567, exclusive_minimum=True)
233
+ with self.assertRaises(ValueError):
234
+ check_float(123.567, minimum=123.568, exclusive_minimum=True)
235
+
236
+ self.assertEqual(check_float(123.567, maximum=123.568), 123.567)
237
+ self.assertEqual(check_float(123.567, maximum=123.567), 123.567)
238
+ with self.assertRaises(ValueError):
239
+ check_float(123.567, maximum=123.566)
240
+
241
+ self.assertEqual(
242
+ check_float(
243
+ 123.567, maximum=123.567,
244
+ exclusive_minimum=True,
245
+ ), 123.567,
246
+ )
247
+ with self.assertRaises(ValueError):
248
+ check_float(123.567, maximum=123.567, exclusive_maximum=True)
249
+ with self.assertRaises(ValueError):
250
+ check_float(123.567, maximum=123.566, exclusive_maximum=True)
251
+
252
+ with self.assertRaises(ValueError):
253
+ check_float(123.567, multiple_of=3)
254
+
255
+ def test_check_str(self):
256
+ self.assertEqual(check_str('hi there'), 'hi there')
257
+ self.assertTrue(isinstance(check_str('hi there'), str))
258
+
259
+ self.assertEqual(check_str('hi there', pattern=r' th'), 'hi there')
260
+ with self.assertRaises(ValueError):
261
+ check_str('hi there', pattern=r' th$')
262
+
263
+ self.assertEqual(check_str('hi there', max_length=20), 'hi there')
264
+ self.assertEqual(check_str('hi there', max_length=8), 'hi there')
265
+ with self.assertRaises(ValueError):
266
+ check_str('hi there', max_length=7)
267
+
268
+ self.assertEqual(check_str('hi there', min_length=3), 'hi there')
269
+ self.assertEqual(check_str('hi there', min_length=8), 'hi there')
270
+ with self.assertRaises(ValueError):
271
+ check_str('hi there', min_length=9)
272
+
273
+ self.assertEqual(
274
+ check_str('hi there', valid_values=['hi there', 'bye now']),
275
+ 'hi there',
276
+ )
277
+ with self.assertRaises(ValueError):
278
+ check_str('foo', valid_values=['hi there', 'bye now'])
279
+
280
+ # Invalid utf8 data
281
+ with self.assertRaises(ValueError):
282
+ check_str(b'\xff\xfeW[')
283
+
284
+ def test_check_url(self):
285
+ self.assertEqual(check_url('hi there'), 'hi there')
286
+ self.assertTrue(isinstance(check_url('hi there'), str))
287
+
288
+ # Invalid utf8 data
289
+ with self.assertRaises(ValueError):
290
+ check_url(b'\xff\xfeW[')
291
+
292
+ def test_check_bool(self):
293
+ self.assertEqual(check_bool(True), True)
294
+ self.assertEqual(check_bool(False), False)
295
+ self.assertEqual(check_bool(1), True)
296
+ self.assertEqual(check_bool(0), False)
297
+ self.assertEqual(check_bool('yes'), True)
298
+ self.assertEqual(check_bool('no'), False)
299
+ self.assertEqual(check_bool('T'), True)
300
+ self.assertEqual(check_bool('F'), False)
301
+ self.assertEqual(check_bool('true'), True)
302
+ self.assertEqual(check_bool('false'), False)
303
+ self.assertEqual(check_bool('on'), True)
304
+ self.assertEqual(check_bool('off'), False)
305
+ self.assertEqual(check_bool('enabled'), True)
306
+ self.assertEqual(check_bool('disabled'), False)
307
+
308
+ with self.assertRaises(ValueError):
309
+ check_bool(2)
310
+ with self.assertRaises(ValueError):
311
+ check_bool('foo')
312
+ with self.assertRaises(ValueError):
313
+ check_bool(1.1)
314
+
315
+
316
+ if __name__ == '__main__':
317
+ import nose2
318
+ nose2.main()