[pull] main from mne-tools:main

.circleci/config.yml

@@ -433,13 +433,9 @@ jobs:
             mne sys_info -pd
       - run:
           name: make linkcheck
+          no_output_timeout: 40m
           command: |
             make -C doc linkcheck
-      - run:
-          name: make linkcheck-grep
-          when: always
-          command: |
-            make -C doc linkcheck-grep
       - store_artifacts:
           path: doc/_build/linkcheck
           destination: linkcheck

.git-blame-ignore-revs

@@ -1,7 +1,16 @@
-e81ec528a42ac687f3d961ed5cf8e25f236925b0  # black
-12395f9d9cf6ea3c72b225b62e052dd0d17d9889  # YAML indentation
-d6d2f8c6a2ed4a0b27357da9ddf8e0cd14931b59  # isort
-e7dd1588013179013a50d3f6b8e8f9ae0a185783  # ruff format
-e39995d9be6fc831c7a4a59f09b7a7c0a41ae315  # percent formatting
-940ac9553ce42c15b4c16ecd013824ca3ea7244a  # whitespace
-1c5b39ff1d99bbcb2fc0e0071a989b3f3845ff30  # ruff UP028
+# PR number should follow the commit number so that our code credit
+# can parse this file correctly:
+d71e497dcf6f98e19eb81e82e641404a71d2d663  # 1420, split up viz.py
+203a96cbba2732d2e349a8f96065e74bbfd2a53b  # 5862, split utils.py
+ff349f356edb04e1b5f0db13deda8d1a20aca351  # 6767, move around manual parts
+31a83063557fbd54d898f00f9527ffc547888395  # 10407, alphabetize docdict
+e81ec528a42ac687f3d961ed5cf8e25f236925b0  # 11667, black
+12395f9d9cf6ea3c72b225b62e052dd0d17d9889  # 11868, YAML indentation
+d6d2f8c6a2ed4a0b27357da9ddf8e0cd14931b59  # 12097, isort
+e7dd1588013179013a50d3f6b8e8f9ae0a185783  # 12261, ruff format
+940ac9553ce42c15b4c16ecd013824ca3ea7244a  # 12533, whitespace
+e39995d9be6fc831c7a4a59f09b7a7c0a41ae315  # 12588, percent formatting
+1c5b39ff1d99bbcb2fc0e0071a989b3f3845ff30  # 12603, ruff UP028
+b8b168088cb474f27833f5f9db9d60abe00dca83  # 12779, PR JSONs
+ee64eba6f345e895e3d5e7d2804fa6aa2dac2e6d  # 12781, Header unification
+362f9330925fb79a6adc19a42243672676dec63e  # 12799, UP038

.github/PULL_REQUEST_TEMPLATE.md

@@ -15,13 +15,20 @@ Again, thanks for contributing!
 
 -->
 
-#### Reference issue
-Example: Fixes #1234.
+#### Reference issue (if any)
+
+<!-- Example:
+
+Fixes #1234.
+
+-->
 
 
 #### What does this implement/fix?
-Explain your changes.
+
+<!-- Explain your changes. -->
 
 
 #### Additional information
-Any additional information you think is important.
+
+<!-- Any additional information you think is important. -->

.github/actions/rename_towncrier/rename_towncrier.py

@@ -1,5 +1,9 @@
 #!/usr/bin/env python3
 
+# Authors: The MNE-Python contributors.
+# License: BSD-3-Clause
+# Copyright the MNE-Python contributors.
+
 # Adapted from action-towncrier-changelog
 import json
 import os

.github/workflows/autofix.yml

@@ -9,13 +9,14 @@ permissions:
 
 jobs:
   autofix:
-    name: Autoupdate changelog entry
+    name: Autoupdate changelog entry and headers
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-      - run: pip install --upgrade towncrier pygithub
+      - run: pip install --upgrade towncrier pygithub gitpython numpy
       - run: python ./.github/actions/rename_towncrier/rename_towncrier.py
+      - run: python ./tools/dev/ensure_headers.py
       - uses: autofix-ci/action@dd55f44df8f7cdb7a6bf74c78677eb8acd40cd0a

.github/workflows/credit.yml

@@ -0,0 +1,44 @@
+name: Contributor credit
+
+on:  # yamllint disable-line rule:truthy
+  # Scheduled actions only run on the main repo branch, which is exactly what we want
+  schedule:
+    - cron: '0 0 1 * *'  # At 00:00 on day-of-month 1
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update_credit:
+    name: Update
+    runs-on: ubuntu-latest
+    env:
+      GH_TOKEN: ${{ github.token }}
+      GITHUB_TOKEN: ${{ github.token }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install pygithub -e .
+      - run: python tools/dev/update_credit_json.py
+      - run: git add -f doc/sphinxext/prs/*.json
+      - run: |
+          git diff && git status --porcelain
+          if [[ $(git status --porcelain) ]]; then
+            echo "dirty=true" >> $GITHUB_OUTPUT
+          fi
+        id: status
+      - name: Create PR
+        run: |
+          set -xeo pipefail
+          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git config --global user.name "github-actions[bot]"
+          git checkout -b credit
+          git commit -am "MAINT: Update code credit [ci skip]"
+          git push origin credit
+          PR_NUM=$(gh pr create --base main --head credit --title "MAINT: Update code credit" --body "Created by \"${{ github.workflow }}\" GitHub action." --label "no-changelog-entry-needed")
+          echo "Opened https://github.com/mne-tools/mne-python/pull/${PR_NUM}" >> $GITHUB_STEP_SUMMARY
+        if: steps.status.outputs.dirty == 'true'

.github/workflows/tests.yml

@@ -72,10 +72,10 @@ jobs:
             python: '3.10'
             kind: mamba
           - os: ubuntu-latest
-            python: '3.9'
+            python: '3.10'
             kind: minimal
           - os: ubuntu-20.04
-            python: '3.9'
+            python: '3.10'
             kind: old
     steps:
       - uses: actions/checkout@v4
@@ -131,4 +131,4 @@ jobs:
       - uses: codecov/codecov-action@v4
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-        if: success()
+        if: always()

.gitignore

@@ -97,7 +97,7 @@ cover
 
 .venv/
 venv/
-*.json
+/*.json
 !codemeta.json
 .hypothesis/
 .ruff_cache/