Archbuild

A modern, sustainable AUR package building and repository management tool for Arch Linux.

Features

• Automatic AUR builds - Clone and build packages from the AUR
• Dependency resolution - Automatically resolve and build AUR dependencies in correct order
• Parallel builds - Build multiple packages concurrently with configurable worker count
• Package signing - Optional GPG signing for packages and database
• Retry logic - Configurable retries with exponential backoff for transient failures
• Package retention - Keep configurable number of old versions, auto-cleanup
• Notifications - Email and webhook (Discord, Slack, ntfy) notifications on failures
• VCS package handling - Automatically rebuild git/svn/hg packages
• Modern Python - Type-safe, async, well-tested codebase

Installation

# From source
pip install -e .

# Or with development dependencies
pip install -e ".[dev]"

Quick Start

1. Create configuration:
   bash cp config/config.example.yaml config.yaml # Edit config.yaml with your settings

2. Initialize repository:
   bash archbuild -c config.yaml init

3. Add packages:
   bash archbuild add yay paru

4. Build all packages:
   bash archbuild build-all

5. Build a specific package:
   bash archbuild build <package>

Commands

Configuration

See config/config.example.yaml for all options. Key settings:

repository:
  name: "myrepo"
  path: "/repo/x86_64"
  build_dir: "/repo/build"

building:
  parallel: true
  max_workers: 4
  retry_attempts: 3

retention:
  keep_versions: 3

notifications:
  email:
    enabled: true
    to: "admin@example.com"

Migration from Bash Version

archbuild migrate-config vars.sh -o config.yaml

Systemd Timer

Create /etc/systemd/system/archbuild.service:
```ini
[Unit]
Description=Build AUR packages

[Service]
Type=oneshot
ExecStart=/usr/bin/archbuild -c /etc/archbuild/config.yaml build-all
User=builduser
```

Create /etc/systemd/system/archbuild.timer:
```ini
[Unit]
Description=Run archbuild daily

[Timer]
OnCalendar=daily
Persistent=true

[Install]
WantedBy=timers.target
```

License

MIT