From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Sun, 9 May 2021 23:46:30 +0000 (+0200)
Subject: Add example about running tests in docker
X-Git-Tag: 3.0.dev0~50
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=38e95db4e9141b3a6041d388b84b924ea882f5f7;p=thirdparty%2Fpsycopg.git

Add example about running tests in docker

Writing it down as I have to hack it together every time.
---

diff --git a/tests/README.rst b/tests/README.rst
index 030477fe9..20e4e2be2 100644
--- a/tests/README.rst
+++ b/tests/README.rst
@@ -54,3 +54,18 @@ Test options
       ========================= test session starts =========================
       [...]
       ==== 1877 passed, 2 skipped, 169 deselected, 48 xfailed in 13.47s =====
+
+
+Testing in docker
+-----------------
+
+Useful order to test other Python versions without installing them. Can be
+used to replicate GitHub actions failures, specifying a ``--randomly-seed``.
+The following ``PG*`` env vars are an example to adjust the test dsn::
+
+    docker run -ti --rm --volume `pwd`:/src --workdir /src \
+        -e PSYCOPG3_TEST_DSN -e PGHOST=172.17.0.1 -e PGUSER=`whoami` \
+        python:3.7 bash
+
+    pip install -e ./psycopg3[test] ./psycopg3_c
+    pytest