alr - Ada Library Repository
alr [global options] <command> [command options]]
[<arguments>]
Alire is a source-based package manager for the Ada and SPARK programming
languages.
It is a way for developers to easily build upon projects (libraries or programs)
shared by the community, but also to easily share their projects for others to
build upon.
In the Alire vocabulary, sources of projects/libraries/programs are provided by
what is called a
crate. A crate can depend on crates, and other crates
can depend on it. For instance, the
libgpr crate depends on the
xmlada crate.
Crates can have multiple dependencies, themselves having multiple dependencies.
This forms a dependency graph. Alire's main task is to automatically fetch,
build and upgrade the crates of the dependency graph so you don't have to do
it by hand.
The main interface into the
Alire ecosystem is a command line tool called
alr.
Command aliases can be defined in local or global configuration.
For example the following command: "$ alr config --set --global alias.graph
'show --graph'" Defines a global alias for the 'show' command with a
--graph switch.
"$ alr graph" is equivalent to "alr show --graph"
Identifiers for crates and indexes must use lowercase alphanumeric characters
from the latin alphabet. Underscores can also be used except as the first
character.
Length must be of 3 to 64 characters.
Alire indexes binary releases of GNAT and gprbuild. The compilers are indexed
with their target name, e.g., gnat_native or gnat_riscv_elf.
Use alr toolchain --help to obtain information about toolchain management. Alire
can be configured to rely on a toolchain installed by the user in the
environment, or to use one of the indexed toolchains whenever possible.
Some crates may override the default toolchain by specifying dependencies on
particular compiler crates, for example to use a cross-compiler. In this
situation, a compiler already available (selected as default or already
installed) will take precedence over a compiler available in the catalog.
See also
https://alire.ada.dev/docs/#toolchains for additional details about
compiler dependencies and toolchain interactions.
alr-get(1),
alr-index(1),
alr-init(1),
alr-pin(1),
alr-search(1),
alr-show(1),
alr-update(1),
alr-with(1),
gprbuild(1)
Generated with generate-man from Alire execution