Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.
GitHub AE est actuellement en version limitée.

pack ls

[Expérimental][Plomberie profonde] Liste les packages CodeQL enracinés dans ce répertoire. Ce répertoire doit contenir un fichier qlpack.yml ou .codeqlmanifest.json.

GitHub CodeQL est concédé sous licence par utilisateur lors de l’installation. Vous pouvez utiliser CodeQL uniquement pour certaines tâches soumises aux restrictions de licence. Pour plus d’informations, consultez « À propos de CodeQL CLI ».

Si vous disposez d’une licence GitHub Advanced Security, vous pouvez utiliser CodeQL pour l’analyse automatisée, l’intégration continue et la livraison continue. Pour plus d’informations, consultez « À propos de GitHub Advanced Security ».

Ce contenu décrit la version la plus récente de l’interface CLI CodeQL. 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 pack ls <options>... -- <dir>

Description

[Expérimental] [Plomberie profonde] Liste les packages CodeQL enracinés dans ce répertoire. Ce répertoire doit contenir un fichier qlpack.yml ou .codeqlmanifest.json.

Disponible depuis v2.7.1.

Options principales

<dir>

Le répertoire racine du package ou de l’espace de travail est défini par défaut sur le répertoire de travail actif. Si ce paramètre pointe vers un répertoire contenant un fichier qlpack.yml, cette opération s’exécute uniquement sur ce package CodeQL. Si ce paramètre pointe vers un répertoire contenant un fichier codeql-workspace.yml, cette opération s’exécute sur tous les packages CodeQL de l’espace de travail.

Options pour configurer les packs CodeQL auxquels appliquer cette commande.

--format=<fmt>

Sélectionne le format de sortie text (par défaut) ou json.

--groups=[-]<group>[,[-]<group>...]

Liste les groupes de packs CodeQL à inclure ou exclure de cette opération. Un qlpack dans l’espace de travail donné est inclus si :

  • Il se trouve dans au moins l’un des groupes listés sans signe moins (cette condition est automatiquement remplie s’il n’y a aucun groupe listé sans signe moins), et
  • Il ne se trouve dans aucun groupe listé avec un signe moins

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