fix: Remove EAGER_IMPORT export and update CI configurations

liblaf · liblaf · commit 375fca42f0bd · 2025-11-03T16:24:48.000+08:00
Remove the EAGER_IMPORT environment variable export from bench.sh as it's no longer needed. Update GitHub Actions workflows (bench, docs, release, test) to use standardized configurations including branch filtering, concurrency controls, and improved job structures. Update Read the Docs configuration to include --all-packages flag for uv sync. Add Python 3.14 classifier and lazy-loader dependency to pyproject.toml.

These changes standardize the CI/CD pipeline configurations, improve build reliability, and ensure compatibility with newer Python versions.
diff --git a/template/.config/copier/mise-tasks/bench.sh b/template/.config/copier/mise-tasks/bench.sh
@@ -5,7 +5,4 @@ set -o errexit
 set -o nounset
 set -o pipefail
 
-# ref: <https://github.com/scientific-python/lazy-loader#early-failure>
-export EAGER_IMPORT=1
-
 pytest -m 'benchmark' --numprocesses 0 --codspeed --codspeed-warmup-time='0.2' "$@"
diff --git a/template/.config/copier/mise-tasks/test.sh b/template/.config/copier/mise-tasks/test.sh
@@ -5,18 +5,12 @@ set -o errexit
 set -o nounset
 set -o pipefail
 
-function is-in-ci() {
-  if [[ -z ${CI:-} ]]; then
+function in-ci() {
+  if [[ -n ${CI:-} ]]; then
+    return 0
+  else
     return 1
   fi
-  case "${CI,,}" in
-    1 | on | true | y | yes) return 0 ;;
-    0 | off | false | n | no | "") return 1 ;;
-    *)
-      echo "Invalid boolean: $CI." >&2
-      exit 1
-      ;;
-  esac
 }
 
 function needs-gpu() {
@@ -37,7 +31,7 @@ else
   numprocesses='auto'
 fi
 
-if is-in-ci; then
+if in-ci; then
   # ref: <https://docs.codecov.com/docs/test-analytics#1-output-a-junit-xml-file-in-your-ci>
   pytest \
     --junit-xml='junit.xml' --override-ini junit_family=legacy \
diff --git a/template/.github/workflows/bench.yaml b/template/.github/workflows/bench.yaml
@@ -5,37 +5,36 @@ name: Bench
 
 on:
   push:
+    branches-ignore:
+      - copier-update
+      - mega-linter-fix/**
+      - pre-commit-ci-update-config
+      - release-please--branches**
   pull_request:
   workflow_dispatch:
 
-jobs:
-  skip-duplicate:
-    name: Skip Duplicate
-    permissions:
-      actions: write
-    runs-on: ubuntu-latest
-    outputs:
-      should-skip: ${{ steps.skip-duplicate.outputs.should-skip }}
-    steps:
-      - id: skip-duplicate
-        name: Skip Duplicate
-        uses: liblaf/actions/skip-duplicate@dist
-        with:
-          cancel-others: true
+env:
+  FORCE_COLOR: 1
 
-  collect:
-    name: Collect
-    needs:
-      - skip-duplicate
-    if: needs.skip-duplicate.outputs.should-skip != 'true'
+concurrency:
+  group: ${{ github.workflow }} @ ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  metadata:
+    name: Metadata
     runs-on: ubuntu-latest
     outputs:
       has-benches: ${{ steps.collect.outputs.has-benches }}
+      python-versions: ${{ steps.inspect.outputs.supported_python_classifiers_json_array }}
     steps:
       - name: Checkout
         uses: actions/checkout@v5
+      - id: inspect
+        name: Build and Inspect a Python Package
+        uses: hynek/build-and-inspect-python-package@v2
       - name: Setup Python
-        uses: liblaf/actions/setup-python@dist
+        uses: liblaf/actions/setup-python@v1
       - id: collect
         name: Collect
         run: |-
@@ -48,14 +47,16 @@ jobs:
   bench:
     name: Bench
     needs:
-      - collect
-    if: needs.collect.outputs.has-benches == 'true'
+      - metadata
+    if: needs.metadata.outputs.has-benches == 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v5
       - name: Setup Python
-        uses: liblaf/actions/setup-python@dist
+        uses: liblaf/actions/setup-python@v1
+        with:
+          python-version: ${{ matrix.python-version }}
       - name: Install Mise
         uses: jdx/mise-action@v3
       - name: Bench
@@ -65,3 +66,7 @@ jobs:
           mode: instrumentation
         env:
           FORCE_COLOR: 1
+    strategy:
+      matrix:
+        python-version: ${{ fromJson(needs.metadata.outputs.python-versions) }}
+      fail-fast: false
diff --git a/template/.github/workflows/build.yaml b/template/.github/workflows/build.yaml
diff --git a/template/.github/workflows/docs.yaml b/template/.github/workflows/docs.yaml
@@ -5,54 +5,43 @@ name: Docs
 
 on:
   push:
+    branches-ignore:
+      - copier-update
+      - mega-linter-fix/**
+      - pre-commit-ci-update-config
+      - release-please--branches**
   pull_request:
   workflow_dispatch:
 
 jobs:
-  skip-duplicate:
-    name: Skip Duplicate
-    permissions:
-      actions: write
-    runs-on: ubuntu-latest
-    outputs:
-      should-skip: ${{ steps.skip-duplicate.outputs.should-skip }}
-    steps:
-      - id: skip-duplicate
-        name: Skip Duplicate
-        uses: liblaf/actions/skip-duplicate@dist
-        with:
-          cancel-others: true
-
   docs:
     name: Docs
     permissions:
-      contents: write
+      id-token: write
       pages: write
-    needs:
-      - skip-duplicate
-    if: needs.skip-duplicate.outputs.should-skip != 'true'
     runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
     steps:
       - name: Checkout
         uses: actions/checkout@v5
         with:
           fetch-depth: 0
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
       - name: Setup Python
-        uses: liblaf/actions/setup-python@dist
+        uses: liblaf/actions/setup-python@v1
       - if: hashFiles('docs/scripts/pre-build.sh') != ''
         name: Pre-Build
         run: docs/scripts/pre-build.sh
       - name: Build
         run: mkdocs build
-      - if: ${{ github.ref == 'refs/heads/main' }}
-        name: Deploy
-        uses: JamesIves/github-pages-deploy-action@v4
-        with:
-          folder: site
-          single-commit: true
-      - if: ${{ github.ref == 'refs/heads/main' }}
-        name: Setup GitHub Pages
-        uses: liblaf/actions/setup-pages@dist
+      - name: Upload Github Pages Artifact
+        uses: actions/upload-pages-artifact@v4
         with:
-          token: ${{ github.token }}
-        continue-on-error: true
+          path: site
+      - id: deploy
+        if: ${{ github.ref == 'refs/heads/main' }}
+        name: Deploy Github Pages Site
+        uses: actions/deploy-pages@v4
diff --git a/template/.github/workflows/release.yaml b/template/.github/workflows/release.yaml
@@ -49,6 +49,8 @@ jobs:
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
+          verbose: true
+          print-hash: true
           attestations: true
 
   release:
@@ -69,7 +71,6 @@ jobs:
           name: ${{ needs.build.outputs.artifact-name }}
           path: dist
       - name: Upload Release Assets
-        uses: liblaf/actions/release@dist
+        uses: softprops/action-gh-release@v2
         with:
           files: dist/*
-          tag: ${{ github.ref_name }}
diff --git a/template/.github/workflows/test.yaml b/template/.github/workflows/test.yaml
@@ -7,37 +7,36 @@ name: Test
 
 on:
   push:
+    branches-ignore:
+      - copier-update
+      - mega-linter-fix/**
+      - pre-commit-ci-update-config
+      - release-please--branches**
   pull_request:
   workflow_dispatch:
 
-jobs:
-  skip-duplicate:
-    name: Skip Duplicate
-    permissions:
-      actions: write
-    runs-on: ubuntu-latest
-    outputs:
-      should-skip: ${{ steps.skip-duplicate.outputs.should-skip }}
-    steps:
-      - id: skip-duplicate
-        name: Skip Duplicate
-        uses: liblaf/actions/skip-duplicate@dist
-        with:
-          cancel-others: true
+env:
+  FORCE_COLOR: 1
 
-  collect:
-    name: Collect
-    needs:
-      - skip-duplicate
-    if: needs.skip-duplicate.outputs.should-skip != 'true'
+concurrency:
+  group: ${{ github.workflow }} @ ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  metadata:
+    name: Metadata
     runs-on: ubuntu-latest
     outputs:
       has-tests: ${{ steps.collect.outputs.has-tests }}
+      python-versions: ${{ steps.inspect.outputs.supported_python_classifiers_json_array }}
     steps:
       - name: Checkout
         uses: actions/checkout@v5
+      - id: inspect
+        name: Build and Inspect a Python Package
+        uses: hynek/build-and-inspect-python-package@v2
       - name: Setup Python
-        uses: liblaf/actions/setup-python@dist
+        uses: liblaf/actions/setup-python@v1
       - id: collect
         name: Collect
         run: |-
@@ -49,26 +48,27 @@ jobs:
 
   test:
     name: Test
-    needs:
-      - collect
-    if: needs.collect.outputs.has-tests == 'true'
     permissions:
       id-token: write
+    needs:
+      - metadata
+    if: needs.metadata.outputs.has-tests == 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v5
         with:
           fetch-depth: 0 # I don't know why, but it is present in the official example
       - name: Setup Python
-        uses: liblaf/actions/setup-python@dist
+        uses: liblaf/actions/setup-python@v1
+        with:
+          python-version: ${{ matrix.python-version }}
       - name: Install Mise
         uses: jdx/mise-action@v3
       - name: Test
         run: mise run test
-        env:
-          FORCE_COLOR: 1
-      - name: Upload Coverage
+      - if: success() || failure()
+        name: Upload Coverage
         uses: codecov/codecov-action@v5
         with:
           use_oidc: true
@@ -77,3 +77,7 @@ jobs:
         uses: codecov/test-results-action@v1
         with:
           use_oidc: true
+    strategy:
+      matrix:
+        python-version: ${{ fromJson(needs.metadata.outputs.python-versions) }}
+      fail-fast: false
diff --git a/template/.readthedocs.yaml.jinja b/template/.readthedocs.yaml.jinja
@@ -38,7 +38,7 @@ build:
       # %% if package_manager == "pixi":
       - pixi install --frozen
       # %% elif package_manager == "uv":
-      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --all-extras --all-groups --frozen --link-mode copy
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --all-extras --all-groups --frozen --all-packages --link-mode copy
       # %% endif
 
     pre_build:
diff --git a/template/pyproject.toml.jinja b/template/pyproject.toml.jinja
@@ -21,9 +21,10 @@ classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Typing :: Typed",
 ]
-dependencies = []
+dependencies = ["lazy-loader>=0.4,<0.5"]
 dynamic = ["version"]
 
 [project.urls]
