From: Dylan Young <dylanyoungmeijer@gmail.com>
Date: Mon, 8 Jun 2026 00:33:31 +0000 (-0300)
Subject: doc(dev): add note about local testing
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f9078032c2ccd64ec351b3ab7bdeb257b2480977;p=thirdparty%2Fpsycopg.git

doc(dev): add note about local testing

How to exclude the primary tests that are likely to fail when
running tests locally.
---

diff --git a/README.rst b/README.rst
index b35643e00..21bcffc5f 100644
--- a/README.rst
+++ b/README.rst
@@ -88,6 +88,12 @@ Now hack away! You can run the tests using::
     export PSYCOPG_TEST_DSN="dbname=psycopg_test"
     pytest
 
+If some of the tests fail on your local host, it may be helpful to exclude the
+`proxy`, `subprocess`, and/or `timing` tests to get a clean test run, for
+example::
+
+     pytest  -m 'not proxy and not timing'
+
 The project includes some `pre-commit`__ hooks to check that the code is valid
 according to the project coding convention. Please make sure to install them
 by running::