CI workflow (FalkorDB/GraphRAG-SDK)

name: CI
 
on:
  push:
    branches: [main, staging]
  pull_request:
    branches: [main, staging]
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  lint:
    timeout-minutes: 30
    name: Lint
    runs-on: latchkey-small
    defaults:
      run:
        working-directory: graphrag_sdk
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v6
        with:
          cache: 'pip'
          python-version: "3.12"
      - run: pip install ruff
      - name: Ruff check (src)
        run: ruff check src/
      - name: Ruff format check (src)
        run: ruff format --check src/
 
  test:
    timeout-minutes: 30
    runs-on: latchkey-small
    strategy:
      matrix:
        python-version: ["3.10", "3.11", "3.12"]
    defaults:
      run:
        working-directory: graphrag_sdk
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v6
        with:
          cache: 'pip'
          python-version: ${{ matrix.python-version }}
      - run: pip install -e ".[dev]"
      - name: Run tests
        run: python -m pytest tests/ -q
      - name: Run tests with coverage (3.12 only)
        if: matrix.python-version == '3.12'
        run: python -m pytest tests/ --cov=src/graphrag_sdk --cov-report=term-missing -q
 
  integration:
    timeout-minutes: 30
    name: Integration (real FalkorDB)
    runs-on: latchkey-small
    services:
      falkordb:
        image: falkordb/falkordb:v4.18.0
        ports:
          - 6379:6379
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 5s
          --health-timeout 3s
          --health-retries 10
    defaults:
      run:
        working-directory: graphrag_sdk
    env:
      RUN_INTEGRATION: "1"
      FALKOR_HOST: localhost
      FALKOR_PORT: "6379"
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-python@v6
        with:
          cache: 'pip'
          python-version: "3.12"
      - run: pip install -e ".[dev]"
      - name: Wait for FalkorDB
        # The service container is healthchecked above, but give the
        # graph layer an extra moment to be reachable from Python.
        # The loop MUST fail the step if readiness never arrives -
        # otherwise pytest runs against a dead service and surfaces
        # a much less obvious error.
        run: |
          for _ in $(seq 1 20); do
            if python -c "import redis; redis.Redis(host='localhost', port=6379).ping()"; then
              exit 0
            fi
            sleep 1
          done
          echo "FalkorDB did not become reachable within 20 attempts" >&2
          exit 1
      - name: Run real-FalkorDB integration tests
        run: >
          python -m pytest -v
          -m integration
          tests/test_integration.py