RLTest
Redis Modules Test Framework, allow to run tests on redis and modules on a variety of environments
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a Redis binary (oss-redis-path defaults to 'redis-server' on PATH) and pytest for test discovery; enterprise testing requires enterprise Redis binaries.
- Low friction installation with a pure Python wheel.
- Active maintenance—last commit 2026-07-22, released 23 days ago.
License · maintenance · safety
BSD-3-Clause (permissive) — 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.
last release 2026-07-22 (23 days) · last repo commit 2026-07-22 · 21 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 134,346 downloads/mo, #11,480 on PyPI
Alternatives
Verify before relying
pip install rltest
rltest --help
rltest --module /path/to/module.so --env oss- 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
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 on it.
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
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.
Requires a Redis binary (oss-redis-path defaults to 'redis-server' on PATH) and pytest for test discovery; enterprise testing requires enterprise Redis binaries.
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 ossVerify 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 the current Python release >=3.7.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesdistroprogressbar2psutilpytestpytest-covredis |
| Maintenance | Actively maintained 23 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 134,346 / month, #11,480 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Database |
Evidence: rltest-0.7.28-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “redis test framework”
- RLTestRLTest is a test framework for Redis and Redis modules that lets you…
- pytest-redisA pytest plugin that provides fixtures for testing code that depends…
- faststreamAn asynchronous Python framework for building event-driven…
Give your agent the search over MCP, or paste the wish link into any chat.
More Database packages
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Python client library for connecting to and executing commands against Redis key-value stores, supporting both synchronous and asynchronous operations.
Install it if your application needs to interact with Redis; the only prerequisite is a running Redis server instance.
YDB Python SDK is the official client library for connecting to and querying YDB databases from Python applications.
Install it if you need to connect Python applications to YDB databases.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
sqlparse tokenizes SQL text into a tree of statements, clauses, and expressions, and provides functions to split scripts, format queries, and inspect parsed tokens without validating dialect or syntax.
Install it if you need to manipulate, format, or analyze SQL text programmatically.
Provides base adapter protocols and shared functionality that database adapters use to integrate with dbt-core, handling connections, dialect translation, relation caching, and core interface management.
See also langgraph-checkpoint-redis · ramp-packer · azure-mgmt-redisenterprise · redisvl · redislite · langchain-redis · agent-framework-redis · redis-py-cluster · redlock · coredis