{"meta":{"title":"extrait de test","intro":"[Plomberie] Génère un jeu de données pour un répertoire de test.","product":"Sécurité et qualité du code","breadcrumbs":[{"href":"/fr/code-security","title":"Sécurité et qualité du code"},{"href":"/fr/code-security/reference","title":"Reference"},{"href":"/fr/code-security/reference/code-scanning","title":"Analyse du code"},{"href":"/fr/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/fr/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manuel de l’interface CLI CodeQL"},{"href":"/fr/code-security/reference/code-scanning/codeql/codeql-cli-manual/test-extract","title":"extrait de test"}],"documentType":"article"},"body":"# extrait de test\n\n\\[Plomberie] Génère un jeu de données pour un répertoire de test.\n\n> \\[!NOTE]\n> Ce contenu décrit la version la plus récente de CodeQL CLI. Pour plus d’informations sur cette version, consultez <https://github.com/github/codeql-cli-binaries/releases>.\n>\n> Pour voir les détails des options disponibles pour cette commande dans une version antérieure, exécutez la commande avec l’option <span style=\"white-space: nowrap;\">`--help`</span> dans votre terminal.\n\n## Synopsis\n\n```shell copy\ncodeql test extract [--print-database] [--source-root=<dir>] <options>... -- <testDirectory>\n```\n\n## Descriptif\n\n```\n          \\[Plomberie] Génère un jeu de données pour un répertoire de test.\n```\n\nCrée une base de données pour un répertoire de test spécifié, sans exécuter réellement de requêtes de test. Génère le chemin du jeu de données QL brut sur lequel exécuter les requêtes de test.\n\n## Options\n\n### Options principales\n\n#### `<testDirectory>`\n\n```\n          \\[Obligatoire] Chemin du répertoire de test.\n```\n\n#### `--database=<dir>`\n\nRemplace l’emplacement de la base de données en cours de création. Par défaut, il s’agit d’un sous-répertoire dont le nom est dérivé du nom du répertoire de test lui-même avec « .testproj » en plus.\n\n#### `-D, --print-database`\n\nAffichez le chemin vers la base de données en cours de création, plutôt que le jeu de données qu’elle contient.\n\n#### `-s, --source-root=<dir>`\n\n```\n          \\[Avancé] Répertoire de code source racine, s’il est différent du répertoire de test.\n```\n\n#### `--search-path=<dir>[:<dir>...]`\n\nListe des répertoires sous lesquels les packs d’extracteur peuvent être trouvés. Les répertoires peuvent être les packs d’extracteur eux-mêmes ou les répertoires qui contiennent les extracteurs en tant que sous-répertoires immédiats.\n\nSi le chemin contient plusieurs arborescences de répertoires, leur ordre définit la priorité entre elles : si le langage cible est mis en correspondance dans plusieurs arborescences de répertoires, celle donnée en premier gagne.\n\nLes extracteurs en bundle avec la chaîne d’outils CodeQL elle-même sont toujours trouvés, mais si vous devez utiliser des extracteurs distribués séparément, vous devez donner cette option (ou, mieux encore, configurer `--search-path` dans un fichier de configuration par utilisateur).\n\n(Remarque : Sur Windows, le séparateur de chemin est `;`.)\n\n#### `--cleanup`\n\nSupprime la base de données de test au lieu de la créer.\n\n#### `--[no-]show-extractor-output`\n\n```\n          \\[Avancé] Affiche la sortie des scripts d’extracteur qui créent les bases de données de test. Peut être utile lors du développement ou de la modification de cas de test.\n```\n\nAttention, cela peut générer une sortie dupliquée ou incorrecte si vous l’utilisez avec plusieurs threads !\n\n#### `--[no-]check-undefined-labels`\n\n```\n          \\[Avancé] Signale les erreurs pour les étiquettes non définies.\n```\n\n#### `--[no-]check-unused-labels`\n\n```\n          \\[Avancé] Signale les erreurs pour les étiquettes non utilisées.\n```\n\n#### `--[no-]check-repeated-labels`\n\n```\n          \\[Avancé] Signale les erreurs pour les étiquettes répétées.\n```\n\n#### `--[no-]check-redefined-labels`\n\n```\n          \\[Avancé] Signale les erreurs pour les étiquettes redéfinies.\n```\n\n#### `--[no-]check-use-before-definition`\n\n```\n          \\[Avancé] Signale les erreurs pour les étiquettes utilisées avant leur définition.\n```\n\n#### `--[no-]fail-on-trap-errors`\n\n```\n          \\[Avancé] Sort une valeur non nulle si une erreur se produit lors de l’importation d’un fichier TRAP.\n```\n\n#### `--[no-]include-location-in-star`\n\n```\n          \\[Avancé] Construit des ID d’entité qui encodent l’emplacement dans le fichier TRAP dont ils proviennent. Peut être utile pour le débogage des générateurs TRAP, mais prend beaucoup d’espace dans le jeu de données.\n```\n\n#### `--[no-]linkage-aware-import`\n\n```\n          \\[Avancé] Contrôle si [l’importation de jeu de données codeql](/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import) prend en compte les liaisons _(par défaut)_ ou non. Sur les projets dans lesquels cette partie de la création de base de données consomme trop de mémoire, la désactivation de cette option peut contribuer à progresser au détriment de l’exhaustivité de la base de données.\n```\n\nDisponible depuis `v2.15.3`.\n\n#### `--format=<fmt>`\n\nSélectionne le format de sortie `text`*(par défaut)* ou `json`.\n\n### Options courantes\n\n#### `-h, --help`\n\nAffiche ce texte d’aide.\n\n#### `-J=<opt>`\n\n```\n          \\[Avancé] Donne une option à l’environnement JVM exécutant la commande.\n```\n\n(Attention, les options contenant des espaces ne sont pas gérées correctement.)\n\n#### `-v, --verbose`\n\nAugmente de façon incrémentielle le nombre de messages de progression affichés.\n\n#### `-q, --quiet`\n\nDiminue de façon incrémentielle le nombre de messages de progression affichés.\n\n#### `--verbosity=<level>`\n\n```\n          \\[Avancé] Définit explicitement le niveau de détail sur errors, warnings, progress, progress+, progress++ ou progress+++. Remplace `-v` et `-q`.\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[Avancé] Écrit des journaux détaillés dans un ou plusieurs fichiers du répertoire donné, avec des noms générés qui incluent des horodatages et le nom de la sous-commande en cours d’exécution.\n```\n\n(Pour écrire un fichier journal avec un nom sur lequel vous avez un contrôle total, donnez plutôt `--log-to-stderr` et redirigez stderr comme vous le souhaitez.)\n\n#### `--common-caches=<dir>`\n\n```\n          \\[Avancé] Contrôle l’emplacement des données en cache sur le disque qui persisteront entre plusieurs exécutions de l’interface CLI, telles que les packs QL téléchargés et les plans de requête compilés. S’il n’est pas défini explicitement, il s’agit par défaut d’un répertoire nommé `.codeql` dans le répertoire de base de l’utilisateur. S’il n’existe pas déjà, il sera créé.\n```\n\nDisponible depuis `v2.15.2`."}