How do I install aurpublish on Arch Linux?

Clone the repository and run 'make && sudo make install', with optional variables like PREFIX for custom paths, as outlined in the Install section of the README. This standard approach requires build tools and root access.

Can aurpublish handle multiple AUR packages in one repository?

Yes, it's designed for managing multiple PKGBUILDs in named subdirectories, using subtree operations to export them individually to the AUR, which is a core feature for streamlined maintenance.

What does the pre-commit hook in aurpublish do?

It warns about whitespace errors, fails if checksums don't match, and auto-generates .SRCINFO files for all changed PKGBUILDs, ensuring validation before commits, as detailed in the Hooks section.

How does aurpublish compare to using git subtree commands manually?

aurpublish automates repetitive tasks like checksum validation and .SRCINFO generation, saving time over manual git subtree operations, but it adds abstraction that might obscure low-level git control for advanced users.

How to update a package with aurpublish?

After committing changes to a PKGBUILD in your repo, run 'aurpublish PACKAGE' to push updates to the AUR; the --speedup option can merge split history for faster operations, per the Commands description.

Is aurpublish suitable for AUR packaging beginners?

While it automates tasks, it assumes familiarity with git and AUR workflows, so beginners might find the setup and git concepts challenging compared to simpler, manual approaches.

Open-Awesome

aurpublish

GPL-2.0Shell

A PKGBUILD management framework for the Arch User Repository using git subtree workflows.

GitHub

281 stars18 forks0 contributors

What is aurpublish?

aurpublish is a PKGBUILD management framework for the Arch User Repository (AUR). It provides a structured workflow for Arch Linux package maintainers to publish, update, and manage AUR packages using git subtree operations, automating tasks like checksum validation and .SRCINFO generation.

Target Audience

Arch Linux users and maintainers who publish or manage multiple packages on the AUR and want a streamlined, git-integrated workflow.

Value Proposition

It simplifies AUR package maintenance by automating repetitive tasks, ensuring clean version history with git subtrees, and reducing manual errors through built-in hooks and validation.

Overview

PKGBUILD management framework for the Arch User Repository

Use Cases

Best For

Managing multiple PKGBUILDs in a single git repository
Automating checksum validation and .SRCINFO generation
Maintaining clean version history for AUR packages
Collaborating on AUR packages with pull requests
Migrating packages from AUR3 to AUR4+
Streamlining AUR package publishing and updates

Not Ideal For

Maintainers who only publish or update a single AUR package occasionally and prefer manual methods
Teams using non-git version control systems or preferring GUI-based AUR management tools
Projects requiring cross-distribution package management beyond Arch Linux's AUR

Pros & Cons

Pros

Automated Validation Hooks

Pre-commit hooks automatically warn about whitespace errors and validate checksums, reducing manual errors as stated in the README's Key Features.

Clean Subtree Workflow

Uses git subtree push to maintain independent history for AUR packages, enabling better collaboration and pull requests, per the How it works section.

Time-Saving Automation

Auto-generates .SRCINFO files for changed PKGBUILDs and pre-fills commit messages with package versions, streamlining updates as described in the Hooks and Commands.

Migration Assistance

Includes an experimental script to import history from non-migrated AUR3 packages, aiding in transition to newer AUR versions, though it's labeled as experimental.

Cons

Experimental Features

The AUR3 migration script is explicitly called experimental in the README, indicating potential instability or lack of robust support for legacy packages.

Setup and Git Dependency

Requires compilation, installation with make, and repository initialization via 'aurpublish setup', adding complexity and assuming proficiency with git and command-line tools.

Limited Scope

Specifically tied to the AUR and Arch Linux ecosystem, with no support for other package repositories or distributions, as evident from its PKGBUILD focus.

Frequently Asked Questions

Related Projects

aur-out-of-date

Determines out-of-date AUR packages w.r.t. upstream version

Stars49

Forks9

Last commit4 years ago

pkgoutofdate

Checks ArchLinux packages repository for upstream updates

Stars12

Forks4

Last commit5 years ago

devtools

Tools for the Arch Linux distribution for building and maintaining official repository packages

Alerts you to upstream activity