anda is both an executable binary that can be run, and a library that can be used in Rust programs.

Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install anda

It will make the anda command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall anda uninstalls.

Adding `anda` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add anda

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

anda = "0.4.7"

The anda library will be automatically available globally. Read the anda library documentation.

Back to the crate overview.

Readme

Andaman Project

Andaman

Andaman is a package build toolchain written in Rust. It is designed to simplify building various types of packages.

It is inspired by umpkg and aims to be a more modern and flexible alternative. It is also designed for monorepos in mind, so you can define multiple projects with multiple package formats in a single repository.

You can look into the Fyra Wiki page and the Terra Devdocs for more technical details.

Installation

On systems with Terra, you can install it with sudo dnf5 in anda (or dnf).

On systems with Cargo, you can install it with cargo install anda.

Alternatively you can also manually download the sources from GitHub:

git clone https://github.com/FyraLabs/anda
cd anda
git checkout 0.1.18
cargo install --path .

How it works

Andaman is simply a meta-build system that calls upon other build systems to build and distribute packages. It works by reading a project manifest in anda.hcl and then calling the appropriate build system to build the package.

Features

Building RPMs
Building Docker/Podman/OCI images
Building Flatpak packages

How we use it at Fyra Labs

We use Andaman to quickly build packages for our distributions, Ultramarine Linux and TauOS. Another notable usage is the Terra repository, which provides more than 1000 packages for Fedora-based distributions. The artifacts generated by Andaman are then sent to Subatomic, our compose and repository manager.

History

The Andaman project has gone through many forms. We initially wrote Andaman as a custom RPM frontend as an alternative to DNF that is similar to that of an AUR helper. However, there were issues with rust and RPM support and we decided to move to a more general CI server based on BuildKit. This however turned into a massive feature creep of projects and so we decided to simply write a build system that can build artifacts for various package formats.

Installing the command-line executable

Adding anda library as a dependency

Adding `anda` library as a dependency