Use task to install Python package dependencies in website deployment workflows

The "Task" task runner is used to perform common development and maintenance operations in Arduino tooling projects.

One such operation is the installation of Python package dependencies using Poetry. The project website deployment
workflows rely on Python packages, and so contain a step to install them. Previously, this was done by invoking the
Poetry command directly from the workflow. That is problematic because it means multiple copies of the command must be
maintained, and the maintainer might easily overlook the need to do so for these workflows since we expect there to be
only one instance of the command.

The workflows are hereby changed to use the standardized approach to installing Python package dependencies.

Author: per1234

workflow-templates/deploy-cobra-mkdocs-versioned-poetry.md

@@ -27,6 +27,8 @@ Install the [`deploy-cobra-mkdocs-versioned-poetry.yml`](deploy-cobra-mkdocs-ver
   - Install to: repository root (or merge into the existing `Taskfile.yml`).
 - [`Taskfile.yml`](assets/check-prettier-formatting-task/Taskfile.yml) - documentation formatting task.
   - Merge into `Taskfile.yml`
+- [`Taskfile.yml`](assets/poetry-task/Taskfile.yml) - Python package dependency management tasks.
+  - Merge into `Taskfile.yml`
 - [`docsgen`](assets/cobra/docsgen) - command line reference generator.
   - Install to: `docsgen/`
 

workflow-templates/deploy-cobra-mkdocs-versioned-poetry.yml

@@ -82,8 +82,10 @@ jobs:
       - name: Create all generated documentation content
         run: task docs:generate
 
-      - name: Install Python dependencies
-        run: poetry install --no-root
+      - name: Install Dependencies
+        run: |
+          task \
+            poetry:install-deps
 
       - name: Determine versioning parameters
         id: determine-versioning

workflow-templates/deploy-mkdocs-poetry.md

@@ -12,6 +12,8 @@ Install the [`deploy-mkdocs-poetry.yml`](deploy-mkdocs-poetry.yml) GitHub Action
 
 ### Assets
 
+- [`Taskfile.yml`](assets/poetry-task/Taskfile.yml) - Python package dependency management tasks.
+  - Install to: repository root (or merge into the existing `Taskfile.yml`).
 - [`mkdocs.yml`](assets/mkdocs/mkdocs.yml) - base MkDocs configuration file.
   - Install to: repository root
 - [`icon_mac_light.png`](assets/mkdocs/icon_mac_light.png) - Arduino logo for the website. **NOTE**: only for use in official Arduino projects. Community projects should use [the Community Logo](https://www.arduino.cc/en/Trademark/CommunityLogo).

workflow-templates/deploy-mkdocs-poetry.yml

@@ -12,6 +12,7 @@ on:
       - "mkdocs.ya?ml"
       - "poetry.lock"
       - "pyproject.toml"
+      - "Taskfile.ya?ml"
       - "docs/**"
   workflow_dispatch:
   repository_dispatch:
@@ -31,11 +32,19 @@ jobs:
         with:
           python-version-file: pyproject.toml
 
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          version: 3.x
+
       - name: Install Poetry
         run: pip install poetry
 
       - name: Install Dependencies
-        run: poetry install --no-root
+        run: |
+          task \
+            poetry:install-deps
 
       - name: Deploy website
         run: poetry run mkdocs gh-deploy

workflow-templates/deploy-mkdocs-versioned-poetry.yml

@@ -13,6 +13,7 @@ on:
       - ".github/workflows/deploy-mkdocs-versioned-poetry.ya?ml"
       - "mkdocs.ya?ml"
       - "poetry.lock"
+      - "Taskfile.ya?ml"
       - "pyproject.toml"
   # Run on branch or tag creation (will be filtered by the publish-determination job).
   create:
@@ -58,13 +59,21 @@ jobs:
         with:
           python-version-file: pyproject.toml
 
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          version: 3.x
+
       - name: Install Poetry
         run: |
           python -m pip install --upgrade pip
           python -m pip install poetry
 
-      - name: Install Python dependencies
-        run: poetry install --no-root
+      - name: Install Dependencies
+        run: |
+          task \
+            poetry:install-deps
 
       - name: Determine versioning parameters
         id: determine-versioning