valkey-glide 2.2.2__cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.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 (40) hide show
  1. glide/__init__.py +388 -0
  2. glide/async_commands/__init__.py +5 -0
  3. glide/async_commands/cluster_commands.py +1476 -0
  4. glide/async_commands/core.py +7818 -0
  5. glide/async_commands/ft.py +465 -0
  6. glide/async_commands/glide_json.py +1269 -0
  7. glide/async_commands/standalone_commands.py +1001 -0
  8. glide/glide.cpython-314-x86_64-linux-gnu.so +0 -0
  9. glide/glide.pyi +61 -0
  10. glide/glide_client.py +821 -0
  11. glide/logger.py +97 -0
  12. glide/opentelemetry.py +185 -0
  13. glide/py.typed +0 -0
  14. glide_shared/__init__.py +330 -0
  15. glide_shared/commands/__init__.py +0 -0
  16. glide_shared/commands/batch.py +5997 -0
  17. glide_shared/commands/batch_options.py +261 -0
  18. glide_shared/commands/bitmap.py +320 -0
  19. glide_shared/commands/command_args.py +103 -0
  20. glide_shared/commands/core_options.py +407 -0
  21. glide_shared/commands/server_modules/ft_options/ft_aggregate_options.py +300 -0
  22. glide_shared/commands/server_modules/ft_options/ft_constants.py +84 -0
  23. glide_shared/commands/server_modules/ft_options/ft_create_options.py +423 -0
  24. glide_shared/commands/server_modules/ft_options/ft_profile_options.py +113 -0
  25. glide_shared/commands/server_modules/ft_options/ft_search_options.py +139 -0
  26. glide_shared/commands/server_modules/json_batch.py +820 -0
  27. glide_shared/commands/server_modules/json_options.py +93 -0
  28. glide_shared/commands/sorted_set.py +412 -0
  29. glide_shared/commands/stream.py +449 -0
  30. glide_shared/config.py +975 -0
  31. glide_shared/constants.py +124 -0
  32. glide_shared/exceptions.py +88 -0
  33. glide_shared/protobuf/command_request_pb2.py +56 -0
  34. glide_shared/protobuf/connection_request_pb2.py +56 -0
  35. glide_shared/protobuf/response_pb2.py +32 -0
  36. glide_shared/protobuf_codec.py +110 -0
  37. glide_shared/routes.py +161 -0
  38. valkey_glide-2.2.2.dist-info/METADATA +211 -0
  39. valkey_glide-2.2.2.dist-info/RECORD +40 -0
  40. valkey_glide-2.2.2.dist-info/WHEEL +4 -0
@@ -0,0 +1,211 @@
1
+ Metadata-Version: 2.1
2
+ Name: valkey-glide
3
+ Version: 2.2.2
4
+ Classifier: Topic :: Database
5
+ Classifier: Topic :: Utilities
6
+ Classifier: License :: OSI Approved :: Apache Software License
7
+ Classifier: Intended Audience :: Developers
8
+ Classifier: Topic :: Software Development
9
+ Classifier: Programming Language :: Rust
10
+ Classifier: Programming Language :: Python :: Implementation :: CPython
11
+ Classifier: Programming Language :: Python :: Implementation :: PyPy
12
+ Requires-Dist: anyio>=4.9.0
13
+ Requires-Dist: protobuf>=6.20
14
+ Requires-Dist: sniffio
15
+ Requires-Dist: typing-extensions>=4.8.0; python_version < '3.11'
16
+ Summary: Valkey GLIDE Async client. Supports Valkey and Redis OSS.
17
+ Author: Valkey GLIDE Maintainers
18
+ License: Apache-2.0
19
+ Requires-Python: >=3.9
20
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
21
+
22
+ # Welcome to Valkey GLIDE!
23
+
24
+ Valkey General Language Independent Driver for the Enterprise (GLIDE) is the official open-source Valkey client library, proudly part of the Valkey organization. Our mission is to make your experience with Valkey and Redis OSS seamless and enjoyable. Whether you're a seasoned developer or just starting out, Valkey GLIDE is here to support you every step of the way.
25
+
26
+ # Why Choose Valkey GLIDE?
27
+
28
+ - **Community and Open Source**: Join our vibrant community and contribute to the project. We are always here to respond, and the client is for the community.
29
+ - **Reliability**: Built with best practices learned from over a decade of operating Redis OSS-compatible services.
30
+ - **Performance**: Optimized for high performance and low latency.
31
+ - **High Availability**: Designed to ensure your applications are always up and running.
32
+ - **Cross-Language Support**: Implemented using a core driver framework written in Rust, with language-specific extensions to ensure consistency and reduce complexity.
33
+ - **Stability and Fault Tolerance**: We brought our years of experience to create a bulletproof client.
34
+ - **Backed and Supported by AWS and GCP**: Ensuring robust support and continuous improvement of the project.
35
+
36
+ ## Documentation
37
+
38
+ See GLIDE's [documentation site](https://valkey.io/valkey-glide/).
39
+ Visit our [wiki](https://github.com/valkey-io/valkey-glide/wiki/Python-wrapper) for examples and further details on TLS, Read strategy, Timeouts and various other configurations.
40
+
41
+ ## Supported Engine Versions
42
+
43
+ Refer to the [Supported Engine Versions table](https://github.com/valkey-io/valkey-glide/blob/main/README.md#supported-engine-versions) for details.
44
+
45
+ # Getting Started - Python Wrapper
46
+
47
+ ## System Requirements
48
+
49
+ The release of Valkey GLIDE was tested on the following platforms:
50
+
51
+ Linux:
52
+
53
+ - Ubuntu 20 (x86_64/amd64 and arm64/aarch64)
54
+ - Amazon Linux 2 (AL2) and 2023 (AL2023) (x86_64)
55
+
56
+ **Note: Currently Alpine Linux / MUSL is NOT supported.**
57
+
58
+ macOS:
59
+
60
+ - macOS 14.7 (Apple silicon/aarch_64)
61
+ - macOS 13.7 (x86_64/amd64)
62
+
63
+ ## Python Supported Versions
64
+
65
+ | Python Version |
66
+ |----------------|
67
+ | 3.9 |
68
+ | 3.10 |
69
+ | 3.11 |
70
+ | 3.12 |
71
+ | 3.13 |
72
+
73
+ Valkey GLIDE transparently supports both the `asyncio` and `trio` concurrency frameworks.
74
+
75
+ ## Installation and Setup
76
+
77
+ ### ✅ Async Client
78
+
79
+ To install the async version:
80
+
81
+ ```bash
82
+ pip install valkey-glide
83
+ ```
84
+
85
+ Verify installation:
86
+
87
+ ```bash
88
+ python3
89
+ >>> import glide
90
+ ```
91
+
92
+ ### ✅ Sync Client
93
+
94
+ To install the sync version:
95
+
96
+ ```bash
97
+ pip install valkey-glide-sync
98
+ ```
99
+
100
+ Verify installation:
101
+
102
+ ```bash
103
+ python3
104
+ >>> import glide_sync
105
+ ```
106
+
107
+ ---
108
+
109
+ ## Basic Examples
110
+
111
+ ### 🔁 Async Client
112
+
113
+ ### ✅ Async Cluster Mode
114
+
115
+ ```python
116
+ import asyncio
117
+ from glide import GlideClusterClientConfiguration, NodeAddress, GlideClusterClient
118
+
119
+ async def test_cluster_client():
120
+ addresses = [NodeAddress("address.example.com", 6379)]
121
+ # It is recommended to set a timeout for your specific use case
122
+ config = GlideClusterClientConfiguration(addresses, request_timeout=500) # 500ms timeout
123
+ client = await GlideClusterClient.create(config)
124
+ set_result = await client.set("foo", "bar")
125
+ print(f"Set response is {set_result}")
126
+ get_result = await client.get("foo")
127
+ print(f"Get response is {get_result}")
128
+
129
+ asyncio.run(test_cluster_client())
130
+ ```
131
+
132
+ #### ✅ Async Standalone Mode
133
+
134
+ ```python
135
+ import asyncio
136
+ from glide import GlideClientConfiguration, NodeAddress, GlideClient
137
+
138
+ async def test_standalone_client():
139
+ addresses = [
140
+ NodeAddress("server_primary.example.com", 6379),
141
+ NodeAddress("server_replica.example.com", 6379)
142
+ ]
143
+ # It is recommended to set a timeout for your specific use case
144
+ config = GlideClientConfiguration(addresses, request_timeout=500) # 500ms timeout
145
+ client = await GlideClient.create(config)
146
+ set_result = await client.set("foo", "bar")
147
+ print(f"Set response is {set_result}")
148
+ get_result = await client.get("foo")
149
+ print(f"Get response is {get_result}")
150
+
151
+ asyncio.run(test_standalone_client())
152
+ ```
153
+
154
+ ---
155
+
156
+ ### 🔂 Sync Client
157
+
158
+ #### ✅ Sync Cluster Mode
159
+
160
+ ```python
161
+ from glide_sync import GlideClusterClientConfiguration, NodeAddress, GlideClusterClient
162
+
163
+ def test_cluster_client():
164
+ addresses = [NodeAddress("address.example.com", 6379)]
165
+ # It is recommended to set a timeout for your specific use case
166
+ config = GlideClusterClientConfiguration(addresses, request_timeout=500) # 500ms timeout
167
+ client = GlideClusterClient.create(config)
168
+ set_result = client.set("foo", "bar")
169
+ print(f"Set response is {set_result}")
170
+ get_result = client.get("foo")
171
+ print(f"Get response is {get_result}")
172
+
173
+ test_cluster_client()
174
+ ```
175
+
176
+ #### ✅ Sync Standalone Mode
177
+
178
+ ```python
179
+ from glide_sync import GlideClientConfiguration, NodeAddress, GlideClient
180
+
181
+ def test_standalone_client():
182
+ addresses = [
183
+ NodeAddress("server_primary.example.com", 6379),
184
+ NodeAddress("server_replica.example.com", 6379)
185
+ ]
186
+ # It is recommended to set a timeout for your specific use case
187
+ config = GlideClientConfiguration(addresses, request_timeout=500) # 500ms timeout
188
+ client = GlideClient.create(config)
189
+ set_result = client.set("foo", "bar")
190
+ print(f"Set response is {set_result}")
191
+ get_result = client.get("foo")
192
+ print(f"Get response is {get_result}")
193
+
194
+ test_standalone_client()
195
+ ```
196
+
197
+ ---
198
+
199
+ For complete examples with error handling, please refer to:
200
+ - [Async Cluster Example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/cluster_example.py)
201
+ - [Async Standalone Example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/standalone_example.py)
202
+
203
+
204
+ ### Building & Testing
205
+
206
+ Development instructions for local building & testing the package are in the [DEVELOPER.md](https://github.com/valkey-io/valkey-glide/blob/main/python/DEVELOPER.md#build-from-source) file.
207
+
208
+ ## Community and Feedback
209
+
210
+ We encourage you to join our community to support, share feedback, and ask questions. You can approach us for anything on our Valkey Slack: [Join Valkey Slack](https://join.slack.com/t/valkey-oss-developer/shared_invite/zt-2nxs51chx-EB9hu9Qdch3GMfRcztTSkQ).
211
+
@@ -0,0 +1,40 @@
1
+ valkey_glide-2.2.2.dist-info/METADATA,sha256=zR9n1QhTaaxGQkMDmfXw3oOuisaXJbFx8I0UHB3ETGY,6998
2
+ valkey_glide-2.2.2.dist-info/WHEEL,sha256=_UPXoWLiLoTlMugaMJ1uHX3GE__thlX1hCUwQ29N8Mw,131
3
+ glide/logger.py,sha256=5-bAhfH_6hYEXdcgBR9R_wdeffSLHqEN-aQeIyMHnYY,4103
4
+ glide/opentelemetry.py,sha256=vg9fTYXj7_rni7hVBkZBJ1ZN4-RSGde5fOH4DsnVx_4,7476
5
+ glide/glide.pyi,sha256=6JIpAeADQ-1fU1Mp99pyh7aJORDxAAdtQebV5aByIVI,2093
6
+ glide/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
7
+ glide/glide_client.py,sha256=dyfHPiDTjvvCcOEcR2HyHK95-9WfYflXXAcLfyetfMk,32981
8
+ glide/async_commands/cluster_commands.py,sha256=NbRijIA22tDaBZg3VlBPUBGmgZ5elq5KnW-FEha9tfI,61045
9
+ glide/async_commands/glide_json.py,sha256=H5dnB4vJkGPpNXJZhhVyPQoTSbkN_chq5Xw6tkP0wMQ,60410
10
+ glide/async_commands/standalone_commands.py,sha256=0YgOnH-8VVM8Cz_iJ2YxTeh8BdLpaxCjROkDhe_2Om8,38228
11
+ glide/async_commands/ft.py,sha256=1v96sBCgiXtPbj85ZurY3ruLCmok3cPoaIXSiJBEv9Y,16849
12
+ glide/async_commands/core.py,sha256=x6lu7xt_pLR5drYDzNHTj0ORYX_oL73v2ZN4yxrTxGk,330289
13
+ glide/async_commands/__init__.py,sha256=_tbTAFATlzp4L2qe-H77PpAQK-16VsV-y7uKNUKLC_o,136
14
+ glide/__init__.py,sha256=u_9M1dUNtZcI8AwbgnA_8Aox81Xbv_oLvn2ApSOmHCY,8843
15
+ glide_shared/__init__.py,sha256=CWiz6vdOysZ-J8skev8VIXG2SPdNaJ8lk-5emGAzzE4,7217
16
+ glide_shared/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
17
+ glide_shared/commands/batch.py,sha256=CYf12G6vQhUv2CcziwQJ5ZTE2c2DDvKEBlx2sgmi-K0,247356
18
+ glide_shared/commands/batch_options.py,sha256=i2lDCLhMzUvpArb2bxX16xu7X-im0hLPaLXALkxWeQ8,11130
19
+ glide_shared/commands/bitmap.py,sha256=ZHGLcKBP7RADtANqIR7PWdIW_gfDBFgpkIsQ-T4QFBQ,10125
20
+ glide_shared/commands/command_args.py,sha256=55vpSxeQr8wFU7olkFTEecl66wPk1g6vWxVYj16UvXs,2529
21
+ glide_shared/commands/core_options.py,sha256=Y_1dFbW50hIHl16xkF4gnJnX_o2_f8neyXNjmc8KCKA,12607
22
+ glide_shared/commands/server_modules/ft_options/ft_aggregate_options.py,sha256=8b3sfsASS3Dr4eSNeRtn28gx8PjrRPOhoXZyoOmVF18,9928
23
+ glide_shared/commands/server_modules/ft_options/ft_constants.py,sha256=r9uLAExg2qThjwOBC8LxqXBITF0fwa5xfnD7EXnyPrw,1704
24
+ glide_shared/commands/server_modules/ft_options/ft_create_options.py,sha256=ll8AQPRe0_v10BdQXfCdN03bml3TEYbTWdaV3L5J_QU,13738
25
+ glide_shared/commands/server_modules/ft_options/ft_profile_options.py,sha256=yIapUTI_f7EI75BcVff9GpAZTT_GD1HS7QVhqjnyV6k,4283
26
+ glide_shared/commands/server_modules/ft_options/ft_search_options.py,sha256=imrnNhBaVsYjlknQpqitXDePoF8sXYdqQS4Ek_DXf7w,4872
27
+ glide_shared/commands/server_modules/json_batch.py,sha256=uqkLXPCOkzp53GfffnII1xA9ga0DefLYPnQ8ta899HE,36651
28
+ glide_shared/commands/server_modules/json_options.py,sha256=0dFk3EEtcERpmkNoO8930MqfEHLVaQRBRcg3CpL7nmE,3042
29
+ glide_shared/commands/sorted_set.py,sha256=hnXud0Ewn1uBdM6T2xzfCneZWfTeP-2U0XfEDGNCqlI,11466
30
+ glide_shared/commands/stream.py,sha256=MlllDP3teVX8BOB4ANb0JFC4RkUp8SQLCGlGMSPU_s4,15589
31
+ glide_shared/config.py,sha256=IScbmbbyemqw0TlkpqLgp2mFY48H2PtF2nE4K4mVGuc,43223
32
+ glide_shared/constants.py,sha256=pS7Xbjvq_qG3mlolVf51cCAGzXRhGdhvGIs2QK3R_b4,4375
33
+ glide_shared/exceptions.py,sha256=Z_szeAE-m1gsoBr5bPQymF6W6wiaunoHvBrt1dHbiYw,1852
34
+ glide_shared/protobuf/command_request_pb2.py,sha256=FIumn0p54n24pNykzWOoSGHQqvaY8-XopLWO0VqqKSI,19539
35
+ glide_shared/protobuf/connection_request_pb2.py,sha256=wlY76aIWKdyETOjD0Xh_B3RsfXqFwzkT0-lymAkTOes,6228
36
+ glide_shared/protobuf/response_pb2.py,sha256=oT2GHUwjrxvBVdINRKCvb3_BFN0Fq2wqwHbTj7KAX2E,2110
37
+ glide_shared/protobuf_codec.py,sha256=xwt4-D4WbvNIY_vjOd-00c73HOyNjWq7nN-Z718PBVA,3667
38
+ glide_shared/routes.py,sha256=HFccxCzXQXSi6Y1HFsRUm9ZcbJgCrar6y6uOWpGJWe0,4746
39
+ glide/glide.cpython-314-x86_64-linux-gnu.so,sha256=x1ueoJwfaOUjEYuZaxQxIilrn-H-vQtmZu3B6veWR5U,16348328
40
+ valkey_glide-2.2.2.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: maturin (0.14.17)
3
+ Root-Is-Purelib: false
4
+ Tag: cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64