AUR
jj-release can automatically update your AUR package after a successful
crates.io and Forge release. This step runs at the very end of the pipeline to
ensure the new source tarball is fully available for checksum calculation.
Prerequisites
- Feature flag:
jj-releasemust be built with thepublish-aur(orfull) feature:cargo install jj-release --features publish-aur. The AUR, COPR, and Nix packages include it already. - Tools:
gitandcurlmust be on yourPATH.makepkgis optional (see below), so this works from any Linux distro or macOS. - Authentication: your machine needs SSH access to
aur@aur.archlinux.org, the same setup you’d use to push to the AUR by hand.
Configuration
Add the [aur] table to your release.toml:
[publish.aur]
# Required: The exact name of your package on the AUR
package = "my-cli-tool"
# fail_on_error = false
# Optional: Override the default Git URL.
# Defaults to ssh://aur@aur.archlinux.org/{package}.git
# repo = "ssh://aur@aur.archlinux.org/custom-repo-name.git"
fail_on_errorcontrols whether an AUR failure aborts the release or just warns. Setfail_on_error = trueif you want a failure to be treated as fatal.
Pipeline Execution
When AUR publishing is enabled, jj-release executes the following sequence
after all other release steps succeed:
-
Clones your AUR package repository into a temporary directory.
-
Sets
pkgverin thePKGBUILDto the new version and resetspkgrelto1. -
Downloads each remote source with
curland recomputes its checksums (sha256sumsand/orb2sums). Downloads are retried briefly, since crates.io can take a few seconds to serve a newly published crate. -
Regenerates
.SRCINFOwithmakepkg --printsrcinfo. Ifmakepkgisn’t available, it updates the version, source, and checksum fields in.SRCINFOdirectly. -
Commits the changes as
Update to <version>and pushes to the AUR.
If the AUR package is already at the new version, this step is skipped, so rerunning after a partial failure is safe.
Limitations
- Only
sha256sumsandb2sumsare supported. Other checksum arrays and architecture-specific sources (source_x86_64) produce a clear error. - If you edit the
PKGBUILDby hand, regenerate.SRCINFOyourself before pushing. Withoutmakepkg,jj-releaseonly updates version-related fields.
Dry run
jj-release --dry-run shows what version the AUR package and COPR spec would be
bumped to, but does not clone, download, or modify anything. No SSH access or
network access is required for the dry run.