ci-lint.yml

# NOTE: This name appears in GitHub's Checks API and in workflow's status badge.
name: ci-lint

# Trigger the workflow when:
on:
  # A push occurs to one of the matched branches.
  push:
    branches:
      - master
      - stable/*
  # Or when a pull request event occurs for a pull request against one of the
  # matched branches.
  pull_request:
    branches:
      - master
      - stable/*

jobs:
  lint:
    # NOTE: This name appears in GitHub's Checks API.
    name: lint
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          # Check out pull request's HEAD commit instead of the merge commit to
          # prevent gitlint from failing due to too long commit message titles,
          # e.g. "Merge 3e621938d65caaa67f8e35d145335d889d470fc8 into 19a39b2f66cd7a165082d1486b2f1eb36ec2354a".
          ref: ${{ github.event.pull_request.head.sha }}
          # Fetch all history so gitlint can check the relevant commits.
          fetch-depth: '0'
      - name: Set up Python 3
        uses: actions/setup-python@v5
        with:
          python-version: '3.x'
      - name: Set up Node.js 18
        uses: actions/setup-node@v4
        with:
          node-version: 18
      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: "1.21.x"
          cache: false
      - name: Install gitlint
        run: |
          python -m pip install gitlint
      - name: Lint git commits
        run: |
          make lint-git
        # Always run this step so that all linting errors can be seen at once.
        # Skip this step for dependabot pull requests.
        if: always() && github.actor != 'dependabot[bot]'
      - name: Lint documentation
        run: |
          make lint-docs
        # Always run this step so that all linting errors can be seen at once.
        if: always()
      - name: Lint Go code
        # NOTE: Using the official golangci-lint GitHub Action should give
        # better performance than manually installing golangci-lint and running
        # 'make lint-go'.
        uses: golangci/golangci-lint-action@v6.1.0
        with:
          version: v1.55
        # Always run this step so that all linting errors can be seen at once.
        if: always()
      - name: Ensure a clean code checkout
        uses: actions/checkout@v4
        with:
          clean: true
        if: always()
      - name: Check go mod tidy
        run: |
          make lint-go-mod-tidy
        # Always run this step so that all linting errors can be seen at once.
        if: always()