pkg++

README

pkg++

pkg++ builds packages native to your distribution by reading recipes or data from various sources.

pkg++ is written in Moonscript.

Executable usage

Usage: pkgxx [-v] [-q] [-a <arch>] [-l] [-w] [-n] [-d]
       [-c <collection>] [-t] [-f] [-h] [<recipe>]

Packages builder.

Arguments:
   recipe                Path to the recipe of the package to build.

Options:
   -v, --verbose
   -q, --quiet
   -a <arch>, --arch <arch>
   -l, --lint            Print potential defects in the recipe instead of building.
   -w, --watch           Only checks whether the packages and recipes are up to date.
   -n, --no-deps         Do not build dependencies.
   -d, --deps            Check and install dependencies before building
   -c <collection>, --collection <collection>
   -t, --targets
   -f, --force           Force rebuild and repository inclusion.
   -h, --help            Show this help message and exit.

Library usage

pkg++ is designed to be usable as a Moonscript library upon which packaging tools can be built.

Examples of uses for such a library include:

  • automated imports from other repositories (language-level package management, other distributions, …);
  • scripted builds (automated testing, automated deployment, …);
  • integration within other tools, possibly packaging tools.

API documentation can be generated with LDoc (ldoc -X .). That documentation is however likely incomplete.

pkgxx = require "pkgxx"

pwd = do
    p = io.popen "pwd"
    s = p\read "*line"
    p\close!
    s

context = with pkgxx.newContext!
    -- Load pkg++’ default modules.
    -- Custom modules can be loaded or created with \loadModule {}.
    \loadModules!

    -- Some package formats want to know who built them.
    .builder = "Example <example@example>"

    .packageManager = "pacman"
    .distribution = "Arch"

    -- Where to store sources, packages and temporary files.
    .buildingDirectory = "#{pwd}/tmp"
    .packagesDirectory = pwd
    .sourcesDirectory =  pwd

recipe = with context\openRecipe "package.toml"
    \download!
    \build!
    \package!

context\close!

package.toml example

package.toml is the WIP recipe format for pkg++.

Work will be invested to support multiple recipe formats in the future.

summary =     "GNU compression utility"
url =         "http://www.gzip.org/"
packager =    "Luka Vandervelden <lukc@upyum.com>"

name =    "gzip"
version = "1.6"
release = 1
sources = [ "http://ftp.gnu.org/gnu/%{name}/%{name}-%{version}.tar.xz" ]

dependencies = ["zlib"]
build-dependencies = ["zlib-devel"]

Dependencies