Logo

Amethyst


License GitHub issues GitHub pull requests
Discord The maintainer of this repository
Mastodon Follow Twitter Follow

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 cargo` - `git clone https://github.com/crystal-linux/pkgbuild.amethyst` - `cd pkgbuild.amethyst && makepkg -si`
#### Debug/development builds - `cargo build` #### Optimised/release builds - `cargo build --release` ### TODO: #### v3.6.0 - ~~Allow editing of PKGBUILDs before install~~