csomh / rpkg

Forked from rpkg 6 years ago
Clone

csomh / rpkg

Forked from rpkg 6 years ago
base library for fedpkg provides common functionality for dist-git setups
Members 1

Introduction

This is the rpkg project, which mostly is a python library for dealing with rpm packaging in a git source control. pyrpkg is the base library that sites can subclass to create useful tools.

rpkg works with Python 2.6, 2.7, 3.5, 3.6 and 3.7.

License

Unless otherwise specified, all files are licensed under GPLv2+.

Installation

Install from distribution packages

rpkg is available in Fedora and EPEL repositories. It can be installed with package manager command. There are Python 2 and 3 package for Fedora and only Python 2 package in EPEL.

Install in a Fedora system:

sudo dnf install python2-rpkg

If Python 3 package is needed, install python3-rpkg.

Install in EL6 or EL7:

sudo yum install python2-rpkg

Install in a Python virtual environment

Both Python 2 and 3 packages are published in PyPI. Install rpkg in a Python 3 virtual environment in these steps:

python3 -m venv env
source env/bin/activate
pip install rpkg rpm-py-installer

You are free to create a virtual environment with option --system-site-packages.

Please note that, rpkg depends on some other utilities to build packages. These packages are required to be installed as well.

  • mock: for local mockbuild.
  • rpm-build: for local RPM build, which provides the command line rpm.
  • rpmlint: check SPEC.
  • copr-cli: for building package in Fedora Copr.
  • module-build-service: for building modules.

Contribution

You are welcome to write patches to fix or improve rpkg. All code should work with Python 2.6, 2.7, and 3. Before you create a PR to propose your changes, make sure

Sign-off commit

Make sure to sign-off your commits by git commit -s. This serves as a confirmation that you have the right to submit your changes. See Developer Certificate of Origin for details.

Run Tests

Before make a pull request, ensure local changes pass all test cases.

Before run tests, install these packages:

sudo dnf install python26 python37 detox python2-virtualenv

To run tests simply, make test.

By default, target test runs tests with all supported Python versions. However, if you look into Makefile, there is still a target tox that allows developer to run tests with test environments one by one.