# core/adapters/tool.clang-tidy.adapter.ts

> 28 lines of code and 10 definitions.

Tree: GovLab Quality
Language: typescript
Layer: infrastructure
Canonical: https://banes-lab.com/anatomy/quality#file-quality-core-adapters-tool-clang-tidy-adapter-ts
Source text: https://banes-lab.com/source/quality/core/adapters/tool.clang-tidy.adapter.ts.txt

Listed in [core/adapters](https://banes-lab.com/api/source/quality/core/adapters.md), after [core/adapters/tool.checkstyle.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.checkstyle.adapter.ts.md) and before [core/adapters/tool.clippy.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.clippy.adapter.ts.md).

## Definitions

- `runClangTidy` (lexical_declaration, line 16)
- `TOOL` (lexical_declaration, line 12)
- `DEFAULT_CHECKS` (lexical_declaration, line 13)
- `DEFAULT_COMPILER_ARGS` (lexical_declaration, line 14)
- `section` (lexical_declaration, line 17)
- `checks` (lexical_declaration, line 18)
- `compilerArgs` (lexical_declaration, line 19)
- `advisory` (lexical_declaration, line 20)
- `spec` (lexical_declaration, line 24)
- `args` (lexical_declaration, line 27)

## Contained in

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)

## Uses

- [core/adapters/tool.adapter.ts](https://banes-lab.com/source/quality/core/adapters/tool.adapter.ts.md)

## Linked from

- [core/adapters](https://banes-lab.com/anatomy/quality/folder-quality-core-adapters.md)

## Source

```typescript
import type { AdvisoryContext, RunnerContext } from "#types/tool.types";
import { installHint, notInstalledOutput } from "#configuration/strings/tool.strings";
import { scanTool, standardScan } from "#core/adapters/tool.adapter";
import { stringArrayFieldOr, stringField } from "#core/selectors/record.selector";
import type { RunResult } from "#types/finding.types";
import { SUCCESS_STATUSES } from "#configuration/constants/tool.constants";
import { defineTool } from "#core/registries/tool.registry";
import { parseClangTidyOutput } from "#core/parsers/tool.clang-tidy.parser";
import { toolAdvisory } from "#core/factories/tool.factory";
import { toolSection } from "#core/resolvers/tool.resolver";

const TOOL = "clang-tidy";
const DEFAULT_CHECKS = "clang-analyzer-*,bugprone-*,modernize-*,performance-*";
const DEFAULT_COMPILER_ARGS = ["-std=c++17"];

const runClangTidy = async function runClangTidy(context: RunnerContext): Promise<RunResult> {
    const section = await toolSection(context.root, TOOL);
    const checks = stringField(section, "checks", DEFAULT_CHECKS);
    const compilerArgs = stringArrayFieldOr(section, "compilerArgs", DEFAULT_COMPILER_ARGS);
    const advisory: AdvisoryContext = {
        ...toolAdvisory(context, TOOL, installHint(TOOL)),
        notInstalledOutput: notInstalledOutput(TOOL),
    };
    const spec = standardScan(advisory, SUCCESS_STATUSES, (result) =>
        parseClangTidyOutput(result.stdout, context.ecosystem),
    );
    const args = [`--checks=${checks}`, "--quiet", ...context.paths, "--", ...compilerArgs];
    return scanTool(advisory, { args, bin: TOOL, cwd: context.root }, spec);
};

defineTool({ ecosystems: ["cpp"], run: runClangTidy, tool: TOOL });
```
