python-app.yml

# FlickVault CI workflow: install dependencies, lint, and smoke-test the app.
# This workflow is tuned specifically for FlickVault's FastAPI backend.

name: FlickVault Python CI

on:
  push:
    branches: ["main"]
  pull_request:
    branches: ["main"]

permissions:
  contents: read

jobs:
  changes:
    runs-on: ubuntu-latest
    outputs:
      should_run: ${{ steps.filter.outputs.src }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: filter
        with:
          filters: |
            src:
              - 'app/**'
              - 'data/**'
              - 'static/**'
              - 'requirements.txt'
              - '.github/workflows/python-app.yml'
              - '.env.example'

  build:
    needs: changes
    if: ${{ needs.changes.outputs.should_run == 'true' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python 3.11
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install flake8 pytest
          pip install -r requirements.txt
      - name: Lint app and data packages
        run: |
          # Only enforce fatal Python errors / undefined names in this repo's current style.
          flake8 app data --count --select=E9,F63,F7,F82 --show-source --statistics
      - name: Smoke-test FastAPI app
        env:
          AUTH_DISABLED: 'true'
          DEV_USER_ID: 'ci-user'
        run: |
          python -m uvicorn app.app:app --host 127.0.0.1 --port 8000 &
          uvicorn_pid=$!
          trap "kill $uvicorn_pid" EXIT
          sleep 6
          curl -f http://127.0.0.1:8000/
          curl -f http://127.0.0.1:8000/config