ALR-SEARCH(1)

📦 version 1.2.1, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ ALR-SEARCH(1) ✨

Heyyy bestie 🦋 this is the Alire manual page for alr-search, and I am obsessed. Let's get into it 💖

✨ NAME ✨

alr-search - search a string in release names and properties 💅

✨ SYNOPSIS ✨

alr search [options] <search term> | [--crates] [--full] --list

✨ OPTIONS ✨

  • --crates — restrict the search and output to crate names and descriptions 🌸
  • --external-detect — detect externally-provided releases (this implies --external) 🔍
  • --full — show every version of a crate, not just the newest one 🧚
  • --list — list all available releases 📋
  • --external — include externally-provided releases in the search 🦋
  • --property=TEXT — search TEXT in property values 🎀

✨ GLOBAL OPTIONS ✨

  • -c, --config=ARG — override the configuration folder location 🗂️
  • -f, --force — keep going even after a recoverable hiccup 💪
  • -h, --help — display general or command-specific help 🙋‍♀️
  • -n, --non-interactive — assume default answers for all user prompts 🤖
  • --no-color — disables colors in output 🩶
  • --no-tty — disables control characters in output 🚫
  • --prefer-oldest — prefer the oldest versions instead of the newest when resolving dependencies 🕰️
  • --version — show the version and exit 🏷️
  • -q — limit output to errors 🤫
  • -v — be more verbose (use it twice for extra detail) 🔊
  • -d, --debug[] — turn on debug-specific log messages 🐛

✨ DESCRIPTION ✨

Okay so this command searches for the given substring in crate names (or in properties, if you use --property), and shows the most recent release of each matching crate (unless you add --full). It's giving precision 🎯

If you just want a clean list of crate names and descriptions, use --crates. Otherwise you get the version, description, and release notes, plus a status column with these flags:

  • E — the release is externally provided. 🌍
  • S — the release is available through a system package. 📦
  • U — the release is not available on the current platform. 🚧
  • X — the release has dependencies that cannot be resolved. 💀

Wondering why something says U? Run alr show <crate>=<version> to find out the reasons for unavailability 🔎

Unresolvable releases (X) should not happen on platforms with assigned maintainers 🫶 The usual culprits are missing system dependencies that the platform has phased out but the community index hasn't been updated to reflect yet 😭

✨ SEE ALSO ✨

alr(1), alr-get(1), alr-index(1), alr-init(1), alr-pin(1), alr-show(1), alr-update(1), alr-with(1), gprbuild(1) 👑

✨ AUTHOR ✨

Generated with generate-man from Alire execution ✨

That's the whole tea, bestie! 🌈 This page is from Alire 1.2, dated Aug 3, 2022, and it's all about ALR-SEARCH(1) 💜 Go forth and search like the main character you are 💅🦋

📦 where this page comes from