Metadata

About

This package contains Python 3 modules for interacting with the AUR along with some tools that use them.

Example scripts are provided in the scripts directory.

See paconky.py for an example of how this can be used with pyalpm.

Command-Line Utilities

The following are installed with the package. See help messages below for more information.

aurtomatic -i -a vote

aurcomment <pkgname> [<pkgname>...]

Modules

Complementary Modules

• pyalpm
• XCPF
• Reflector

Aurquery Help Message

$ aurquery -h

usage: aurquery [-h] [-i] [-s] [--by {name,name-desc,maintainer}] [--debug]
                [--log <path>] [--ttl <minutes>] [--full-info] [--intersect]
                <arg> [<arg> ...]

Query the AUR RPC interface.

positional arguments:
  <arg>

options:
  -h, --help            show this help message and exit
  -i, --info            Query package information.
  -s, --search          Search the AUR.
  --by {name,name-desc,maintainer}
                        By which fields to search. Default: name-desc
  --debug               Enable debugging.
  --log <path>          Log debugging information to <path>.
  --ttl <minutes>       Time-to-live of cached data (default: 15)
  --full-info           Return full information for searches and msearches.
  --intersect           When searching for packages, only return results that
                        match all search terms.

For maintainer searches, use an empty string ('') as an argument to search for
orphans.

Aurquery Example Output 1

$ aurquery -i python3-aur

Repository            : AUR
PackageBase           : python3-aur
Name                  : python3-aur
Version               : 2021.11.20.1-14
Description           : AUR-related modules and helper utilities (aurploader, aurquery, aurtomatic).
URL                   : https://xyne.dev/projects/python3-aur
AURPage               : https://aur.archlinux.org/packages/python3-aur
URLPath               : https://aur.archlinux.org/cgit/aur.git/snapshot/python3-aur.tar.gz
Maintainer            : Xyne
Depends               : pyalpm python-pyxdg python3 python3-xcgf python3-xcpf
MakeDepends           : None
CheckDepends          : None
OptDepends            : curl
                        git
Conflicts             : aurploader
Provides              : aurploader
Replaces              : aurploader
Groups                : None
License               : GPL
NumVotes              : 219
FirstSubmitted        : 2011-07-04 05:22:15 CEST
LastModified          : 2023-06-27 11:34:01 CEST
OutOfDate             : 
ID                    : 1279449
PackageBaseID         : 50424
Keywords              : arch_linux aur python

Aurtomatic Help Message Output

$ aurtomatic -h

usage: aurtomatic [-h]
                  [-a {adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} [{adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} ...]]
                  [--comment COMMENT] [--comment-from-file <path>]
                  [--keywords [KEYWORD ...]] [-i] [-q] [-c <path>]
                  [-j {ask,keep,remove}] [-l <path>] [--confirm]
                  [--merge-into MERGE_INTO]
                  [<pkgname> ...]

Post comments to the AUR.

positional arguments:
  <pkgname>

options:
  -h, --help            show this help message and exit
  -a {adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} [{adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} ...], --action {adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} [{adopt,comment,delete,disown,flag,notify,setkeywords,unflag,unnotify,unvote,vote} ...]
                        Action(s) to perform for each specified package.
  --comment COMMENT     Post a comment without the interactive prompt.
  --comment-from-file <path>
                        Load a comment from a path without the interactive
                        prompt.
  --keywords [KEYWORD ...]
                        Set keywords without the interactive prompt.
  -i, --installed       Perform action for all installed AUR packages. Use
                        this to vote for the packages that you use and show
                        support.
  -q, --quiet           Suppress output.

cookie-management arguments:
  -c <path>, --cookiejar <path>
                        Specify the path of the cookie jar. The file follows
                        the Netscape format.
  -j {ask,keep,remove}, --jar {ask,keep,remove}
                        What to do with the cookiejar. Default: ask.
  -l <path>, --login <path>
                        Read name and password from a file. The first line
                        should contain the name and the second the password.

deletion arguments:
  --confirm             Confirm deletion and other actions requiring
                        additional confirmation.
  --merge-into MERGE_INTO
                        Merge target when deleting package.

Aurpkglist Help Message Output

$ aurpkglist -h

usage: aurpkglist [-h] [-f] [-t TTL] [-p PATH] [-q]

Retrieve and print the full list of AUR packages.

options:
  -h, --help            show this help message and exit
  -f, --force           Force a refresh of the local file.
  -t TTL, --ttl TTL, --time TTL
                        The time, in seconds, to cache the local file, counted
                        from the last modification. Default: 900
  -p PATH, --path PATH  Set the local file path.
  -q, --quiet           Refresh the local file without printing the list of
                        packages.

AurTUs Help Message Output

$ aurtus -h

usage: aurtus [-h] [-c <path>] [-j {ask,keep,remove}] [-l <path>]

Retrieve the current list of trusted users (TUs) from the AUR.

options:
  -h, --help            show this help message and exit
  -c <path>, --cookiejar <path>
                        Specify the path of the cookie jar. The file follows
                        the Netscape format.
  -j {ask,keep,remove}, --jar {ask,keep,remove}
                        What to do with the cookiejar. Default: ask.
  -l <path>, --login <path>
                        Read name and password from a file. The first line
                        should contain the name and the second the password.

CHANGELOG