ALPM

This project comprises specifications, as well as Rust libraries and tools for Arch Linux Package Management.

The ALPM project arose from the need for more clearly specifying the interfaces, as well as providing bindings and tools in a memory-safe programming language. The specifications and implementations are based on ad-hoc implementations in the pacman project. Currently, this project aims to maintain compatibility with pacman 5.1.0 and onwards.

The scope of this project is to provide robust integration for all relevant package creation and consumption, as well as repository management tasks. As such, the ALPM project also aims at providing drop-in replacements or alternatives for some facilities provided by pacman.

This project has been financed by the Sovereign Tech Agency. Read the official announcement for more information.

Documentation

The latest project documentation can be found at https://alpm.archlinux.page

Documentation for all current ALPM lints is available at https://alpm.archlinux.page/lints/

Overview

The following mindmap attempts to provide a high-level overview of the project and put file types as well as (existing and upcoming) libraries into context.

mindmap
  root((ALPM))
    📂 Source
      📄 PKGBUILD
      📄 .SRCINFO
      📚️ alpm-pkgbuild
      ⌨️/📚️ alpm-srcinfo
    📦 Package
      📄 .BUILDINFO
      📄 .INSTALL
      📄 .MTREE
      📄 .PKGINFO
      ⌨️/📚️ alpm-buildinfo
      ⌨️/📚️ alpm-mtree
      📚️ alpm-package
      ⌨️/📚️ alpm-pkginfo
      ⌨️/📚️ alpm-soname
    🗄️ Repository
      📄 desc
      📄 files
      ⌨️/📚️ alpm-repo-db
    🗄️ Package Management
      📄 desc
      📄 files
      ⌨️/📚️ alpm-db
    ✅️ Linting
      ⌨️/📚️ alpm-lint
    💬 Language bindings
      🐍 python-alpm
    🛠️ Utils
      📚️ alpm-common
      📚️ alpm-compress
      📚️ alpm-parsers

For an overview of planned specifications and components, refer to the milestones of the project.

Components

Currently the following software components are available:

• alpm-buildinfo: a library and command line interface to work with BUILDINFO(5) files
• alpm-common: a library for common traits and functionality
• alpm-compress: a library for compression operations in ALPM
• alpm-db: a library and command line interface to work with an alpm-db(7) and its alpm-db-desc(5) and alpm-db-files(5) file formats
• alpm-lint: a linting tool for everything around Arch Linux packaging.
• alpm-mtree: a library and command line interface to work with ALPM-MTREE(5) files
• alpm-package: a library for the creation of alpm-package(7) files
• alpm-parsers: a library for providing various custom parsers/deserializers for file types used in ALPM
• alpm-pkginfo: a library and command line interface to work with PKGINFO(5) files
• alpm-repo-db: a library and command line interface to work with an alpm-repo-db(7) and its alpm-repo-desc(5) and alpm-repo-files(5) file formats
• alpm-soname: a library and command line interface for looking up soname data
• alpm-srcinfo: a library and command line interface to work with SRCINFO(5) files
• alpm-types: a central library for types used by other ALPM libraries and tools
• python-alpm: Python bindings for ALPM crates and the python-alpm Python library

Contributing

Please refer to the contribution guidelines to learn how to contribute to this project.

Releases

Releases of components are created by the developers of this project.

OpenPGP certificates with the following OpenPGP fingerprints can be used to verify signed tags:

• [3051329b47b855c4f888f975cc9408f679023b65] (Arne Christian Beer <nukesor@archlinux.org>)
• [991f6e3f0765cf6295888586139b09da5bf0d338] (David Runge <dvzrv@archlinux.org>)
• [165e0ff7c48c226e1ec363a7f83424824b3e4b90] (Orhun Parmaksız <orhun@archlinux.org>)

Some of the above are part of archlinux-keyring and certified by at least three main signing keys of the distribution.

License

This project can be used under the terms of the Apache-2.0 or MIT. Contributions to this project, unless noted otherwise, are automatically licensed under the terms of both of those licenses.