Tool to automatically update Slackware build scripts.
Go to file
Eugen Wissner f395d57b33
All checks were successful
Build / audit (push) Successful in 8s
Build / test (push) Successful in 15m9s
Add version filter to the configuration
2024-09-30 14:39:38 +02:00
.gitea/workflows Switch to buildenv for test builds 2024-08-09 10:04:40 +02:00
config Support a custom upload command 2024-05-11 19:01:41 +02:00
lib/SlackBuilder Add version filter to the configuration 2024-09-30 14:39:38 +02:00
src Add version filter to the configuration 2024-09-30 14:39:38 +02:00
tests Introduce a matcher for one or more matched digits 2024-09-13 21:58:13 +02:00
.gitignore Use TOML configuration 2023-08-09 20:59:42 +02:00
.hlint.yaml universal-ctags: Add version path segment 2023-09-25 10:18:00 +02:00
CHANGELOG.md Move packagist check to a Haskell binary 2023-08-04 21:33:21 +02:00
LICENSE Add autoupdater 2020-12-09 18:28:42 +01:00
README.md Describe features 2024-04-01 21:31:41 +02:00
slackbuilder.cabal Provide own lzma conduit adapters 2024-08-08 11:03:02 +02:00

SlackBuilder

SlackBuilder is a tool which aims to help to update Slackware packages. It checks for the latest version of an upstream package and can modify SlackBuild meta information accordingly.

Features

  • Querying various sources (like registries) for the latest upstream version. Currently supported sources are:
    • GitHub
    • Packagist
    • Remote text file containing a version number (like the LATEST file).
  • Updating package version and checksum in the .info file; Updating version variables in the .SlackBuild
  • Updating packages with multiple sources. One source is assumed to be the main source and match the version of the package. Other sources are just updated to the latest version available for them.
  • Modifying or just reuploading source tarballs to a different destination. SlackBuilder can download the original source tarball, optionally extract and modify its contents, and upload it to another server. It can be used for example to download package dependencies to ship them all within a single archive, so the package can be built offline.

Build instructions

SlackBuilder is a Haskell program and can be built and run using the Cabal build tool and package manager:

cabal build

After that you can run slackbuilder using Cabal and cabal run slackbuilder. Or you can install the program locally with cabal install and run it just as slackbuilder assuming ~/.cabal/bin is on your PATH.

Usage

Configuration

There is a sample configuration file under config/config.toml.example. The sample contains comments describing each supported option. Just copy this file to config/config.toml and modify as needed.

Each package that should be updated automatically needs a special description which contains links to the upstream repositories and instructions how the sources should be prepared.

Unfortunately the only format currently supported for the package descriptions is Haskell source code. But I'm planning to make it possible to describe the packages without recompiling the slackbuilder itself.

For the time being src/Main.hs contains descriptions of my slackbuilds, that can be used as an example and a start point.

Command line options

SlackBuilder is called with a command as its first argument:

slackbuilder COMMAND

Currently supported commands are listed below.

check

check checks whether there are updates available. It prints the name of each known package together with its version. If the package version is not the latest known version, the version the package can be updated to is printed as well.

up2date

Performs the package updates for packages the can be updated. up2date accepts an optional argument specifying the package that should be updated if only one package should be updated and not all.