---
id: lintrunner-adapters
version: "0.14.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# lintrunner-adapters — Adapters and tools for lintrunner

License: permissive · Maintenance: active · Downloads: 1.1M/mo

## What it is and what it does

lintrunner-adapters is a bridge layer that integrates popular linters and formatters from Python, Rust, and C++ ecosystems into lintrunner, a unified linting orchestration tool. It provides CLI commands to run individual adapters and convert lintrunner JSON output to SARIF format for GitHub code scanning. The package depends only on click for its command-line interface, keeping installation lightweight. It's designed to be used within a lintrunner project configuration (via .lintrunner.toml) to standardize how different linting tools are invoked and their results are reported.

The package is actively maintained and positioned as a growing collection of adapters; users can contribute new linter integrations by following the adapter pattern. It supports auto-fix capabilities for tools like ruff and integrates with GitHub Actions workflows for CI/CD pipelines, allowing linting results to appear as code scanning alerts in pull requests.

Use it for:

- Standardize linting across a polyglot codebase by running Python, Rust, and C++ linters through a single configuration file.
- Integrate linting into CI/CD pipelines and display results as GitHub code scanning annotations without manual result parsing.
- Convert lintrunner output to SARIF format for consumption by other analysis or reporting tools.
- Manage auto-fix workflows for tools like ruff within a unified linting orchestration system.
- Reduce boilerplate by reusing pre-built adapters for common linters instead of writing custom integration code.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides adapter integrations for lintrunner, enabling unified execution of popular Python, Rust, and C++ linters and formatters (flake8, pylint, mypy, black, ruff, rustfmt, clippy, clang-format, and others) through a single CLI interface.

Yes, if you are already using lintrunner or planning to adopt it for multi-language linting. The package is actively maintained, has low install friction, carries a permissive MIT license, and addresses a real need for unified linter orchestration. Install it as part of your lintrunner setup; it is not useful standalone.

## Install

pip install lintrunner-adapters
uv add lintrunner-adapters
poetry add lintrunner-adapters

## Installing lintrunner-adapters

Before you install: Low install friction with a single runtime dependency (click). Actively maintained with a recent release (32 days ago) and ongoing repository activity.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install lintrunner-adapters
python -m lintrunner_adapters run

Requires Python 3.9 or later; lintrunner itself must be installed and configured separately via .lintrunner.toml.

Verify before relying:

- Whether all listed linters (flake8, pylint, mypy, black, ruff, rustfmt, clippy, clang-format) are fully supported or if some are partial/experimental.
- Performance characteristics when running multiple linters in sequence or parallel.
- Compatibility with specific versions of underlying linters and formatters.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

lintrunner adapters, multi-language linter integration, unified lint runner, linter cli wrapper, python rust c++ linting, lintrunner plugins, sarif output conversion, linting-orchestration, polyglot-ci, code-scanning

[View on SkillFed](https://skillfed.io/packages/lintrunner-adapters) · [View on PyPI](https://pypi.org/project/lintrunner-adapters/)