Riferimenti e fonti

Schema delle configurazioni

Lo JSON Schema delle configurazioni di un progetto Lagune, per l'autocompletamento e la validazione nel tuo editor, allineato al Lagune attuale o fissato a una versione.

.lagune/configs.json registra le categorie usate da un progetto e indicizza le sue specializzazioni. Il suo JSON Schema permette al tuo editor di completare automaticamente ogni campo e di segnalare un refuso o una categoria sconosciuta mentre modifichi il file.

Lo schema attuale​

Ogni volta che Lagune scrive il file e non vi trova alcun $schema, fa puntare il file allo schema attuale:

{
"$schema": "https://lagune.ai/schemas/configs.json",
"categories": ["owasp", "javascript"]
}

Questo indirizzo segue sempre il Lagune attuale. Un file scritto prima di Lagune 0.16.0 lo riceve alla modifica successiva, e fino ad allora ogni fase lo fa notare.

Fissa una versione​

Ogni release di Lagune dalla 0.16.0 in poi porta con sé lo schema com'era in quella versione, pubblicato su npm e servito da jsDelivr. Per fissarne una, metti la versione dopo lagune@ nell'indirizzo di $schema:

{
"$schema": "https://cdn.jsdelivr.net/npm/lagune@0.16.0/schemas/configs.json"
}

La versione accetta qualsiasi intervallo semver:

VersioneSchema
0.16.0Quello della 0.16.0
0.16.x o 0.16Quello dell'ultima release 0.16
0.x o 0Quello dell'ultima release 0.x
latestQuello dell'ultima release

Domande frequenti

No. Lo schema aiuta solo il tuo editor, e Lagune legge il file nello stesso modo con o senza $schema.

No. Lagune scrive $schema solo quando il file non ne ha uno, e mantiene qualsiasi indirizzo tu abbia impostato.

Quando il progetto usa una versione specifica di Lagune, così il tuo editor valida il file rispetto a ciò che quella versione accetta.