ci-build.yml

name: Python CI

on:
  push:
    branches:
      - main
  pull_request:
  schedule:
    - cron: "0 0 * * *"
  workflow_dispatch:

env:
  LATEST_SUPPORTED_PY: "3.15"

jobs:
  lint:
    name: Lint
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false
      - name: Set up Python ${{ env.LATEST_SUPPORTED_PY }}
        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
        with:
          python-version: ${{ env.LATEST_SUPPORTED_PY }}
      - name: Run lint verification
        run: ./scripts/lint.sh

  typecheck:
    name: Typecheck
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false
      - name: Set up Python ${{ env.LATEST_SUPPORTED_PY }}
        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
        with:
          python-version: ${{ env.LATEST_SUPPORTED_PY }}
      - name: Install synchronous dependencies
        run: |
          pip install -U pip
          pip install -U .
          pip install -r requirements/dev_tools.txt
      - name: Type check synchronous modules
        run: mypy --config-file pyproject.toml --exclude "async_|/adapter/"
      - name: Install async and adapter dependencies
        run: |
          pip install -r requirements/async_dev.txt
          pip install -r requirements/adapter_dev.txt
      - name: Type check all modules
        run: mypy --config-file pyproject.toml

  unittest:
    name: Unit tests
    runs-on: ubuntu-22.04
    timeout-minutes: 10
    strategy:
      fail-fast: false
      matrix:
        python-version:
          - "3.7"
          - "3.8"
          - "3.9"
          - "3.10"
          - "3.11"
          - "3.12"
          - "3.13"
          - "3.14"
          - "3.15"
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false
      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
        with:
          python-version: ${{ matrix.python-version }}
      - name: Install synchronous dependencies
        run: |
          pip install -U pip
          pip install .
          pip install -r requirements/test.txt
      - name: Run tests without aiohttp
        run: |
          pytest tests/slack_bolt/ --junitxml=reports/test_slack_bolt.xml
          pytest tests/scenario_tests/ --junitxml=reports/test_scenario.xml
      - name: Install adapter dependencies
        run: |
          pip install -r requirements/adapter_dev.txt
          pip install -r requirements/test_adapter.txt
      - name: Run tests for HTTP Mode adapters
        run: |
          pytest tests/adapter_tests/ \
          --ignore=tests/adapter_tests/socket_mode/ \
          --ignore=tests/adapter_tests/asgi/ \
          --junitxml=reports/test_adapter.xml
      - name: Install async dependencies
        run: |
          pip install -r requirements/async_dev.txt
      - name: Run tests for Socket Mode adapters
        run: |
          # Requires async test dependencies
          pytest tests/adapter_tests/socket_mode/ --junitxml=reports/test_adapter_socket_mode.xml
      - name: Install all dependencies
        run: |
          pip install -r requirements/test_async.txt
      - name: Run tests for HTTP Mode adapters (ASGI)
        run: |
          # Requires async test dependencies
          pytest tests/adapter_tests/asgi/ --junitxml=reports/test_adapter_asgi.xml
      - name: Run tests for HTTP Mode adapters (asyncio-based libraries)
        run: |
          pytest tests/adapter_tests_async/ --junitxml=reports/test_adapter_async.xml
      - name: Run asynchronous tests
        run: |
          pytest tests/slack_bolt_async/ --junitxml=reports/test_slack_bolt_async.xml
          pytest tests/scenario_tests_async/ --junitxml=reports/test_scenario_async.xml
      - name: Upload test results to Codecov
        if: ${{ !cancelled() }}
        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          directory: ./reports/
          fail_ci_if_error: false
          flags: ${{ matrix.python-version }}
          report_type: test_results
          token: ${{ secrets.CODECOV_TOKEN }}
          verbose: true

  codecov:
    name: Code Coverage
    runs-on: ubuntu-latest
    timeout-minutes: 10
    permissions:
      contents: read
    env:
      BOLT_PYTHON_CODECOV_RUNNING: "1"
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false
      - name: Set up Python ${{ env.LATEST_SUPPORTED_PY }}
        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
        with:
          python-version: ${{ env.LATEST_SUPPORTED_PY }}
      - name: Install dependencies
        run: |
          pip install -U pip
          pip install .
          pip install -r requirements/adapter_dev.txt
          pip install -r requirements/test_async.txt
          pip install -r requirements/test_adapter.txt
      - name: Run all tests for codecov
        run: |
          pytest --cov=./slack_bolt/ --cov-report=xml
      - name: Upload coverage to Codecov
        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          fail_ci_if_error: true
          report_type: coverage
          token: ${{ secrets.CODECOV_TOKEN }}
          verbose: true

  notifications:
    name: Regression notifications
    runs-on: ubuntu-latest
    needs:
      - lint
      - typecheck
      - unittest
    if: ${{ !success() && github.ref == 'refs/heads/main' && github.event_name != 'workflow_dispatch' }}
    steps:
      - name: Send notifications of failing tests
        uses: slackapi/slack-github-action@dcb1066f776dd043e64d0e8ba94ca15cc7e1875d # v4.0.0
        with:
          errors: true
          webhook: ${{ secrets.SLACK_REGRESSION_FAILURES_WEBHOOK_URL }}
          webhook-type: webhook-trigger
          payload: |
            action_url: "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
            repository: "${{ github.repository }}"