Écosystème et outils¶

# Application du format
clang-format -i src/*.cpp src/*.hpp  # -i : modification en place

# Verification sans modification (utile en CI)
clang-format --dry-run --Werror src/*.cpp
# Retourne code 1 si des modifications seraient necessaires

# Integration CMake — cible custom
# cmake --build build --target format
find_program(CLANG_FORMAT clang-format)
if(CLANG_FORMAT)
    file(GLOB_RECURSE SOURCES src/*.cpp src/*.hpp tests/*.cpp)
    add_custom_target(format
        COMMAND ${CLANG_FORMAT} -i ${SOURCES}
        COMMENT "Formatage du code source"
    )
endif()

# Execution sur un fichier avec compile_commands.json
clang-tidy src/database.cpp -- -std=c++17

# Sur tout le projet (parallel)
run-clang-tidy -p build/dev -j 8 src/

# Correction automatique (-fix)
clang-tidy -fix src/database.cpp -- -std=c++17

# Integration dans CMake
find_program(CLANG_TIDY clang-tidy)
if(CLANG_TIDY)
    set_target_properties(items_lib PROPERTIES
        CXX_CLANG_TIDY "${CLANG_TIDY};--config-file=${CMAKE_SOURCE_DIR}/.clang-tidy"
    )
endif()

# cppcheck — analyse statique open source
cppcheck --enable=all --std=c++17 \
         --suppress=missingIncludeSystem \
         --error-exitcode=1 \
         -I src/ src/

# cppcheck avec XML pour CI (ex: plugin Jenkins)
cppcheck --xml --xml-version=2 src/ 2> cppcheck_report.xml

# Clang Static Analyzer via scan-build
scan-build cmake -B build_scan -DCMAKE_BUILD_TYPE=Debug
scan-build cmake --build build_scan
# Rapport HTML dans /tmp/scan-build-XXXXXXX/

# Compilation avec ASan
cmake -B build_asan -DENABLE_ASAN=ON -DCMAKE_BUILD_TYPE=Debug
cmake --build build_asan

# Execution — les erreurs sont affichees avec trace de pile complete
./build_asan/items_api

# Exemple de rapport ASan typique :
# ==12345==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x...
# READ of size 4 at 0x... thread T0
#     #0 0x... in Database::listerItems() database.cpp:45
#     #1 0x... in main main.cpp:12

# MemorySanitizer (Clang uniquement) : lecture de memoire non initialisee
clang++ -std=c++17 -fsanitize=memory -fno-omit-frame-pointer -g \
  src/*.cpp -o items_msan

# Lancement GDB en mode TUI (interface texte)
gdb -tui ./build_debug/items_api

# Commandes essentielles GDB
# b database.cpp:45   -- breakpoint ligne 45
# b Database::creerItem -- breakpoint methode
# r                   -- run
# n                   -- next (step over)
# s                   -- step (step into)
# p item.nom          -- afficher variable
# p *ptr              -- dereference pointeur
# bt                  -- backtrace (pile d'appels)
# info locals         -- variables locales courantes
# watch variable      -- watchpoint : arret si variable change
# continue            -- reprendre l'execution
# q                   -- quitter

# Fichier .gdbinit — commandes executees au demarrage
# set print pretty on       # Affichage JSON des structs
# set print elements 50     # Limite les tableaux a 50 elements
# b main                    # Breakpoint automatique sur main

# LLDB — syntaxe differente de GDB mais commandes similaires
lldb ./build_debug/items_api

# Equivalences GDB -> LLDB
# b Database.cpp:45         -> breakpoint set -f database.cpp -l 45
# r                         -> run
# n                         -> next
# s                         -> step
# p item.nom                -> frame variable item.nom
# bt                        -> thread backtrace
# continue                  -> continue

# Profiling avec perf (Linux uniquement, kernel events)
# Necessite : CMAKE_BUILD_TYPE=RelWithDebInfo pour les symboles
cmake -B build_prof -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build_prof

# Enregistrement du profil
perf record -g ./build_prof/items_api
# Rapport interactif
perf report --sort=dso,symbol

# Rapport one-liner (top des fonctions)
perf report --stdio --sort=symbol | head -30

# Flamegraph via perf + FlameGraph scripts
perf record -F 99 -g ./items_api -- --iterations=100000
perf script | ~/FlameGraph/stackcollapse-perf.pl | \
  ~/FlameGraph/flamegraph.pl > flamegraph.svg

# Valgrind Memcheck — fuites memoire et erreurs d'acces
valgrind --leak-check=full --show-leak-kinds=all \
         --track-origins=yes --verbose \
         ./build_debug/items_api

# Callgrind — profil d'execution (comptage d'instructions)
valgrind --tool=callgrind --callgrind-out-file=callgrind.out \
         ./build_debug/items_api

# Visualisation Callgrind avec KCachegrind ou QCachegrind
kcachegrind callgrind.out

# Heaptrack — profil d'allocations memoire (plus rapide que Valgrind)
heaptrack ./build_release/items_api
heaptrack_gui heaptrack.items_api.*.gz

# 1. Build RelWithDebInfo (optimise + symboles)
cmake --preset release   # ou un preset avec RelWithDebInfo

# 2. Bench de base pour identifier les hotspots
time ./build/release/items_api --bench

# 3. perf stat — statistiques CPU globales
perf stat ./build/release/items_api --bench
# Performance counter stats:
#  12,345,678 instructions
#   1,234,567 cache-misses  <-- indicateur de probleme cache

# 4. perf record + report pour localiser les fonctions couteuses
perf record -g ./build/release/items_api --bench
perf report

# 5. Callgrind pour l'analyse fine instruction par instruction
valgrind --tool=callgrind ./build/debug/items_api --bench
kcachegrind callgrind.out.*

# Choisir le standard C++ a la compilation
g++     -std=c++23 -o app main.cpp  # GCC avec C++23
clang++ -std=c++20 -o app main.cpp  # Clang avec C++20
cl.exe  /std:c++20    main.cpp      # MSVC avec C++20

# Verifier la version du compilateur
g++ --version
# g++ (Ubuntu 13.2.0) 13.2.0

clang++ --version
# Ubuntu clang version 17.0.6