cargo-search2
A binary utility that provides a more convenient version of cargo search.
Installation
Grab pre-built binaries for your platform from the releases page.
To grab releases in CI or other automation:
curl -LsSf https://github.com/sunshowers/cargo-search2/releases/latest/download/cargo-search2-{platform}.zip | tar xzf - -C ~/.cargo/bin
Install manually:
cargo install cargo-search2
Examples
$ cargo search2 serde
# output:
serde 1.0.130 (hash: blake2b24:2e6117acae4f6f2d2d698c9fc0b43de60ac26556f44ad96b)
$ cargo search2 serde --message-format toml
serde = "1.0.130"
$ cargo search2 serde --message-format json
{"crate-name":"serde","version":"1.0.130","hash":"blake2b24:2e6117acae4f6f2d2d698c9fc0b43de60ac26556f44ad96b"}
# Get an exact version or semver range
$ cargo search2 serde --req '=1.0.120'
serde 1.0.120 (hash: blake2b24:f79131f50c298569f841e47287c3b0a443c29cfda3ffd475)
# Use --cache-version/-c to invalidate caches
$ cargo run -- serde --req '=1.0.120' -c1
serde 1.0.120 (hash: blake2b24:168778241e3b0e96f5547fba1eb4b4b84efa8291c3c14b37)
$ cargo run -- serde --req '=1.0.120' -c2
serde 1.0.120 (hash: blake2b24:344d8a8d08a16dbce8c4e0d90fd6aad513631ca081185ea8)
# Step outputs for GitHub Actions
$ cargo search2 serde --message-format github
::set-output name=crate-name::serde
::set-output name=version::1.0.120
::set-output name=hash::blake2b24:f79131f50c298569f841e47287c3b0a443c29cfda3ffd475
For an example GitHub Action, see .github/workflows/example.yml.
Why?
People sometimes use cargo search to generate cache keys for tools. This is an easier way to achieve the same goal with a couple more features.
cargo search2 supports:
- looking for exact versions and semver ranges
- producing results in plain, JSON, and GitHub Actions formats
- easy cache invalidation through the
--cache-versionoption
Hash contents
The hashes produced by cargo search2 are derived from:
- The name of the crate
- The exact version number
- The cache version
Notably, the operating system and other parts of the environment are not part of the hash.
Stability guarantees
Within a semver range, the command-line interface is append-only, and hashes stay the same.
Contributing
Pull requests are welcome! Please follow the code of conduct.
License
This project is available under the terms of either the Apache 2.0 license or the MIT license.
41 Dec 17, 2022
6 Aug 7, 2023
502 Nov 7, 2022
26 Nov 22, 2022
2 Jul 4, 2022
87 Dec 14, 2022
6 Nov 9, 2023
21 Dec 16, 2022
19 Dec 22, 2022
30 Mar 6, 2023
62 Dec 27, 2022
116 Dec 27, 2022
61 Dec 16, 2022
14 Jun 20, 2022
55 Jan 8, 2023
1.7k Jan 8, 2023
5 Aug 29, 2023
10 Sep 26, 2023
6 Oct 27, 2023
61 Dec 16, 2022
14 Jun 20, 2022
58 Dec 2, 2022
25 Jun 15, 2022
23 Aug 30, 2023
2.4k Dec 27, 2022
294 Dec 23, 2022
231 Jan 2, 2023
60 Dec 9, 2022
12 Dec 27, 2022