Merge branch 'v0.x.x' into dependabot/pip/black-26.1.0

Signed-off-by: daniel-zullo-frequenz <120166726+daniel-zullo-frequenz@users.noreply.github.com>

Author: daniel-zullo-frequenz

.github/dependabot.yml

@@ -38,11 +38,13 @@ updates:
           - "mkdocs-gen-files"
           - "mkdocs-literate-nav"
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
           - "pydoclint"
           - "pytest-asyncio"
       mkdocstrings:
         patterns:
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
 
   - package-ecosystem: "github-actions"
     directory: "/"

.github/workflows/ci-pr.yaml

@@ -35,7 +35,7 @@ jobs:
           submodules: true
 
       - name: Setup Python
-        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.1
+        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.2
         with:
           python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
           dependencies: .[dev-mkdocs]
@@ -48,7 +48,7 @@ jobs:
           mike set-default $MIKE_VERSION
 
       - name: Upload site
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: docs-site
           path: site/

.github/workflows/ci.yaml

@@ -84,7 +84,7 @@ jobs:
           submodules: true
 
       - name: Setup Python
-        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.1
+        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.2
         with:
           python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
           dependencies: build
@@ -93,7 +93,7 @@ jobs:
         run: python -m build
 
       - name: Upload distribution files
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: dist-packages
           path: dist/
@@ -143,7 +143,7 @@ jobs:
             > pyproject.toml
 
       - name: Setup Python
-        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.1
+        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.2
         with:
           python-version: ${{ matrix.python }}
           dependencies: dist/*.whl
@@ -182,7 +182,7 @@ jobs:
           submodules: true
 
       - name: Setup Python
-        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.1
+        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.2
         with:
           python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
           dependencies: .[dev-mkdocs]
@@ -195,7 +195,7 @@ jobs:
           mike set-default $MIKE_VERSION
 
       - name: Upload site
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: docs-site
           path: site/
@@ -218,7 +218,7 @@ jobs:
           submodules: true
 
       - name: Setup Python
-        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.1
+        uses: frequenz-floss/gh-action-setup-python-with-deps@v1.0.2
         with:
           python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
           dependencies: .[dev-mkdocs]

RELEASE_NOTES.md

@@ -45,12 +45,8 @@ But you might still need to adapt your code:
 
 ### Cookiecutter template
 
-- Switched `project.license` to SPDX expressions and added `project.license-files`.
-  This removes deprecated setuptools license metadata and avoids build warnings.
-
-- Fixed auto-dependabot workflow failing to trigger merge queue CI or complete
-  auto-merge. The workflow now uses a GitHub App installation token (via
-  `actions/create-github-app-token`) instead of `GITHUB_TOKEN`, which was
-  suppressing subsequent workflow runs by design. Workflow permissions have been
-  reduced to the minimum needed for the workflow (`contents: read` and
-  `pull-requests: write`).
+- Switched `project.license` to SPDX expressions and added `project.license-files`. This removes deprecated setuptools license metadata and avoids build warnings.
+
+- Fixed auto-dependabot workflow failing to trigger merge queue CI or complete auto-merge. The workflow now uses a GitHub App installation token (via `actions/create-github-app-token`) instead of `GITHUB_TOKEN`, which was suppressing subsequent workflow runs by design. Workflow permissions have been reduced to the minimum needed for the workflow (`contents: read` and `pull-requests: write`).
+
+- Fix dependabot group patterns for repo-config and mkdocstrings.

cookiecutter/migrate.py

@@ -46,6 +46,9 @@ def main() -> None:
     print("Adding flake8-datetimez plugin to dev-flake8 dependencies...")
     migrate_add_flake8_datetimez()
     print("=" * 72)
+    print("Fixing dependabot repo-config and mkdocstrings patterns...")
+    migrate_dependabot_patterns()
+    print("=" * 72)
     print("Migrating auto-dependabot workflow to use GitHub App token...")
     migrate_auto_dependabot_token()
     print("=" * 72)
@@ -323,6 +326,93 @@ def migrate_add_flake8_datetimez() -> None:
     print("  Updated pyproject.toml: added flake8-datetimez plugin")
 
 
+def migrate_dependabot_patterns() -> None:
+    """Fix dependabot repo-config and mkdocstrings dependency patterns.
+
+    Dependabot wildcards don't work when ``[]`` is involved in optional
+    dependency specifiers, so we need to list them explicitly in the
+    include/exclude patterns.
+
+    This replaces ``frequenz-repo-config*`` with explicit entries for the
+    base package, the project-type extra, and the ``extra-lint-examples``
+    extra, and adds ``mkdocstrings[python]`` alongside ``mkdocstrings*``.
+    """
+    filepath = Path(".github") / "dependabot.yml"
+    if not filepath.exists():
+        manual_step(
+            f"Unable to find {filepath}. Please update your dependabot config "
+            "manually by replacing any `frequenz-repo-config*` patterns with explicit "
+            "entries for `frequenz-repo-config`, `frequenz-repo-config[<your-type>]`, and "
+            "`frequenz-repo-config[extra-lint-examples]`, and add `mkdocstrings[python]` "
+            "to the patterns for the `mkdocstrings` group if it is missing."
+        )
+        return
+
+    content = filepath.read_text(encoding="utf-8")
+    new_content = content
+    updated = False
+
+    project_type = read_project_type()
+    if project_type is None:
+        manual_step(
+            "Unable to detect the cookiecutter project type from "
+            ".cookiecutter-replay.json; cannot determine the correct "
+            "frequenz-repo-config optional dependency for dependabot.yml. "
+            "Please replace any `frequenz-repo-config*` patterns with explicit "
+            "entries for `frequenz-repo-config`, "
+            "`frequenz-repo-config[<your-type>]`, and "
+            "`frequenz-repo-config[extra-lint-examples]`."
+        )
+        return
+
+    # Replace frequenz-repo-config* with explicit entries (appears in both
+    # exclude-patterns and repo-config group patterns).
+    old_repo_config = '          - "frequenz-repo-config*"\n'
+    new_repo_config = (
+        '          - "frequenz-repo-config"\n'
+        f'          - "frequenz-repo-config[{project_type}]"\n'
+        '          - "frequenz-repo-config[extra-lint-examples]"\n'
+    )
+    if old_repo_config in new_content:
+        new_content = new_content.replace(old_repo_config, new_repo_config)
+        updated = True
+    elif f'"frequenz-repo-config[{project_type}]"' in new_content:
+        print(f"  Skipped {filepath}: repo-config patterns already updated")
+    else:
+        manual_step(
+            f"Could not find `frequenz-repo-config*` pattern in {filepath}. "
+            "Please replace it with explicit entries for "
+            "`frequenz-repo-config`, "
+            f"`frequenz-repo-config[{project_type}]`, and "
+            "`frequenz-repo-config[extra-lint-examples]`."
+        )
+
+    # Add mkdocstrings[python] after mkdocstrings* (appears in both
+    # exclude-patterns and mkdocstrings group patterns).
+    old_mkdocstrings = '          - "mkdocstrings*"\n'
+    new_mkdocstrings = (
+        '          - "mkdocstrings*"\n          - "mkdocstrings[python]"\n'
+    )
+    if old_mkdocstrings in new_content and '"mkdocstrings[python]"' not in new_content:
+        new_content = new_content.replace(old_mkdocstrings, new_mkdocstrings)
+        updated = True
+    elif '"mkdocstrings[python]"' in new_content:
+        print(f"  Skipped {filepath}: mkdocstrings patterns already updated")
+    else:
+        manual_step(
+            f"Could not find `mkdocstrings*` pattern in {filepath}. "
+            'Please add `"mkdocstrings[python]"` alongside `"mkdocstrings*"` '
+            "in both the exclude-patterns and the mkdocstrings group."
+        )
+
+    if not updated or new_content == content:
+        print(f"  Skipped {filepath} (already up to date)")
+        return
+
+    replace_file_contents_atomically(filepath, content, new_content, count=1)
+    print(f"  Updated {filepath}: fixed repo-config and mkdocstrings patterns")
+
+
 def migrate_auto_dependabot_token() -> None:
     """Migrate auto-dependabot workflow to use a GitHub App installation token.
 

cookiecutter/{{cookiecutter.github_repo_name}}/.github/dependabot.yml

@@ -37,22 +37,28 @@ updates:
 {%- if cookiecutter.type == "api" %}
           - "frequenz-api-common"
 {%- endif %}
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[{{ cookiecutter.type }}]"
+          - "frequenz-repo-config[extra-lint-examples]"
           - "markdown-callouts"
           - "mkdocs-gen-files"
           - "mkdocs-literate-nav"
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
           - "pydoclint"
           - "pytest-asyncio"
       # We group repo-config updates as it uses optional dependencies that are
       # considered different dependencies otherwise, and will create one PR for
       # each if we don't group them.
       repo-config:
         patterns:
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[{{ cookiecutter.type }}]"
+          - "frequenz-repo-config[extra-lint-examples]"
       mkdocstrings:
         patterns:
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
 
   - package-ecosystem: "github-actions"
     directory: "/"

pyproject.toml

@@ -78,26 +78,26 @@ dev-flake8 = [
 dev-formatting = ["black == 26.1.0", "isort == 7.0.0"]
 dev-mkdocs = [
   "black == 26.1.0",
-  "Markdown == 3.10",
+  "Markdown == 3.10.2",
   "mike == 2.1.3",
   "mkdocs-gen-files == 0.6.0",
   "mkdocs-literate-nav == 0.6.2",
   "mkdocs-macros-plugin == 1.5.0",
-  "mkdocs-material == 9.7.1",
-  "mkdocstrings[python] == 1.0.0",
-  "mkdocstrings-python == 2.0.1",
+  "mkdocs-material == 9.7.2",
+  "mkdocstrings[python] == 1.0.3",
+  "mkdocstrings-python == 2.0.2",
 ]
 dev-mypy = [
   "mypy == 1.19.1",
-  "types-setuptools >= 67.6.0, < 81", # Should match the api dependency
-  "types-Markdown == 3.10.0.20251106",
+  "types-setuptools >= 67.6.0, < 83", # Should match the api dependency
+  "types-Markdown == 3.10.2.20260211",
   "types-PyYAML == 6.0.12.20250915",
   "types-babel == 2.11.0.15",
   "types-colorama == 0.4.15.20250801",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-repo-config[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
-dev-noxfile = ["nox == 2025.11.12"]
+dev-noxfile = ["nox == 2026.2.9"]
 dev-pylint = [
   # dev-pytest already defines a dependency to pylint because of the examples
   # For checking the noxfile, docs/ script, and tests

tests_golden/integration/test_cookiecutter_generation/actor/frequenz-actor-test/.github/dependabot.yml

@@ -34,22 +34,28 @@ updates:
           - "minor"
         exclude-patterns:
           - "async-solipsism"
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[actor]"
+          - "frequenz-repo-config[extra-lint-examples]"
           - "markdown-callouts"
           - "mkdocs-gen-files"
           - "mkdocs-literate-nav"
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
           - "pydoclint"
           - "pytest-asyncio"
       # We group repo-config updates as it uses optional dependencies that are
       # considered different dependencies otherwise, and will create one PR for
       # each if we don't group them.
       repo-config:
         patterns:
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[actor]"
+          - "frequenz-repo-config[extra-lint-examples]"
       mkdocstrings:
         patterns:
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
 
   - package-ecosystem: "github-actions"
     directory: "/"

tests_golden/integration/test_cookiecutter_generation/api/frequenz-api-test/.github/dependabot.yml

@@ -35,22 +35,28 @@ updates:
         exclude-patterns:
           - "async-solipsism"
           - "frequenz-api-common"
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[api]"
+          - "frequenz-repo-config[extra-lint-examples]"
           - "markdown-callouts"
           - "mkdocs-gen-files"
           - "mkdocs-literate-nav"
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
           - "pydoclint"
           - "pytest-asyncio"
       # We group repo-config updates as it uses optional dependencies that are
       # considered different dependencies otherwise, and will create one PR for
       # each if we don't group them.
       repo-config:
         patterns:
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[api]"
+          - "frequenz-repo-config[extra-lint-examples]"
       mkdocstrings:
         patterns:
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
 
   - package-ecosystem: "github-actions"
     directory: "/"

tests_golden/integration/test_cookiecutter_generation/app/frequenz-app-test/.github/dependabot.yml

@@ -34,22 +34,28 @@ updates:
           - "minor"
         exclude-patterns:
           - "async-solipsism"
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[app]"
+          - "frequenz-repo-config[extra-lint-examples]"
           - "markdown-callouts"
           - "mkdocs-gen-files"
           - "mkdocs-literate-nav"
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
           - "pydoclint"
           - "pytest-asyncio"
       # We group repo-config updates as it uses optional dependencies that are
       # considered different dependencies otherwise, and will create one PR for
       # each if we don't group them.
       repo-config:
         patterns:
-          - "frequenz-repo-config*"
+          - "frequenz-repo-config"
+          - "frequenz-repo-config[app]"
+          - "frequenz-repo-config[extra-lint-examples]"
       mkdocstrings:
         patterns:
           - "mkdocstrings*"
+          - "mkdocstrings[python]"
 
   - package-ecosystem: "github-actions"
     directory: "/"