redis/redis-py

Recent updates

• v8.0.0

  5 days ago

  redis-py 8.0.0 focuses on adding major protocol and API coverage improvements, including full asyncio Cluster PubSub, keyspace and subkey notifications (sync and async, standalone and cluster), Redis Array command helpers, and RESP3 becoming the default on the wire with opt-in unified response shapes. The release also updates connection and retry defaults and substantially improves type hint accuracy using overloads and distinct sync versus async protocol typing.

  BreakingSecurityFeatures

• v8.0.0b2

  1 month ago

  redis-py 8.0.0b2 is a major compatibility release centered on unifying command response shapes between RESP2 and RESP3 and switching the default client protocol to RESP3. It also adds a new random load-balancing strategy that can target the primary, while the rest of the visible diff is dominated by docs, migration guidance, and test/workflow restructuring.

  BreakingFeatures

• v8.0.0b1

  1 month ago

  This beta adds asyncio Cluster PubSub and first-class Redis Keyspace Notifications support (sync + async) including cluster-wide handling, plus widespread type-hint changes that alter static types for many client methods. Runtime behavior is unchanged, but the typing changes are a breaking change for static analysis and may require updates to your type annotations or CI checks.

  BreakingSecurityFeatures

• v7.4.0

  2 months ago

  v7.4.0 focuses on bug fixes and observability improvements: it fixes a metrics-related AttributeError in cluster metric recording, prevents password leakage via ConnectionPool.__repr__, and refactors metric collection. It also exposes basic OpenTelemetry classes under redis.observability and contains an experimental refactor of MultiDBClient health-check logic—test before upgrading in production.

  BreakingSecurityFeatures

• v7.3.0

  2 months ago

  This release (v7.3.0) adds OpenTelemetry native metrics support for asynchronous clients, instrumenting many connection, command, resiliency, pub/sub and stream metrics following OTel database semantic conventions. It also includes a couple of async-focused bug fixes (cluster pipeline accessors and connection protocol initialization) and small maintenance/CI updates.

  Features

• v7.2.1

  3 months ago

  v7.2.1 is a small bugfix/maintenance release that tightens cluster and connection error handling, fixes PubSub reconnect issues with binary channel names, and cleans up several cluster/connection management bugs. Note: OpenTelemetry metric attributes batch_size and consumer_name have been removed, and some internal connection APIs now return copies — these changes may require action before upgrading.

  Breaking

• v7.2.0

  3 months ago

  v7.2.0 adds first-class support for Redis 8.6 features (idempotent producers, HOTKEYS, vrange) and introduces Smart Client Handoff for Redis Enterprise cluster maintenance (SMIGRATING/SMIGRATED). It also adds OpenTelemetry-native metrics for the sync client, several operational resiliency fixes (cluster slot mapping, connection leaks, pubsub reconnects), and a few new client configuration options (ssl_password, ssl_ca_path).

  BreakingFeatures

• v7.1.1

  3 months ago

  This patch release introduces initial (experimental) health check policies and a refactor of the add_database method, plus behavioral changes to MultiDBClient internals: server-side cursor (SCH) support is disabled by default and additional logging was added. Developers should review any code that calls add_database and any code relying on SCH defaults or logging output before upgrading.

  BreakingFeatures

• v7.1.0

  6 months ago

  v7.1.0 adds new Redis command support (MSETEX, CLAIM for XREADGROUP), cluster routing/aggregation in OSS Cluster mode, and several experimental features (CAS/CAD and HYBRID search). Important CI/runtime dependency changes include dropping Python 3.9 in favor of Python 3.14 and updated Redis 8.4 test images; there is also an experimental breaking change replacing the default health check/failure detector which may change node-failure behavior.

  BreakingFeatures

• v7.0.1

  7 months ago

  This is a documentation-focused maintenance release for v7.0.1. It adds the multi-database section to the docs index and README, and revises the multi-database guide to better describe Active-Active/Redis Enterprise usage, health checks, and failover behavior. The package version is also bumped from 7.0.0 to 7.0.1.

  Features

• v7.0.0

  7 months ago

  7.0.0 adds an experimental MultiDBClient for active-active multi-database setups, maintenance push-notification support, and new command options such as WITHATTRIBS for vector VSIM, ssl_verify_flags_config, and ExternalAuthProviderError. It also includes broad typing/API cleanup across Redis, Redis Search, and connection-pool code, plus several breaking changes around async RedisCluster, sorted-set rank helpers, and timeout typing.

  BreakingFeatures

• v7.0.0b3

  7 months ago

  This beta introduces an experimental `MultiDBClient` for active-active multi-database setups with failover across databases. The only documented breaking change is an update to the ping command's docstrings and method return type hint, so upgrade impact appears limited but may affect type-checked code.

  BreakingFeatures