table of contents
| ALR-WITH(1) | Alire manual | ALR-WITH(1) |
NAME¶
alr-with - Manage release dependencies
SYNOPSIS¶
alr with [options] [{ [--del] <crate>[versions]... | --from <gpr_file>... | <crate>[versions] --use <path> [--commit REF] [--branch NAME]} ] | --solve | --tree | --versions
OPTIONS¶
- --del
- Remove given dependencies
- --from
- Use dependencies declared within GPR project file
- --graph
- Show ASCII graph of dependencies
- --branch=NAME
- Branch to track in repository
- --commit=REF
- Commit to retrieve from repository
- --use=PATH|URL
- Add a dependency pinned to some external source
- --solve
- Show complete solution to dependencies
- --tree
- Show complete dependency tree
- --versions
- Show version status of dependencies
GLOBAL OPTIONS¶
- -c, --config=ARG
- Override configuration folder location
- -f, --force
- Keep going after a recoverable troublesome situation
- -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 oldest versions instead of newest when resolving dependencies
- --version
- Displays version and exits
- -q
- Limit output to errors
- -v
- Be more verbose (use twice for extra detail)
- -d, --debug[]
- Enable debug-specific log messages
DESCRIPTION¶
Inspect and manage dependencies.
Inspecting dependencies¶
Run without arguments prints current dependencies. Use --solve to print the solution in use for these dependencies.
Adding dependencies from the command line¶
Dependencies are added by giving their name, and removed by using the --del flag. Dependencies cannot be simultaneously added and removed in a single invocation.
Adding dependencies pinned to external sources¶
When a single crate name is accompanied by an --use PATH|URL argument, the crate is always fulfilled for any required version by the sources found at the given target. An optional reference can be specified with --commit; the pin will be frozen at the commit currently matching the reference. Alternatively, a branch to track can be specified with --branch. Use `alr update` to refresh the tracking pin contents.
Adding dependencies from a GPR file¶
The project file given with --from will be scanned looking for comments that contain the sequence 'alr with'. These will be processed individually as if they had been given in the command line, starting with no dependencies. That is, only dependencies given in the GPR file will be preserved. Example of GPR file contents: with "libhello"; -- alr with libhello Version selection syntax (global policy applies within the allowed version subsets):
crate Newest/oldest version
crate=version Exact version
crate^version Major-compatible version
crate~version Minor-compatible version
SEE ALSO¶
alr(1), alr-get(1), alr-index(1), alr-init(1), alr-pin(1), alr-search(1), alr-show(1), alr-update(1), gprbuild(1)
AUTHOR¶
Generated with generate-man from Alire execution
| August 3, 2022 | Alire 1.2 |