Il blocco checkers di .lagune/configs.json stabilisce cosa lasciano fuori gli hook che analizzano i file, per tutti o per uno solo.

Come configurarlo

Aggiungi o rimuovi percorsi e pattern dalla riga di comando, mettendo ogni pattern tra virgolette perché la shell lo lasci così com'è scritto:

npx lagune write add --ignore test/fixtures
npx lagune write add --ignore 'packages/*/dist' --checker secrets
npx lagune write remove --ignore test/fixtures

Oppure impostali nel file:

{
  "checkers": {
    "ignore": ["test/fixtures"],
    "secrets": { "gitignore": false, "ignore": ["test/fixtures", "temp"] }
  }
}

Impostazioni

Chiave	Valore	Predefinito	Descrizione
gitignore	true o false	true	Lascia fuori ciò che Git ignora. Un file tracciato da Git viene analizzato comunque.
ignore	percorsi o pattern dalla radice del progetto	[]	Lascia fuori ciò che corrisponde a ognuno e tutto ciò che contiene, anche un file tracciato da Git.

Al primo livello di checkers, una chiave vale per ogni checker. Sotto il nome di un checker, vale solo per quel checker e sostituisce quella condivisa, quindi nell'esempio secrets analizza ciò che Git ignora e lascia fuori test/fixtures e temp. Quando write add --ignore assegna a un checker la prima lista tutta sua, quella lista parte come copia di quella condivisa.

Pattern

Un pattern parte dalla radice del progetto, quindi *.generated.ts raggiunge solo i file che si trovano lì e **/*.generated.ts li raggiunge a qualsiasi profondità. I nomi devono corrispondere esattamente, maiuscole e minuscole comprese.

Pattern	Lascia fuori
dist	dist nella radice del progetto
packages/*/dist	dist in ogni cartella dentro packages
**/dist	ogni dist, a qualsiasi profondità
**/*.generated.ts	ogni file il cui nome termina con .generated.ts
fixture-?	fixture-a, fixture-1 e simili
[ab]-cache	a-cache e b-cache
[*]x	*x, con un * letterale

Come leggere il risultato

Il report si chiude indicando quanti percorsi l'analisi ha lasciato fuori, in base a cosa li ignora:

Skipped 25 paths that Git ignores and 3 paths that .lagune/configs.json ignores. Name one with --dir or --file to scan it.

Un percorso indicato con --dir o --file viene analizzato qualunque cosa dicano le impostazioni. Un'impostazione che il motore non riesce a leggere ferma il checker con un errore che la nomina, come un pattern che inizia con ! o con uno spazio, esce dal progetto, lascia una parentesi quadra aperta o richiede troppo tempo per essere confrontato.

Domande frequenti

No. Il charter elenca le cartelle versionate che, secondo la sua lettura, non sono codice tuo da difendere, come le fixture di test scritte per sembrare vulnerabili, e registra solo quelle che scegli tramite il numero.

Quando non hai motivo di fidarti del repository, dato che i suoi file .gitignore potrebbero nascondere codice, oppure quando una cartella di build potrebbe contenere una chiave inserita in fase di build. Imposta gitignore a false per tutti i checker o per uno solo.