diff --git a/.gitignore b/.gitignore index 6bef812..3710a4b 100644 --- a/.gitignore +++ b/.gitignore @@ -6,6 +6,7 @@ __pycache__/ # Virtual environments .venv/ +.uvenv/ venv/ env/ diff --git a/README.md b/README.md index b5865ec..bd62589 100644 --- a/README.md +++ b/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 diff --git a/wiki/Install.da.md b/wiki/Install.da.md index bbe1124..757a5bc 100644 --- a/wiki/Install.da.md +++ b/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 diff --git a/wiki/Install.md b/wiki/Install.md index d8c418b..e2cd9b3 100644 --- a/wiki/Install.md +++ b/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 diff --git a/wiki/Install.ms.md b/wiki/Install.ms.md index ee54e37..7b31080 100644 --- a/wiki/Install.ms.md +++ b/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