---
id: rltest
version: "0.7.28"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# RLTest — Redis Modules Test Framework, allow to run tests on redis and modules on a variety of environments

License: permissive · Maintenance: active · Downloads: 134.3K/mo

## 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 above — 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

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

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 134.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

redis test framework, redis module testing, multi-environment redis tests, redis cluster testing, redis enterprise testing, redis test automation, redis module qa, redis-testing, module-qa, multi-environment

[View on SkillFed](https://skillfed.io/packages/rltest) · [View on PyPI](https://pypi.org/project/rltest/)