File e directory

QuickRust crea le sue directory con modalità 0700. I percorsi qui sotto usano la home predefinita, ~/.qrust; QRUST_HOME la sposta per intero.

La home di QuickRust

<id> sono le prime 16 cifre esadecimali dello SHA-256 del percorso canonico della radice del workspace.

La cache di QuickRust

Tutto ciò che si trova sotto ~/.qrust/cache/ può essere ricompilato o scaricato di nuovo. QuickRust la mantiene entro cache.max-size e lascia libero cache.min-free del disco (Configurazione), rimuovendo ciò che è stato usato meno di recente.

Raccolta

Una pulizia rimuove, in quest’ordine:

1. tutto ciò che nulla può più usare: directory di build di workspace che non esistono più, driver di toolchain che non esistono più, download incompleti vecchi di una settimana, memo vecchi di un mese, residui in tmp/;
2. finché la cache supera cache.max-size o il disco scende sotto cache.min-free: directory di build, voci degli artefatti e sorgenti dei programmi installati, a partire da quelli usati meno di recente, finché la cache non scende sotto il 90% di cache.max-size e il disco non ha libero il 125% di cache.min-free;
3. i crate e i checkout git scaricati nella home di Cargo di QuickRust, rimossi da Cargo stesso (cargo -Zgc clean gc): secondo le età consuete di Cargo a ogni pulizia e, finché i limiti sono ancora superati, quelli inutilizzati da un mese, una settimana, un giorno, un’ora e 15 minuti, nell’ordine. Solo mentre nessun comando di QuickRust sta eseguendo un Cargo (~/.qrust/cargo-runs/). Altrimenti vengono lasciati alla pulizia successiva, cosa che qrust gc e qrust cache status riportano. La pulizia di Cargo cancella i suoi record dei registri che non trova nella home di Cargo, come quello temporaneo su cui compila cargo package, e un Cargo in esecuzione che tiene uno di quei record si ferma con un errore interno. Un comando che parte mentre la pulizia di Cargo è in corso la attende e lo dice.

Una pulizia conta da sé ciò che libera e non misura di nuovo il disco finché non termina, perché il disco potrebbe non mostrare ciò che libera. Uno snapshot (gli snapshot locali orari di Time Machine su macOS, gli snapshot di btrfs o ZFS) conserva i blocchi di ogni file più vecchio di sé, e ciò che è stato usato meno di recente lo è sempre. Ciò che il disco non mostra alla fine viene registrato in usage.json e contato come libero, prima e dopo i comandi e dalla pulizia successiva, finché il disco non lo mostra. Questo dura al massimo un giorno, la vita di uno snapshot locale di Time Machine. Dopo un giorno, torna a contare il valore del disco stesso.

Non vengono mai rimossi: tutto ciò che è stato usato negli ultimi 15 minuti; una directory di build tenuta da un comando di QuickRust o in cui un Cargo tiene un lock; un sorgente tenuto da un’installazione; una voce degli artefatti i cui file sono collegati da una directory di build in uso. Le dimensioni sono i blocchi allocati; un file con più hard link viene contato una sola volta e liberato con il suo ultimo link.

qrust cache status mostra l’ultimo conteggio e le pulizie recenti; qrust gc --dry-run elenca ciò che una pulizia rimuoverebbe.

Programmi della toolchain all’interno di una toolchain

In una directory di build

Se ne vanno insieme al resto della directory (cargo clean).

In un repository

QuickRust scrive in un repository solo su richiesta.

In un progetto non viene creata alcuna directory target/.

Setup

qrust setup scrive:

• ~/.qrust/bin/ con qrust, qrust-rustc-wrapper e i link ai programmi; si rifiuta di sostituire lì un file che non sia di QuickRust;
• ~/.qrust/env e ~/.qrust/env.fish;
• una riga contrassegnata # Added by qrust setup: QuickRust's bin first on PATH in ~/.profile, e in ~/.bash_profile, ~/.bashrc e ~/.zshenv dove esistono (~/.zshenv anche quando zsh è nel PATH); ~/.config/fish/conf.d/qrust.fish quando esiste ~/.config/fish; su Windows, il PATH dell’utente tramite PowerShell (niente di tutto questo con --no-modify-path);
• una sola volta, da $CARGO_HOME o da ~/.cargo: credentials.toml e le tabelle [registries], [registry], [source], [net] e [http] di config.toml, in ~/.qrust/cargo/ (le tabelle che non ha importato vengono elencate);
• ~/.qrust/setup.json.

qrust self uninstall --yes rimuove ~/.qrust e le righe e i file elencati sopra che qrust setup ha aggiunto. rustup e ~/.cargo non vengono mai modificati.

Conservazione

La potatura viene eseguita circa un comando ogni 32. Stamp delle build già compilate: al massimo 32 per workspace. Log delle pulizie: le ultime 200 voci.