#arch-linux

app aur-cli-git

Prepare Rust projects to be released on the Arch Linux User Repository

1 unstable release

0.1.3 Jul 1, 2023

#78 in #arch-linux

MIT license

1MB
372 lines

aur_cli

Crates.io Rust license

aur_cli is a CLI that produces a release tarball and PKGBUILD file for a Rust project, so that it can be released on the Arch Linux User Repository (AUR).

No extra configuration is necessary. As long as your Cargo.toml has the usual fields, a PKGBUILD will be generated with all the necessary sections filled out.

Installation

Guess what? aur_cli itself is on the AUR! Install it with an AUR-compatible

yay -S aur_cli

... or via cargo:

cargo install aur_cli

Usage

Basics

Navigate to a Rust project, and run:

aur_cli

This will produce a foobar-1.2.3-x86_64.tar.gz tarball and a PKGBUILD.

If you wish, you can now run makepkg to ensure that your package actually builds.

> makepkg
==> Making package: aur_cli-bin 1.0.0-1 (Wed 10 Jun 2020 08:23:46 PM PDT)
==> Checking runtime dependencies...
==> Checking buildtime dependencies...
... etc ...
==> Finished making: aur_cli 1.0.0-1 (Wed 10 Jun 2020 08:23:47 PM PDT)

At this point, it is up to you to:

  1. Create an official Release on Github/Gitlab, attaching the original binary tarball that aur_cli produced.
  2. Copy the PKGBUILD to a git repo that tracks releases of your package.
  3. Run makepkg --printsrcinfo > .SRCINFO.
  4. Commit both files and push to the AUR.

Some of these steps may be automated in aur_cli at a later date if there is sufficient demand.

Custom Binary Names

If you specify a [[bin]] section in your Cargo.toml and set the name field, this will be used as the binary name to install within the PKGBUILD.

depends and optdepends

If your package requires other Arch packages at runtime, you can specify these within your Cargo.toml like this:

[package.metadata]
depends = ["nachos", "pizza"]
optdepends = ["sushi", "ramen"]

And these settings will be copied to your PKGBUILD.

Static Binaries

Run with --musl to produce a release binary that is statically linked via MUSL.

> aur_cli --musl
> cd target/x86_64-unknown-linux-musl/release/
> ldd <your-binary>
    not a dynamic executable

Dependencies

~4–15MB
~156K SLoC