Basics

Basics

import pytest

def test_a():
    assert 1 == 2

class TestB:
    def test_b(self):
        assert 'a'.upper() == 'A'

    def test_c(self):
        with pytest.raises(ZeroDivisionError):
            1/0
            

Running

$ py.test -k "(a or B) and not c"

Fixtures

Fixture

import random

@pytest.fixture
def rnd():
    return random.random()
            

def test_rnd(rnd):
    print(rnd)
            

Fixture dependencies

@pytest.fixture
def rnd_gen():
    return random.Random(123456)


@pytest.fixture
def rnd(rnd_gen):
    return rnd_gen.random()
            

Fixture calculation

@pytest.fixture
def fixture_a(rnd):
    return rnd

@pytest.fixture
def fixture_b(rnd):
    return rnd

def test(fixture_a, fixture_b):
    assert fixture_a == fixture_b  # ???
            

Fixture factories

@pytest.fixture
def make_rnd(rnd_gen):
    def maker()
        return rnd_gen.random()
    return maker
            

@pytest.fixture
def fixture_a(rnd):
    return rnd()

@pytest.fixture
def fixture_b(rnd):
    return rnd()

def test(fixture_a, fixture_b):
    assert fixture_a == fixture_b  # ???
              

Resource cleanup

@pytest.yield_fixture
def opened_file():
    f = open("filename")
    yield f
    f.close()
            

def test_a(opened_file):
    assert opened_file.read() == "file content"
            

Cleanup for factories

@pytest.yield_fixture
def open_file():
    f = None
    def opener(filename):
        nonlocal f
        assert f is None
        f = open(filename)
        return f
    yield opener
    if f is not None:
        f.close()
            

def test_a(open_file):
    assert open_file("file_a.txt").read() == "Content A"
    assert open_file("file_b.txt").read() == "Content B"
            

Comparison with unittest

Monolitic test case

class TestA(unittest.TestCase):
    def setUp(self):
        self.redis = redis.Redis()
        self.db = db.connect(':memory:')

    def tearDown(self):
        self.redis.close()
        self.db.close()

    def test_a(self):
        self.db.execute(...)
        self.redis.set(...)
            

Mixin classes

class RedisMixin:
    def setUp(self):
        self.redis = Redis()
        super().setUp()
    def tearDown(self):
        self.redis.close()
        super().tearDown()

class DBMixin:
    def setUp(self):
        self.db = sqlite3.connect(':memory:')
        super().setUp()
    def tearDown(self):
        self.db.close()
        super().tearDown()
            

class TestA(RedisMixin, DBMixin, unittest.TestCase):
    def setUp(self):
        self.val = 'value'
        super().setUp()

    def tearDown(self):
        ...
        super().tearDown()

    def test_a(self):
        self.db.execute(...)
        self.redis.set(...)
            

py.test

@pytest.yield_fixture
def redis():
    with Redis() as redis:
        yield redis

@pytest.yield_fixture
def db():
    with sqlite.connect(':memory:') as db:
        yield db

def test_a(db, redis):
    db.execute(...)
    redis.set(...)
            

Project structure

• root
• project
• __init__.py
• ...
• tests
• conftest.py
• redis_fixtures.py
• db_fixtures.py
• test_a.py
• setup.py

No __init__.py in tests folder

conftest.py

import pytest

pytest_plugins = ['redis_fixtures', 'db_fixtures']

@pytest.fixture
def fixture_a():
    return 'value'
            

No fixture imports in conftest.py

Docker and tests

Fixture scope

• function
• class
• module
• session

Unique ID and docker client

import docker as libdocker
import socket
import uuid

@pytest.fixture(scope='session')
def session_id():
    return str(uuid.uuid4())
@pytest.yield_fixture(scope='session')
def unused_port():
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
        s.bind(('127.0.0.1', 0))
        yield s.getsockname()[1]
@pytest.fixture(scope='session')
def docker():
    return libdocker.Client(version='auto')
            

Running container

@pytest.yield_fixture(scope='session')
def redis_server(unused_port, session_id, docker):
    docker.pull('redis')
    port = unused_port()
    container = docker.create_container(
        image='redis',
        name='test-redis-{}'.format(session_id),
        ports=[6379],
        detach=True,
        host_config=docker.create_host_config(
            port_bindings={6379: port}))
    docker.start(container=container['Id'])
    yield port
    docker.kill(container=container['Id'])
    docker.remove_container(container['Id'])
            

Redis client

@pytest.yield_fixture
def redis_client(redis_server):
    for i in range(100):
        try:
            client = redis.StrictRedis(host='127.0.0.1',
                                       port=port, db=0)
            client.flushall()
        except redis.ConnectionError:
            time.sleep(0.01)
        else:
            yield client
            client.close()
            

Test

def test_redis(redis_client):
    redis_client.set(b'key', b'value')
    assert redis_client.get(b'key') == b'value'
            

Plugins

Test skipping

@pytest.mark.skipif(sys.version_info < (3, 4, 1),
                    reason="Python<3.4.1 doesnt support "
                           "__del__ calls from GC")
def test___del__():
    ...
            

Test exclusion

def pytest_ignore_collect(path, config):
    if 'py35' in str(path):
        if sys.version_info < (3, 5, 0):
            return True
            

• tests
• conftest.py
• ...
• py35
• test_1.py
• test_2.py