From 54d855a6cdbcd9f5e6b8c467d6e32cbfba572e8f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Thalheim?= <joerg@thalheim.io>
Date: Wed, 30 Aug 2023 11:28:07 +0200
Subject: [PATCH] clan-cli: Document how to run single-threaded

---
 pkgs/clan-cli/README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/pkgs/clan-cli/README.md b/pkgs/clan-cli/README.md
index 5389164..df9c509 100644
--- a/pkgs/clan-cli/README.md
+++ b/pkgs/clan-cli/README.md
@@ -27,3 +27,18 @@ To start a local developement environment instead, use the `--dev` flag:
 ```
 
 This will spawn two webserver, a python one to for the api and a nodejs one that rebuilds the ui on the fly.
+
+## Run locally single-threaded for debugging
+
+By default tests run in parallel using pytest-parallel.
+pytest-parallel however breaks `breakpoint()`. To disable it, use this:
+
+```console
+pytest --workers "" -s
+```
+
+You can also run a single test like this:
+
+```console
+pytest --workers "" -s tests/test_secrets_cli.py::test_users
+```