docs: update .github/workflows/ci.yml via Apex Optimizer

Author: chirag127

.github/workflows/ci.yml

@@ -1,62 +1,65 @@
-name: CI Pipeline
+# .github/workflows/ci.yml
+# Apex Technical Authority Standard CI/CD Pipeline (Python/uv/Ruff/Pytest)
+
+name: CI | Build, Test, and Lint
 
-# Trigger the workflow on push events to the main branch and pull requests targeting the main branch.
 on:
   push:
-    branches: [ main ]
+    branches: ["main"]
   pull_request:
-    branches: [ main ]
+    branches: ["main"]
+  workflow_dispatch:
 
-# Define environment variables for the workflow
-env:
-  PYTHON_VERSION: '3.10'
-  REPO_NAME: 'Academic-Python-Lab-Solutions-Toolkit'
-  OWNER_NAME: 'chirag127'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
 
 jobs:
   build-and-test:
-    name: Build and Test
-    runs-on: ubuntu-latest # Use the latest Ubuntu runner
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.10", "3.11", "3.12"]
 
     steps:
-      # Step 1: Checkout the repository code
-      - name: Checkout repository
+      - name: 1. | Check out repository
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0 # Fetch all history for accurate blame/coverage analysis
 
-      # Step 2: Set up Python environment
-      - name: Set up Python ${{ env.PYTHON_VERSION }}
+      - name: 2. | Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ env.PYTHON_VERSION }}
-          cache: 'uv'
+          python-version: ${{ matrix.python-version }}
 
-      # Step 3: Install dependencies using uv
-      - name: Install dependencies with uv
-        run: |
-          python -m uv pip install --system --upgrade pip
-          python -m uv pip install --system --all-extras # Installs all extras, including dev dependencies
+      - name: 3. | Install uv (Ultra-Fast Python Package Manager)
+        uses: astral-sh/install-uv-action@v1
 
-      # Step 4: Lint and format code with Ruff
-      - name: Lint and format with Ruff
+      - name: 4. | Install project dependencies via uv
         run: |
-          python -m uv exec ruff format --check .
-          python -m uv exec ruff check .
+          # Create a virtual environment
+          uv venv
+          # Install main and dev dependencies
+          if [ -f requirements-dev.txt ]; then
+            uv pip install -r requirements.txt -r requirements-dev.txt
+          else
+            uv pip install -r requirements.txt
+          fi
+        shell: bash
 
-      # Step 5: Run tests with Pytest
-      - name: Run tests with Pytest
-        run: |
-          python -m uv exec pytest --cov=${{ env.REPO_NAME }} --cov-report=xml
-        # The --cov=${{ env.REPO_NAME }} flag enables coverage collection for the package itself.
-        # The --cov-report=xml generates a coverage report in XML format, suitable for Codecov.
+      - name: 5. | Lint with Ruff
+        run: uv run ruff check .
+
+      - name: 6. | Check formatting with Ruff
+        run: uv run ruff format --check .
+
+      - name: 7. | Run tests and generate coverage report
+        run: uv run pytest --cov=./ --cov-report=xml
 
-      # Step 6: Upload coverage report to Codecov
-      # This step assumes you have a CODECOV_TOKEN set in your GitHub repository secrets.
-      - name: Upload coverage to Codecov
+      - name: 8. | Upload coverage to Codecov
         uses: codecov/codecov-action@v4
-        if: github.ref == 'refs/heads/main' || github.ref == 'refs/pull/${{ github.event.number }}/merge'
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
-          # This token is required for uploading coverage reports to Codecov.
-          # It should be configured as a secret in your GitHub repository settings.
+          fail_ci_if_error: true
+          verbose: true