kewlfft / pkgwap

Scan directory for PKGBUILDs, watch for upstream updates and push to the AUR

pkgwap

PKGBUILD Watch And Push

Scan directory for PKGBUILDs, look for upstream updates, update the description and push to the AUR.

Goal

The objective of pkgwap is to ease and automate as much as possible the update of user packages in the AUR in a controlled manner. It scans local directories for PKGBUILD files and compare them with the current AUR version and the upstream version.

• The latest upstream version can be figured out for GitHub projects and Python packages.

• The PKGBUILD can be enriched with an option named _watch providing:

  1. the URL where the latest version number can be found,
  2. the associated regular expression to capture it within the HTML page.

_watch = ('https://www.upstreamsite.org/download' '<title>[a-zA-Z_-]*(\d[\d.]*\d+)</title>')

Alternatively, the URL only can be provided in _watch. In this case the hash of the page is calculated and it will warn next time the upstream URL is modified.

_watch = ('https://www.upstreamsite.org/download')

Usage

Run pkgwap -h to see the full list of options. The basic usage consists in:

$ pkgwap directory_name

where pkgwap checks into directory_name and analyses the PKGBUILD files found, the sub-directories are also recursively scanned.

An environment variable GITHUB_TOKEN can be set to a GitHub OAuth token in order to raise the request limit for the GitHub API.