cargo-aur
cargo-aur is a new subcommand for cargo 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? cargo-aur itself is on the AUR! Install it with an AUR-compatible
package manager like aura:
sudo aura -A cargo-aur-bin
... or via cargo:
cargo install cargo-aur
Usage
Basics
Navigate to a Rust project, and run:
cargo aur
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: cargo-aur-bin 1.0.0-1 (Wed 10 Jun 2020 08:23:46 PM PDT)
==> Checking runtime dependencies...
==> Checking buildtime dependencies...
... etc ...
==> Finished making: cargo-aur-bin 1.0.0-1 (Wed 10 Jun 2020 08:23:47 PM PDT)
Notice that the built package itself is postfixed with -bin, which follows the
AUR standard.
At this point, it is up to you to:
- Create an official
Releaseon Github/Gitlab, attaching the original binary tarball thatcargo aurproduced. - Copy the PKGBUILD to a git repo that tracks releases of your package.
- Run
makepkg --printsrcinfo > .SRCINFO. - Commit both files and push to the AUR.
Some of these steps may be automated in cargo aur 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.
> cargo aur --musl
> cd target/x86_64-unknown-linux-musl/release/
> ldd <your-binary>
not a dynamic executable