CARGO-INST...DATE-CONFIG(1)

✨ CARGO-INSTALL-UPDATE-CONFIG ✨

Okay bestie, listen up 💅 — this is the manual page for cargo-install-update-config, a Cargo subcommand that's all about checking and applying updates to installed executables. But specifically? The configuration part. No cap, this is where you tweak the compilation vibes for your packages. 🎀

---

🌸 SYNOPSIS 🌸

cargo install-update-config OPTIONS PACKAGE

---

💖 DESCRIPTION 💖

Real talk: this command lets you configure the cargo/rustc compilation commandlines for packages. It's giving "full control over the build" energy. ✨

Here's what you can set (the settable options, periodt):

• toolchain
• whether to use default features
• additional feature list
• build profile
• whether to install prereleases other than those for the currently-installed version
• Cargo.lock enforcement
• version range locks
• environment variable value or removal

Now, if there is no configuration for a package — like, zero, nada — the $CARGO_DIR/.crates2.json file gets parsed instead. Depending on your Cargo version, that might yield the following subset of data:

• whether to use default features
• additional feature list
• build profile

💡 For all the general info, go check out cargo-install-update(1). That's your main character manpage.

---

🦋 OPTIONS 🦋

Okay, let's get into the flags, bestie. There's a lot, but we're gonna slay through them together. 💪

• PACKAGE — the package you're adjusting settings for. Obvi.
• -t, --toolchain [TOOLCHAIN] — Set the toolchain to use. Pass an empty string to use the cargo default. (Yes, a literal empty string. Iconic.) ✨
• -f, --feature [FEATURE]... — Enable a cargo feature. You can stack these, so go off. 🎀
• -n, --no-feature [FEATURE]... — Disable/remove a cargo feature. The anti--f. 💅
• -d, --default-features [DEFAULT] — Enable or disable default features. The argument can be "yes", "true", "1" to enable, or "no", "false", "0" to disable. It's giving boolean energy. 🔥
• --debug — Compile in debug mode. Same as --build-profile dev. Lowkey useful for testing. 🙈
• --release — Compile in release mode (default). Same as --build-profile release. This is the one you probably want. 👑
• --build-profile [PROFILE] — Compile with PROFILE (dev/release/test/bench or defined in $CARGO_DIR/.cargo/config.toml under [profile.PROFILE]). Pick your fighter. 🌈
• --install-prereleases — Install the version even if it's a prerelease. Living on the edge, bestie. ⭐
• --no-install-prereleases — Don't update to prerelease versions.

⚠️ Important caveat, no cap: If the currently-installed version is a prerelease, and the candidate version is a newer prerelease for the same major.minor.patch version, it will be installed regardless of this setting. (To wit: this setting controls updates to prereleases, not within them.) So like, don't think it blocks everything. 💀

• --enforce-lock — Require Cargo.lock is up to date. Strict queen behavior. 👑
• --no-enforce-lock — Don't require Cargo.lock to be up to date. (default). Chill vibes. 🍓
• --respect-binaries — Only install the binaries that are already installed for this package. Selective. ✨
• --no-respect-binaries — Install all binaries. (default). Go big or go home. 🔥
• -v, --version [VERSION_REQ] — Require a cargo-compatible version range not to update beyond.

Example: ">1.3", "^0.1.8".

• -a, --any-version — Allow any version. YOLO. 💅
• -e, --environment [VARIABLE=VALUE]... — Set environment VARIABLE to VALUE in the cargo install process. You can stack these too. 🎀
• -E, --clear-environment [VARIABLE]... — Remove environment VARIABLE from the cargo install process. Bye felicia. 👋
• --inherit-environment [VARIABLE]... — Don't do anything to environment VARIABLE. Leave it alone, it's fine. 🙈
• -r, --reset — Roll back the configuration to the empty defaults. Fresh start, main character energy. ✨
• -c, --cargo-dir CARGO_DIR — Set the directory containing cargo metadata.

Required. Default: "$CARGO_HOME", then "$HOME/.cargo", otherwise manual. So like, it'll try to figure it out, but you might need to help.

---

🧚 EXAMPLES 🧚

Okay so here's a real example. Watch and learn, bestie:

cargo install-update-config -t nightly -d 0 -f log -f colour -v ~2.3 -e RUSTC_WRAPPER=sccache clippy

This sets clippy to be compiled with the nightly toolchain without default features, with log and colour features. Obsessed. 💖

Example output, for the visual learners:

  Toolchain              nightly
  Default features       true
  Features               log
                         colour
  Environment variables  RUSTC_WRAPPER=sccache

See how it all lines up? Slay. 💅

---

💜 AUTHOR 💜

This page was written by a whole squad of legends, fr fr. Shoutout to:

• наб <nabijaczleweli@nabijaczleweli.xyz>
• Yann Simon <yann.simon.fr@gmail.com>
• ven <vendethiel@hotmail.fr>
• Cat Plus Plus <piotrlegnica@piotrl.pl>
• Liigo <liigo@qq.com>
• azyobuzin <azyobuzin@users.sourceforge.jp>
• Tatsuyuki Ishi <ishitatsuyuki@gmail.com>
• Tom Prince <tom.prince@twistedmatrix.com>
• Mateusz Mikuła <mati865@gmail.com>
• sinkuu <sinkuupump@gmail.com>
• Alex Burka <aburka@seas.upenn.edu>
• Matthias Krüger <matthias.krueger@famsik.de>
• Daniel Holbert <dholbert@cs.stanford.edu>
• Jonas Bushart <jonas@bushart.org>
• Harrison Metzger <harrisonmetz@gmail.com>
• Benjamin Bannier <bbannier@gmail.com>
• Dimitris Apostolou <dimitris.apostolou@icloud.com>
• Corbin Uselton <corbinu@decimal.io>
• QuarticCat <QuarticCat@protonmail.com>
• Artur Sinila <freesoftware@logarithmus.dev>
• qthree <qthree3@gmail.com>
• tranzystorekk <tranzystorek.io@protonmail.com>
• Paul Barker <paul@pbarker.dev>
• Benoît Cortier
• Biswapriyo Nath <nathbappai@gmail.com>
• Shiraz <smcclennon@protonmail.com>
• Victor Song <vms2@rice.edu>
• chrisalcantara <chris@chrisalcantara.com>
• Utkarsh Gupta <utkarshgupta137@gmail.com>
• nevsal
• Rui Chen <https://chenrui.dev>
• Lynnesbian <https://fedi.lynnesbian.space/@lynnesbian>
• Rene Leonhardt
• Maxime Guerreiro <maxime@cloudflare.com>
• and Brian

That's a lot of icons, and we love that for them. 🌟

---

🫶 SPECIAL THANKS 🫶

To all who support further development, in particular:

• ThePhD
• Embark Studios
• Lars Strojny
• EvModder

Y'all are the real MVPs. 💖

---

😭 REPORTING BUGS 😭

Find a bug? Don't just scream into the void — report it here:

<https://github.com/nabijaczleweli/cargo-update/issues>

The devs will thank you, fr fr. 🙏

---

🌈 SEE ALSO 🌈

• <https://github.com/nabijaczleweli/cargo-update>

That's the main repo. Go explore, bestie. ✨

---

🎀 Sign-off time: This iconic page comes to you from the cargo-update developers, dated January 1980. Yes, that date is a whole mood. Stay slaying, and may your builds always compile on the first try. 💅💖✨