valkey-glide 1.3.5rc5__tar.gz → 2.0.0__tar.gz

{valkey_glide-1.3.5rc5 → valkey_glide-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: valkey-glide
-Version: 1.3.5rc5
+Version: 2.0.0
 Classifier: Topic :: Database
 Classifier: Topic :: Utilities
 Classifier: License :: OSI Approved :: Apache Software License
@@ -9,8 +9,11 @@ Classifier: Topic :: Software Development
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Dist: async-timeout>=4.0.2; python_version < '3.11'
-Requires-Dist: typing-extensions>=4.8.0; python_version < '3.11'
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Trio
+Classifier: Framework :: AnyIO
+Requires-Dist: anyio>=4.9.0
+Requires-Dist: typing-extensions>=4.8.0 ; python_full_version < '3.11'
 Requires-Dist: protobuf>=3.20
 Summary: An open source Valkey client library that supports Valkey and Redis open source 6.2, 7.0, 7.2 and 8.0.
 Author: Valkey GLIDE Maintainers
@@ -18,9 +21,24 @@ License: Apache-2.0
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 
-# Valkey GLIDE
+# Welcome to Valkey GLIDE!
 
-Valkey General Language Independent Driver for the Enterprise (GLIDE), is an open-source Valkey client library. Valkey GLIDE is one of the official client libraries for Valkey, and it supports all Valkey commands. Valkey GLIDE supports Valkey 7.2 and above, and Redis open-source 6.2, 7.0 and 7.2. Application programmers use Valkey GLIDE to safely and reliably connect their applications to Valkey- and Redis OSS- compatible services. Valkey GLIDE is designed for reliability, optimized performance, and high-availability, for Valkey and Redis OSS based applications. It is sponsored and supported by AWS, and is pre-configured with best practices learned from over a decade of operating Redis OSS-compatible services used by hundreds of thousands of customers. To help ensure consistency in application development and operations, Valkey GLIDE is implemented using a core driver framework, written in Rust, with language specific extensions. This design ensures consistency in features across languages and reduces overall complexity.
+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.
+
+# Why Choose Valkey GLIDE?
+
+- **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.
+- **Reliability**: Built with best practices learned from over a decade of operating Redis OSS-compatible services.
+- **Performance**: Optimized for high performance and low latency.
+- **High Availability**: Designed to ensure your applications are always up and running.
+- **Cross-Language Support**: Implemented using a core driver framework written in Rust, with language-specific extensions to ensure consistency and reduce complexity.
+- **Stability and Fault Tolerance**: We brought our years of experience to create a bulletproof client.
+- **Backed and Supported by AWS and GCP**: Ensuring robust support and continuous improvement of the project.
+
+## Documentation
+
+See GLIDE's [documentation site](https://valkey.io/valkey-glide/).  
+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.
 
 ## Supported Engine Versions
 
@@ -34,14 +52,15 @@ The release of Valkey GLIDE was tested on the following platforms:
 
 Linux:
 
--   Ubuntu 22.04.1 (x86_64 and aarch64)
--   Amazon Linux 2023 (AL2023) (x86_64)
+-   Ubuntu 20 (x86_64/amd64 and arm64/aarch64)
+-   Amazon Linux 2 (AL2) and 2023 (AL2023) (x86_64)
+
+**Note: Currently Alpine Linux / MUSL is NOT supported.**
 
 macOS:
 
-- macOS (Apple silicon/aarch_64 and Intel/x86_64)
-Testing are being done on macOS arm64 platforms. 
-Please note that the package is not tested on macOS intel platforms, only minimal testing is done during CD.
+-   macOS 14.7 (Apple silicon/aarch_64)
+-   macOS 13.7 (x86_64/amd64)
 
 ## Python Supported Versions
 
@@ -53,6 +72,8 @@ Please note that the package is not tested on macOS intel platforms, only minima
 | 3.12           |
 | 3.13           |
 
+Valkey GLIDE transparently supports both the `asyncio` and `trio` concurrency frameworks.
+
 ## Installation and Setup
 
 ### Installing via Package Manager (pip)
@@ -79,7 +100,8 @@ To install Valkey GLIDE using `pip`, follow these steps:
 >>> from glide import GlideClusterClientConfiguration, NodeAddress, GlideClusterClient
 >>> async def test_cluster_client():
 ...     addresses = [NodeAddress("address.example.com", 6379)]
-...     config = GlideClusterClientConfiguration(addresses)
+...     # It is recommended to set a timeout for your specific use case
+...     config = GlideClusterClientConfiguration(addresses, request_timeout=500)  # 500ms timeout
 ...     client = await GlideClusterClient.create(config)
 ...     set_result = await client.set("foo", "bar")
 ...     print(f"Set response is {set_result}")
@@ -101,7 +123,8 @@ Get response is bar
 ...             NodeAddress("server_primary.example.com", 6379),
 ...             NodeAddress("server_replica.example.com", 6379)
 ...     ]
-...     config = GlideClientConfiguration(addresses)
+...     # It is recommended to set a timeout for your specific use case
+...     config = GlideClientConfiguration(addresses, request_timeout=500)  # 500ms timeout
 ...     client = await GlideClient.create(config)
 ...     set_result = await client.set("foo", "bar")
 ...     print(f"Set response is {set_result}")
@@ -115,11 +138,12 @@ Get response is bar
 
 For complete examples with error handling, please refer to the [cluster example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/cluster_example.py) and the [standalone example](https://github.com/valkey-io/valkey-glide/blob/main/examples/python/standalone_example.py).
 
-## Documentation
-
-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.
 
 ### Building & Testing
 
 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.
 
+## Community and Feedback
+
+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).
+

valkey_glide-2.0.0/glide-core/Cargo.toml

@@ -0,0 +1,92 @@
+[package]
+name = "glide-core"
+version = "0.1.0"
+edition = "2024"
+license = "Apache-2.0"
+authors = ["Valkey GLIDE Maintainers"]
+readme = "README.md"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+uuid = { version = "1", features = ["v4", "fast-rng"] }
+bytes = "1"
+futures = "^0.3"
+redis = { path = "./redis-rs/redis", features = [
+    "aio",
+    "keep-alive",
+    "tokio-comp",
+    "tokio-rustls-comp",
+    "connection-manager",
+    "cluster",
+    "cluster-async",
+] }
+telemetrylib = { path = "./telemetry" }
+tokio = { version = "1", features = ["macros", "time"] }
+logger_core = { path = "../logger_core" }
+tokio-util = { version = "^0.7", features = ["rt"], optional = true }
+num_cpus = { version = "^1", optional = true }
+tokio-retry2 = { version = "0.5", features = ["jitter"] }
+
+protobuf = { version = "3", features = [
+    "bytes",
+    "with-bytes",
+], optional = true }
+integer-encoding = { version = "4", optional = true }
+thiserror = "2"
+rand = { version = "0.8" }
+futures-intrusive = "0.5"
+directories = { version = "6", optional = true }
+once_cell = "1"
+sha1_smol = "1"
+nanoid = "0.4"
+async-trait = { version = "0.1" }
+serde_json = "1"
+serde = { version = "1", features = ["derive"] }
+versions = "7"
+
+[features]
+proto = ["protobuf"]
+socket-layer = [
+    "proto",
+    "directories",
+    "integer-encoding",
+    "num_cpus",
+    "tokio-util",
+]
+standalone_heartbeat = []
+
+[dev-dependencies]
+rsevents = "0.3.1"
+socket2 = "^0.5"
+tempfile = "3.3.0"
+rstest = "^0.25"
+serial_test = "3"
+criterion = { version = "^0.6", features = ["html_reports", "async_tokio"] }
+which = "8"
+ctor = "0.4"
+redis = { path = "./redis-rs/redis", features = ["tls-rustls-insecure"] }
+rustls = { version = "0.23", features = ["ring"], default-features = false}
+iai-callgrind = "0.14"
+tokio = { version = "1", features = ["rt-multi-thread"] }
+glide-core = { path = ".", features = [
+    "socket-layer",
+] } # always enable this feature in tests.
+
+[lints.rust]
+unexpected_cfgs = { level = "warn", check-cfg = ['cfg(standalone_heartbeat)'] }
+
+[build-dependencies]
+protobuf-codegen = "3"
+
+[[bench]]
+name = "rotating_buffer_benchmark"
+harness = false
+
+[[bench]]
+name = "connections_benchmark"
+harness = false
+
+[[bench]]
+name = "memory_benchmark"
+harness = false