README.md
October 4, 2022 ยท View on GitHub
Amethyst
Amethyst is a fast, efficient and lightweight AUR helper and Pacman wrapper.
Made for Crystal, compatible with any Arch-based Linux distribution.
Basic usage
| Action | FreeBSD pkg-style alias | Pacman-style flags |
|---|---|---|
| Install a package | ame ins/install | ame -S |
| Remove a package | ame rm/remove | ame -R/-Rs |
| Upgrade a package | ame upg/upgrade | ame -Syu |
| Search for a package | ame sea/search | ame -Ss |
| Query the package list | ame qu/query | ame -Q |
| Show a package's info | ame inf/info | ame -Qi |
| Clean the pacman cache | ame cl/clean | ame -Sc |
| Check for .pacnew | ame di/diff | ame -D |
Exit codes overview
| Exit Code (i32) | Reason |
|---|---|
| 1 | Running ame as UID 0 / root |
| 2 | Failed creating paths |
| 3 | Could not find one or more required package dependencies |
| 4 | User cancelled package installation |
| 5 | Pacman error when installing package |
| 6 | Git error |
| 7 | Makepkg error |
| 8 | Failed to parse config file |
| 63 | Any other misc error |
Install on non-Crystal distros
sudo pacman -S --needed base-devel pacman-contrib cargogit clone https://github.com/crystal-linux-packages/amecd ame && makepkg -si
Debug/development builds
cargo build
Optimised/release builds
cargo build --release
TODO:
v3.6.0
Allow editing of PKGBUILDs before install