.clang-tidy

# clang-tidy config for WhiteoutLib.
#
# Tuned for a low-level binary-format parsing library: bug detection and
# clang-analyzer's data-flow checks are on; style-pedantic and noisy
# "modernize-everything" checks are off.
#
# Usage:
#   - Per-build: configure with -DWHITEOUT_ENABLE_CLANG_TIDY=ON.
#   - Standalone: clang-tidy -p build/clang src/whiteout/...
#   - All sources: run-clang-tidy -p build/clang -header-filter='(include|src)/whiteout/'
---
Checks: >
  -*,
  bugprone-*,
  cert-*,
  clang-analyzer-*,
  concurrency-*,
  cppcoreguidelines-*,
  misc-*,
  modernize-*,
  performance-*,
  portability-*,
  readability-*,
  -bugprone-easily-swappable-parameters,
  -bugprone-implicit-widening-of-multiplication-result,
  -bugprone-narrowing-conversions,
  -bugprone-suspicious-include,
  -cert-dcl21-cpp,
  -cert-err58-cpp,
  -cppcoreguidelines-avoid-c-arrays,
  -cppcoreguidelines-avoid-do-while,
  -cppcoreguidelines-avoid-magic-numbers,
  -cppcoreguidelines-avoid-non-const-global-variables,
  -cppcoreguidelines-init-variables,
  -cppcoreguidelines-macro-usage,
  -cppcoreguidelines-narrowing-conversions,
  -cppcoreguidelines-non-private-member-variables-in-classes,
  -cppcoreguidelines-owning-memory,
  -cppcoreguidelines-pro-bounds-array-to-pointer-decay,
  -cppcoreguidelines-pro-bounds-constant-array-index,
  -cppcoreguidelines-pro-bounds-pointer-arithmetic,
  -cppcoreguidelines-pro-type-cstyle-cast,
  -cppcoreguidelines-pro-type-reinterpret-cast,
  -cppcoreguidelines-pro-type-union-access,
  -cppcoreguidelines-pro-type-vararg,
  -cppcoreguidelines-special-member-functions,
  -misc-include-cleaner,
  -misc-no-recursion,
  -misc-non-private-member-variables-in-classes,
  -misc-use-anonymous-namespace,
  -modernize-avoid-c-arrays,
  -modernize-pass-by-value,
  -modernize-use-nodiscard,
  -modernize-use-trailing-return-type,
  -portability-avoid-pragma-once,
  -readability-avoid-nested-conditional-operator,
  -readability-braces-around-statements,
  -readability-else-after-return,
  -readability-function-cognitive-complexity,
  -readability-function-size,
  -readability-identifier-length,
  -readability-implicit-bool-conversion,
  -readability-magic-numbers,
  -readability-math-missing-parentheses,
  -readability-named-parameter,
  -readability-uppercase-literal-suffix

# Only diagnose headers under our own tree — keeps external deps quiet.
HeaderFilterRegex: '(include|src)[/\\]whiteout[/\\]'

# Don't fail the build on warnings yet; treat clang-tidy as advisory until
# the codebase is clean. Flip this list as checks get cleaned up.
WarningsAsErrors: ''

# Defer to .clang-format for whitespace fixes.
FormatStyle: file