zio/zio-redis
65.2
Adequate · 7 November 2026
10.4k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
Add ZIO Redis example application
The \modules/example\ directory now contains a complete example application demonstrating ZIO Redis integration. This includes a ZIO HTTP server (\Main.scala\) that serves an API endpoint for fetching repository contributors, backed by a Redis cache and configured via Typesafe Config. The example introduces domain models (\Contributions\, \Login\, \Name\, \Owner\) using ZIO Prelude Newtypes and ZIO Schema for JSON and Protobuf serialization, along with the necessary API routes (\Api.scala\) and configuration layers (\AppConfig.scala\).
modules/example/src/main/scala · high confidence
Add embedded Redis support for local testing
The \modules/embedded\ module now provides an \EmbeddedRedis\ ZIO layer that automatically finds a free local port and starts an embedded Redis server, allowing users to run integration tests against a real Redis instance without external infrastructure. This includes the core implementation in \EmbeddedRedis.scala\ and corresponding tests in \EmbeddedRedisSpec.scala\ that verify basic set/get operations with Protobuf serialization.
modules/embedded · high confidence
Added Redis4Cats and ZioRedis benchmark suite
The benchmarks module now includes a new JMH-based benchmark suite that compares the performance of the ZIO Redis client against the Redis4Cats library. This addition introduces setup and teardown infrastructure for both libraries, along with a specific SetGetBenchmark that measures throughput for parallel SET and GET operations, allowing users to evaluate the relative performance characteristics of the ZIO Redis implementation.
modules/benchmarks · high confidence
Added default Redis connection configuration
A new application.conf file has been added to the example module, establishing default configuration values for a Redis connection. Users of this example module will now have a predefined host (0.0.0.0) and port (6379) for Redis connectivity out of the box.
modules/example/src/main/resources · high confidence
Initial implementation of Redis cluster support and Pub/Sub subscriptions
This change introduces the internal infrastructure required for Redis Cluster and Pub/Sub features. It adds a CRC16 hash implementation for key slot calculation, a ClusterExecutor to manage connections to multiple nodes and handle cluster-specific errors (MOVED/ASK), and a SubscriptionExecutor with RedisSubscriptionCommand to support subscribe, pSubscribe, and unsubscribe operations. It also includes SSL/TLS connection support in RedisConnection, a reconnect method for connection resilience, and configurable request queue sizes.
modules/redis/src/main/scala/zio/redis/internal · high confidence
Initial release of ZIO Redis client with core API and cluster support
This change introduces the ZIO Redis client library, providing a type-safe, ZIO-native interface for interacting with Redis. It includes the core command input/output encoders, error handling, and configuration models (including SSL/TLS and authentication settings). The library supports both single-node and cluster deployments, featuring automatic slot-based routing, reconnection logic, and configurable request queue sizes. Additionally, it implements the Pub/Sub API for subscribing to channels and patterns, along with a comprehensive set of Redis commands covering strings, lists, sets, sorted sets, hashes, geo, and streams.
repository · high confidence
Project initialization and repository configuration
The repository has been initialized with standard open-source governance and development tooling. This includes adding an Apache 2.0 License, a Contributor License Agreement (CLA), and a generated README.md documenting the ZIO Redis library and its usage. Development workflows are configured via \.mergify.yml\ for automated pull request handling, \.scalafmt.conf\ for code formatting (upgraded to version 3.11.5), \.scalafix.conf\ for static analysis rules, and an \sbt\ wrapper script. Repository metadata is also established through \.gitattributes\ and \.gitignore\.
(repo-wide) · high confidence
Removals
Removal of internal Redis client and socket option implementations
The internal implementation of the Redis client and related socket utilities has been removed from the codebase. Specifically, the \HelloWorld\ application entry point, the \StandardSocketOptions\ wrapper for Java socket options, the \HashApi\ trait defining Redis hash commands, and the core \RedisIO\ class handling the Redis protocol and network I/O have all been deleted. This eliminates the local, custom-built Redis connectivity layer that previously managed connections via \AsynchronousSocketChannel\ and parsed Redis protocol responses.
src/main · high confidence
Behavioural changes
Redis API restructured with new execution layers and schema-based codecs
The Redis client library has been reorganized to support a new execution model and type-safe data handling. The API traits (such as Connection, Hashes, and Geo) are now composed into a unified GenRedis interface, which exposes both synchronous and asynchronous execution modes via dedicated ZLayers (Redis, AsyncRedis, and RedisSubscription). This change introduces a CodecSupplier abstraction that leverages zio-schema to handle serialization and deserialization, replacing previous implicit codec mechanisms. Users must now provide a CodecSupplier when constructing the Redis layer, enabling consistent, schema-driven encoding and decoding of command arguments and results across the entire API.
modules/redis/src/main/scala/zio/redis/api · high confidence
Test coverage
Added tests for Redis internal protocol components; Added unit tests for Redis input encoders and output decoders; New integration test suite for Redis commands and cluster support; Removed HelloWorldSpec test suite.
Dependencies
Migrate CI to zio-sbt and upgrade build tooling
The project's build infrastructure has been significantly updated: sbt has been upgraded from version 1.3.6 to 1.13.0, and the CI configuration has migrated to the zio-sbt ecosystem (plugins zio-sbt-ci, zio-sbt-ecosystem, and zio-sbt-website version 0.8.5). Additionally, several build plugins have been updated or replaced, including sbt-scalafmt (2.3.0 to 2.6.2), sbt-scalafix (0.14.9), sbt-ci-release (1.12.1), and sbt-mima-plugin (1.2.1), while sbt-explicit-dependencies and sbt-tpolecat have been removed in favor of the new zio-sbt tooling.
project · high confidence
Migrate build infrastructure to zio-sbt and update Scala/ZIO versions
The project build has been restructured to use the zio-sbt ecosystem plugins, replacing the previous manual configuration. This migration updates the supported Scala versions to 2.12.21, 2.13.18, and 3.9.0, and aligns the ZIO core libraries to version 2.x. The build now automatically generates GitHub Actions workflows for CI, auto-approval, and auto-merge, and configures the documentation release job to correctly pass the NPM authentication token for publishing docs to the npm registry.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 65 (+1.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 73 → 73 (+0.0)
- Architecture 73 → 72 (-0.7)
- Maturity 55 → 62 (+7.3)
- Readiness 80 → 85 (+5.0)
- Security 65 → 59 (-6.0)
- Domain Modelling 100 → 100 (+0.0)
- Performance 77 → 89 (+11.5)
Resolved (1)
- Off-boarding risk: anonymized user #1
New (2)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- (root) — 4 commits
- .github/workflows — 1 commit
- docs/commands — 1 commit
- modules/redis — 1 commit
- modules/redis-it — 1 commit
- project/Dependencies.scala — 1 commit
- project/build.properties — 1 commit
Notable commits
- change: Reconnect after the host name failed to resolve (#1350)
- change: Update README.md (#1356)
- change: Update README.md (#1360)
- change: Update README.md (#1361)
- change: Update sbt, scripted-plugin to 1.13.1 (#1348)
- change: Update zio, zio-json to 4.1.1 (#1352)
- change: Update zio-sbt-ci, zio-sbt-ecosystem, ... to 0.8.7 (#1351)
- change: ci: publish docs to npm with Trusted Publishing (drop NPM_TOKEN) (#1357)
- change: docs: comprehensive ZIO Redis documentation (#1355)
- change: test: make the reconnect tests reliable (retry ping after restart; restart the right password-protected node) (#1359)
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
zio/zio-redis was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 9dda2ab27b565675ecad11d2919f779aeb4dbcae — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-c34be012586e.