release: v0.12.0

[github-actions]

This is a release PR for version 0.12.0.

Use squash merge.
Upon merging, this will automatically build the CLI and create a GitHub release.
You still need to manually publish the cargo crate.

$ git pull
$ git checkout v0.12.0
$ cargo publish

---

Edit release notes into the section below:

Release notes

Binstall is a tool to fetch and install Rust-based executables as binaries. It aims to be a drop-in replacement for cargo install in most cases. Install it today with cargo install cargo-binstall, from the binaries below, or if you already have it, upgrade with cargo binstall cargo-binstall.

In this release:

• If a crate is already installed and its version is the same as would be installed, we now skip installing it, mirroring cargo-install's behaviour. A new --force option lets you do it anyway. (Skip if already installed and add new cmdline option --force #282)
• Binstall writes to its own specific metafile format in $CARGO_HOME/binstall/crates-v1.json for global installs. This new format is better suited to binstall over the .crates2.json data, and lets both Binstall itself and third party tools if they so wish have access to installation information. The classic .crates.toml is still written to too. (Feature: Create metafile format for cargo-binstall #252)
• We now live in the cargo-bins GitHub organisation. This will let us fork some unmaintained projects that we use in here, and perhaps bring other cargo tools under this umbrella. (Move to an org and fork some crates #251)

Other changes:

• New: -V to print version. (Deprecate --version and add support for -v #248, Add -V, clean up errors and help text #259)
• New: --quiet as an alias to --log-level=off. (Improve doc of cmdline option log_level, add --quiet and pass it to cargo-install #281, Fix passing --quiet to cargo-install #283)
• Improved: --manifest-path can take both a crate folder path and a Cargo.toml's path. (Add -V, clean up errors and help text #259)
• Improved: --log-level=off (or --quiet) also passes --quiet to cargo-install when installing from source. (Improve doc of cmdline option log_level, add --quiet and pass it to cargo-install #281, Fix passing --quiet to cargo-install #283)
• Fix: show help when no arguments are provided. (Help doesn't show when invoking with no arguments #244, Print out help when crate_names is empty #245)
• Fix: $CARGO_HOME and the .crates.toml metafile will be created if they don't exist yet. (Memory corruption(? well, probably not; random name though) -> inscrutable error on plain unpack #267, Fix #267 #276)
• Fix: specifying duplicate crates is now handled properly, with the latter specification being used. (Fix repeated crates on batch installation: Dedup them and only keep the last one #264)
• Doc: possible values of --log-level are listed out. (Improve doc of cmdline option log_level, add --quiet and pass it to cargo-install #281)
• Doc: the readme has been streamlined for the use case, rather than the support case (adding binstall configuration to your crate), which has moved to its own dedicated page. (split docs, first step towards simplifying support instructions #284)

Plus many performance and CI/CD optimisations.

[passcod]

I think with #282 and #284 this should be enough for a release. I'm not going to get to finishing my UI work this weekend, so it will go in the next.

[NobodyXu]

@passcod You forgot to cargo publish the crate.

[passcod]

Was doing something else. You can publish too, you know :)

[NobodyXu]

Was doing something else. You can publish too, you know :)

OH I forgot I got access to crates.io :D