An action that checks code format using clang-format tool. Suitable for projects built on C, C++, C#, Objective-C.

Clang: a C language family frontend for LLVM

• It automatically checks the source file's code format, and if there is any code format violation, it exits with a nonzero status.
• Suggests commands for fixing files with formatting violations.

Sources to check by this action. It can be a single file, regex of a folder or multiple selectors separated by comma (,).

Default: "**/*". That means all files in this repository.

Example: If your repository contains many files other than C files, you can try with specific extension like:

"src/*.h,src/*.c"

or, for all nested folders

"src/**/*.h,src/**/*.c"

Sources to exclude from this action. It can be a single file, regex of a folder or multiple selectors separated by comma (,).

Default: "".

The style for clang-format. Possible values are: LLVM, GNU, Google, Chromium, Microsoft, Mozilla, WebKit. If your repository has a .clang-format file in the root directory then you can use file option here.

Default: LLVM

The version of clang-format used by this action. This can be useful when you need to verify which version ran or use it in subsequent workflow steps.

Example usage:

- uses: RafikFarhad/clang-format-github-action@v6
  id: clang-format
  with:
    sources: "src/**/*.h,src/**/*.c"

- run: echo "Formatted with clang-format version ${{ steps.clang-format.outputs.clang-format-version }}"

Create a file in .github/workflows/ folder with:

name: Clang Format Checker
on: [push]
jobs:
  clang-format-checking:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: RafikFarhad/clang-format-github-action@v6
        with:
          sources: "src/**/*.h,src/**/*.c,test/**/*.c"

It will check for code formatting violations on every push to GitHub.

The latest version of this action uses clang-format version 21. Use older versions for specific clang-format versions.

Kudos to

• @silkeh for his awesome docker image.
• @LinkTed
• @aadeg
• y-guyon

Feel free to submit a PR and/or raise an issue.

🌞 Thanks for using 🌞