Convert GitHub project releases to Archlinux package, with autoupdate.
Project description
arch-github-package
Convert GitHub project releases to Archlinux package, with autoupdate.
Why
A lot of packages in Archlinux's AUR are just a single PKGBUILD file that downloads the latest release from GitHub, and many of them are human-maintained, which means that they are not updated as soon as a new release is published.
This script provides an alternative. If a GitHub project has binary releases, it can automatically download a release tarball, create a PKGBUILD file, makepkg, and install it. It can also rebuild the package if a new release is found.
Installation
pipx install arch-github-package
pipx installs the package in a virtualenv, so it doesn't pollute your system.
You can also use pip:
pip install --user --break-system-packages arch-github-package
(This will install the package in your user site-packages, not really breaking system packages.)
Usage
Install a package
agp install <github-repo>
Example:
agp install cortesi/devd
How does it work:
-
It looks for the latest release on GitHub.
-
It tries to find a pre-built package for your system, by looking for keywords like "linux", "x86-64", "x86_64", "amd64", "gnu" in the release assets.
-
It downloads the tarball, extracts it, and tries to dertermine which file goes where. E.g.:
- If a file is ELF, or its x modbit is set, it goes to
/usr/bin
. - Files like *.1.gz go to
/usr/share/man
. - README.* go to
/usr/share/doc/<package-name>
. - LICENSE goes to
/usr/share/licenses/<package-name>
.
- If a file is ELF, or its x modbit is set, it goes to
-
It creates a PKGBUILD file, and runs
makepkg -si
to build and install it. The package name is<github-project-name>-github
. E.g.,ortesi/devd
becomesdevd-github
.
List installed packages
agp list
Check for upgrades
agp upgrade
You can also use agp upgrade <package-name>
to upgrade a single package.
Note: if you run this command repeatively in quick succession, it will hit GitHub's rate limit for anonymous API access.
Uninstall a package
agp uninstall <package-name>
If you uninstall an -github package with pacman
, it will still be listed by agp list
.
So remember to use agp uninstall
to remove it.
Internals
Package metadata
Metadata is stored under ~/.local/share/arch-github-package
.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for arch_github_package-0.0.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | add226698f5172e4c62d96e9033cf15d0adfdc58ff41c05bb0039b2d7dec56e1 |
|
MD5 | 1f1f237c081a133b46f5f21be9ecd681 |
|
BLAKE2b-256 | 8494b459d3c3723b8c469a16a5be598e768c6ca08d572a2817135f1ed10d4430 |
Hashes for arch_github_package-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6c36360b884d0e078370c62de8d246546047732fc004047129a0f1dd2420c491 |
|
MD5 | 8dadaf7aeeaf705227ed222f5489c299 |
|
BLAKE2b-256 | 6f645f8badd37af8f39a02d0129f9e31144b80a188ed7204aff4a83b8b5e5c01 |