LG

• Configuration

S'intègre parfaitement avec CMake.

Il faut commencer par activer l'option set(CMAKE_EXPORT_COMPILE_COMMANDS ON).

Puis lancer la génération des fichiers Makefile avec CC="clang" CXX="clang++" cmake -S . -B build pour générer également le fichier compile_commands.json.

• Exécution de l'analyse

iwyu_tool -p . -- -Xiwyu --mapping_file="$(pwd)/../.iwyu-suppressions"

Il est possible de mettre autant de -Xiwyu --mapping_file= que l'on veut.

Le dossier spécifié par -p est celui qui contient le fichier compile_commands.json.

• Filtrer les erreurs

Il est possible de supprimer certains avertissements en utilisant un fichier (ici .iwyu-suppressions). Il est important que le chemin de ce fichier soit absolu.

.iwyu-suppressions

[
    { include: ["@\"gtest/.*\"", "private", "<jessica/test/test.h>", "public"] },
    { include: ["@<gtest/.*>", "private", "<jessica/test/test.h>", "public"] }
]

Dans la première partie private, on met le nom de l'entête erroné. Si le texte commence par @, la recherche est une expression régulière.

Dans la seconde partie public, on met le nom du juste entête.

• Qt

Dans le code source, il y a un script mapgen/iwyu-mapgen-qt.py qui permet de générer du fichier de correspondance. Il est impératif de l'utiliser avec la version exacte de Qt.

Attention, tout est codé en expression régulière et iwyu n'est pas du tout optimisé pour ça. Il est conseillé de remplacer tous les "@[\"<](Qt3DCore/)?qcomponent\\.h[\">]" par "<qcomponent.h>" et éventuellement d'ajuster en fonction des premiers résultats.