268 lines
9.5 KiB
YAML
268 lines
9.5 KiB
YAML
# =============================================================================
|
|
# CI Workflow — Continuous Integration
|
|
# =============================================================================
|
|
# Triggers on push and pull_request.
|
|
#
|
|
# Detection logic:
|
|
# 1. Python: if requirements.txt exists → install deps, lint, test.
|
|
# 2. Node/JS: if package.json exists → npm ci, lint, test, build.
|
|
# 3. Neither detected → print a message and exit 0 (never fail).
|
|
#
|
|
# Controlled by .ci/config.env:
|
|
# ENABLE_CI — master switch (default: true)
|
|
# CI_STRICT — if true, lint/test failures fail the workflow
|
|
# if false, failures are warnings only
|
|
#
|
|
# See docs/CI.md for full details.
|
|
# =============================================================================
|
|
|
|
name: CI
|
|
|
|
on:
|
|
push:
|
|
pull_request:
|
|
|
|
jobs:
|
|
ci:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
# -----------------------------------------------------------------------
|
|
# Step 1: Checkout the code
|
|
# -----------------------------------------------------------------------
|
|
- name: Checkout
|
|
uses: actions/checkout@v4
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 2: Load configuration from .ci/config.env
|
|
# -----------------------------------------------------------------------
|
|
- name: Load config
|
|
id: config
|
|
run: |
|
|
# Source config.env to get ENABLE_CI, CI_STRICT, etc.
|
|
if [ -f .ci/config.env ]; then
|
|
# Export all non-comment, non-empty lines
|
|
set -a
|
|
source .ci/config.env
|
|
set +a
|
|
echo "Config loaded from .ci/config.env"
|
|
else
|
|
echo "WARNING: .ci/config.env not found, using defaults"
|
|
ENABLE_CI=true
|
|
CI_STRICT=true
|
|
fi
|
|
|
|
# Pass values to subsequent steps via environment file
|
|
echo "ENABLE_CI=${ENABLE_CI:-true}" >> "$GITHUB_ENV"
|
|
echo "CI_STRICT=${CI_STRICT:-true}" >> "$GITHUB_ENV"
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 3: Check master switch
|
|
# -----------------------------------------------------------------------
|
|
- name: Check if CI is enabled
|
|
run: |
|
|
if [ "$ENABLE_CI" != "true" ]; then
|
|
echo "CI is disabled (ENABLE_CI=$ENABLE_CI). Exiting."
|
|
exit 0
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 4: Detect project type
|
|
# -----------------------------------------------------------------------
|
|
- name: Detect project type
|
|
id: detect
|
|
run: |
|
|
HAS_PYTHON=false
|
|
HAS_NODE=false
|
|
|
|
if [ -f requirements.txt ] || [ -f setup.py ] || [ -f pyproject.toml ]; then
|
|
HAS_PYTHON=true
|
|
echo "Detected: Python project"
|
|
fi
|
|
|
|
if [ -f package.json ]; then
|
|
HAS_NODE=true
|
|
echo "Detected: Node.js project"
|
|
fi
|
|
|
|
if [ "$HAS_PYTHON" = "false" ] && [ "$HAS_NODE" = "false" ]; then
|
|
echo "No Python or Node.js project detected. CI will skip gracefully."
|
|
fi
|
|
|
|
echo "HAS_PYTHON=${HAS_PYTHON}" >> "$GITHUB_ENV"
|
|
echo "HAS_NODE=${HAS_NODE}" >> "$GITHUB_ENV"
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 5: Python — Setup & Install
|
|
# -----------------------------------------------------------------------
|
|
- name: Set up Python
|
|
if: env.HAS_PYTHON == 'true'
|
|
uses: actions/setup-python@v5
|
|
with:
|
|
python-version: "3.x"
|
|
|
|
- name: Install Python dependencies
|
|
if: env.HAS_PYTHON == 'true'
|
|
run: |
|
|
python -m pip install --upgrade pip
|
|
if [ -f requirements.txt ]; then
|
|
pip install -r requirements.txt
|
|
fi
|
|
# Install optional dev tools (won't fail if not needed)
|
|
pip install ruff black flake8 pytest 2>/dev/null || true
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 6: Python — Lint
|
|
# Runs ruff, then black --check, then flake8. Each is optional:
|
|
# only runs if the tool is installed AND relevant config exists.
|
|
# -----------------------------------------------------------------------
|
|
- name: Python lint
|
|
if: env.HAS_PYTHON == 'true'
|
|
run: |
|
|
EXIT_CODE=0
|
|
|
|
# --- ruff ---
|
|
if command -v ruff >/dev/null 2>&1; then
|
|
echo ">>> ruff check ."
|
|
ruff check . || EXIT_CODE=$?
|
|
else
|
|
echo "SKIP: ruff not installed"
|
|
fi
|
|
|
|
# --- black ---
|
|
if command -v black >/dev/null 2>&1; then
|
|
echo ">>> black --check ."
|
|
black --check . || EXIT_CODE=$?
|
|
else
|
|
echo "SKIP: black not installed"
|
|
fi
|
|
|
|
# --- flake8 ---
|
|
if command -v flake8 >/dev/null 2>&1; then
|
|
echo ">>> flake8 ."
|
|
flake8 . || EXIT_CODE=$?
|
|
else
|
|
echo "SKIP: flake8 not installed"
|
|
fi
|
|
|
|
if [ "$EXIT_CODE" -ne 0 ]; then
|
|
if [ "$CI_STRICT" = "true" ]; then
|
|
echo "ERROR: Lint failed (CI_STRICT=true)"
|
|
exit 1
|
|
else
|
|
echo "WARNING: Lint issues found (CI_STRICT=false, continuing)"
|
|
fi
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 7: Python — Test
|
|
# Runs pytest if a tests/ directory or pytest config is detected.
|
|
# -----------------------------------------------------------------------
|
|
- name: Python test
|
|
if: env.HAS_PYTHON == 'true'
|
|
run: |
|
|
# Check if tests exist
|
|
HAS_TESTS=false
|
|
if [ -d tests ] || [ -d test ]; then
|
|
HAS_TESTS=true
|
|
fi
|
|
# Check for pytest config in pyproject.toml or pytest.ini
|
|
if [ -f pytest.ini ] || [ -f setup.cfg ]; then
|
|
HAS_TESTS=true
|
|
fi
|
|
if [ -f pyproject.toml ] && grep -q '\[tool\.pytest' pyproject.toml 2>/dev/null; then
|
|
HAS_TESTS=true
|
|
fi
|
|
|
|
if [ "$HAS_TESTS" = "true" ]; then
|
|
echo ">>> pytest"
|
|
if ! pytest; then
|
|
if [ "$CI_STRICT" = "true" ]; then
|
|
echo "ERROR: Tests failed (CI_STRICT=true)"
|
|
exit 1
|
|
else
|
|
echo "WARNING: Tests failed (CI_STRICT=false, continuing)"
|
|
fi
|
|
fi
|
|
else
|
|
echo "SKIP: No tests detected (no tests/ dir or pytest config)"
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 8: Node.js — Setup & Install
|
|
# -----------------------------------------------------------------------
|
|
- name: Set up Node.js
|
|
if: env.HAS_NODE == 'true'
|
|
uses: actions/setup-node@v4
|
|
with:
|
|
node-version: "lts/*"
|
|
|
|
- name: Install Node dependencies
|
|
if: env.HAS_NODE == 'true'
|
|
run: npm ci
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 9: Node.js — Lint (only if "lint" script exists in package.json)
|
|
# -----------------------------------------------------------------------
|
|
- name: Node lint
|
|
if: env.HAS_NODE == 'true'
|
|
run: |
|
|
if grep -q '"lint"' package.json 2>/dev/null; then
|
|
echo ">>> npm run lint"
|
|
if ! npm run lint; then
|
|
if [ "$CI_STRICT" = "true" ]; then
|
|
echo "ERROR: Lint failed (CI_STRICT=true)"
|
|
exit 1
|
|
else
|
|
echo "WARNING: Lint issues found (CI_STRICT=false, continuing)"
|
|
fi
|
|
fi
|
|
else
|
|
echo "SKIP: no 'lint' script in package.json"
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 10: Node.js — Test (only if "test" script exists)
|
|
# -----------------------------------------------------------------------
|
|
- name: Node test
|
|
if: env.HAS_NODE == 'true'
|
|
run: |
|
|
if grep -q '"test"' package.json 2>/dev/null; then
|
|
echo ">>> npm test"
|
|
if ! npm test; then
|
|
if [ "$CI_STRICT" = "true" ]; then
|
|
echo "ERROR: Tests failed (CI_STRICT=true)"
|
|
exit 1
|
|
else
|
|
echo "WARNING: Tests failed (CI_STRICT=false, continuing)"
|
|
fi
|
|
fi
|
|
else
|
|
echo "SKIP: no 'test' script in package.json"
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 11: Node.js — Build (only if "build" script exists)
|
|
# -----------------------------------------------------------------------
|
|
- name: Node build
|
|
if: env.HAS_NODE == 'true'
|
|
run: |
|
|
if grep -q '"build"' package.json 2>/dev/null; then
|
|
echo ">>> npm run build"
|
|
npm run build
|
|
else
|
|
echo "SKIP: no 'build' script in package.json"
|
|
fi
|
|
|
|
# -----------------------------------------------------------------------
|
|
# Step 12: Summary
|
|
# -----------------------------------------------------------------------
|
|
- name: CI Summary
|
|
if: always()
|
|
run: |
|
|
echo "=============================="
|
|
echo " CI Complete"
|
|
echo " Python detected: $HAS_PYTHON"
|
|
echo " Node detected: $HAS_NODE"
|
|
echo " Strict mode: $CI_STRICT"
|
|
echo "=============================="
|