summaryrefslogtreecommitdiff
path: root/test/python/docker/README.md
diff options
context:
space:
mode:
authorJhon Honce <jhonce@redhat.com>2020-11-03 13:15:16 -0700
committerJhon Honce <jhonce@redhat.com>2020-11-09 10:45:54 -0700
commit2d50ec69965af3e5e15922094294fd451d468c46 (patch)
treeda57246e1e28a8b2bf0b503488495ab7fd693a67 /test/python/docker/README.md
parente2b82e6245ed9459a37dc004a2b1d593d2835cb7 (diff)
downloadpodman-2d50ec69965af3e5e15922094294fd451d468c46.tar.gz
podman-2d50ec69965af3e5e15922094294fd451d468c46.tar.bz2
podman-2d50ec69965af3e5e15922094294fd451d468c46.zip
Update CI tests to run python docker library against API
* Update reference to docker-py to docker to reflect change in library name * Update tests to create storage sandbox * Enable all tests that endpoints support * Refactor containers/{id}/rename to return 404 not 500 * Refactor tests to use quay.io vs. docker.io Signed-off-by: Jhon Honce <jhonce@redhat.com>
Diffstat (limited to 'test/python/docker/README.md')
-rw-r--r--test/python/docker/README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/test/python/docker/README.md b/test/python/docker/README.md
new file mode 100644
index 000000000..c10fd636d
--- /dev/null
+++ b/test/python/docker/README.md
@@ -0,0 +1,38 @@
+# Docker regression test
+
+Python test suite to validate Podman endpoints using docker library (aka docker-py).
+See [Docker SDK for Python](https://docker-py.readthedocs.io/en/stable/index.html).
+
+## Running Tests
+
+To run the tests locally in your sandbox (Fedora 32,33):
+
+```shell
+# dnf install python3-docker
+```
+
+### Run the entire test suite
+
+```shell
+# python3 -m unittest discover test/python/docker
+```
+
+Passing the -v option to your test script will instruct unittest.main() to enable a higher level of verbosity, and produce detailed output:
+
+```shell
+# python3 -m unittest -v discover test/python/docker
+```
+
+### Run a specific test class
+
+```shell
+# cd test/python/docker
+# python3 -m unittest -v tests.test_images
+```
+
+### Run a specific test within the test class
+
+```shell
+# cd test/python/docker
+# python3 -m unittest tests.test_images.TestImages.test_import_image
+```