README.md

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 cargo
• git clone https://github.com/crystal-linux-packages/ame
• cd ame && makepkg -si

Debug/development builds

• cargo build

Optimised/release builds

• cargo build --release

TODO:

v3.6.0

• Allow editing of PKGBUILDs before install