Skip to main content

Utility for building Linux packages for multiple distributions.

Reason this release was yanked:

DO NOT USE: RPM builds may remove '/' upon uninstall.

Project description

PackageCore


pypi version travis ci status circle ci status readthedocs status

Python 3 library for building and testing Linux packages for multiple distributions. Works in Travis-CI and Circle-CI.

Documentation at packagecore.readthedocs.io.

NOTICE:

Starting with version 0.10.0 you will need to specify a docker container image for archlinux in your configuration file. See the Configuration example for how to do this.

Requirements

PackageCore is written in python 3 and uses the PyYAML and setuptools modules.

PackageCore utilizes Docker to provide the distribution environments for building and testing packages.

Installation

The easiest way to get PackageCore is via pip (after installing Docker and your distro's libyaml package).

pip3 install packagecore

Alternatively, Linux packages are provided on our release page or you can install in manually from this repo using the setup.py module.

./setup.py install

Execution

You can build packages by executing:

packagecore <version> [<release num>]

from the source directory.

In your source directory if packagecore.yaml contains the configuration. Otherwise, the configuration file can be explicitly specified:

packagecore -c myfile.yaml <version> [<release num>]

Use the -h flag to get a full list of options:

packagecore -h

Configuration

PackageCore uses YAML files for configuration. The basic structure is:

name: wx-calc
maintainer: Dominique LaSalle <packagecore@solidlake.com>
license: GPL3
summary: A simple calculator using wxWidgets.
homepage: https://solidlake.com
commands:
  compile:
    - mkdir build
    - cd build
    - cmake ../ -DCMAKE_INSTALL_PREFIX=/usr
    - make
  install:
    - make install -C build DESTDIR="${BP_DESTDIR}"
  testinstall:
    - ls /usr/bin/wxcalc
packages:
  archlinux:
    buildeps:
      - gcc
      - cmake
    deps:
      - wxgtk
    container: "example.com/my/custom/container"
  centos7.3:
    buildeps:
      - gcc
      - cmake
      - wxGTK3-devel
    deps:
      - wxGTK3
  fedora25:
    buildeps:
      - gcc
      - cmake
      - wxGTK3-devel
    deps:
      - wxGTK3
  ubuntu16.04:
    buildeps:
      - gcc
      - cmake
      - libwxgtk3-dev
    deps:
      - libwxgtk3-0v5

When executing install commands, the environment variable BP_DESTDIR is defined, and should be used as the root directory for installation (e.g., specify things like install -D -m755 mybin ${BP_DESTDIR}/usr/bin/mybin).

If a specifc Linux distribution requires special commands to build, you can override the top-level commands inside of the package listing:

  centos7.3:
    commands:
      compile:
        - mkdir build
        - cd build
        - cmake ../ -DCMAKE_INSTALL_PREFIX=/usr -DwxWidgets_CONFIG_EXECUTABLE=/usr/bin/wx-config-3.0

Usage in Travis-CI

To use in travis-ci, you must be using at least Ubuntu 14.04 (Trusty) with docker and sudo.

sudo: required
services:
  - docker

Then, add the following before_deploy commands:

before_deploy:
  - sudo apt-get update -qy
  - sudo apt-get install -qy python3 python3-pip libyaml-dev
  - sudo python3 -m pip install packagecore
  - packagecore -o dist "${TRAVIS_TAG#v}"

Which will build your packages with the version defined by your tag (assumes you prefixed it with a v), and place the packages in a dist directory. Then add the following to the deploy section:

deploy:
  ...
  file_glob: true
  file:
    - dist/*
  on:
    tags: true
  ...

If you want to upload your packages to your GitHub release page, follow the Travis-CI instructions for how to fill out the rest of the deploy section.

Usage in Circle-CI

To use in circle-ci, add the following to your configuration circle.yaml file (assuming version 1).

machine:
  services:
    - docker
...
deployment:
  package:
    tag: /^v.*$/
    commands:
      - sudo apt-get update -qy
      - sudo apt-get install -qy python3 python3-pip libyaml-dev
      - sudo python3 -m pip install packagecore
      - packagecore -o "${CIRCLE_ARTIFACTS}" "${CIRCLE_TAG#v}"

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

packagecore-0.11.4.tar.gz (22.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page