Function create_checkers

ci/lint_cpp/run_all_checkers.py:169–340

Create all checker instances organized by which files they should check. Args: all_headers: Optional frozenset of all header file paths in the project (used for cross-file validation in some checkers)

(
    all_headers: frozenset[str] | None = None,
)

def create_checkers(
    all_headers: frozenset[str] | None = None,
) -> dict[str, list[FileContentChecker]]:
    """Create all checker instances organized by which files they should check.

    Args:
        all_headers: Optional frozenset of all header file paths in the project
                    (used for cross-file validation in some checkers)
    """
    checkers_by_scope: dict[str, list[FileContentChecker]] = {}

    # Global checkers (run on all src/, examples/, tests/ files)
    checkers_by_scope["global"] = [
        CppIncludeChecker(),
        CppHppIncludesChecker(),
        ImplHppIncludesChecker(),
        IncludeAfterNamespaceChecker(),
        MemberStyleChecker(),
        NumericLimitMacroChecker(),
        StaticInHeaderChecker(),
        LoggingInIramChecker(),
        PlatformIncludesChecker(),
        PlatformTrampolineChecker(),  # Enforce trampoline architecture in src/fl/** and root src/
        WeakAttributeChecker(),
        AttributeChecker(),  # Checks all C++ standard attributes (replaces MaybeUnusedChecker)
        AsmJsLocationChecker(),  # Checks EM_JS / EM_ASYNC_JS / EM_ASM live only in *.js.cpp.hpp
        BannedMacrosChecker(),  # Checks for banned preprocessor macros like __has_include
        BuiltinMemcpyChecker(),  # Checks for raw __builtin_memcpy — use FL_BUILTIN_MEMCPY
        EspRomPrintfChecker(),  # Checks for raw esp_rom_printf — use FastLED logging
        FlIsDefinedChecker(),
        BannedNamespaceChecker(),  # Checks for banned namespace patterns like fl::fl
        SingletonInHeadersChecker(),  # Checks for Singleton<T> in headers (must use SingletonShared<T>)
        SpanFromPointerChecker(),  # Checks for span<T>(container.data(), container.size()) → span<T>(container)
        BareAllocationChecker(),  # Checks for bare new/delete/malloc/free — use fl::unique_ptr/fl::shared_ptr
        BareSnprintfChecker(),  # Bans bare C ::snprintf/::printf/::sprintf in src/ — use fl::snprintf (#2773 item 1.5)
        BareLibmChecker(),  # Bans bare C libm calls (::sqrtf, ::atan2, ::powf, ::ldexpf, ...) — use fl::sqrt/fl::atan2/... (#3002, #3012)
        BareNoInlineChecker(),  # Bans bare __attribute__((noinline)) in src/ — use FL_NO_INLINE (#2773 item 2.1 follow-up)
        SleepForChecker(),  # Checks for sleep_for() — bypasses async runner, use fl::yield/fl::async_run
        ThreadLocalKeywordChecker(),  # Checks for thread_local keyword — use fl::SingletonThreadLocal<T>::instance()
        BannedDefineChecker(),  # Checks for wrong #if patterns (e.g., #if ESP32 → #ifdef ESP32)
        PlatformPragmaChecker(),  # Checks for raw #pragma GCC/clang/warning — use FL_DISABLE_WARNING macros
        RawPragmaChecker(),  # Checks for raw _Pragma() — use FL_DISABLE_WARNING macros
        RawNoexceptChecker(),  # Checks for raw noexcept keyword — use FL_NOEXCEPT macro
        # Note: Private libc++ headers checking is now integrated into BannedHeadersChecker
        # Note: _build.hpp hierarchy checking is now integrated into test_unity_build.py
    ]

    # Src-only checkers
    checkers_by_scope["src"] = [
        ArduinoMacroUsageChecker(),  # Checks for banned Arduino macros (INPUT, OUTPUT, DEFAULT)
        UsingNamespaceFlChecker(),
        StdNamespaceChecker(),
        NamespaceIncludesChecker(),
        ReinterpretCastChecker(),
        RelativeIncludeChecker(),
        FastLEDHeaderUsageChecker(),
        StdintTypeChecker(),  # Covers all src/ (excludes third_party/ internally)
        CtypeGlobalChecker(),  # Checks for global-scope ctype functions (use fl:: variants)