Scansione dei commenti di lavoro con annotations

Il comando annotations esegue una scansione sistematica dei file sorgente IbiScript alla ricerca di commenti di lavoro contrassegnati da tag specifici (TODO, FIXME, WARN, NOTE). Lo strumento consente all’editore di monitorare lo stato di avanzamento dell’edizione e di individuare i punti critici sospesi prima della compilazione finale. Tramite le opzioni della CLI, è possibile filtrare l’ispezione per singoli tag, formattare l’output su una sola riga per facilitare l’uso di grep, esportare i risultati in formato JSON o forzare un codice di uscita diverso da zero in caso di riscontri positivi (utile per l’integrazione in script di controllo automatizzati).

$ ibis annotations -h

Scan IbiScript files for tagged annotation comments (TODO, FIXME, WARN, NOTE)

Usage: ibis annotations [OPTIONS] [PATHS]...

Arguments:
  [PATHS]...  Files or directories to scan

Options:
  -t <TAGS>           Restrict to specific tags (repeatable). Omit to include all tagged comments
      --no-recursive  Do not descend into subdirectories
      --check         Exit non-zero if any matching annotation is found; suppresses listing unless --verbose
      --verbose       Print matches even when --check is set
      --json          Output as JSON
      --oneline       Collapse multi-line comment text onto a single line (useful for grep/scripting)
  -h, --help          Print help