Contributing

To start contributing you must read all the following.

First you must fork/clone repo from github:

$ git clone git@github.com:aio-libs/aioredis.git

Next, you should install all python dependencies, it is as easy as running single command:

$ make devel

this command will install:

  • sphinx for building documentation;
  • pytest for running tests;
  • flake8 for code linting;
  • and few other packages.

Code style

Code must be pep8 compliant.

You can check it with following command:

$ make flake

Running tests

You can run tests in any of the following ways:

# will run tests in a verbose mode
$ make test
# or
$ py.test

# will run tests with coverage report
$ make cov
# or
$ py.test --cov

SSL tests

Running SSL tests requires following additional programs to be installed:

  • openssl – to generate test key and certificate;
  • socat – to make SSL proxy;

To install these on Ubuntu and generate test key & certificate run:

$ sudo apt-get install socat openssl
$ make certificate

Different Redis server versions

To run tests against different redises use --redis-server command line option:

$ py.test --redis-server=/path/to/custom/redis-server

UVLoop

To run tests with uvloop:

$ pip install uvloop
$ py.test --uvloop

Note

Until Python 3.5.2 EventLoop has no create_future method so aioredis won’t benefit from uvloop’s futures.

Writing tests

aioredis uses pytest tool.

Tests are located under /tests directory.

Pure Python 3.5 tests (ie the ones using async/await syntax) must be prefixed with py35_, for instance see:

tests/py35_generic_commands_tests.py
tests/py35_pool_test.py

Fixtures

There is a number of fixtures that can be used to write tests:

loop

Current event loop used for test. This is a function-scope fixture. Using this fixture will always create new event loop and set global one to None.

def test_with_loop(loop):
    @asyncio.coroutine
    def do_something():
        pass
    loop.run_until_complete(do_something())
unused_port()

Finds and returns free TCP port.

def test_bind(unused_port):
    port = unused_port()
    assert 1024 < port <= 65535
coroutine create_connection(*args, **kw)

Wrapper around aioredis.create_connection(). Only difference is that it registers connection to be closed after test case, so you should not be worried about unclosed connections.

coroutine create_redis(*args, **kw)

Wrapper around aioredis.create_redis().

coroutine create_pool(*args, **kw)

Wrapper around aioredis.create_pool().

redis

Redis client instance.

pool

RedisPool instance.

server

Redis server instance info. Namedtuple with following properties:

name
server instance name.
port
Bind port.
unixsocket
Bind unixsocket path.
version
Redis server version tuple.
serverB

Second predefined Redis server instance info.

start_server(name)

Start Redis server instance. Redis instances are cached by name.

Returns:server info tuple, see server.
Return type:tuple
ssl_proxy(unsecure_port)

Start SSL proxy.

Parameters:unsecure_port (int) – Redis server instance port
Returns:secure_port and ssl_context pair
Return type:tuple

Helpers

aioredis also updates pytest‘s namespace with several helpers.

pytest.redis_version(*version, reason)

Marks test with minimum redis version to run.

Example:

@pytest.redis_version(3, 2, 0, reason="HSTRLEN new in redis 3.2.0")
def test_hstrlen(redis):
    pass
pytest.logs(logger, level=None)

Adopted version of unittest.TestCase.assertEqual(), see it for details.

Example:

def test_logs(create_connection, server):
    with pytest.logs('aioredis', 'DEBUG') as cm:
        conn yield from create_connection(server.tcp_address)
    assert cm.output[0].startswith(
      'DEBUG:aioredis:Creating tcp connection')
pytest.assert_almost_equal(first, second, places=None, msg=None, delta=None)

Adopted version of unittest.TestCase.assertAlmostEqual().

pytest.raises_regex(exc_type, message)

Adopted version of unittest.TestCase.assertRaisesRegex().