pytest-docker-py

• Easy to use, simple to extend, external pytest plugin that minimally leverages docker-py.

1. Introduction

• A plugin that keeps it simple and lets you:

  • pull images - if not already pulled.
  • start containers - with various, optional, parameters - i.e. ports; networks; volumes; commands.
  • stop containers.

• See test/integration/test_plugin.py for a working example.

2. Installation

• pip install pytest-docker-py

or

• pip install git+https://github.com/jameshnsears/pytest-docker-py@master

then

• create a test, similar to test/integration/test_plugin.py
• run pytest -s

3. Development / PR - on Ubuntu 18.04

• sudo apt-get install -y build-essential python3-pip python3-venv
• git clone https://github.com/jameshnsears/pytest-docker-py.git
• cd pytest-docker-py

3.1. Create Virtual Environment

• ./create-venv.sh

3.2. Unit Tests

• ./run-unit-tests.sh

3.3. Integration Tests

• ./run-integration-tests.sh