rltest

library0.7.27pypypiunverified

RLTest is a test framework for Redis modules, allowing developers to run tests on Redis and modules across various environments (containers, local, cloud). The current version is 0.7.25, with maintenance mode status. It is a core tool in the Redis module ecosystem, receiving occasional updates.

testing database

pip install rltest

github ↗package ↗

INSTALL

IMPORT

SIG · RLTEST

rltest

testingpythonv0.7.27

Install

3.7s avg

Import

—

Disk

29MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.27 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 29.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.7s · import 0.000s · 30MB

29MB installed

● package 29MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

RLTest

✓ from RLTest import RLTest

✗ from rltest import RLTest

Minimal RLTest usage: configure module path, create environment, define tests, run.

from rltest import RLTest, TestEnvConfig # Create environment configuration env_config = TestEnvConfig( module_path='/path/to/your/module.so', redis_port=6379 ) # Create test instance rt = RLTest(env_config) # Define your test method def test_my_module(): client = rt.env.get_redis_connection() assert client.ping() # Run tests if __name__ == '__main__': rt.run()

rltest --version

Debug

Known issues

deprecatedRLTest now recommends using pytest-based approach (pytest-rltest) instead of traditional RLTest classes. The standalone RLTest class may be deprecated in future releases.

fix

Consider using pytest integration: pip install pytest-rltest and write test functions with pytest fixtures.

affects: >=0.7.0

gotchaMissing 'module_path' or 'binary_path' in TestEnvConfig will cause the environment to fail silently or use default Redis (without module). Always set at least one.

fix

Explicitly set module_path, binary_path, or use a pre-existing Redis instance via connection_params.

affects: all

gotchaEnvConfig (deprecated) vs TestEnvConfig: Older code uses EnvConfig, but it's deprecated. Using EnvConfig may break in newer versions.

fix

Use TestEnvConfig from rltest.config (though often imported directly from rltest).

affects: >=0.6.0

Upgrade

Version history

0.7.27latest on PyPI · released May 29, 2026

Audit

Dependencies

redis-pyrequiredRLTest uses redis-py to interact with Redis instances for testing.

Agent activity

15 hits · last 30 days

node