Home

The Alire project

The Ada Library Repository, a package manager for the Ada language.

This wiki is currently tailored to project developers or contributors.

Index format

https://github.com/alire-project/alire/blob/master/doc/catalog-format-spec.rst

In other related projects

• Arduino Library Manager: https://github.com/arduino/Arduino/wiki/Arduino-IDE-1.5:-Library-specification
• Rust's Cargo: https://doc.rust-lang.org/cargo/reference/manifest.html
• OCaml's opam: https://opam.ocaml.org/doc/Packaging.html

Glossary

Current meaning of terms that appear in the documentation and codebase.

• Crate: An Alire-indexed bundle of code. Depending on context:
  • The name (and primary key) with which a bunch of software is packaged into Alire (e.g. alr get <crate>)
  • Everything that is fetched by alr (the contents in the folder resulting from e.g. alr get, or in a downloaded dependency -- See also "session"). Should be a mirror of a remote repository or zip file (any supported origin). folder).
• Index: A collection of references to crates. Stored as toml files. Default community index found at https://github.com/alire-project/alire-index
• Package: An Ada package.
• Project file: A GPR project file within a crate. A crate may contain many of these (alr show).
• Sandbox: A folder containing several crates, either dependencies of one another or not. What would be a Python virtualenv. NOT YET IMPLEMENTED.
• Session: A folder that alr recognizes as containing a crate (and its dependencies). Either the result of alr get or alr init. Contains a top-level alire folder with all alr metadata:
  • Crate description file (crate-name.toml)
  • Aggregate GPR project for building (alr_build.gpr).
  • A folder containing dependencies (cache/deps).