ci.yml

name: CI

on:
  push:
    branches: [ main ]
    paths-ignore:
      - '**/*.md'
      - 'CLAUDE.md'
      - 'README.md'
      - 'LICENSE*'
      - 'docs/**'
      - '.gitignore'
  pull_request:
    branches: [ main ]
    paths-ignore:
      - '**/*.md'
      - 'CLAUDE.md'
      - 'README.md'
      - 'LICENSE*'
      - 'docs/**'
      - '.gitignore'

env:
  MIX_ENV: test

jobs:
  format:
    name: Code Formatting
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: '1.18.3'
        otp-version: '27.3'

    - name: Check formatting
      run: mix format --check-formatted

  test:
    name: Test (Elixir ${{matrix.elixir}} / OTP ${{matrix.otp}})
    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        include:
          # Latest stable versions
          - elixir: '1.18.3'
            otp: '27.3'
            coverage: true
          # Previous versions for compatibility
          - elixir: '1.17.3'
            otp: '26.2'
            coverage: false
          - elixir: '1.16.3'
            otp: '26.2'
            coverage: false
          - elixir: '1.15.8'
            otp: '26.2'
            coverage: false
          - elixir: '1.14.5'
            otp: '26.2'
            coverage: false

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: ${{ matrix.elixir }}
        otp-version: ${{ matrix.otp }}

    - name: Cache deps
      uses: actions/cache@v4
      with:
        path: |
          deps
          _build
        key: deps-${{ runner.os }}-${{ matrix.otp }}-${{ matrix.elixir }}-${{ hashFiles('**/mix.lock') }}
        restore-keys: |
          deps-${{ runner.os }}-${{ matrix.otp }}-${{ matrix.elixir }}-

    - name: Install dependencies
      run: mix deps.get

    - name: Compile dependencies
      run: mix deps.compile

    - name: Compile project
      run: mix compile

    - name: Run tests with coverage
      if: ${{ matrix.coverage }}
      run: mix coveralls.json

    - name: Upload coverage to Codecov
      if: ${{ matrix.coverage }}
      uses: codecov/codecov-action@v4
      with:
        file: ./cover/excoveralls.json
        fail_ci_if_error: false
        token: ${{ secrets.CODECOV_TOKEN }}

    - name: Run tests
      if: ${{ !matrix.coverage }}
      run: mix test

  credo:
    name: Static Code Analysis (Credo)
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: '1.18.3'
        otp-version: '27.3'

    - name: Cache deps
      uses: actions/cache@v4
      with:
        path: |
          deps
          _build
        key: deps-${{ runner.os }}-27.3-1.18.3-${{ hashFiles('**/mix.lock') }}
        restore-keys: |
          deps-${{ runner.os }}-27.3-1.18.3-

    - name: Install dependencies
      run: mix deps.get

    - name: Compile dependencies
      run: mix deps.compile

    - name: Compile project
      run: mix compile

    - name: Run Credo
      run: mix credo --strict

  dialyzer:
    name: Static Type Analysis (Dialyzer)
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: '1.18.3'
        otp-version: '27.3'

    - name: Cache deps
      uses: actions/cache@v4
      with:
        path: |
          deps
          _build
        key: deps-${{ runner.os }}-27.3-1.18.3-${{ hashFiles('**/mix.lock') }}
        restore-keys: |
          deps-${{ runner.os }}-27.3-1.18.3-

    - name: Cache Dialyzer PLTs
      uses: actions/cache@v4
      with:
        path: priv/plts
        key: dialyzer-${{ runner.os }}-27.3-1.18.3-${{ hashFiles('**/mix.lock') }}
        restore-keys: |
          dialyzer-${{ runner.os }}-27.3-1.18.3-

    - name: Install dependencies
      run: mix deps.get

    - name: Compile dependencies
      run: mix deps.compile

    - name: Compile project
      run: mix compile

    - name: Run Dialyzer
      run: mix dialyzer

  regression-tests:
    name: Regression Test Suite
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: '1.18.3'
        otp-version: '27.3'

    - name: Cache deps
      uses: actions/cache@v4
      with:
        path: |
          deps
          _build
        key: deps-${{ runner.os }}-27.3-1.18.3-${{ hashFiles('**/mix.lock') }}
        restore-keys: |
          deps-${{ runner.os }}-27.3-1.18.3-

    - name: Install dependencies
      run: mix deps.get

    - name: Compile project
      run: mix compile

    - name: Run regression tests
      run: mix test.regression

  example-tests:
    name: Examples Test Suite
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: examples

    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Elixir
      uses: erlef/setup-beam@v1
      with:
        elixir-version: '1.18.3'
        otp-version: '27.3'

    - name: Cache deps
      uses: actions/cache@v4
      with:
        path: |
          examples/deps
          examples/_build
        key: example-deps-${{ runner.os }}-27.3-1.18.3-${{ hashFiles('examples/**/mix.lock') }}
        restore-keys: |
          example-deps-${{ runner.os }}-27.3-1.18.3-

    - name: Install dependencies
      run: mix deps.get

    - name: Compile project
      run: mix compile

    - name: Run tests
      run: mix test