---
name: "alr-with"
section: "1"
platform: "linux"
package: "alire"
version: "1.2.1-2.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/alr-with"
---

# alr-with(1)

Manage release dependencies

## 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/1.md)*, *[alr-get(1)](/alr-get/1.md)*, *[alr-index(1)](/alr-index/1.md)*, *[alr-init(1)](/alr-init/1.md)*, *[alr-pin(1)](/alr-pin/1.md)*, *[alr-search(1)](/alr-search/1.md)*, *[alr-show(1)](/alr-show/1.md)*, *[alr-update(1)](/alr-update/1.md)*, *[gprbuild(1)](/gprbuild/1.md)*

## AUTHOR

Generated with generate-man from Alire execution