Update to Poetry 2.0

.github/workflows/pages.yml

@@ -8,7 +8,7 @@ on:
     branches: [main]
 
 env:
-  POETRY_VERSION: "1.8.4"
+  POETRY_VERSION: "2.0.1"
   PYTHON_VERSION: "3.11"
 
 jobs:
@@ -23,6 +23,6 @@ jobs:
           python-version: ${{ env.PYTHON_VERSION }}
           cache: poetry
       - name: Install Nox and doc dependencies
-        run: poetry install --only nox,docs
+        run: poetry sync --only nox,docs
       - name: Publish Docs
         run: poetry run nox -s docs_github_pages

.github/workflows/python.yml

@@ -3,7 +3,7 @@ name: python
 on: [push, pull_request]
 
 env:
-  POETRY_VERSION: "1.8.4"
+  POETRY_VERSION: "2.0.1"
   PYTHON_VERSION: "3.11"
 
 jobs:
@@ -23,7 +23,7 @@ jobs:
           # https://github.com/actions/setup-python#caching-packages-dependencies
           cache: poetry
       - name: Install Nox
-        run: poetry install --only nox
+        run: poetry sync --only nox
       - name: Test with Nox
         run: poetry run nox -s test-${{ matrix.python-version }}
   quality:
@@ -45,7 +45,7 @@ jobs:
           python-version: ${{ env.PYTHON_VERSION }}
           cache: poetry
       - name: Install Nox and group dependencies
-        run: poetry install --only nox,${{ matrix.job.poetry-groups }}
+        run: poetry sync --only nox,${{ matrix.job.poetry-groups }}
       - name: Test with Nox
         run: poetry run nox -s ${{ matrix.job.nox-session }}
   poetry-check:
@@ -59,4 +59,4 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
       - name: Validate Poetry Configuration and Lockfile Freshness
-        run: poetry check --lock
+        run: poetry check --lock --strict

Dockerfile

@@ -11,7 +11,7 @@
 FROM python:3.11-slim-bookworm AS python_builder
 
 # Pin Poetry to a specific version to make Docker builds reproducible.
-ENV POETRY_VERSION=1.8.4
+ENV POETRY_VERSION=2.0.1
 
 # Set ENV variables that make Python more friendly to running inside a container.
 ENV PYTHONDONTWRITEBYTECODE=1
@@ -46,9 +46,7 @@ ENV PATH="${VIRTUAL_ENV}/bin:${PATH}"
 COPY pyproject.toml poetry.lock ./
 
 # Don't install the package itself with Poetry because it will install it as an editable install.
-# TODO: Improve this when non-editable `poetry install` is supported in Poetry.
-#    https://github.com/python-poetry/poetry/issues/1382
-RUN poetry install --only main --no-root
+RUN poetry sync --only main --no-root
 
 # Copy in source files.
 COPY README.md ./

README.md

@@ -35,11 +35,8 @@ all machines that use the project, both during development and in production.
 
 To install all dependencies into an isolated virtual environment:
 
-> [!TIP]
-> Append `--sync` to uninstall dependencies that are no longer in use from the virtual environment.
-
 ```bash
-$ poetry install
+$ poetry sync
 ```
 
 To [activate](https://python-poetry.org/docs/basic-usage#activating-the-virtual-environment) the
@@ -107,7 +104,7 @@ environments and run commands based on [`noxfile.py`](./noxfile.py) for unit tes
 guide checking, type checking and documentation generation.
 
 > [!NOTE]
-> `nox` is installed into the virtual environment automatically by the `poetry install` command
+> `nox` is installed into the virtual environment automatically by the `poetry sync` command
 > above. Run `poetry shell` to activate the virtual environment.
 
 To run all default sessions:

docs/index.md

@@ -65,7 +65,7 @@ pipx install poetry
 Then install the `fact` package and its dependencies:
 
 ```bash
-poetry install
+poetry sync
 ```
 
 Activate the virtual environment created automatically by Poetry: