ci: refactor CI workflows and add config file (#46)

Author: ZCShou

.github/config.json

@@ -0,0 +1,13 @@
+{
+  "targets": [
+    "aarch64-unknown-none-softfloat",
+    "x86_64-unknown-linux-gnu",
+    "x86_64-unknown-none",
+    "riscv64gc-unknown-none-elf"
+  ],
+  "rust_components": [
+    "rust-src",
+    "clippy",
+    "rustfmt"
+  ]
+}

.github/workflows/check.yml

@@ -1,20 +1,42 @@
 name: Quality Checks
 
 on:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
+  pull_request:
   workflow_call:
 
 jobs:
+  load-config:
+    name: Load CI Configuration
+    runs-on: ubuntu-latest
+    outputs:
+      targets: ${{ steps.config.outputs.targets }}
+      rust_components: ${{ steps.config.outputs.rust_components }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Load configuration
+        id: config
+        run: |
+          TARGETS=$(jq -c '.targets' .github/config.json)
+          COMPONENTS=$(jq -r '.rust_components | join(", ")' .github/config.json)
+          
+          echo "targets=$TARGETS" >> $GITHUB_OUTPUT
+          echo "rust_components=$COMPONENTS" >> $GITHUB_OUTPUT
+
   check:
-    name: Quality Checks
+    name: Check
     runs-on: ubuntu-latest
+    needs: load-config
     strategy:
       fail-fast: false
       matrix:
-        target:
-          - x86_64-unknown-linux-gnu
-          - x86_64-unknown-none
-          - riscv64gc-unknown-none-elf
-          - aarch64-unknown-none-softfloat
+        target: ${{ fromJson(needs.load-config.outputs.targets) }}
 
     steps:
       - name: Checkout code
@@ -23,7 +45,7 @@ jobs:
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@nightly
         with:
-          components: rust-src, clippy, rustfmt
+          components: ${{ needs.load-config.outputs.rust_components }}
           targets: ${{ matrix.target }}
 
       - name: Check rust version
@@ -36,7 +58,7 @@ jobs:
         run: cargo build --target ${{ matrix.target }} --all-features
 
       - name: Run clippy
-        run: cargo clippy --target ${{ matrix.target }} --all-features -- -D warnings -A clippy::new_without_default
+        run: cargo clippy --target ${{ matrix.target }} --all-features -- -D warnings
 
       - name: Build documentation
         env:

.github/workflows/deploy.yml

@@ -2,12 +2,8 @@ name: Deploy
 
 on:
   push:
-    branches:
-      - '**'
-    tags-ignore:
-      - 'v*'
-      - 'v*-pre.*'
-  pull_request:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
 
 permissions:
   contents: read
@@ -23,16 +19,63 @@ env:
   RUST_BACKTRACE: 1
 
 jobs:
-  quality-check:
+  verify-tag:
+    name: Verify Tag
+    runs-on: ubuntu-latest
+    outputs:
+      should_deploy: ${{ steps.check.outputs.should_deploy }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Check if tag is on main or master branch
+        id: check
+        run: |
+          git fetch origin main master || true
+          BRANCHES=$(git branch -r --contains ${{ github.ref }})
+          
+          if echo "$BRANCHES" | grep -qE 'origin/(main|master)'; then
+            echo "✓ Tag is on main or master branch"
+            echo "should_deploy=true" >> $GITHUB_OUTPUT
+          else
+            echo "✗ Tag is not on main or master branch, skipping deployment"
+            echo "Tag is on: $BRANCHES"
+            echo "should_deploy=false" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Verify version consistency
+        if: steps.check.outputs.should_deploy == 'true'
+        run: |
+          # Extract version from git tag (remove 'v' prefix)
+          TAG_VERSION="${{ github.ref_name }}"
+          TAG_VERSION="${TAG_VERSION#v}"
+          # Extract version from Cargo.toml
+          CARGO_VERSION=$(grep -m1 '^version' Cargo.toml | sed 's/.*"\(.*\)"/\1/')
+          echo "Git tag version: $TAG_VERSION"
+          echo "Cargo.toml version: $CARGO_VERSION"
+          if [ "$TAG_VERSION" != "$CARGO_VERSION" ]; then
+            echo "ERROR: Version mismatch! Tag version ($TAG_VERSION) != Cargo.toml version ($CARGO_VERSION)"
+            exit 1
+          fi
+          echo "✓ Version check passed!"
+
+  check:
     uses: ./.github/workflows/check.yml
+    needs: verify-tag
+    if: needs.verify-tag.outputs.should_deploy == 'true'
 
   test:
     uses: ./.github/workflows/test.yml
+    needs: verify-tag
+    if: needs.verify-tag.outputs.should_deploy == 'true'
 
-  build-doc:
+  build:
     name: Build documentation
     runs-on: ubuntu-latest
-    needs: quality-check
+    needs: [verify-tag, check, test]
+    if: needs.verify-tag.outputs.should_deploy == 'true'
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -45,21 +88,20 @@ jobs:
           RUSTDOCFLAGS: -D rustdoc::broken_intra_doc_links -D missing-docs
         run: |
           cargo doc --no-deps --all-features
-          printf '<meta http-equiv="refresh" content="0;url=axdevice_base/index.html">' > target/doc/index.html
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
           path: target/doc
 
-  deploy-doc:
+  deploy:
     name: Deploy to GitHub Pages
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
-    needs: build-doc
-    if: github.ref == format('refs/heads/{0}', github.event.repository.default_branch)
+    needs: [verify-tag, build]
+    if: needs.verify-tag.outputs.should_deploy == 'true'
     steps:
       - name: Deploy to GitHub Pages
         id: deployment