From 060885320e5da8b7c1a1a5a001342cab153787bf Mon Sep 17 00:00:00 2001
From: Josh Rotenberg <joshrotenberg@gmail.com>
Date: Thu, 29 Jan 2026 18:29:23 -0800
Subject: [PATCH] fix: add README to PyPI package

---
 README.md             | 57 ++++++++++++++++++++++++++++++++++++++++++-
 python/pyproject.toml |  1 +
 2 files changed, 57 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 68a79c3..ca5d256 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,9 @@
 [![Documentation](https://docs.rs/redis-cloud/badge.svg)](https://docs.rs/redis-cloud)
 [![CI](https://github.com/redis-developer/redis-cloud-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/redis-developer/redis-cloud-rs/actions/workflows/ci.yml)
 [![License](https://img.shields.io/crates/l/redis-cloud.svg)](https://github.com/redis-developer/redis-cloud-rs)
+[![PyPI](https://img.shields.io/pypi/v/redis-cloud.svg)](https://pypi.org/project/redis-cloud/)
 
-A comprehensive Rust client library for the Redis Cloud REST API.
+A comprehensive Rust client library for the Redis Cloud REST API, with Python bindings.
 
 ## Features
 
@@ -92,6 +93,60 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 
 This enables composition with Tower middleware like circuit breakers, retry, rate limiting, and more.
 
+## Python Bindings
+
+This library also provides Python bindings via PyO3:
+
+```bash
+pip install redis-cloud
+```
+
+```python
+from redis_cloud import CloudClient
+
+# Create client
+client = CloudClient(
+    api_key="your-api-key",
+    api_secret="your-api-secret"
+)
+
+# Or from environment variables
+client = CloudClient.from_env()
+
+# Async usage
+async def main():
+    subs = await client.subscriptions()
+    for sub in subs:
+        print(sub["name"], sub["id"])
+
+# Sync usage
+subs = client.subscriptions_sync()
+```
+
+### Python API
+
+- `CloudClient(api_key, api_secret, base_url=None, timeout_secs=None)`
+- `CloudClient.from_env()` - Create from environment variables
+
+#### Subscriptions
+- `subscriptions()` / `subscriptions_sync()` - List all subscriptions
+- `subscription(id)` / `subscription_sync(id)` - Get subscription by ID
+
+#### Databases
+- `databases(subscription_id)` / `databases_sync(subscription_id)` - List databases
+- `database(subscription_id, database_id)` / `database_sync(subscription_id, database_id)` - Get database
+
+#### Raw API
+- `get(path)` / `get_sync(path)` - Raw GET request
+- `post(path, body)` / `post_sync(path, body)` - Raw POST request
+- `delete(path)` / `delete_sync(path)` - Raw DELETE request
+
+### Environment Variables
+
+- `REDIS_CLOUD_API_KEY` - API key
+- `REDIS_CLOUD_API_SECRET` - API secret
+- `REDIS_CLOUD_BASE_URL` - Base URL (optional)
+
 ## API Coverage
 
 This library provides comprehensive coverage of the Redis Cloud REST API, including:
diff --git a/python/pyproject.toml b/python/pyproject.toml
index 61b4017..46ceb35 100644
--- a/python/pyproject.toml
+++ b/python/pyproject.toml
@@ -6,6 +6,7 @@ build-backend = "maturin"
 name = "redis-cloud"
 version = "0.1.0"
 description = "Python bindings for Redis Cloud REST API client"
+readme = { file = "../README.md", content-type = "text/markdown" }
 license = { text = "MIT OR Apache-2.0" }
 authors = [
     { name = "Josh Rotenberg", email = "joshrotenberg@gmail.com" }