alineat amb AEEA: cmake, makefile, clang-* i hooks

This commit is contained in:
2026-05-19 08:48:25 +02:00
parent 79d6e71fff
commit 851e6d35a2
11 changed files with 612 additions and 1423 deletions
+79 -76
View File
@@ -1,104 +1,107 @@
Checks:
# Estrategia: Habilitar checks uno por uno, aplicar fix, compilar, commit
# ✅ Check 1: readability-uppercase-literal-suffix (1.0f → 1.0F)
# ✅ Check 2: readability-math-missing-parentheses (claridad en ops matemáticas)
# ✅ Check 3: readability-identifier-naming (DESHABILITADO temporalmente - cascada de cambios)
# ✅ Check 4: readability-const-return-type (código ya cumple)
# ✅ Check 5: readability-else-after-return (código ya cumple)
# ✅ Check 6: readability-simplify-boolean-expr (código ya cumple)
# ✅ Check 7: readability-* (225 fixes aplicados)
- readability-*
- -readability-identifier-naming # Excluido (cascada de cambios)
- -readability-identifier-length # Excluido (nombres cortos son OK)
- -readability-magic-numbers # Excluido (muchos falsos positivos)
- -readability-convert-member-functions-to-static # Excluido (rompe encapsulación)
- -readability-use-anyofallof # Excluido (C++20 ranges - no todos los compiladores)
- -readability-function-cognitive-complexity # Excluido (complejidad ciclomática aceptable)
- -clang-analyzer-security.insecureAPI.rand # Excluido (rand() es suficiente para juegos)
# ✅ Check 8: modernize-* (215 fixes aplicados)
- modernize-*
- -modernize-use-trailing-return-type # Excluido (estilo controversial)
- -modernize-avoid-c-arrays # Excluido (arrays C son OK en algunos contextos)
# ✅ Check 9: performance-* (91 fixes aplicados)
- performance-*
- -performance-enum-size # Excluido (tamaño de enum no crítico)
# ✅ Check 10: bugprone-* (0 fixes - todos eran falsos positivos)
- bugprone-*
- -bugprone-easily-swappable-parameters # Excluido (muchos falsos positivos)
- -bugprone-narrowing-conversions # Excluido (conversiones intencionales)
- -bugprone-integer-division # Excluido (divisiones enteras OK en contexto)
- -bugprone-branch-clone # Excluido (fall-through en switch es intencional)
- -bugprone-switch-missing-default-case # Excluido (no todos los switches necesitan default)
- -bugprone-implicit-widening-of-multiplication-result # Excluido (valores pequeños, sin overflow)
- -bugprone-exception-escape # Excluido (excepciones en main terminan el programa - OK)
# ✅ Check 11: llvm-include-order (validar orden de includes - 0 errores)
- llvm-include-order
# ⏸️ Check 12: misc-include-cleaner (DESHABILITADO temporalmente - requiere refactorización masiva de includes)
- -misc-include-cleaner
- -readability-identifier-length
- -readability-magic-numbers
- -bugprone-integer-division
- -bugprone-easily-swappable-parameters
- -bugprone-narrowing-conversions
- -modernize-avoid-c-arrays
WarningsAsErrors: '*'
# No usar HeaderFilterRegex - usamos .clang-tidy local en source/core/audio/ para excluir
# Headers nostres (excloem source/external/ que conté dependències de tercers no editables)
HeaderFilterRegex: 'source/(core|game|utils)/'
FormatStyle: file
CheckOptions:
# Variables locales en snake_case
- { key: readability-identifier-naming.VariableCase, value: lower_case }
# bugprone-empty-catch: aceptar catches vacíos marcados con @INTENTIONAL en un comentario
- { key: bugprone-empty-catch.IgnoreCatchWithKeywords, value: '@INTENTIONAL' }
# Miembros privados en snake_case con sufijo _
# =====================================================================
# CONSTANTES → UPPER_CASE (compile-time y runtime, en cualquier scope)
# =====================================================================
# Todo lo que sea const o constexpr se identifica visualmente en UPPER_CASE,
# sin importar si es global, local, miembro o static.
# constexpr en cualquier scope (globales y locales)
- { key: readability-identifier-naming.ConstexprVariableCase, value: UPPER_CASE }
# Constantes globales (const no-constexpr)
- { key: readability-identifier-naming.GlobalConstantCase, value: UPPER_CASE }
# Constantes locales (const en función)
- { key: readability-identifier-naming.LocalConstantCase, value: UPPER_CASE }
# Static const a nivel de archivo/namespace
- { key: readability-identifier-naming.StaticConstantCase, value: UPPER_CASE }
# Miembros static const/constexpr de clase (p.ej. static constexpr int MAX = 100;)
- { key: readability-identifier-naming.ClassConstantCase, value: UPPER_CASE }
# Miembros const no-static de clase (p.ej. const int limit;)
- { key: readability-identifier-naming.ConstantMemberCase, value: UPPER_CASE }
# Valores de enums
- { key: readability-identifier-naming.EnumConstantCase, value: UPPER_CASE }
# NOTA: Los parámetros const NO se tratan como constantes aquí.
# Un parámetro sigue siendo un parámetro aunque sea const → hereda ParameterCase.
# =====================================================================
# VARIABLES NO-CONST
# =====================================================================
# Variables locales
- { key: readability-identifier-naming.VariableCase, value: lower_case }
- { key: readability-identifier-naming.LocalVariableCase, value: lower_case }
# Parámetros de función
- { key: readability-identifier-naming.ParameterCase, value: lower_case }
# Variables estáticas no-const (static locales, static file-scope,
# y static members no-const de clase como el instance_ de un Singleton).
# Sufijo _ para marcar que tienen storage estático.
- { key: readability-identifier-naming.StaticVariableCase, value: lower_case }
- { key: readability-identifier-naming.StaticVariableSuffix, value: _ }
# =====================================================================
# MIEMBROS DE CLASE NO-CONST
# =====================================================================
# Privados: snake_case con sufijo _
- { key: readability-identifier-naming.PrivateMemberCase, value: lower_case }
- { key: readability-identifier-naming.PrivateMemberSuffix, value: _ }
# Miembros protegidos en snake_case con sufijo _
# Protegidos: snake_case con sufijo _
- { key: readability-identifier-naming.ProtectedMemberCase, value: lower_case }
- { key: readability-identifier-naming.ProtectedMemberSuffix, value: _ }
# Miembros públicos en snake_case (sin sufijo)
# Públicos: snake_case sin sufijo
- { key: readability-identifier-naming.PublicMemberCase, value: lower_case }
# Namespaces en CamelCase
- { key: readability-identifier-naming.NamespaceCase, value: CamelCase }
# Variables estáticas privadas como miembros privados
- { key: readability-identifier-naming.StaticVariableCase, value: lower_case }
- { key: readability-identifier-naming.StaticVariableSuffix, value: _ }
# Constantes estáticas sin sufijo
- { key: readability-identifier-naming.StaticConstantCase, value: UPPER_CASE }
# Constantes globales en UPPER_CASE
- { key: readability-identifier-naming.GlobalConstantCase, value: UPPER_CASE }
# Variables constexpr globales en UPPER_CASE
- { key: readability-identifier-naming.ConstexprVariableCase, value: UPPER_CASE }
# Constantes locales en UPPER_CASE
- { key: readability-identifier-naming.LocalConstantCase, value: UPPER_CASE }
# Constexpr miembros en UPPER_CASE (sin sufijo)
- { key: readability-identifier-naming.ConstexprMemberCase, value: UPPER_CASE }
# Constexpr miembros privados/protegidos con sufijo _
- { key: readability-identifier-naming.ConstexprMethodCase, value: UPPER_CASE }
# Clases, structs y enums en CamelCase
# =====================================================================
# TIPOS
# =====================================================================
- { key: readability-identifier-naming.ClassCase, value: CamelCase }
- { key: readability-identifier-naming.StructCase, value: CamelCase }
- { key: readability-identifier-naming.EnumCase, value: CamelCase }
- { key: readability-identifier-naming.UnionCase, value: CamelCase }
- { key: readability-identifier-naming.TypeAliasCase, value: CamelCase }
- { key: readability-identifier-naming.TypedefCase, value: CamelCase }
- { key: readability-identifier-naming.TemplateParameterCase, value: CamelCase }
# Valores de enums en UPPER_CASE
- { key: readability-identifier-naming.EnumConstantCase, value: UPPER_CASE }
# Namespaces
- { key: readability-identifier-naming.NamespaceCase, value: CamelCase }
# Métodos en camelBack (sin sufijos)
# =====================================================================
# FUNCIONES Y MÉTODOS (incluyendo constexpr)
# =====================================================================
# Un método/función constexpr es un invocable, no una constante → camelBack.
- { key: readability-identifier-naming.FunctionCase, value: camelBack }
- { key: readability-identifier-naming.ConstexprFunctionCase, value: camelBack }
- { key: readability-identifier-naming.MethodCase, value: camelBack }
- { key: readability-identifier-naming.PrivateMethodCase, value: camelBack }
- { key: readability-identifier-naming.ProtectedMethodCase, value: camelBack }
- { key: readability-identifier-naming.PublicMethodCase, value: camelBack }
# Funciones en camelBack
- { key: readability-identifier-naming.FunctionCase, value: camelBack }
# Parámetros en lower_case
- { key: readability-identifier-naming.ParameterCase, value: lower_case }
# misc-include-cleaner: Ignorar SDL (genera falsos positivos)
- { key: misc-include-cleaner.IgnoreHeaders, value: 'SDL3/.*' }
- { key: readability-identifier-naming.ConstexprMethodCase, value: camelBack }