Skip to content
pytest plugin for writing functional tests with pexpect and docker
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.

pytest-docker-pexpect Build Status

py.test plugin for writing simple functional tests with pexpect and docker.


pip install pytest-docker-pexpect


The plugin provides spawnu fixture, that could be called like spawnu(tag, dockerfile_content, command), it returns pexpect.spwanu attached to command runned inside a container that built with tag and dockerfile:

def test_echo(spawnu):
    proc = spawnu(u'ubuntu', u'FROM ubuntu:latest', u'bash')

Current working directory available inside the container in /src.

It's also possible to pass arguments to docker run with spawnu:

spawnu(u'ubuntu', u'FROM ubuntu:latest', u'bash',
       docker_run_arguments=[u'--expose', u'80'])

spawnu provides pexpect API and additional docker-specific API:

  • proc.docker_container_id – container id
  • proc.docker_inspect() – decoded json output of docker inspect
  • proc.docker_stats() – decoded json output of docker stats

Also the plugin provides TIMEOUT fixture, that can be used for simple asserts, like:

assert proc.expect([TIMEOUT, u'1'])

run_without_docker fixtures, that indicates that docker isn't used.

If you want to disable tests if docker isn't available, use @pytest.mark.skip_without_docker.

If you want to run parametrized test only once without docker, use @pytest.mark.once_without_docker.

Usage without docker

With flag --run-without-docker tests can be run in environment without docker. In this mode tests runs only for first container and docker initialization steps are skipped. Be careful, in this mode all commands will be execute directly on local system!

Licensed under MIT

You can’t perform that action at this time.