Capabilities

Faites de chaque couche
un comportement vérifiable

De la sélection de la version cible aux macros prédéfinies et aux diagnostics, jusqu'aux PCH et aux projets réels, CrucibleCpp ne fonctionne pas au « ça devrait marcher », mais grâce à une chaîne de tests reproductible.

A

Version cible et profil

Un préprocesseur, trois GCC cibles. La version choisie détermine ses macros prédéfinies et les données __has_* ainsi que les chemins de recherche d'include.

  • --gcc-version=13|14|15
  • --gcc D:\path\to\g++.exe
  • Détection automatique dans PATH, version prise en charge la plus élevée par défaut
  • GCC 13.3 / 14.3 / 15.2 profile
  • C++11 / C++14 / C++17 / C++20
B

Système de diagnostics

Un format de diagnostics conçu pour les vrais systèmes de build : ligne de code source, caret, include trace et option d'avertissement, pas seulement une chaîne d'erreur.

  • Severity / option / caret au style de GCC
  • -Werror, -Wno-..., -Werror=...
  • #pragma GCC diagnostic push/pop
  • #pragma GCC system_header
  • -Wsystem-headers et suppression des en-têtes système
C

Macros et sémantique du prétraitement

Macros objet, macros fonction, arguments vides, macros variadiques, stringification, token pasting et l'extension GCC d'élimination de la virgule.

  • # et ##
  • __VA_OPT__(C++20)
  • , ## __VA_ARGS__
  • defined / __has_include
  • Analyse JSON du macro trace et du graphe d'include
D

UCN et #embed

Les universal character names participent aux identifiants et au collage ; #embed intègre les ressources binaires selon la sémantique de GCC.

  • \uXXXX / \UXXXXXXXX
  • UCN formés par un antislash en fin de ligne
  • # / ## conservent l'orthographe UCN
  • #embed + limit
  • prefix / suffix / if_empty
  • gnu::offset et __has_embed
E

PCH et cache

GCC 13/14/15 peuvent tous utiliser les stratégies PCH et le cache. Le cache n'analyse pas directement les PCH de GCC : il valide, enregistre, invalide et suit les fichiers .gch.

  • --pch=ignore|warn|error|report
  • Disposition PCH de CMake avec include forcé
  • Isolation par chemin, version et hachage du compilateur
  • Écriture atomique, verrou de répertoire, purge par capacité et par ancienneté
  • Statistiques JSON : taux de succès / stale / corrupt
F

Tests reproductibles

Trois GCC, deux corpus différentiels et des projets réels valident ensemble la sortie, et pas seulement un « prétraitement réussi ».

  • 65/65 CTest pour GCC15 / 14 / 13
  • differential corpus 13/13
  • realworld corpus 3/3
  • CrucibleCpp .i → GCC cible → exe → exécution
  • GCC g++.dg/cpp testsuite en régression
Positioning

Il remplace l'étape de prétraitement, pas le compilateur

CrucibleCpp ne génère pas de code, n'optimise pas et n'analyse pas les PCH binaires de GCC. Il se contente de transformer les fichiers sources en un fichier .i déterministe, en confiant les diagnostics, les dépendances et les informations analysables au système de build.