RLTest

What it is and what it does

RLTest is a test harness designed specifically for Redis and Redis module developers. It abstracts away environment setup—OSS single-node, OSS cluster, enterprise single-node, and enterprise cluster—so you write your test logic once and run it against all four configurations without modification. The framework handles Redis binary management, port allocation, cluster initialization, and teardown, letting you focus on test assertions rather than infrastructure.

You invoke it via a CLI with flags for module path, environment type, credentials, and logging. It integrates with pytest for test discovery and execution, uses progressbar2 for progress reporting, and psutil for resource monitoring. The framework is maintained by Redis Labs and actively developed; it targets module developers and QA teams who need to validate Redis modules across heterogeneous deployment topologies.

Use it for:

• Test a Redis module against OSS, cluster, and enterprise Redis variants in a single CI/CD pipeline run
• Validate that a module's behavior is consistent when Redis is deployed with replication, clustering, or enterprise features enabled
• Debug module failures in enterprise environments by running the same test locally against an OSS Redis instance first
• Automate regression testing of Redis modules across multiple Python versions (3.7–3.14) and deployment modes
• Set up a test environment without manually provisioning Redis binaries, ports, or cluster topology

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

RLTest is a test framework for Redis and Redis modules that lets you write tests once and run them across multiple deployment environments (OSS, OSS cluster, enterprise, enterprise cluster) without rewriting test code.

Yes, if you develop or test Redis modules or need to validate Redis behavior across multiple deployment topologies. The framework eliminates boilerplate environment setup and lets you write environment-agnostic tests. Install friction is low, maintenance is active, and the BSD license is permissive. Not necessary for simple Redis client testing or single-environment deployments.

Install

rltest on PyPI

pip install rltest

uv add rltest

poetry add rltest

Installing RLTest

Before you install

Low friction installation with a pure Python wheel. Active maintenance—last commit 2026-07-22, released 23 days ago. Supports Python 3.7 through 3.14. Six runtime dependencies (distro, progressbar2, psutil, pytest, pytest-cov, redis) are all standard tools with minimal overhead.

License in practice

BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and acknowledge the original authors.

Quickstart

pip install rltest
rltest --help
rltest --module /path/to/module.so --env oss

Requires a Redis binary (oss-redis-path defaults to 'redis-server' on PATH) and pytest for test discovery; enterprise testing requires enterprise Redis binaries.

Verify before relying

• Whether the framework supports writing tests in languages other than Python or only Python test files
• Whether test results can be exported to standard formats (JUnit XML, etc.) for CI/CD integration
• Performance overhead or scalability limits when running against large module test suites

Package facts

Evidence: rltest-0.7.28-py3-none-any.whl

Tags

More Database packages