Skip to content
Redis Labs Test Framework
Python Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Add license file Aug 28, 2018 Added installation/venv scripts Aug 13, 2019 Added installation/venv scripts Aug 13, 2019
requirements.txt added the ability to connect to spacific shard, fix setUp and tearDow… Jul 15, 2019


Redis Labs Test Framework, allow to run tests on redis and modules on verity of environments.

Supported Environment: oss, oss-cluster, enterprise, enterprise-cluster

The framework allow you to write a test without environment specification and then run the test on all supported environment.


$ pip install git+


usage: RLTest [-h] [--module MODULE] [--module-args MODULE_ARGS]
              [--env {oss,oss-cluster,enterprise,enterprise-cluster}]
              [--oss-redis-path OSS_REDIS_PATH]
              [--enterprise-redis-path ENTERPRISE_REDIS_PATH]
              [--stop-on-failure] [--verbose] [--debug]
              [--tests-dir TESTS_DIR] [--test-name TEST_NAME]
              [--tests-file TESTS_FILE] [--env-only] [--clear-logs]
              [--log-dir LOG_DIR] [--use-slaves] [--shards-count SHARDS_COUNT]
              [--proxy-binary-path PROXY_BINARY_PATH]
              [--enterprise-lib-path ENTERPRISE_LIB_PATH] [--env-reuse]
              [--use-aof] [--debug-print] [--use-valgrind]
              [--valgrind-suppressions-file VALGRIND_SUPPRESSIONS_FILE]
              [--debugger-args DEBUGGER_ARGS] [--no-output-catch]


Load a spacific module to the environment, notice that on enterprise the file should be a zip file packed with RAMP. might override by the test.


Pass arguments to the loaded module. might override by the test.


The environment on which to run the tests (oss,oss-cluster,enterprise,enterprise-cluster), might override by the test.


Path to the oss redis binary (default - redis-server)


Path to the enterprise redis binarty (default - ~/.RLTest/opt/redislabs/bin/redis-server).


Stop the tests run on failure, allows you to check what went wrong.


Increase verbosity, it is possible to write this options twice (-vv) to increase verbosity even more.


Stop before each test execution and allow you to attach to any process with debuger.


Directory to search for tests (default - current directory).


Name of spacific test function to run.


File inside the test_dir to search for tests (if not specified the framework searches in all files)


Not running any tests, just setup the environment and keep it up for manual tests.


Directory on which logs will be written to (default - ./logs).


Setup the environment with slaves. might override by the test.


On cluster, setting the amount on required shards. might override by the test.


Downloading the enterprise binaries before running the tests and save it under ~/.RLTest/.


Enterprise proxy binary path (default - ~/.RLTest/opt/redislabs/bin/dmcproxy)


Enterprise libraries requires for run (default - ~/.RLTest/opt/redislabs/lib/)


Reuse the existing env between tests. Notice that if some test requires a different env setting then the current env will be taken down (and a new one will be setup) regardless this parameter value.


Using aof instead of rdb, might override by the test.


Run redis under valgrind (assuming valgrind is installed on the machine).


Path to valgrind suppressions (not mandatory).


runs the redis on a debugger (gdb/lldb) interactivly. debugger interactive mode is only possible on a single process and so unsupported on cluste or with slaves. it is also not possible to use valgrind on interactive debugger. interactive debugger direcly applies: --no-output-catch and --stop-on-failure. it is also implies that only one test will be run (if --inv-only was not specify), an error will be raise otherwise.


arguments to pass to the debugger.


all output will be written to the stdout, no log files.

Configuration File

By default the framework search for configuration file on the current directory. The configuration file name is: config.txt. It is possible to specify different configuration file on command line using the '@' prefix, for example:

RLTest @myConfig.txt # search for myConfig.txt configuration file

The configuration file format is the same as the command line argument, i.e : '--< param_name > < param_val >'.

It is also possible to comment a spacific lines in the configuration file using '#'.



Test Example

from RLTest import Env
import time

class testExample():
    run all tests on a single env without taking
    env down between tests
    def __init__(self):
        self.env = Env()

    def testExample(self):
        con = self.env.getConnection()
        con.set('x', 1)
        self.env.assertEqual(con.get('x'), '1')

    def testExample1(self):
        con = self.env.getConnection()
        con.set('x', 1)
        self.env.assertEqual(con.get('x'), '1')
        self.env.assertFalse(True)  # check failure

    def testExample2(self):
        con = self.env.getConnection()
        con.set('x', 1)
        self.env.assertEqual(con.get('x'), '1')

# run each test on different env
def test_example():
    env = Env()
    con = env.getConnection()
    con.set('x', 1)
    env.assertEqual(con.get('x'), '1')

def test_example_2():
    env = Env()
    env.assertOk(env.cmd('set', 'x', '1'))
    env.expect('get', 'x').equal('1')

    env.expect('lpush', 'list', '1', '2', '3').equal(3)
    env.expect('lrange', 'list', '0', '-1').debugPrint().contains('1')
    env.debugPrint('this is some debug printing')

def test_example_3():
    env = Env(useSlaves=True, env='oss')
    con = env.getConnection()
    con.set('x', 1)
    con2 = env.getSlaveConnection()
    env.assertEqual(con2.get('x'), '1')

You can’t perform that action at this time.