otty / apps

All apps/rustup

rustup

rustup is an installer for the systems programming language Rust.

Runs as rustup|macOS, Linux, Windows|rustup.rs

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

rustup in your home directory Every rule on this page, by file

overrides

Each machine keeps its own copy of these.

version = "12"

default_toolchain = "stable-aarch64-apple-darwin"machine-local

profile = "default"

[overrides]

…

Each machine keeps its own copy of these.

· toolchains/ Exclude

· downloads/ Exclude

· update-hashes/ Exclude

· tmp/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/rustup/otty.tomlThe file this page is generated from

id = "rustup"

name = "rustup"

homepage = "https://rustup.rs"

description = "rustup is an installer for the systems programming language Rust."

icon = "SimpleIcons:rust"

executables = ["rustup"]

[dotfiles]

# https://rust-lang.github.io/rustup/configuration.html — rustup keeps a TOML

# settings file at ${RUSTUP_HOME}/settings.toml, and RUSTUP_HOME defaults to

# ~/.rustup (%USERPROFILE%\.rustup on Windows, which resolves to this same

# path). This is a different tree from Cargo's ~/.cargo (apps/cargo.toml),

# which holds no rustup state.

paths = ["~/.rustup/settings.toml"]

# Everything else under RUSTUP_HOME is downloaded toolchains and the

# bookkeeping for them: gigabytes, all of it refetchable with

# `rustup toolchain install`.

exclude = [

"~/.rustup/toolchains/",

"~/.rustup/downloads/",

"~/.rustup/update-hashes/",

"~/.rustup/tmp/",

]

# rustup authenticates to nothing; the toolchain archives it fetches are

# public. Registry tokens belong to Cargo and live in ~/.cargo/credentials.toml

# (apps/cargo.toml).

secret = []

# Read on each rustup/cargo/rustc shim invocation.

side_effect = false

# `overrides` is https://rust-lang.github.io/rustup/overrides.html's

# per-directory overrides — "the per-directory overrides are stored in a

# configuration file in rustup's home directory" — keyed by absolute paths to

# checkouts on this machine. Those are the user's own working copies, so the

# map is kept for rebuilding this machine and applied to no other.

[[dotfiles.machine_lines]]

file = "~/.rustup/settings.toml"

match = { key_path = ["overrides"] }

scope = "backup"

# `default_toolchain` is written as a full descriptor including the host triple

# ("stable-aarch64-apple-darwin"), so the value from a Mac names a toolchain a

# Linux box cannot install — it is decided by the OS and the architecture and

# by nothing else, which is why it is split off from the overrides above and

# shared across that machine class instead.

[[dotfiles.machine_lines]]

file = "~/.rustup/settings.toml"

match = { key_path = ["default_toolchain"] }

scope = "platform"

[commands]

format = 1

label = "rustup"

description = "Update toolchains, install toolchains and add targets."

quality = "ai-draft"

base = "fig:rustup"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/rustup.ts"

license = "MIT"

[[commands.subcommand]]

path = ["update"]

label = "Update toolchains"

description = "Update Rust toolchains and rustup."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/rustup.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "toolchain"

label = "Toolchains"

type = "string"

position = 0

multiple = true

description = "Leave empty to update all installed toolchains."

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_self_update"

label = "Skip rustup self-update"

type = "boolean"

option = ["--no-self-update"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "force"

label = "Force update"

type = "boolean"

option = ["--force"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "update"

label = "Update"

fields = ["toolchain", "no_self_update"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["toolchain", "no_self_update"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["force"]

[[commands.subcommand]]

path = ["toolchain", "install"]

label = "Install toolchain"

description = "Install or update a toolchain."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/rustup.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "toolchain"

label = "Toolchain"

type = "string"

position = 0

multiple = true

suggestions = [{ value = "stable", label = "stable" }, { value = "beta", label = "beta" }, { value = "nightly", label = "nightly" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "profile"

label = "Profile"

type = "string"

option = ["--profile"]

suggestions = [{ value = "minimal", label = "minimal" }, { value = "default", label = "default" }, { value = "complete", label = "complete" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "component"

label = "Components"

type = "string"

option = ["--component", "-c"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "target"

label = "Targets"

type = "string"

option = ["--target", "-t"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_self_update"

label = "Skip rustup self-update"

type = "boolean"

option = ["--no-self-update"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "force"

label = "Force"

type = "boolean"

option = ["--force"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "install"

label = "Install"

fields = ["toolchain", "profile"]

required = ["toolchain"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["toolchain", "profile", "component", "target"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["no_self_update", "force"]

[[commands.subcommand]]

path = ["target", "add"]

label = "Add target"

description = "Add a compilation target to a toolchain."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/rustup.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "target"

label = "Target triple"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "toolchain"

label = "Toolchain"

type = "string"

option = ["--toolchain"]

suggestions = [{ value = "stable", label = "stable" }, { value = "beta", label = "beta" }, { value = "nightly", label = "nightly" }]

sources = ["fig"]

[[commands.subcommand.task]]

id = "add"

label = "Add target"

fields = ["target", "toolchain"]

required = ["target"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["target", "toolchain"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/rustup. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits overrides and default_toolchain for you — that part is Otty’s own sync, or a template you write by hand.