Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
align-left

GitHub Action

clang-format lint

v0.6 Pre-release

clang-format lint

align-left

clang-format lint

Github Action that check if code is formatted correctly using clang-format

Installation

Copy and paste the following snippet into your .yml file.

              

- name: clang-format lint

uses: DoozyX/[email protected]

Learn more about this action in DoozyX/clang-format-lint-action

Choose a version

clang-format lint action

This action checks if the source code matches the .clang-format file.

Inputs

source

Where the source files are located.
Default: '.' (current folder)
Example: './src'

exclude

What folder should be excluded from format checking.
Default: 'none'
Example: './third_party'

Multiple exclude rules can be put in a .clang-format-ignore file, which also supports comments.
Example:

# ignore third_party code from clang-format checks
src/third_party/*
src/ignored/*

extensions

What filename extensions should be used for format checking.
Default: 'c,h,C,H,cpp,hpp,cc,hh,c++,h++,cxx,hxx'
Example: 'cpp,h'

clangFormatVersion

What clang-format version should be used.
Available version are from 5 to 9.
Default: 9
Example: 9

style

Style to use.
Results in the appropriate --style parameter.
Default: file
Example: chromium

Example usage

name: test-clang-format

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - uses: DoozyX/[email protected]
      with:
        source: '.'
        exclude: './third_party ./external'
        extensions: 'h,cpp'
        clangFormatVersion: 9
        style: chromium