From 73dbee940022c0b5aba28c52ea2d767d50ec5574 Mon Sep 17 00:00:00 2001 From: Keith Smith Date: Sun, 1 Nov 2026 09:23:02 -0700 Subject: [PATCH] Document running the test suite against PostgreSQL The Postgres search backend's tests are skipped on SQLite, so they only run when pointed at a real Postgres. Documents the throwaway-container recipe used to verify the stored/GIN-indexed search vector migration. Co-Authored-By: Claude Sonnet 5.5 --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 89b54e4..c50a4cd 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,18 @@ ruff check . black --check . ``` +### Testing against PostgreSQL + +The suite runs on SQLite by default; the Postgres-only tests (search backend) +are skipped there. To run everything against a real Postgres: + +```bash +docker run -d --name evection-pg-test -e POSTGRES_PASSWORD=testpw -e POSTGRES_DB=evection \ + -p 127.0.0.1:55432:5432 postgres:16 +DATABASE_URL=postgres://postgres:testpw@127.0.0.1:55432/evection pytest +docker rm -f evection-pg-test +``` + ## License [GNU AGPL-3.0-or-later](LICENSE) — if you run a modified version of Evection as