Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

aggrega version

aggrega version affiche la version de la CLI aggrega.

Sortie

Par défaut, aggrega version affiche une ligne de version lisible par un humain.

Avec -o json, il émet un objet lisible par une machine, indenté de deux espaces, sous la même forme que celle qu’utilise chaque commande aggrega pour sa sortie JSON. Lisez-le avec un parseur JSON ; un consommateur qui effectue plutôt une correspondance sur le texte doit supprimer les espaces avant la correspondance, car les noms de champs constituent le contrat, et non la mise en page environnante.

{
"version": "1.2.3",
"committed": "2026-07-09T18:07:57Z",
"commit": "a1b2c3d",
"abiVersion": "v1beta1",
"goVersion": "go1.23.0",
"platform": "linux/amd64"
}

Les champs proviennent des métadonnées de build intégrées au binaire. committed est l’horodatage du commit, et n’est présent que lorsque la build en a enregistré un. abiVersion est la version de l’ABI des plugins que parle le binaire, qu’un pipeline peut lire pour vérifier la compatibilité des plugins sans charger de plugin. Une build de développement qui ne porte aucune version intégrée rapporte une valeur sentinelle (telle que (devel)) plutôt que d’échouer.

Quand utiliser -o json

  • Une extension d’éditeur compare la version rapportée par le démon à la version pour laquelle elle a été construite, afin de détecter un binaire aggrega serve incompatible avant de le piloter.
  • Les outils de CI et de provenance enregistrent la build exacte du compilateur qui a produit un artefact.

Voir aussi

  • ./aggrega-serve.md — le démon dont un client vérifie la version pour la compatibilité.

Synopsis

aggrega version [flags]

Description

Print the aggrega CLI's build identity.
By default the output is a single human-readable line followed by a
one-line pointer to the plugins compiled into the binary. With
-o json, the output is a structured JSON object suitable for
programmatic consumption (the VS Code extension uses this form to
read the binary's version at activation time), in the same indented
shape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table of
the embedded plugins — type, name, served capabilities, and commit —
under a header naming the count and their shared version. With
--verbose -o json, the JSON object gains an embeddedPlugins array
carrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with the
version form catalog entities use. Tagged release builds report the
release version, a build stamped with a version reports that version,
and a build carrying no version stamp reports the literal "(devel)",
which marks an unreleased build.

Options

OptionPar défautDescription
--output, -otextFormat de sortie : text|json.
--verbosefalseinclure dans la sortie l’ensemble des plugins intégrés