valkey-glide 2.2.0rc1__cp312-cp312-macosx_10_7_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.
- glide/__init__.py +388 -0
- glide/async_commands/__init__.py +5 -0
- glide/async_commands/cluster_commands.py +1476 -0
- glide/async_commands/core.py +7818 -0
- glide/async_commands/ft.py +465 -0
- glide/async_commands/glide_json.py +1269 -0
- glide/async_commands/standalone_commands.py +1001 -0
- glide/glide.cpython-312-darwin.so +0 -0
- glide/glide.pyi +61 -0
- glide/glide_client.py +821 -0
- glide/logger.py +97 -0
- glide/opentelemetry.py +185 -0
- glide/py.typed +0 -0
- glide_shared/__init__.py +330 -0
- glide_shared/commands/__init__.py +0 -0
- glide_shared/commands/batch.py +5997 -0
- glide_shared/commands/batch_options.py +261 -0
- glide_shared/commands/bitmap.py +320 -0
- glide_shared/commands/command_args.py +103 -0
- glide_shared/commands/core_options.py +407 -0
- glide_shared/commands/server_modules/ft_options/ft_aggregate_options.py +300 -0
- glide_shared/commands/server_modules/ft_options/ft_constants.py +84 -0
- glide_shared/commands/server_modules/ft_options/ft_create_options.py +423 -0
- glide_shared/commands/server_modules/ft_options/ft_profile_options.py +113 -0
- glide_shared/commands/server_modules/ft_options/ft_search_options.py +139 -0
- glide_shared/commands/server_modules/json_batch.py +820 -0
- glide_shared/commands/server_modules/json_options.py +93 -0
- glide_shared/commands/sorted_set.py +412 -0
- glide_shared/commands/stream.py +449 -0
- glide_shared/config.py +975 -0
- glide_shared/constants.py +124 -0
- glide_shared/exceptions.py +88 -0
- glide_shared/protobuf/command_request_pb2.py +56 -0
- glide_shared/protobuf/connection_request_pb2.py +56 -0
- glide_shared/protobuf/response_pb2.py +32 -0
- glide_shared/protobuf_codec.py +110 -0
- glide_shared/routes.py +161 -0
- valkey_glide-2.2.0rc1.dist-info/METADATA +210 -0
- valkey_glide-2.2.0rc1.dist-info/RECORD +40 -0
- valkey_glide-2.2.0rc1.dist-info/WHEEL +4 -0
|
@@ -0,0 +1,210 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: valkey-glide
|
|
3
|
+
Version: 2.2.0rc1
|
|
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: typing-extensions>=4.8.0; python_version < '3.11'
|
|
15
|
+
Summary: Valkey GLIDE Async client. Supports Valkey and Redis OSS.
|
|
16
|
+
Author: Valkey GLIDE Maintainers
|
|
17
|
+
License: Apache-2.0
|
|
18
|
+
Requires-Python: >=3.9
|
|
19
|
+
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
|
|
20
|
+
|
|
21
|
+
# Welcome to Valkey GLIDE!
|
|
22
|
+
|
|
23
|
+
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.
|
|
24
|
+
|
|
25
|
+
# Why Choose Valkey GLIDE?
|
|
26
|
+
|
|
27
|
+
- **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.
|
|
28
|
+
- **Reliability**: Built with best practices learned from over a decade of operating Redis OSS-compatible services.
|
|
29
|
+
- **Performance**: Optimized for high performance and low latency.
|
|
30
|
+
- **High Availability**: Designed to ensure your applications are always up and running.
|
|
31
|
+
- **Cross-Language Support**: Implemented using a core driver framework written in Rust, with language-specific extensions to ensure consistency and reduce complexity.
|
|
32
|
+
- **Stability and Fault Tolerance**: We brought our years of experience to create a bulletproof client.
|
|
33
|
+
- **Backed and Supported by AWS and GCP**: Ensuring robust support and continuous improvement of the project.
|
|
34
|
+
|
|
35
|
+
## Documentation
|
|
36
|
+
|
|
37
|
+
See GLIDE's [documentation site](https://valkey.io/valkey-glide/).
|
|
38
|
+
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.
|
|
39
|
+
|
|
40
|
+
## Supported Engine Versions
|
|
41
|
+
|
|
42
|
+
Refer to the [Supported Engine Versions table](https://github.com/valkey-io/valkey-glide/blob/main/README.md#supported-engine-versions) for details.
|
|
43
|
+
|
|
44
|
+
# Getting Started - Python Wrapper
|
|
45
|
+
|
|
46
|
+
## System Requirements
|
|
47
|
+
|
|
48
|
+
The release of Valkey GLIDE was tested on the following platforms:
|
|
49
|
+
|
|
50
|
+
Linux:
|
|
51
|
+
|
|
52
|
+
- Ubuntu 20 (x86_64/amd64 and arm64/aarch64)
|
|
53
|
+
- Amazon Linux 2 (AL2) and 2023 (AL2023) (x86_64)
|
|
54
|
+
|
|
55
|
+
**Note: Currently Alpine Linux / MUSL is NOT supported.**
|
|
56
|
+
|
|
57
|
+
macOS:
|
|
58
|
+
|
|
59
|
+
- macOS 14.7 (Apple silicon/aarch_64)
|
|
60
|
+
- macOS 13.7 (x86_64/amd64)
|
|
61
|
+
|
|
62
|
+
## Python Supported Versions
|
|
63
|
+
|
|
64
|
+
| Python Version |
|
|
65
|
+
|----------------|
|
|
66
|
+
| 3.9 |
|
|
67
|
+
| 3.10 |
|
|
68
|
+
| 3.11 |
|
|
69
|
+
| 3.12 |
|
|
70
|
+
| 3.13 |
|
|
71
|
+
|
|
72
|
+
Valkey GLIDE transparently supports both the `asyncio` and `trio` concurrency frameworks.
|
|
73
|
+
|
|
74
|
+
## Installation and Setup
|
|
75
|
+
|
|
76
|
+
### ✅ Async Client
|
|
77
|
+
|
|
78
|
+
To install the async version:
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
pip install valkey-glide
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Verify installation:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
python3
|
|
88
|
+
>>> import glide
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### ✅ Sync Client
|
|
92
|
+
|
|
93
|
+
To install the sync version:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
pip install valkey-glide-sync
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Verify installation:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
python3
|
|
103
|
+
>>> import glide_sync
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## Basic Examples
|
|
109
|
+
|
|
110
|
+
### 🔁 Async Client
|
|
111
|
+
|
|
112
|
+
### ✅ Async Cluster Mode
|
|
113
|
+
|
|
114
|
+
```python
|
|
115
|
+
import asyncio
|
|
116
|
+
from glide import GlideClusterClientConfiguration, NodeAddress, GlideClusterClient
|
|
117
|
+
|
|
118
|
+
async def test_cluster_client():
|
|
119
|
+
addresses = [NodeAddress("address.example.com", 6379)]
|
|
120
|
+
# It is recommended to set a timeout for your specific use case
|
|
121
|
+
config = GlideClusterClientConfiguration(addresses, request_timeout=500) # 500ms timeout
|
|
122
|
+
client = await GlideClusterClient.create(config)
|
|
123
|
+
set_result = await client.set("foo", "bar")
|
|
124
|
+
print(f"Set response is {set_result}")
|
|
125
|
+
get_result = await client.get("foo")
|
|
126
|
+
print(f"Get response is {get_result}")
|
|
127
|
+
|
|
128
|
+
asyncio.run(test_cluster_client())
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
#### ✅ Async Standalone Mode
|
|
132
|
+
|
|
133
|
+
```python
|
|
134
|
+
import asyncio
|
|
135
|
+
from glide import GlideClientConfiguration, NodeAddress, GlideClient
|
|
136
|
+
|
|
137
|
+
async def test_standalone_client():
|
|
138
|
+
addresses = [
|
|
139
|
+
NodeAddress("server_primary.example.com", 6379),
|
|
140
|
+
NodeAddress("server_replica.example.com", 6379)
|
|
141
|
+
]
|
|
142
|
+
# It is recommended to set a timeout for your specific use case
|
|
143
|
+
config = GlideClientConfiguration(addresses, request_timeout=500) # 500ms timeout
|
|
144
|
+
client = await GlideClient.create(config)
|
|
145
|
+
set_result = await client.set("foo", "bar")
|
|
146
|
+
print(f"Set response is {set_result}")
|
|
147
|
+
get_result = await client.get("foo")
|
|
148
|
+
print(f"Get response is {get_result}")
|
|
149
|
+
|
|
150
|
+
asyncio.run(test_standalone_client())
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
### 🔂 Sync Client
|
|
156
|
+
|
|
157
|
+
#### ✅ Sync Cluster Mode
|
|
158
|
+
|
|
159
|
+
```python
|
|
160
|
+
from glide_sync import GlideClusterClientConfiguration, NodeAddress, GlideClusterClient
|
|
161
|
+
|
|
162
|
+
def test_cluster_client():
|
|
163
|
+
addresses = [NodeAddress("address.example.com", 6379)]
|
|
164
|
+
# It is recommended to set a timeout for your specific use case
|
|
165
|
+
config = GlideClusterClientConfiguration(addresses, request_timeout=500) # 500ms timeout
|
|
166
|
+
client = GlideClusterClient.create(config)
|
|
167
|
+
set_result = client.set("foo", "bar")
|
|
168
|
+
print(f"Set response is {set_result}")
|
|
169
|
+
get_result = client.get("foo")
|
|
170
|
+
print(f"Get response is {get_result}")
|
|
171
|
+
|
|
172
|
+
test_cluster_client()
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
#### ✅ Sync Standalone Mode
|
|
176
|
+
|
|
177
|
+
```python
|
|
178
|
+
from glide_sync import GlideClientConfiguration, NodeAddress, GlideClient
|
|
179
|
+
|
|
180
|
+
def test_standalone_client():
|
|
181
|
+
addresses = [
|
|
182
|
+
NodeAddress("server_primary.example.com", 6379),
|
|
183
|
+
NodeAddress("server_replica.example.com", 6379)
|
|
184
|
+
]
|
|
185
|
+
# It is recommended to set a timeout for your specific use case
|
|
186
|
+
config = GlideClientConfiguration(addresses, request_timeout=500) # 500ms timeout
|
|
187
|
+
client = GlideClient.create(config)
|
|
188
|
+
set_result = client.set("foo", "bar")
|
|
189
|
+
print(f"Set response is {set_result}")
|
|
190
|
+
get_result = client.get("foo")
|
|
191
|
+
print(f"Get response is {get_result}")
|
|
192
|
+
|
|
193
|
+
test_standalone_client()
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
For complete examples with error handling, please refer to:
|
|
199
|
+
- [Async Cluster Example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/cluster_example.py)
|
|
200
|
+
- [Async Standalone Example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/standalone_example.py)
|
|
201
|
+
|
|
202
|
+
|
|
203
|
+
### Building & Testing
|
|
204
|
+
|
|
205
|
+
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.
|
|
206
|
+
|
|
207
|
+
## Community and Feedback
|
|
208
|
+
|
|
209
|
+
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).
|
|
210
|
+
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
valkey_glide-2.2.0rc1.dist-info/METADATA,sha256=lBcaeW0T3PcBPIZZsBolQ5OPT1Z4NvH8sbXqNE2bBiY,6978
|
|
2
|
+
valkey_glide-2.2.0rc1.dist-info/WHEEL,sha256=-5Buz4kVvl2d82a7-CYo0aHqIxt4AiVJyY1MaONohOk,107
|
|
3
|
+
glide/async_commands/glide_json.py,sha256=H5dnB4vJkGPpNXJZhhVyPQoTSbkN_chq5Xw6tkP0wMQ,60410
|
|
4
|
+
glide/async_commands/ft.py,sha256=1v96sBCgiXtPbj85ZurY3ruLCmok3cPoaIXSiJBEv9Y,16849
|
|
5
|
+
glide/async_commands/__init__.py,sha256=_tbTAFATlzp4L2qe-H77PpAQK-16VsV-y7uKNUKLC_o,136
|
|
6
|
+
glide/async_commands/core.py,sha256=x6lu7xt_pLR5drYDzNHTj0ORYX_oL73v2ZN4yxrTxGk,330289
|
|
7
|
+
glide/async_commands/standalone_commands.py,sha256=0YgOnH-8VVM8Cz_iJ2YxTeh8BdLpaxCjROkDhe_2Om8,38228
|
|
8
|
+
glide/async_commands/cluster_commands.py,sha256=NbRijIA22tDaBZg3VlBPUBGmgZ5elq5KnW-FEha9tfI,61045
|
|
9
|
+
glide/__init__.py,sha256=u_9M1dUNtZcI8AwbgnA_8Aox81Xbv_oLvn2ApSOmHCY,8843
|
|
10
|
+
glide/glide.pyi,sha256=6JIpAeADQ-1fU1Mp99pyh7aJORDxAAdtQebV5aByIVI,2093
|
|
11
|
+
glide/opentelemetry.py,sha256=vg9fTYXj7_rni7hVBkZBJ1ZN4-RSGde5fOH4DsnVx_4,7476
|
|
12
|
+
glide/glide_client.py,sha256=dyfHPiDTjvvCcOEcR2HyHK95-9WfYflXXAcLfyetfMk,32981
|
|
13
|
+
glide/logger.py,sha256=5-bAhfH_6hYEXdcgBR9R_wdeffSLHqEN-aQeIyMHnYY,4103
|
|
14
|
+
glide/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
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-312-darwin.so,sha256=2rCcpskkJNo_P1_IXKW520BH7fc4rNXd9PudK5K48JI,15581752
|
|
40
|
+
valkey_glide-2.2.0rc1.dist-info/RECORD,,
|