Output

Perché l’output ha questo aspetto: L’output delle build di QuickRust.

Forme delle righe

Tutto ciò che QuickRust scrive per le persone è in ASCII.

Un messaggio è un’intestazione, seguita dai suoi dettagli dopo : , separati da , ; una durata, quando c’è, chiude la riga tra parentesi quadre. Un tag che non ha nulla da aggiungere sta da solo: OK, oppure OK [0.42s] quando vale la pena di indicare solo il tempo.

Di una riga di esito è colorato solo il tag. La riga di stato e le righe di dettaglio come Locked ... sono attenuate; le parole delle righe delle dipendenze sono colorate (più sotto). Non c’è colore quando NO_COLOR è impostata (non vuota) o con CARGO_TERM_COLOR=never, e quando la riga non va a un terminale, a meno che non valga CARGO_TERM_COLOR=always. Senza colore, è il tag a portare il significato.

Le durate sono mostrate come 120ms, 4.21s, 2m05.3s; le dimensioni come 942 B, 281.0 KiB, 5.6 MiB.

Quando QuickRust presenta l’output

QuickRust presenta l’output di un comando quando valgono tutte queste condizioni:

• output = "qrust" (il default in fast mode; in compat mode solo se impostato esplicitamente);
• stderr è un terminale;
• il comando non è un alias di Cargo;
• la riga di comando non contiene nessuno tra --message-format, -v, -vv, --verbose, -q, --quiet, --color (prima di un eventuale --).

Altrimenti l’output di Cargo raggiunge il terminale, la pipe o il file senza modifiche. Per comando:

Per un comando presentato, QuickRust chiede a Cargo i suoi messaggi JSON (per le build) e il suo avanzamento, e gli chiede di disegnare in ASCII (term.unicode = false, così cargo tree disegna |-- e `--). Questi arrivano a quel solo Cargo come argomenti --config; gli script di build, i Cargo annidati e i programmi che un comando esegue non li vedono.

Build

Riga di stato

Una riga, ridisegnata sul posto, rientrata fino alla colonna del messaggio:

     Building [=========>          ] 112/240, 98 compiled, 14 fresh; tokio, syn
     Downloading [=====>              ] 7/25 crates, 2.1 MiB left
     Updating crates.io index: 26 packages looked up
     Waiting for the lock on the package cache (another Cargo holds it)

La barra è larga 20 celle. La riga viene troncata alla larghezza del terminale con .... Viene rimossa prima del riepilogo.

Righe sopra la riga di stato

| Riga | Esempio | |—|—| | Un errore del compilatore: il crate in rosso, poi la resa di rustc, per intero, man mano che arriva | --- app (bin) seguito da error[E0425]: cannot find function ... | | I download, una volta terminati | ` Downloaded 1 crate, 4.4 KiB [0.32s] | | Le modifiche al lockfile | Locked 1 package to highest compatible version | | Le righe che QuickRust non riconosce (fallimenti degli script di build, output cargo:warning=`, errori di risoluzione) | così come Cargo le ha stampate |

I warning non vengono stampati man mano che arrivano; vengono contati.

Riepilogo

Ogni unità viene contata una volta sola: compiled (rustc è stato eseguito), fresh (Cargo l’ha trovata aggiornata) oppure restored from QuickRust's cache. I conteggi pari a zero vengono omessi. I warning seguono il riepilogo in una sola riga, con i tre lint più frequenti per primi:

WARN 23 warnings in app and util: unused_variables x17, dead_code x4, +2 more; `qrust warnings` shows them

run, test, bench

Dopo il riepilogo della build viene eseguito il comando vero e proprio, che trova tutto aggiornato. Le righe “Finished” e “Running” di Cargo per cargo run non vengono mostrate, né i warning che Cargo riproporrebbe. L’output del programma non viene toccato.

Per test e bench, QuickRust mostra le righe di Cargo a modo suo e chiude con i conteggi di tutti i programmi di test sommati:

OK   Built: 1 compiled, 1 fresh [0.42s]
     unittests src/lib.rs
running 132 tests
...
test result: ok. 132 passed; 0 failed; 2 ignored; 0 measured; 0 filtered out; finished in 0.31s
     doc-tests app
...
OK   Tests: 140 passed, 2 ignored [1.12s]

Su Windows le righe dell’esecuzione dei test sono quelle di Cargo.

Comandi che non compilano

     updated    serde                    1.0.209 -> 1.0.210
     added      hashbrown                0.15.0
     removed    autocfg                  1.3.0
OK   Lockfile updated: 1 updated, 1 added, 1 removed [0.92s]

La riga di chiusura:

I comandi propri di QuickRust

Esempi:

OK   Rust 1.99.0 ready (1.99.0-x86_64-unknown-linux-gnu) [38.20s]
OK   Installed hello 0.3.0: hello -> ~/.qrust/bin [12.41s]
OK   Freed 1.2 GiB: QuickRust's cache 9.8 GiB -> 8.6 GiB (at most 10.0 GiB; keeps 2.0 GiB of the disk free, 40.1 GiB free now) [0.84s]
FAIL toolchain no-such-toolchain-xyz (from `+toolchain` argument): no toolchain is named `no-such-toolchain-xyz` (`qrust toolchain link no-such-toolchain-xyz <dir>` names one)

Output conservato

Per ogni build che QuickRust ha presentato, ogni riga scritta da Cargo e da rustc (al massimo 200.000 per esecuzione) viene conservata insieme all’esecuzione, in cargo-output.jsonl nella directory degli eventi dell’esecuzione. I ridisegni della riga di stato non vengono conservati. Un’esecuzione trovata aggiornata contiene l’output conservato della build rispetto alla quale è aggiornata, i cui warning vengono ripetuti dalla sua riga WARN. qrust warnings, qrust errors e qrust log lo stampano di nuovo (Comandi). L’output conservato viene mantenuto finché vengono mantenuti gli eventi grezzi dell’esecuzione (measurement.keep-raw-events). I comandi che non compilano non vengono conservati.