Configurazione

QuickRust non legge mai la configurazione di Cargo (.cargo/config.toml) per le proprie impostazioni, e Cargo non legge mai quella di QuickRust. qrust policy explain stampa ogni chiave con il suo valore effettivo, la variabile d’ambiente e l’origine; --format json stampa le stesse informazioni in JSON.

Fonti e precedenza

Le fonti successive prevalgono su quelle precedenti, chiave per chiave:

Una variabile d’ambiente vuota conta come non impostata. Un file di configurazione che non esiste conta come vuoto.

Formato del file

TOML. output e mode sono chiavi di primo livello; ogni altra chiave è name dentro la tabella che ha come nome la sua prima parte:

mode = "fast"

[cache]
provider = "sccache"
max-size = "40GiB"

[measurement]
report = ".qrust/runs/{session}.json"

Validazione

Una configurazione non valida ferma ogni comando tranne qrust upstream, con exit status 2 e un messaggio che indica la chiave e la sua fonte:

• una chiave che non esiste (unknown configuration key cache.providr in <file>);
• un valore al di fuori del tipo o dei valori ammessi per la chiave (invalid value "maybe" for cache.fail from <file>: expected one of open, closed);
• un valore del tipo TOML sbagliato;
• TOML non valido;
• qualsiasi variabile d’ambiente il cui nome inizia con QRUST_ e che non è la variabile di una chiave né una delle variabili interne di QuickRust (Ambiente): unknown configuration variable QRUST_…``.

Tipi di valore

Chiavi

La variabile d’ambiente di una chiave è QRUST_ seguito dalla chiave in maiuscolo con . e - sostituiti da _, tranne per le chiavi la cui variabile è indicata diversamente qui sopra (QRUST_MODE, QRUST_OUTPUT, QRUST_NESTED, QRUST_REPORT, QRUST_EARLY_CUTOFF, QRUST_CACHE_MAX_SIZE, QRUST_CACHE_MIN_FREE, QRUST_UPDATE_URL, QRUST_TOOLCHAIN_AUTO_UPDATE, QRUST_DIST_SERVER).

Un’esecuzione conta come CI quando una tra CI, GITHUB_ACTIONS, GITLAB_CI, BUILDKITE, JENKINS_URL, TF_BUILD, TEAMCITY_VERSION è impostata a un valore diverso da vuoto, false o 0. La CI seleziona incremental.ci al posto di incremental.local-dev e disattiva toolchain.auto-update. Un CARGO_INCREMENTAL esplicito nell’ambiente prevale sempre su entrambe le chiavi incremental.*.

Selezione della toolchain

La toolchain di un comando è la prima tra:

qrust toolchain list e qrust doctor mostrano la toolchain selezionata e che cosa l’ha selezionata. Gli override per directory di rustup non hanno un equivalente.

Nomi delle toolchain

Qualsiasi altra forma è un errore, prima di qualsiasi download. Una nightly senza data si risolve nella nightly più recente degli ultimi sette giorni che abbia tutti i componenti e i target richiesti.

File della toolchain

rust-toolchain.toml, oppure rust-toolchain (lo stesso TOML, oppure una singola riga che indica la toolchain). Una directory che li contiene entrambi è un errore.

[toolchain]
channel = "1.98"                       # oppure path = "../my-toolchain", mai entrambi
components = ["rust-src", "llvm-tools"]
targets = ["wasm32-unknown-unknown"]
profile = "minimal"                    # minimal | default | complete

Qualsiasi altra chiave o tabella è un errore. La toolchain, i suoi componenti e target, e la libreria standard di ogni --target per cui un comando compila vengono installati al primo utilizzo.

Profili delle toolchain

Una toolchain installata senza un profilo riceve default.

File che QuickRust legge in un repository