See the Docker contributing guidelines. The following is specific to docker-py.

Running the tests & Code Quality

To get the source source code and run the unit tests, run:

$ git clone git://
$ cd docker-py
$ pip install tox
$ tox

Building the docs

Docs are built with MkDocs. For development, you can run the following in the project directory:

$ pip install -r docs-requirements.txt
$ mkdocs serve

Release Checklist

Before a new release, please go through the following checklist:

  • Bump version in docker/
  • Add a release note in docs/
  • Git tag the version
  • Upload to pypi

Vulnerability Reporting

For any security issues, please do NOT file an issue or pull request on github! Please contact or read the Docker security page.