AUR helpers: Difference between revisions

From ArchWiki
(reword intro sentence)
(merge warning and move after into)
Line 8: Line 8:
[[ru:AUR helpers]]
[[ru:AUR helpers]]
[[zh-hans:AUR helpers]]
[[zh-hans:AUR helpers]]
{{Warning|1=AUR helpers are '''not''' [https://bbs.archlinux.org/viewtopic.php?pid=828310#p828310 supported] by Arch Linux. You should become familiar with the [[Arch User Repository#Installing packages|manual build process]] in order to be prepared to troubleshoot problems.}}
{{Note|Do not edit this article prior to discussion in [[Talk:AUR helpers]].}}
{{Note|Do not edit this article prior to discussion in [[Talk:AUR helpers]].}}


Line 15: Line 14:
In most cases packages installed from the AUR are not checked for updates by [[pacman]]; thus some helpers check the AUR for updates and automate the re-build process. However, keep in mind that a rebuild of an AUR package, or any other packages built and installed locally, may be required when shared libraries are updated, not just when the package is updated.
In most cases packages installed from the AUR are not checked for updates by [[pacman]]; thus some helpers check the AUR for updates and automate the re-build process. However, keep in mind that a rebuild of an AUR package, or any other packages built and installed locally, may be required when shared libraries are updated, not just when the package is updated.


Since AUR helpers are unsupported, they are not present in the [[official repositories]].
{{Warning|1=<nowiki></nowiki>
* AUR contains user produced content, therefore AUR helpers are [https://bbs.archlinux.org/viewtopic.php?pid=828310#p828310 forbidden] for inclusion in [[official repositories]].
* You need to get familiar with [[Arch User Repository#Installing packages|manual build process]] to install your first package from AUR, effectively troubleshoot problems or ask for help in the community.}}


== Legend ==
== Legend ==

Revision as of 23:53, 27 September 2018

Note: Do not edit this article prior to discussion in Talk:AUR helpers.

AUR helpers automate certain tasks for using the Arch User Repository. Most of AUR helpers can search for packages in AUR and fetch their PKGBUILDs – others additionally assist with build and install process.

In most cases packages installed from the AUR are not checked for updates by pacman; thus some helpers check the AUR for updates and automate the re-build process. However, keep in mind that a rebuild of an AUR package, or any other packages built and installed locally, may be required when shared libraries are updated, not just when the package is updated.

Warning:
  • AUR contains user produced content, therefore AUR helpers are forbidden for inclusion in official repositories.
  • You need to get familiar with manual build process to install your first package from AUR, effectively troubleshoot problems or ask for help in the community.

Legend

The columns have the following meaning:

File review
Does not source the PKGBUILD at all by default; or, alerts the user and offers the opportunity to inspect the PKGBUILD manually before it is sourced. Some helpers are known to source PKGBUILDs before the user can inspect them, allowing malicious code to be executed. Optional means that there is a command line flag or configuration option to prevent the automatic sourcing before viewing.
Diff view
Ability to view package differences on inspection. Besides the PKGBUILD, this includes changes to files such as .install or .patch files.
Git clone
Uses git-clone(1) by default to retrieve build files from the AUR.
Reliable parser
Ability to handle complex packages by using the provided metadata (RPC/.SRCINFO) instead of PKGBUILD parsing, such as aws-cli-gitAUR.
Reliable solver
Ability to correctly solve and build complex dependency chains, such as ros-lunar-desktopAUR.
Split packages
Ability to correctly build and install:
  • Multiple packages from the same package base, without rebuilding or reinstalling multiple times, such as clionAUR
  • Split packages which depend on a package from the same package base, such as libc++AUR and libc++abiAUR.
  • Split packages independently, such as python-pyalsaaudioAUR and python2-pyalsaaudioAUR.
Clean build
Does not export new variables that can prevent a successful build process.
Batch interaction
Ability to prompt before the build process, in particular:
  1. Inspection of package files or their differences;
  2. Summary of package upgrades;
  3. Resolution of package conflicts and installations.
An asterisk denotes functionality specifically enabled by the user.
Shell completion
Tab completion is available for the listed shells.
Note:
  • Table rows are sorted by column values, where Yes or N/A take precedence over Partial or Optional and No, or alphabetically if values are equal.
  • Optional means that a feature is available, but only through a command-line argument or configuration option. Partial means that a feature is not fully implemented, or that it partially deviates from the given criteria.

Search-only

Name Written in File review Git clone Reliable parser Reliable solver Shell completion Specificity
pbgetAUR Python Yes Yes Yes
yaahAUR Bash Yes Optional Yes bash
auracle-gitAUR C++ Yes No Yes Yes print build order
cowerAUR C Yes No Yes bash, zsh regex support, sort by votes/popularity
package-queryAUR C Yes No
repoctlAUR Go Yes No Yes zsh local repository support
aurelAUR
(discontinued)
Emacs Lisp Yes No Yes Emacs integration

Build and search

Name Written in File review Diff view Git clone Reliable parser Reliable solver Split packages Clean build Batch interaction Shell completion Specificity
aurutilsAUR Bash/C Yes Yes Yes Yes Yes Yes Yes 1 zsh vifm, local repository, package signing, clean chroot support, sort by votes/popularity
bauerbillAUR Python Yes No Yes Yes Yes Yes Yes 1 bash, zsh trust management, ABS support, extends powerpill, bb-wrapper for pacman wrapping
PKGBUILDerAUR Python Optional No Yes Yes Yes Partial Yes 1* automatic builds by default, use -F to disable; multilingual, pb-wrapper for pacman wrapping
naamanAUR Python Optional No Yes Yes Partial Partial Yes 1* bash automatic builds by default, use --fetch to disable; use -d to enable the solver
repofishAUR Bash Optional Yes Yes No No No Yes 1* automatic builds by default, use check or update to disable; local repository support
aurgetAUR Bash Optional No No No No No Yes bash, zsh sort by votes
spinachAUR
(discontinued)
Bash Yes No No No No No Yes
burgaurAUR
(discontinued)
Python/C Optional No No No No No Yes wrapper for cower

Pacman wrappers

See also pacman/Tips and tricks#Pacman wrappers.

Warning: pacman(8) wrappers abstract the work of the package manager. They may (optionally or by default) introduce unsafe flags, or other unexpected behavior leading to a defective system.
Name Written in File review Diff view Git clone Reliable parser Reliable solver Split packages Clean build Unsafe flags Batch interaction Shell completion Specificity
pakkuAUR Nim Yes Yes Yes Yes Yes Yes Yes -Sy 1 bash, zsh ABS support, AUR comments, fetch PGP keys
pikaurAUR Python Yes Yes Yes Yes Yes Yes Yes -Sy 1, 2, 3 bash, fish, zsh dynamic users, multilingual, sort by votes/popularity, print news, ignore errors
yayAUR Go Yes Yes Yes Yes Yes Yes Yes -Sy*
--ask*
1, 2*, 3* bash, fish, zsh fetch PGP keys, sort by votes/popularity, prompt architecture
trizenAUR Perl Yes Yes Yes Yes Yes Partial Yes -Ud* 1* bash, fish, zsh automatic builds by default, use -G to disable; AUR comments
auraAUR Haskell Optional Partial No Yes No No Yes 1* bash, zsh automatic builds by default, use --dryrun to disable; downgrade support, multilingual
aurmanAUR
(no user support)
Python Yes Yes Yes Yes Yes Yes Yes -Sy*
--ask*
1, 2*, 3* bash, fish fetch PGP keys, sort by votes/popularity, print news
pacaurAUR
(discontinued)
Bash/C Yes Yes Yes Yes Yes Yes Yes -Ud
--ask
1, 3 bash, zsh multilingual, sort by votes/popularity
wrapaurAUR
(stalled)
Bash Yes No Yes No No No Yes mirror updates, print news and AUR comments
packer-aurAUR
(stalled)
Bash No No No No No No Yes
yaourtAUR
(stalled)
Bash/C No Optional Optional No No No No -Sy 2 bash, fish, zsh ABS support, print AUR comments, multilingual

Graphical

See also pacman/Tips and tricks#Graphical front-ends.

Warning:
  • Graphical AUR helpers are typically aimed at Arch-based distributions. Their use in Arch Linux may lead to a defective system, for example through unattended partial upgrades.
  • If a helper has known problematic behavior, it is colored with a red entry.
Name Written in GUI toolkit Backend helper Notes
aarchupAUR C GTK+ 2 auracle
argonAUR Python GTK+ 3 auracle, pacaur
cylonAUR Bash TUI auracle, trizen
kaluAUR C GTK+ 3
pactrayAUR Python GTK+3 auracle
pamac-aurAUR Vala GTK+ 3 Uses libalpm(3) instead of pacman(8)
pakku-guiAUR Python GTK+ 3 pakku
pkgbrowserAUR Python Qt 5
updatehintAUR Bash GTK+ 3 auracle
octopiAUR C++ Qt 5 trizen, pacaur, yaourt enabled on install notifier service regularly performs partial upgrades

Libraries

  • haskell-archlinux — Library to access the AUR and package metadata from the Haskell programming language.
http://hackage.haskell.org/package/archlinux || haskell-archlinuxAUR
  • python3-aur — Python 3 modules for accessing AUR package information and automating AUR interactions.
http://xyne.archlinux.ca/projects/python3-aur || python3-aurAUR

Maintenance

  • aur-out-of-date — Uses hoster APIs to check AUR packages for upstream changes.
https://github.com/simon04/aur-out-of-date || aur-out-of-dateAUR
  • pkgbuild-watch — Looks for changes on the upstream web pages.
http://kmkeen.com/pkgbuild-watch || pkgbuild-watchAUR
  • pkgbuildup — Helps AUR package maintainers automatically update PKGBUILD files. Supports a template variable syntax.
https://github.com/fasheng/pkgbuildup || pkgbuildup-gitAUR
  • pkgoutofdate — Parses the source URL from PKGBUILDs and tries to find new versions of packages by incrementing the version number and sending requests to the web server.
https://github.com/anatol/pkgoutofdate || pkgoutofdate-gitAUR

Uploading

  • aur4_import.sh — Splits a package from a git repository with multiple packages, adding/updating .SRCINFO for every commit
  • aur4_make_submodule.sh — Replaces a package in a bigger git repository with an AUR 4 submodule, including .SRCINFO
  • aurpublish — Helper script to manage and upload AUR packages using git-subtree(1). Uses githooks(5) to verify the PKGBUILD integrity, generate .SRCINFO automatically, and create a commit message template.
https://github.com/eli-schwartz/aurpublish || aurpublish