Refactor GitHub Actions workflows: consolidate validation steps, upgrade actions/checkout and actions/setup-python to v6, and streamline build steps for Windows, MacOS, and Linux executables.

Author: dipu-bd

.github/workflows/release.yml

@@ -12,78 +12,47 @@ concurrency:
 
 jobs:
   validate:
-    name: Validate Build
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    strategy:
-      fail-fast: true
-      matrix:
-        python-version:
-          ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: 🔐 Validate VERSION tag
-        run: |
-          [ "${GITHUB_REF##*/}" == "v$(head -n 1 lncrawl/VERSION)" ] || exit 100
-
-      - name: 🐍 Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: 📦 Install uv
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
-          echo "$HOME/.local/bin" >> $GITHUB_PATH
-
-      - name: 📦 Install Dependencies
-        run: uv sync --frozen --extra dev
-
-      - name: 🧹 Lint Code
-        run: uv run flake8 -v --count --show-source --statistics
+    uses: ./.github/workflows/lint.yml
 
-      - name: 🏗️ Build Wheel
-        run: uv run python -m build --wheel --no-isolation
-
-      - name: 🧪 Test Wheel Installation
-        run: |
-          uv pip install --system dist/lightnovel_crawler*.whl
-          lncrawl -ll sources list
-          lncrawl -lll crawl 'https://novelfull.com/the-kings-avatar-for-the-glory.html' --first 2 --format epub --noin
+  build-docker:
+    needs: validate
+    uses: ./.github/workflows/build-docker.yml
 
   build-windows:
+    name: Build & Publish (Windows)
     needs: validate
-    name: Build Windows Executable
     runs-on: windows-latest
     permissions:
       contents: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: 🔄 Update submodules
+        run: |
+          git submodule sync
+          git submodule update --init --remote --merge
 
       - name: 🧰 Install OpenSSL
         run: choco install -y --no-progress openssl
 
       - name: 🐍 Set up Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
 
-      - name: 🏗️ Build Windows Executable
-        env:
-          PYTHONIOENCODING: utf-8
-        run: .\scripts\build.bat
-
-      - name: 🧪 Test Executable
+      - name: 🏗️ Build Executable
         env:
           PYTHONIOENCODING: utf-8
-        run: .\dist\lncrawl.exe -ll sources list
+        run: |
+          .\scripts\build.bat
+          .\dist\lncrawl.exe -ll sources list
 
       - name: 📦 Upload Artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: lncrawl-windows
           path: dist/lncrawl.exe
@@ -98,30 +67,36 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
 
   build-mac:
+    name: Build & Publish (MacOS)
     needs: validate
-    name: Build MacOS Executable
     runs-on: macos-latest
     permissions:
       contents: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: 🔄 Update submodules
+        run: |
+          git submodule sync
+          git submodule update --init --remote --merge
 
       - name: 🐍 Set up Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
 
-      - name: 🏗️ Build MacOS Executable
+      - name: 🏗️ Build Executable
         run: |
           sh ./scripts/build.sh
           mv ./dist/lncrawl ./dist/lncrawl-mac
-
-      - name: 🧪 Test Executable
-        run: ./dist/lncrawl-mac -ll sources list
+          ./dist/lncrawl-mac -ll sources list
 
       - name: 📦 Upload Artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: lncrawl-mac
           path: dist/lncrawl-mac
@@ -136,31 +111,37 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
 
   build-linux:
+    name: Build & Publish (Linux)
     needs: validate
-    name: Build & Publish Linux
     runs-on: ubuntu-latest
     permissions:
       contents: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: 🔄 Update submodules
+        run: |
+          git submodule sync
+          git submodule update --init --remote --merge
 
       - name: 🐍 Set up Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
           cache: pip
 
-      - name: 🏗️ Build Linux Executable
+      - name: 🏗️ Build Executable
         run: |
           sh ./scripts/build.sh
           mv ./dist/lncrawl ./dist/lncrawl-linux
-
-      - name: 🧪 Test Executable
-        run: ./dist/lncrawl-linux -ll sources list
+          ./dist/lncrawl-linux -ll sources list
 
       - name: 📦 Upload Artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: lncrawl-linux
           path: |
@@ -187,63 +168,3 @@ jobs:
           TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
           TWINE_NON_INTERACTIVE: true
         run: sh ./scripts/publish.sh
-
-  build-docker:
-    # NOTE: Forks must run the "Build Base Image" workflow (docker-base.yml) first
-    # to create ghcr.io/<owner>/lncrawl-base:latest before this job can succeed.
-    needs: [validate]
-    name: Build & Publish Docker
-    runs-on: ubuntu-latest
-
-    permissions:
-      contents: read
-      packages: write # required for GHCR pushes
-
-    env:
-      REGISTRY: ghcr.io
-      IMAGE_NAME: ghcr.io/${{ github.repository }}
-      BASE_IMAGE: ghcr.io/${{ github.repository_owner }}/lncrawl-base:latest
-
-    steps:
-      - name: 📥 Checkout
-        uses: actions/checkout@v4
-
-      - name: 🔧 Set lowercase image name
-        run: |
-          echo "IMAGE_NAME=ghcr.io/${GITHUB_REPOSITORY,,}" >> $GITHUB_ENV
-          echo "BASE_IMAGE=ghcr.io/${GITHUB_REPOSITORY_OWNER,,}/lncrawl-base:latest" >> $GITHUB_ENV
-
-      - name: 🏗️ Set up QEMU
-        uses: docker/setup-qemu-action@v3
-
-      - name: 🐳 Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: 🔐 Login to GHCR
-        uses: docker/login-action@v3
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: 🏷️ Read package version
-        id: package_version
-        run: echo "version=$(head -n 1 lncrawl/VERSION)" >> "$GITHUB_OUTPUT"
-
-      - name: 🏗️ Build and Push Image
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          platforms: linux/amd64,linux/arm64
-          push: true
-          build-args: |
-            BASE_IMAGE=${{ env.BASE_IMAGE }}
-          tags: |
-            ${{ env.IMAGE_NAME }}:latest
-            ${{ env.IMAGE_NAME }}:${{ github.sha }}
-            ${{ env.IMAGE_NAME }}:${{ steps.package_version.outputs.version }}
-          labels: |
-            org.opencontainers.image.source=${{ github.event.repository.html_url }}
-            org.opencontainers.image.revision=${{ github.sha }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max