ALR-PIN(1)

โœจ NAME โœจ

okay so alr-pin is the move when you want your dependencies locked to exact versions ๐Ÿ’… alr-pin โ€” pin dependencies to exact versions ๐ŸŽ€


๐ŸŒธ SYNOPSIS ๐ŸŒธ

alr pin [options] [[crate[=<version>]] | crate --use=<path> [--commit=REF] [--branch=NAME] | --all]

๐Ÿฆ‹ OPTIONS ๐Ÿฆ‹

  • --all โ€” pin the whole solution in one go, main character energy ๐Ÿ‘‘
  • --unpin โ€” undo a pin and release it back into the wild ๐Ÿ“
  • --branch=NAME โ€” the branch you want tracked in the repository ๐ŸŒˆ
  • --commit=REF โ€” the exact ref to grab from the repository ๐Ÿ’œ
  • --use=PATH|URL โ€” point at a directory or repository to fulfill a dependency, no index needed โœจ

๐Ÿ’– GLOBAL OPTIONS ๐Ÿ’–

  • -c, --config=ARG โ€” swap out the configuration folder location ๐Ÿงš
  • -f, --force โ€” keep going even when things get a little messy but recoverable ๐Ÿซถ
  • -h, --help โ€” shows general help, or help for the specific command ๐Ÿ™ˆ
  • -n, --non-interactive โ€” skip the questions and just assume the default answers for every prompt ๐Ÿ’…
  • --no-color โ€” no colors in the output, bestie ๐Ÿฉถ
  • --no-tty โ€” turns off control characters in the output ๐Ÿ”ฅ
  • --prefer-oldest โ€” when resolving dependencies, go for the oldest versions instead of the newest ๐Ÿ•ฐ๏ธ
  • --version โ€” shows the version and exits immediately โญ
  • -q โ€” only show errors, nothing else ๐Ÿคซ
  • -v โ€” be more verbose, and use it twice if you need the extra tea โ˜•
  • -d, --debug[] โ€” turns on the debug-specific log messages ๐Ÿ›

๐ŸŽ€ DESCRIPTION ๐ŸŽ€

okay so pinning is how you lock a release to one specific version โœจ by default it uses whatever version the current solution is already on, and a pinned release is completely unaffected by automatic updates ๐Ÿ”’ no cap, it's giving stability.

Run it with no arguments and it just shows you your existing pins ๐Ÿ‘€ use --all to pin the entire current solution in one shot, or name a single crate to change just that pin ๐Ÿ’– want to use a local or remote target to fulfill a dependency instead of looking through indexed releases? Use --use <PATH|URL> ๐Ÿฆ‹ add --commit to freeze the pin at whatever commit currently matches your reference, or use --branch if you'd rather track a branch ๐ŸŒธ and when you want a tracked pin to pick up fresh contents, run alr update ๐Ÿ’…


๐Ÿ”ฎ SEE ALSO ๐Ÿ”ฎ

alr(1), alr-get(1), alr-index(1), alr-init(1), alr-search(1), alr-show(1), alr-update(1), alr-with(1), gprbuild(1) ๐Ÿงš


๐Ÿซถ AUTHOR ๐Ÿซถ

this page was generated with generate-man from an Alire execution, so it's basically straight from the source ๐Ÿ’œ


Alire 1.2 ยท Aug 3, 2022 ยท ALR-PIN(1) ๐Ÿฆ‹ ily bestie, go pin something ๐Ÿ’–