1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# Examples
Contenuto generato da `scripts/regenerate_examples.sh`.
## File
- `inventory.xlsx`: workbook di input con il foglio predefinito generato automaticamente.
- `inventory.xml`: input XML con i tag `Inventory` e `Archive`.
- `inventory.csv`: input CSV con gli stessi campi dell'inventory principale.
- `inventory.json`: input JSON con chiavi top-level `Inventory` e `Archive`.
- `inventory.jsonl`: input JSONL con un oggetto per riga.
- `inventory.html`: input HTML con una tabella equivalente agli altri esempi di inventory.
- `inventory.md`: input Markdown con più tabelle; di default viene usata la prima.
- `inventory.feather`: input Feather equivalente agli altri dataset tabellari.
- `snapshot-before.csv` / `snapshot-after.csv`: snapshot CSV da confrontare con `qf diff`.
- `multi-statement.sql`: file SQL con più statement separati da `;`; esempio per `--sql-file` con DDL intermedio e SELECT finale.
- `active-products.txt`: output in formato table (predefinito) di una query sui prodotti attivi.
- `active-products.csv`: output CSV della stessa query sui prodotti attivi.
- `active-products.jsonl`: output JSONL della stessa query sui prodotti attivi.
- `active-products.md`: output Markdown della stessa query sui prodotti attivi.
- `active-products.html`: output HTML della stessa query sui prodotti attivi.
- `active-products.xml`: output XML della stessa query sui prodotti attivi.
- `active-products.feather`: output Feather della stessa query sui prodotti attivi.
- `active-products-from-xml.csv`: output CSV ottenuto interrogando `inventory.xml:Inventory`.
- `active-products-from-csv.csv`: output CSV ottenuto interrogando `inventory.csv`.
- `active-products-from-json.csv`: output CSV ottenuto interrogando `inventory.json:Inventory`.
- `active-products-from-jsonl.csv`: output CSV ottenuto interrogando `inventory.jsonl`.
- `active-products-from-html.csv`: output CSV ottenuto interrogando `inventory.html`.
- `active-products-from-markdown.csv`: output CSV ottenuto interrogando la prima tabella di `inventory.md`.
- `active-products-from-feather.csv`: output CSV ottenuto interrogando `inventory.feather`.
- `cte-chaining-example.csv`: output CSV ottenuto con due CTE via `--with` (filtro attivi, poi filtro per prezzo).
- `multi-statement-result.csv`: output CSV del file `multi-statement.sql` con DDL intermedio e SELECT finale.
- `stock-by-category.xlsx`: output XLSX aggregato per categoria.
- `diff-products.txt`: diff tabellare (added/removed/changed) con confronto per chiave.
- `diff-products-side-by-side.md`: diff completo con colonne `_left_*` / `_right_*`.
- `diff-schema.json`: confronto schema-only tra i due snapshot.
- `commands.sh`: esempi di comandi da eseguire dalla root del repository.
## Note
- Gli esempi CSV e JSONL riflettono il percorso ottimizzato per file grandi: caricamento incrementale e inserimenti SQLite a batch.
- Nei comandi di esempio, `--format md` e `--format markdown` sono equivalenti.
- Per gli esempi clipboard usa pseudo-percorsi come `@clipboard.csv` e `@clipboard.json`; i dati reali non vengono salvati nella cartella `examples/`.
## Rigenerazione locale
```bash
./scripts/regenerate_examples.sh
```
## Rigenerazione via GitHub Actions
Esegui manualmente il workflow `Regenerate examples` dalla tab **Actions**. Il job allega la cartella `examples/` come artifact.