Pronto runner for clang-format, a tool to reformat C/C++/Java/JavaScript/Objective-C/Protobuf code according to configurable style guidelines. What is Pronto?

As an example, this can be used to run clang-format and submit replacements to web-based git repo managers (e.g. github, gitlab, ...) as comments using Pronto.

First, the following prerequisites need to be installed:

1. clang-format
2. Ruby
3. Pronto, this can be done after installing Ruby using:

   gem install pronto
   

After that, pronto-clang_format can be installed using:

gem install pronto-clang_format

Pronto will detect and run clang-format as soon as this runner is installed.

The runner can be configured by setting some environment variables before invoking it. The following table lists these environment variables along with a description for each one of them:

• Every replacement reported by clang-format is mapped to no more than one offence, even though the reported replacement might be fixing more than one offence (e.g. trailing whitespace in a line and improper indentation in the following line)
• Only one offence is reported per line; to avoid overwhelming one line with too many offences
• Categorizers are rudimentary, but more can be added easily to the current chain
• This runner is mostly meant to remind the developer to run clang-format on his changed files. It is not about going through the offences one by one and fixing them manually