aurman - AUR helper with almost pacman syntax

aurman in the AUR

aurman (https://aur.archlinux.org/packages/aurman)

When encountering wrong behavior, consider opening issues in the GitHub repository to help improving the overall stability of aurman.

Warning

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't and will never be a replacement for the sometimes needed concept of "human interaction". If you ever encounter an issue whereby aurman e.g. is not able to find a dependency solution, and you do not know how to solve the problem either, 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 a Turing-complete user know what to do.

If you do not, do not use aurman.

Also: If you are already failing to install aurman, because you do not know e. g. 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 who fill out issues in a non-sensible way may be banned from this repository without further warning.

How to install

• https://wiki.archlinux.org/index.php/Arch_User_Repository
• https://wiki.archlinux.org/index.php/Makepkg
• https://wiki.archlinux.org/index.php/Pacman

Notice: The only supported way to install aurman, is to install it from the AUR. There are linux distributions, shipping prebuilt aurman versions, that is not supported in any 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 - Note: By default, aurman respects the presence of the Color option in pacman.conf.
• --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.

• --devel_skip_deps: Skips dependency checks when determining development packages versions (makepkg -odc instead of makepkg -oc) - see: https://github.com/polygamma/aurman/issues/245

• --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: -Ss just searches for AUR packages and -Sc cleans only the aurman cache.

• --repo: -Ss just searches for repo packages and -Sc cleans only the pacman cache.

• --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.

• --ignore_versioning: Assume all versioned dependencies to be fulfilled, even if the versions are known and they do not match.

• --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.

• --skip_new_locations: Skips being shown new locations of packages.

Config and cache directory

aurman conforms to the XDG Base Directory Specification:

• The configuration file is $XDG_CONFIG_HOME/aurman/aurman_config
• The cache directory used to remember internal state and to store downloaded AUR package sources is $XDG_CACHE_HOME/aurman/

Config Options

Command-line defaults

A number of aurman's command-line flags can be enabled by default, by listing them with the leading -- removed in the [miscellaneous] section. In a case of conflict between a command-line flag and a config option, the command-line flag always wins.

Available (example) defaults:

[miscellaneous]
keyserver=hkp://ipv4.pool.sks-keyservers.net:11371
show_changes
solution_way
do_everything
optimistic_versioning
ignore_versioning
skip_news
skip_new_locations

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

Notice: Use of optimistic_versioning is not recommended since this flag should only be used when needed.

Notice: Use of ignore_versioning is not recommended since this flag should only be used when needed.

Choose between multiple package sources

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

• Repository package as listed in the pacman.conf - see https://www.archlinux.org/pacman/pacman.conf.5.html#_repository_sections

The order of repositories in the configuration file 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

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 a non-default folder to