Skip to content
CAI
Software that uses CAICheck a score

zio/zio-redis

65.2

Adequate · 7 November 2026

10.4k

lines of production code

Scala

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.