fix: default bridge and tests to project venv Python

Use .venv/bin/python3 by default, with PYTHON_PATH as an override, and update the setup script and docs to match the new virtualenv-based workflow.
2026-05-10 00:00:56 +02:00
parent 0d25e52ebc
commit 4cb568c326
5 changed files with 28 additions and 65 deletions
@@ -16,6 +16,7 @@ The TypeScript layer launches a Python bridge and exchanges JSON through stdin/s
 - Node.js or Bun
 - Python 3
 - `pykeepass` installed in the Python environment used by the bridge (the project provides `bun run setup:python`)
+- The bridge defaults to `.venv/bin/python3` when available, or you can override with `PYTHON_PATH`

 ## Python setup

@@ -28,10 +29,10 @@ bun run setup:python
 If you prefer manual installation:

 ```bash
-python3 -m pip install pykeepass
+python3 -m venv .venv && .venv/bin/pip install pykeepass
 ```

-The bridge also works with a project-local virtual environment such as `.venv` if you want to pin Python dependencies.
+The bridge also works with a project-local virtual environment such as `.venv` and the tests will use it when present.

 ## Usage