Merge pull request 'Document Python 3.13 on Debian 12' (#48) from fix-debian-instructions into main

.gitignore

@@ -6,6 +6,7 @@ __pycache__/
 
 # Virtual environments
 .venv/
+.uvenv/
 venv/
 env/
 

README.md

@@ -36,6 +36,8 @@ If PowerShell refuses to run the activation script, allow it for the current ses
 
 ### Linux debian
 
+On Debian 13 (trixie) or later, `python3` is 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -44,6 +46,20 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+On Debian 12 (bookworm), `python3` is 3.11 and `pip` refuses to install the project
+(`requires a different Python`). Get Python 3.13 with [uv][uv] and use it for the `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ### MacOS
 
 ```bash
@@ -132,6 +148,7 @@ GNU Affero General Public License v3.0 or later. See [LICENSE][license].
 [img-run]: docs/images/run.png
 [img-tests]: docs/images/tests.png
 [doxygen]: https://www.doxygen.nl/
+[uv]: https://docs.astral.sh/uv/
 [adr-0001]: docs/adr/adr-0001-standard-library-instead-of-pandas.md
 [ci]: .gitea/workflows/ci.yml
 [doxyfile]: Doxyfile

wiki/Install.da.md

@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+På Debian 13 (trixie) eller nyere er `python3` 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+På Debian 12 (bookworm) er `python3` 3.11, og `pip` nægter at installere projektet (`requires a different Python`). Hent Python 3.13 med [uv](https://docs.astral.sh/uv/) og brug den til `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash

wiki/Install.md

@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+On Debian 13 (trixie) or later, `python3` is 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+On Debian 12 (bookworm), `python3` is 3.11 and `pip` refuses to install the project (`requires a different Python`). Get Python 3.13 with [uv](https://docs.astral.sh/uv/) and use it for the `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash

wiki/Install.ms.md

@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+Pada Debian 13 (trixie) atau lebih baharu, `python3` ialah 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+Pada Debian 12 (bookworm), `python3` ialah 3.11 dan `pip` enggan memasang projek (`requires a different Python`). Dapatkan Python 3.13 dengan [uv](https://docs.astral.sh/uv/) dan gunakannya untuk `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash