/aurman

AUR Helper

Primary LanguagePythonMIT LicenseMIT

aurman - AUR helper with almost pacman syntax

aurman in the AUR

aurman-git (https://aur.archlinux.org/packages/aurman-git) - development version

aurman (https://aur.archlinux.org/packages/aurman) - release version

Notice: Even though it may seem like an AUR helper is targeted at inexperienced users, the opposite is the case. aurman is targeted at advanced users, who are familiar with pacman, makepkg and most of all with the AUR. aurman is an AUR helper, it can not and will never be a replacement for the sometimes needed human interaction. If you ever encounter a problem, at which aurman e.g. is not able to find a dependency solution, and you do not know either how to solve the problem, you should not use an AUR helper. Even though the specific problem may be a bug in the aurman implementation, it is always expected, that you as user will know what to do. If you do not, do not use aurman. Also: If you already failed to install aurman, because you do not know something like how to import PGP keys or how to fulfill aurman dependencies manually, you should not use aurman. Last but not least: The GitHub issues are not for support, they are only for feature requests, bug reports or general discussions. To reduce the noise by users, who should not use aurman, but still do, users may be banned from this repository without further warning if they fill out issues in a non sensible way.

Syntax

Usage

aurman < operation > [ options ] [ targets ] - see also https://www.archlinux.org/pacman/pacman.8.html

Description

aurman is a pacman wrapper. All pacman operations are supported, and calling aurman with an operation besides --sync or -S passes the arguments to pacman.

Native pacman options for --sync or -S that are passed to pacman:
  • -r, --root
  • -v, --verbose
  • --cachedir
  • --color
  • --debug
  • --gpgdir
  • --hookdir
  • --logfile
  • --noconfirm
  • --confirm
  • --overwrite
  • --asdeps
  • --asexplicit
  • --needed
  • --ignore
  • --ignoregroup
  • -s, --search
  • -i, --info
  • -u, --sysupgrade
  • -y, --refresh
  • -c, --clean
Native pacman options for --sync or -S that are also used by aurman:
  • --color - Notice: aurman respects by default, if Color is set in the pacman.conf or not.
  • --noconfirm
  • --needed
  • --ignore
  • --ignoregroup
  • -s, --search
  • -i, --info
  • -u, --sysupgrade
  • -c, --clean
Options for --sync or -S exclusive to aurman:

  • --noedit: Do not show changes of PKGBUILDs, .install, and other relevant files. It assumes you will be okay with the changes.

  • --always_edit: Edit the files of packages even when there are no new changes.

  • --show_changes: Show changes of PKGBUILDs, .install, and other relevant files without asking.

  • --devel: Fetch current development versions of packages to check if a new version is available.

  • --deep_search: Dependency solving will ignore currently fulfilled dependencies and try to solve the problem for systems with zero packages installed. If aurman is not able to find a solution, try re-running with this flag. It could take some time to find a solution.

  • --pgp_fetch: Fetch needed PGP keys without asking.

  • --keyserver: Specify a keyserver to fetch the PGP keys from.

  • --aur: Act on AUR packages only.

  • --repo: Act on regular repo packages only.

  • --domain: Change the base URL for AUR requests (https://aur.archlinux.org is the default).

  • --solution_way: Print what exactly will be done (order of installing/removing packages).

  • --holdpkg: Specify installed packages that must not be removed. Separate package names with space to specify more than one package.

  • --holdpkg_conf: Append packages from the pacman.conf to --holdpkg.

  • --do_everything: -u for repo packages will be handled by aurman and not pacman. May be useful if (1) the aurman config is used to fetch repo packages from other repos than they would normally be installed from or if (2) you want to confirm the installation of packages only once ("full batch interaction"). This is not recommended since the pacman call -Syu is executed in this order: split to -Sy, do calculations, and upgrade the system. With aurman handling -u, it still may result in a partial upgrade, not just because of splitting -Syu, but because the dependency solver of aurman may yield wrong results.

  • --optimistic_versioning: In case of an unknown version of a provider for a versioned dependency, assume that the dependency is fulfilled.

  • --rebuild: Always rebuild packages before installing them.

  • --sort_by_name: Sort -Ss AUR results by name.

  • --sort_by_votes: Sort -Ss AUR results by votes.

  • --sort_by_popularity: Sort -Ss AUR results by popularity.

  • --skip_news: Skips being shown unseen archlinux.org news.

Config

You may use the file aurman_config under $XDG_CONFIG_HOME/aurman (fallback to ~/.config/aurman in case of no $XDG_CONFIG_HOME) as config for aurman.

Config Options

Choose between multiple package sources

By default aurman assumes the following priorities in case of multiple available packages with the same names (high to low):

The order of repositories in the configuration files matters; repositories listed first will take precedence over those listed later in the file when packages in two repositories have identical names, regardless of version number.

  • AUR packages

Overriding this priority has to be done via the aurman config.

For AUR packages create a section [aur_packages] and list the names of the AUR packages.

For repo packages create a section [repo_packages] and list the names of the repo packages followed by = and the name of the repo.

Notice: These packages will be excluded from the pacman --sysupgrade by --ignore. Otherwise pacman would replace these packages.

Example:

[aur_packages]
aur_package_name
other_aur_package_name

[repo_packages]
repo_package_name=repo_one
other_repo_package_name=repo_two

PGP fetching keyserver

You may specify the keyserver for PGP fetching in the config instead of yielding it via commandline.

Notice: Commandline overrides config.

Create a key called keyserver in the section [miscellaneous].

Example:

[miscellaneous]
keyserver=hkp://ipv4.pool.sks-keyservers.net:11371

Disable notifications about packages that are not in known repos or the AUR

Create a key called no_notification_unknown_packages in the section [miscellaneous].

Example:

[miscellaneous]
no_notification_unknown_packages

You may also disable the notification for certain packages.

Create a section [no_notification_unknown_packages] and list the names of the packages.

Example:

[no_notification_unknown_packages]
package1_name
package2_name

Disable background sudo loop

Create a key called no_sudo_loop in the section [miscellaneous].

Example:

[miscellaneous]
no_sudo_loop

Set the preselected answer for the question: Do you want to see the changes of x? to yes.

Create a key called default_show_changes in the section [miscellaneous].

Example:

[miscellaneous]
default_show_changes

Notice: Not setting this option retains the default, which is no.

Ignore missing or incomplete arch fields in the build script, (passing -A to makepkg during package building)

Create a key called ignore_arch in the section [miscellaneous].

Example:

[miscellaneous]
ignore_arch

Set packages that are to be treated as development packages

List the names of the packages in the section [devel_packages].

Example:

[devel_packages]
package_name1
package_name2

Specify the folder to save aurman cache files

Create a key called cache_dir in the section [miscellaneous].

default: $XDG_CACHE_HOME/aurman (fallback to ~/.cache/aurman in case of no $XDG_CACHE_HOME).

Example:

[miscellaneous]
cache_dir=/tmp/aurman

Specify the timeout for AUR RPC requests (in seconds)

Create a key called aur_timeout in the section [miscellaneous].

Example:

[miscellaneous]
aur_timeout=10

Use --show_changes persistently without specifying via commandline

Create a key called show_changes in the section [miscellaneous].

Example:

[miscellaneous]
show_changes

Use --solution_way persistently without specifying via commandline

Create a key called solution_way in the section [miscellaneous].

Example:

[miscellaneous]
solution_way

Use --do_everything persistently without specifying via commandline

Create a key called do_everything in the section [miscellaneous].

Example:

[miscellaneous]
do_everything

Notice: This is not recommended since the usage of this flag is in general not recommended.

Use --optimistic_versioning persistently without specifying via commandline

Create a key called optimistic_versioning in the section [miscellaneous].

Example:

[miscellaneous]
optimistic_versioning

Notice: This is not recommended since that flag should only be used when needed.

Set interval in which to call sudo -v (sudo loop) (in seconds) (default is 120)

Create a key called sudo_timeout in the section [miscellaneous].

Example:

[miscellaneous]
sudo_timeout=120

Make use of the undocumented --ask flag of pacman

Create a key called use_ask in the section [miscellaneous].

Example:

[miscellaneous]
use_ask

Explanation: https://git.archlinux.org/pacman.git/commit/?id=90e3e026d1236ad89c142b427d7eeb842bbb7ff4

aurman will use --ask=4 if this config option is set. You will not have to confirm things like the installation of packages or the removal of conflicting packages again. "Again" - meaning again for pacman. You will still see the overview of aurman, which only predicts what will happen, and you will have to confirm unless --noconfirm was set. To make clear: aurman only predicts what will happen in every case. When using --ask=4, it may be possible that a conflict will not be detected by aurman. Hence, using --ask=4 may lead to unintended removal of package(s). All in all it comes down to: "redundant" confirmations of actions (less prone to errors) or "not redundant" confirmations of actions (more prone to errors).

Disable showing of archlinux.org news when not using --aur

Create a key called arch_news_disable in the section [miscellaneous].

Example:

[miscellaneous]
arch_news_disable

Features

  • Threaded sudo loop in the background so you only have to enter your password once.
  • Reliable dependency resolving.
  • Conflict detection.
  • Split package support.
  • Development package support.
  • Distinction between explicitly and implicitly installed packages.
  • Lets you see and edit all needed PKGBUILDs before starting AUR package building.
  • Fetching of needed PGP keys for package building.
  • Pacman --search for repo and AUR packages (results sorted by popularity).
  • Search function supports regex for searching the AUR the first span of at least two consecutive non-regex characters being used. These results will be filtered by the regex expression afterwards.
  • Differentiate between the sources of packages in case of identical names in different known repos and/or the AUR.
  • Show unread news from archlinux.org

Dependency solving description including benchmarks

https://github.com/polygamma/aurman/wiki/Description-of-the-aurman-dependency-solving

Using aurman just as a dependency solver

In order to discover available updates, search for potential packages to install and more, it is useful to get machine-readable descriptions of the potential sync/install/update transactions aurman can propose.

aurmansolver [options] answers this need, by providing a json desciption of the equivalent aurman [options] transaction, but without carrying out any changes.

One example use is with -Su, in order to list packages which have updates available.

See https://github.com/polygamma/aurman/wiki/Using-aurman-as-dependency-solver for a detailed explanation

FAQ

Question

aurman wants to remove packages that should not be removed - what's the matter?

Answer

Please check, if the problem arises, because aurman assumes .so dependencies to be unfulfilled. E.g. libavcodec.so=57-64 which requires a specific version of the mentioned .so. This may be the case because a providing AUR package only lists libavcodec.so as being provided without specifying the version. Hence aurman cannot be sure if the version will match, since this can only be known after building the package, thus assuming that the dependency is not fulfilled. You may change this behavior by yielding --optimistic_versioning via the commandline. Now, aurman will assume that the dependency will be fulfilled. However, you should make sure that the version you are installing is the needed one, otherwise the behavior of those packages will be undefined.

This behavior may also occur when there are no .so dependencies involved. Check if the dependencies are really fulfilled. If they are not, because you forced installations of packages with pacman -d, this behavior is explicitly wanted. It warns you about broken package dependencies in the system. To remove this output of aurman you will have to fulfill the dependencies.

Notice: aurman will never remove packages on its own. aurman just predicts what will happen.

Question

How do I change the editor used by aurman for editing PKGBUILDs etc.?

Answer

aurman uses the environment variables VISUAL and EDITOR, hence you will have to change these variables.

If VISUAL is set, aurman uses this,

else if EDITOR is set, aurman uses this,

else aurman resorts to /usr/bin/nano.

Question

How to install packages whose names are saved in a file with aurman?

Answer

You may run commands like: aurman -S $(cat ~/packages_names.txt | xargs).

Question

Does aurman support ignoring packages and groups via the pacman.conf?

Answer

Yes.

Question

I get a UnicodeEncodeError or a UnicodeDecodeError when executing aurman - how to fix it?

Answer

See: polygamma#88.

Question

I am using Arch ARM and I am getting expac errors when executing aurman, what to do?

Answer

see: polygamma#200

tl;dr - install the latest expac-git version from the AUR and everything works

Question

How to achieve full batch interaction with aurman?

Answer

Use --do_everything and --ask via the aurman config.

--do_everything for 2* and --ask for 3* as listed here

But there are downsides to this. See the description of --do_everything here and the description of --ask here.

Screenshots