Skip to main content

cpp-linter

PyPI ci coverage part of cpp-linter

The Python command behind cpp-linter-action: it runs clang-format and clang-tidy on C and C++ files, locally or in other CI.

Website · Documentation · Get started · Discussions

Quick start

With the clang tools installed (see Limitations):

pip install "cpp-linter<2"
cpp-linter --version=21 --style=file --tidy-checks=''

Usage

For usage in a GitHub Actions workflow, see the cpp-linter/cpp-linter-action repository

For the description of supported Command Line Interface options, see the CLI documentation

Applying fixes

Passing the --fix option makes cpp-linter apply clang-format fixes in-place to any files that have formatting problems.

Limitations

  • cpp-linter does not install the clang tools. Install them first, for example with clang-tools; without them, --version=21 falls back to whatever clang-format and clang-tidy are on your PATH.

  • It exits 0 even when checks fail, so it reports findings but does not fail a build.

  • --files-changed-only and --lines-changed-only read the local git diff, except in GitHub Actions (and Gitea Actions), where those options ask the server’s REST API for the changed files.

Sponsors

cpp-linter is maintained by two volunteers. Sponsor the project through GitHub Sponsors or Open Collective. Silver and Gold sponsors get their logo here.

Contributing

To provide feedback (requesting a feature or reporting a bug) please post to issues. To contribute changes, see CONTRIBUTING.rst.

License

The scripts and documentation in this project are released under the MIT License.

Metadata

Release files for cpp-linter 1.16.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cpp-linter 1.16.1
File Size Uploaded Provenance Actions
cpp_linter-1.16.1.tar.gz 2.6 MB With provenance Details for cpp_linter-1.16.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cpp-linter 1.16.1
File Interpreter ABI Platform Actions
cpp_linter-1.16.1-py3-none-any.whl Python 3 none any Details for cpp_linter-1.16.1-py3-none-any.whl

Total release size: 2.6 MB

Release files / cpp_linter-1.16.1.tar.gz

Download URL cpp_linter-1.16.1.tar.gz
Size 2.6 MB
Tags Source
SHA-256 checksum
How to use checksums
85d62ff1d579a2d11f7cbfa573cfd175430ad59ba644001fca30b2478456db98
BLAKE2b-256 checksum
How to use checksums
8b74e4ba9753af03d5fde78d70f39b004ef0478a5df67389c2843989ea251836
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / cpp_linter-1.16.1-py3-none-any.whl

Download URL cpp_linter-1.16.1-py3-none-any.whl
Size 40.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f81280250eb0bd8e5b934e999ac00f9fac965b78b6bf10506bf62265bcfda744
BLAKE2b-256 checksum
How to use checksums
8a796386ebd49b260cfbd39f1ddafafe473fbc4466debfd763404964afef5ac4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for cpp-linter 1.16.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cpp_linter-1.16.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.16.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page