Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rmarquis/pacaur

[unmaintained] An AUR helper that minimizes user interaction
https://github.com/rmarquis/pacaur

arch archlinux aur aur-helper helper pacaur pacman shell

Last synced: 3 months ago
JSON representation

[unmaintained] An AUR helper that minimizes user interaction

Awesome Lists containing this project

README 

        
=encoding utf8



=head1 NAME



pacaur - an AUR helper that minimizes user interaction



=head1 SYNOPSIS



Usage: I EoperationE [ options ] [ target(s) ]



=head1 DESCRIPTION



Pacaur is an Arch User Repository (AUR) helper aiming at speed and simplicity

and is designed to minimize user prompt interaction. It uses an uncluttered

interface and makes use of the full secured RPC interface to solve the dependency

tree. It will also automatically prompt for sudo access when needed. It is built

upon the well designed cower and expac C backends.



Invoking pacaur consists of supplying an operation, any applicable options, and

usually one or more targets. A I is usually a package name or a search

string.



=head1 USERBASE TARGET



Pacaur is targeted at B who want some degree of automation for

repetitive tasks. As such, the user is expected to be familiar with the AUR

manual build process with makepkg and its configuration options, as well as

being knowledgeable about sudo and gpg configuration.



Two sets of command line options are provided: commands which call the pacman

binary and extend it with AUR functions B<(-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc)>,

and commands which are AUR specific B<(sync, search, info, buildonly,

upgrade, check, clean, cleanall)>. As such, pacaur can be used by users

who prefer to have a single tool to manage the official and AUR repositories, or

by users who prefer to keep their AUR frontend separated from pacman.



=head1 OPERATIONS



=head2 Pacman extension operations



=over 4



=item B<-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc>



Pacaur wraps all B and by default extends respectively its

sync, search, info, download only, system upgrade, upgrades check, clean and

clean all functions to the AUR. This extension behavior is optional and can be

disabled with the I variable in the config file. Pacaur will also pass

any other pacman operations and their related options to the pacman binary.



=back



=head2 AUR specific operations



=over 4



=item B



Clone build files, build and install I. Missing dependencies will be

automatically installed as needed.



=item B



Search for packages with the I as the search term(s). Queries with

multiple targets will return the result of the intersection of all query

results. Extended regex patterns as defined by POSIX are allowed.

The output will display the name, version, votes and popularity values of each

package. The flagged status will also be indicated by a  symbol or a colored

version string if colored output is enabled.



=item B



Show info for I.



=item B



Clone build files and build I. Missing dependencies will be installed

as needed for the build process, and removed automatically afterwards.



=item B



Update foreign packages in the AUR. Without any arguments, all manually

installed packages will be upgraded. If I are supplied, only those

packages will be upgraded.



=item B



Check foreign packages for upgrades in the AUR. Without any arguments, all

manually installed packages will be checked. If I are supplied, only

those packages will be checked.



=item B



Clean foreign packages and clones. Offer to remove all non locally installed

built packages from defined I cache, all non development files from

defined I cache, and all uninstalled clones from AUR clones directory.

If I are supplied, only those specific clones will be removed.



=item B



Clean all foreign packages and clones. Offer to remove all built packages from

defined I, all sources in defined I, and all local clones from

clones directory.



=back



=head2 General operations



=over 4



=item B<-v, --version>



Display version and quit.



=item B<-h, --help>



Display the help message and quit.



=back



=head1 OPTIONS



=head2 Pacman extension options



=over 4



=item B<-a, --aur>



When used with pacman extended operations, only search, build, install, upgrade

or clean I from the AUR. When combined with I<-Syu>, only the I<-Sy>

operation is run for the repositories.



=item B<-r, --repo>



When used with pacman extended operations, only search, build, install, upgrade

or clean I from the repositories.



=back



=head2 General options



=over 4



=item B<-e, --edit>



Edit build files when cloning or building I. Overrides the

I config option and always fully shows the build files.

Can also be used as a standalone command.



=item B<-q, --quiet>



Show less information for search and query operations. Search will only show

package names and not version, group, and description information.



=item B<--devel>



When used with upgrade and check operations, also consider AUR development

packages. Supported are I, I, I, I, I and I

development packages, as well as I and I build packages.



=item B<--foreign>



When used with buildonly, sync and upgrade operations, also consider already

installed foreign dependencies when solving the dependency tree.



=item B<--ignore> I



Ignore a I upgrade. Can be used more than once. Also accepts a comma

delimited list as a single argument. Packages listed in pacman and cower's

I directive are honored.



=item B<--needed>



Do not reinstall I that are already up-to-date. The build of

development packages that are found up-to-date after the source checkout will

be skipped. Supported are I, I, I and I development

packages, as well as I and I build packages.



=item B<--noconfirm>



Perform commands without confirmation from the user.



=item B<--noedit>



Perform commands without editing any installation files. Overrides the

I<--edit> option.



=item B<--rebuild>



Always rebuild packages regardless of any existing file in I<$PKGDEST> directory,

and regardless of up-to-date status of development packages.



=item B<--silent>



Silence output. This will send the output of each packaging functions to text

files in the clone directory named I.

Additional pacman output for providers and cached packages installation will

also be hidden.



=back



=head2 Search options



=over 4



=item B<--by> 



When searching the AUR, search by I where I is B, B,

or B to search for packages by their name, name and description, or by

the package maintainer, respectively. The default is to search by name-desc.



=item B<--ignore-ood>, B<--no-ignore-ood>



When searching the AUR, ignore all results marked as out of date or do not ignore

results marked as out of date, respectively. The default is to not ignore results

marked as out of date. This can be changed with the I option in the

cower config file.



=item B<--literal>



When searching the AUR, disable regex search and interpret target as a literal

string.



=item B<--sort> , B<--rsort> 



When searching the AUR, sort the results in ascending or descending order,

respectively, by I where I is B, B or B.



=back



=head2 Other options



=over 4



=item B<--domain> 



Point at a domain other than the default I.



=back



=head1 CONFIG FILE



=over 4



=item B



Pacaur honors a system-wide config file which will be looked for first at



  $XDG_CONFIG_DIRS/pacaur/config



and falling back to



  /etc/xdg/pacaur/config



=item B



User-defined configuration files overriding the general settings will be looked

for first at



  $XDG_CONFIG_HOME/pacaur/config



and falling back to



  $HOME/.config/pacaur/config



=item B



In addition, pacaur fully honors cower's config file. See B(1).



=back



=head1 CONFIG OPTIONS



The available options are:



=over 4



=item B



Define the editor. Default is B<$VISUAL>, with a fallback on B<$EDITOR> and I.



=item B



Display PKGBUILD and install script viewing prompt. Possible values are I

to always display the full build files, I to only display the difference

since last build, and I to disable the viewing prompt. Default is B.



=item B



Extend pacman commands to the AUR. Default is B.



=item B



Enable silent output. The makepkg output will be collected in the clone directory

or the I<$LOGDEST> directory should any error occur. Default is B.



=item B



When searching the AUR, sort the results by I, number of I or

I. Default is B.



=item B



When searching the AUR, sort the results in I or I order.

Default is B.



=item B



Prevent sudo timeout. This option overrides the system-wide I

sudo configuration and refreshes the sudo timestamp automatically in a loop when

building packages. Default is B.



=back



=head1 ENVIRONMENT



=over 4



=item B



Determines where the packages build files (PKGBUILD, .SRCINFO and install script

files) will be cloned. The I<-Sc> and I<-Scc> clean operations allow to remove

the untracked cloned files and the non locally installed cloned files, and all

cloned files, respectively.



If this environment variable is not defined, the clone directory will be set to



  $XDG_CACHE_HOME/pacaur



with a fall back to



  $HOME/.cache/pacaur



=back



In addition, makepkg environment variables are fully honored. See B(8).

In particular, the following variables are useful:



=over 4



=item B



Determines where the built packages will be stored. If using the existing

I pacman cache directory, ensure your user has proper

write permissions. Additionally, if added to the I path option of

I, the I<-Sc> and I<-Scc> clean operations will enable removal of

non locally installed cached files and all cached files, respectively.



=item B



Determines where the source of packages will be stored. This will speed up the

upgrade of development packages. The I<-Sc> and I<-Scc> clean operations allow

to remove the non development packages source files and all source files,

respectively.



=item B



Determines where the build logs will be stored. By default, the I<--silent>

option will write build logs in the clone directory if the build fails, but

will remove them if the build succeeds.



=item B



Determines where the packages will be built. By default, build will happen in

the defined clone directory, but build speed can be improved by using I

located in volatile memory. This is however not recommended if big packages

need to be built on a low-memory machine.



=back



=head1 NOTES



=over 4



=item B



To be used with minimal password prompting, I should be configured

accordingly to allow sudo access. See B(5). If you disable the

I config option, you might also want to disable the I

sudo parameter to avoid password prompt timeout.



=item B



Miscellaneous options enabled in I are taken into account. Thus,

colored output can be enabled with the I option, while a detailed interface

displaying name, version and size of packages formatted as a table is available

through the I option.



=item B



To allow build files comparison, the I default config option

is set to I. Although the clone directory (set by default to

I<$XDG_CACHE_HOME/pacaur>) can be changed through the alternative I<$AURDEST>

environment variable, it should always be set to a persistent location.



=item B



By default, any operation will be applied on the binary repositories, then the

AUR if necessary. This behavior is optional and can be disabled with the

I config option. When disabled, any operation will be restricted to

the binary repositories similarly to pacman, while AUR operations can be

applied explicitly with the I<--aur> option.



=item B



Packages requiring user input while building are not supported and might fail

to install properly. There is currently no official directive about these

interactive PKGBUILDs, but some of the official pacman developers expressed

the opinion that PKGBUILDs should always provide default compilation options.



=item B



If a lot of "Could not connect to the AUR" and "Timeout was reached" messages

are displayed while searching or requesting info for packages despite the

internet connection working correctly, ensure your local I is

correctly configured to improve name lookups. Using Google's primary DNS

(8.8.8.8 and 8.8.4.4) might also help.



=back



=head1 SEE ALSO



B(1), B(8), B(8), B(5)



=head1 AUTHOR



Remy Marquis [email protected]



If you feel great pity for the present maintainer that has to constantly cope

with users that don't want to read man pages and refuse to take responsibility

for their own system, you can send me funny cat pictures. Alternatively, you

can send a donation via PayPal to the above email address.



I would also suggest to donate to a charitable organization of your choice

should you believe that your money could make a bigger difference there.

Thank you!



Absolutely B is provided, unless you are ready to pay for it.



All credits go to all direct or indirect contributors. Many thanks to all of

you!



=head1 TRANSLATORS



B<[ca] - Català> - Alex "alexhenrie" Henrie



B<[da] - Dansk> - Filip "filipkemuel" Kemuel



B<[de] - Deutsch> - Marco "BigBoot" Kirchner, "HerrNieschnell", "pszalanski", Stefan "rumpelsepp" Tatschner, Tilman "Tblue" Blumenbach



B<[es] - Español> - Germán "gosella" Osella Massa, Ismael "ChuckDaniels87" González, Pablo "jristz" Lezaeta Reyes



B<[fi] - Suomi> - "durazell"



B<[fr] - Français> - "spider-mario", "Neitsab", Antoine "Nevax07" Gravelot



B<[hu] - Magyar> - "avelkei"



B<[it] - Italiano> - Demenico "NoMore201" Lezzi, Giovanni "ItachiSan" Santini



B<[ja] - 日本語> - Colin "fosskers" Woodbury, TSUYUSATO "MakeNowJust" Kitsune



B<[nl] - Nederlands> - "Yoshi2889", Willem "14mRh4X0r" Mulder



B<[pl] - Polski> - Tomasz "Ludvick" Niedzielski



B<[pt] - Português> - Thiago "thiagowfx" Barroso Perrotta, Rafael "rccavalcanti" Cavalcanti



B<[ru] - Русский> - "kyak"



B<[sk] - Slovenčina> - Pavol "pakapusta" Kapusta, Juraj "DoctorJellyface" Fiala



B<[sl] - Slovenščina> - Žan "tofiffe" Skamljič



B<[sr] - Српски / srpski> - Slobodan "Faenriis" Terzić



B<[tr] - Türkçe> - Volkan "wakeup" Gezer



B<[zh_CN] - 简体中文> - "Victorique "victoriqueko" Ko, kizayoi"