D 2015-04-17T13:10:25.220
L cross\spackage\smaker
N text/x-markdown
P 0c02b625c8033acddcb34740a06f96d4021887d3
U mario
W 5615
<a href="https://github.com/jordansissel/fpm" title="Effing Package Management ;)">fpm</a> greatly simplifies distribution package generation.<br>
<a href="http://fossil.include-once.org/xpm/"><em title="Cross Package Maker">xpm</em></a> is a feature-oriented branch of fpm.

<img src=logo align=right width=130 height=154 alt=xpm style="margin:25pt">
It creates or converts between

  * Debian <kbd>`deb`</kbd>
  * RedHat <kbd>`rpm`</kbd>
  * Node <kbd>`npm`</kbd>
  * OSX <kbd>`pkg`</kbd>
  * Ruby <kbd>`gem`</kbd>
  * Solaris packages, plain <kbd>`zip`</kbd> or <kbd>`tar`</kbd> archives, and a few more..

See the [→ Howto](wiki/Howto) on common `fpm` usage examples.


### xpm target/source plugins

This variant (precautiosly renamed for parallel installation) adds a few more source/target modules:

  *  <kbd>[*-t* **exe**](wiki/exe)</kbd> assembles Windows SFX "installers"

  *  <kbd>[*-s* **src**](wiki/src)</kbd> consumes per-file relative `pack:` specifiers from meta comment fields for source-based apps

  *  <kbd>[*-t* **phar**](wiki/phar)</kbd> bundles PHP scripts into `.phar`/zip/tars with meta fields

  *  <kbd>[*-t* **ipk**](wiki/ipk)</kbd> creates a static Listaller (.IPK) or Limba archive (which is a cross-distro packaging format)

  *  <kbd>[*-s* **composer**](wiki/source_composer)</kbd> fetches PHP bundles per composer, allows to pack them as phars or system packages (or matroska phar in deb/rpm)

A few more are currently pondered..


### new features

This fpm branch already provides a few extensions:

  *  [**Multi-target**](wiki/multi-target) creation in one swoop.

        xpm -t deb,rpm,exe

     Avoids having to call fpm multiple times for creating distinct system packages. Usually package-specific flags `--deb-…` and `--rpm-…` can be mixed in one invocation - when they're non-overlapping.

  *  Simple post-processing with [**update filters**](wiki/update+filters):

        xpm -u man,appdata

     Update filters are run between input file collection and target package building. They're intended for quick tasks or semi-build functionality. Existing filters:

      * <kbd>[man](wiki/update+filters#man)</kbd> - compresses man pages
      * <kbd>[appdata](wiki/update+filters#appdata)</kbd> - creates pkg.appdata.xml for distro managers
      * <kbd>[desktop](wiki/update+filters#desktop)</kbd> - add stub fpm:pkg.desktop file
      * <kbd>[composer](wiki/update+filters#update_composer)</kbd> - update/generate `composer.json` for <kbd>phar</kbd> target
      * <kbd>[fixperms](wiki/update+filters#fixperms)</kbd> - limit file permissions (umask 755 / 644)
      * <kbd>[strip](wiki/update+filters#strip)</kbd> - strip debugging symbols from binaries
      * <kbd>[deps](wiki/update+filters#deps)</kbd> - resolve cross-distro library names per whohas/distromatch
      * <kbd>[unprefix](wiki/update+filters#unprefix)</kbd> - workaround for converting system packages back to local paths
      * <kbd>[lcase](wiki/update+filters#lcase)</kbd> - lowercase filenames prior packaging
      * <kbd>[packfile](wiki/update+filters#packfile)</kbd> - runs any `Packfile` within the /tmp/staging dir on assembled files

  *  Debian [package signing](wiki/package+signing) with `--deb-sign KEYNAME` integrated.

  *  Additional <kbd>--attr</kbd> option to add custom control header fields (practically an alias for --deb-field, but also works for phar packages, based on `attrs{}`, so src plugin implicitly populates extra fields).


### possible extensions

It's planned or at least considered to add:

  * <kbd>[*-t* **inst**](wiki/inst)</kbd> → a GUI/Python-based BSD/Linux cross-distro installer (reusing zip, deb, alien, pkcon, xdg-tools)

  * <kbd>[*-t* **msi**](wiki/msi)</kbd> - for proper Windows packages

  * depending on further research, one of the AppImage-formats (utilizing their actual tools) might make sense

See [Research](wiki/Research) on existing and inactive cross-distro packagers, schemes and initiatives.


### build and installation

Meanwhile xpm installs as `xpm`, to keep any mainline `fpm` accessible. It's installed per rubygems easily. Either download a [prebuilt gem ($stats_latest_version) from `apt.io`](http://apt.include-once.org/xpm-$stats_latest_version.gem) or assemble it yourself:

  1. Download the [xpm.tgz](tarball/xpm.tgz?uuid=trunk) tarball, extract somewhere
  2. `gem build ./xpm.gemspec`
  3. `gem install ./xpm-$stas_latest_version.gem`

Take note that this fetches a few other dependencies, even compiles `ffi`; so may take a few more seconds. But basically that's it.


### fossil → git

I just don't fancy git. That is all. But this fossil repo will be synced back to [https://github.com/prof-milki/xpm](https://github.com/prof-milki/xpm) once in a while.

Or you can just sync it directly from here. Download or install the single [fossil binary](http://www.fossil-scm.org/download.html), then:

  1. `fossil clone http://fossil.include-once.org/xpm/ xpm.fsl`
  2. `fossil open xpm.fsl`
  3. `fossil ui`

From there you could also just `fossil export --git` and pipe that into `git fast-import`.

Alternatively just use the new direct remote export:

  1. `wget //fossil.include-once.org/xpm/git-fast-export`

It should be noted that Git is occasionally flaky with its own export format though.


### links

  *  mainline fpm version [https://github.com/jordansissel/fpm](https://github.com/jordansissel/fpm)
  *  apt/yum repo builder [https://github.com/dnbert/prm](https://github.com/dnbert/prm)

Z a82b1d8c84d7bd02c202d4c10fa9f3d0