resolve extractor

Remarque

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.

Pour voir les détails des options disponibles pour cette commande dans une version antérieure, exécutez la commande avec l’option --help dans votre terminal.

Synopsis

Shell

codeql resolve extractor --language=<lang> <options>...

codeql resolve extractor --language=<lang> <options>...

Description

[Plomberie profonde] Détermine le pack d’extracteur à utiliser pour un langage donné.

Options

Options principales

`-l, --language=<lang>`

[Obligatoire] Nom de l’extracteur à localiser.

`--search-path=<dir>[:<dir>...]`

Liste 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.

Si 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.

Les 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).

(Remarque : Sur Windows, le séparateur de chemin est ;.)

`--just-check`

N’affiche aucune sortie, mais quitte avec le code 0 si l’extracteur est trouvé et le code 1 dans le cas contraire.

`--format=<fmt>`

Sélectionne le format de sortie. Les options sont les suivantes :

text (par défaut) : Affiche le chemin du pack d’extracteur trouvé dans la sortie standard.

json : Affiche le chemin du pack d’extracteur trouvé sous forme de chaîne JSON.

betterjson : Affiche les détails sur le pack d’extracteur trouvé sous forme de chaîne JSON.

Options courantes

`-h, --help`

Affiche ce texte d’aide.

`-J=<opt>`

[Avancé] Donne une option à l’environnement JVM exécutant la commande.

(Attention, les options contenant des espaces ne sont pas gérées correctement.)

`-v, --verbose`

Augmente de façon incrémentielle le nombre de messages de progression affichés.

`-q, --quiet`

Diminue de façon incrémentielle le nombre de messages de progression affichés.

`--verbosity=<level>`

[Avancé] Définit explicitement le niveau de détail sur errors, warnings, progress, progress+, progress++ ou progress+++. Remplace -v et -q.

`--logdir=<dir>`

[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.

(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.)

`--common-caches=<dir>`

[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 est créé.

Disponible depuis v2.15.2.