/amethyst

Amethyst is a fast, efficient and lightweight AUR helper and Pacman wrapper. Made for Crystal, compatible with any Arch-based Linux distribution

Primary LanguageRustGNU General Public License v3.0GPL-3.0

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