Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simon04/aur-out-of-date
Determines out-of-date AUR packages w.r.t. upstream version
https://github.com/simon04/aur-out-of-date
archlinux aur packaging
Last synced: 12 days ago
JSON representation
Determines out-of-date AUR packages w.r.t. upstream version
- Host: GitHub
- URL: https://github.com/simon04/aur-out-of-date
- Owner: simon04
- License: gpl-3.0
- Created: 2018-01-21T10:39:42.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-03-21T08:24:09.000Z (over 2 years ago)
- Last Synced: 2024-10-10T17:25:25.857Z (29 days ago)
- Topics: archlinux, aur, packaging
- Language: Go
- Homepage:
- Size: 136 KB
- Stars: 49
- Watchers: 4
- Forks: 9
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-Arch - aur-out-of-date - Determines out-of-date AUR packages w.r.t. upstream version. (AUR Helpers / Maintenance)
README
# aur-out-of-date
Iterates through a user's AUR (Arch User Repository) packages, and determines out-of-date packages w.r.t. their upstream version.
⚠️ [Leaving Arch Linux](https://lists.archlinux.org/pipermail/aur-general/2021-November/036683.html) in November 2021 – I'll keep maintaining the project, but don't expect new features unless _you_ are submitting a patch.
## Installation
```sh
$ go get github.com/simon04/aur-out-of-date
```
Since modern Go features (such as modules) are used, at least [Go 1.13](https://golang.org/doc/go1.13) is required.
The tool is also available in AUR: [aur-out-of-date](https://aur.archlinux.org/packages/aur-out-of-date/)
## Usage
```
$ aur-out-of-date
Usage of aur-out-of-date:
-config string
Config file (default "$XDG_CONFIG_HOME/aur-out-of-date/config.json")
-devel
Check -git/-svn/-hg packages
-flag
Flag out-of-date on AUR
-json
Generate JSON Text Sequences (RFC 7464)
-local
Local .SRCINFO files
-pkg
AUR package name(s)
-statistics
Print summary statistics
-update
Update pkgver/pkgrel in local PKGBUILD files
-user string
AUR username
```
AUR packages can be obtained …
- for a given AUR user (using `-user simon04`; specify `-devel` to include VCS packages), or
- from a list of packages via [AUR RPC](https://aur.archlinux.org/rpc.php) (using `-pkg package1 package2 …`), or
- from local `.SRCINFO` files (using `-local packages/*/.SRCINFO`).
```
$ aur-out-of-date -user simon04
[OUT-OF-DATE] [python-mwclient] Package python-mwclient should be updated from 0.8.6-1 to 0.8.7-1
[OUT-OF-DATE] [nodejs-osmtogeojson] Package nodejs-osmtogeojson should be updated from 2.2.12-1 to 3.0.0
[OUT-OF-DATE] [spectre-meltdown-checker] Package spectre-meltdown-checker should be updated from 0.31-1 to 0.32
$ aur-out-of-date -user simon04 -devel
[UP-TO-DATE] [ocproxy-git] Package ocproxy-git 1.60.r8.g8f15425-3 matches upstream version 1.60
$ aur-out-of-date -pkg caddy dep aur-out-of-date
[UP-TO-DATE] [aur-out-of-date] Package aur-out-of-date 0.4.0-1 matches upstream version 0.4.0
[UP-TO-DATE] [caddy] Package caddy 0.10.10-3 matches upstream version 0.10.10
[UP-TO-DATE] [dep] Package dep 0.3.2-2 matches upstream version 0.3.2
$ aur-out-of-date -local packages/*/.SRCINFO
```
The output can be switched to a machine-readable format – [JavaScript Object Notation (JSON) Text Sequences](https://tools.ietf.org/html/rfc7464) – using `-json`.
```json
$ aur-out-of-date -json -pkg nodejs-osmtogeojson spectre-meltdown-checker
{"type":"package","name":"nodejs-osmtogeojson","message":"Package nodejs-osmtogeojson should be updated from 2.2.12-1 to 3.0.0","version":"2.2.12-1","upstream":"3.0.0","status":"OUT-OF-DATE"}
{"type":"package","name":"spectre-meltdown-checker","message":"Package spectre-meltdown-checker 0.35-1 matches upstream version 0.35","version":"0.35-1","upstream":"0.35","status":"UP-TO-DATE"}
```
Summary statistics can be enabled using `-statistics`.
The option `-flag` flags out-of-date packages on AUR after a user prompt: "Should the package … be flagged out-of-date?"
The tool `aur-out-of-date` exists with code `4` if at least one out-of-date package has been found.
## Principle
For each package, the upstream URL and/or source URL is matched against supported platforms. For those platforms the latest release is obtained via an API/HTTP call.
- `github.com` or `github.io`
- - → https://github.com/…/…/releases.atom if the environment variable `GITHUB_ATOM` is nonempty.
- - → http://api.github.com/repos/…/…/releases/latest (provide a [personal access token](https://github.com/settings/tokens) in the environment variable `GITHUB_TOKEN` for [higher request limits](https://developer.github.com/v3/#rate-limiting); [no scope](https://developer.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) needs to be selected when creating the token)
- - → http://api.github.com/repos/…/…/tags if the environment variable `GITHUB_TAGS` is nonempty (request limits applies).
- `registry.npmjs.org` → https://registry.npmjs.org/-/package/…/dist-tags
- `pypi.org` or `pypi.io` or `pypi.python.org` or `files.pythonhosted.org` → https://pypi.python.org/pypi/…/json
- `search.cpan.org` or `search.mcpan.org` → https://fastapi.metacpan.org/v1/release/…
- `rubygems.org` or `gems.rubyforge.org` → https://rubygems.org/api/v1/versions/….json
- `gitlab.com` or any self-hosted GitLab instance → http://gitlab.com/api/v4/…/…/repository/tags (provide a [personal access token](https://github.com/settings/tokens) in the environment variable `GITLAB_TOKEN` for [higher request limits](https://docs.gitlab.com/ee/api/#oauth2-tokens))
## Configuration
The tool reads a configuration file from `$XDG_CONFIG_HOME/aur-out-of-date/config.json`.
```json
{
"ignore": {
"foo": ["*"],
"osmtogeojson": ["3.0.0-beta.3", "3.0.0-rc.1"]
},
"scripts": {
"bar": "echo 42",
"aurweb": "curl -s https://aur.archlinux.org/ | grep aurweb.git/log | grep -oE 'v[1-9][.0-9]+' | head -n1"
}
}
```
### Ignoring versions
The `ignore` key configuration file allows to ignore certain package versions from being reported as out-of-date. The string `"*"` acts as a placeholder for all versions.
Running `aur-out-of-date -pkg osmtogeojson` yields:
```
[UNKNOWN] [osmtogeojson][3.0.0b3-2] ignoring package upgrade to 3.0.0-beta.3
```
### Using custom version script
You may specify a custom version script via `scripts`. The given script is executed as `/bin/sh -c $SCRIPT`, and its output is used as upstream version.
```
[UP-TO-DATE] [bar] Package bar 42-1 matches upstream version 42
```
## Related projects
- https://github.com/repology/repology
- https://github.com/lilydjwg/nvchecker
## License
GNU General Public License v3.0