Skip to main content

RPM packaging automation tool

Project description

# rdopkg

rdopkg is an RPM packaging automation tool. It provides automation for package maintenance including git-based patches management and automagic rebases to new upstream versions with nice .spec changes, changelogs and commit messages for both CLI and CI usage. It also contains various functionality we needed for [RDO](https://www.rdoproject.org/) packaging, such as advanced requirements.txt management for python projects and [rdoinfo](https://github.com/redhat-openstack/rdoinfo) integration.

Generic [distgit](https://www.rdoproject.org/documentation/intro-packaging/#distgit—where-the-spec-file-lives) and patches management functionality and conventions provided by rdopkg proved to be efficient way of packaging fast-moving upstream projects with minimal human effort but without losing control over individual packages.

rdopkg is under constant development, serving mainly the needs of the mighty [RDO](https://www.rdoproject.org/) packager-warriors and their weapons such as [DLRN](https://github.com/softwarefactory-project/DLRN), but it strives to help all RPM packagers. For example, see [how you can manage your RPMs with rdopkg](https://www.rdoproject.org//blog/2017/03/let-rdopkg-manage-your-RPM-package/).

rdopkg uses [software factory](https://softwarefactory-project.io/) for CI and every commit goes through automatic unit, feature, and integration testing as well as human reviews.

See [open rdopkg reviews](https://softwarefactory-project.io/r/#/q/status:open+project:rdopkg).

rdopkg is fully reusable but the goal of also serving as packaging CLI tool framework as described in [pwnpkg](https://github.com/yac/pwnpkg) proved to be out of scope. However, (not only jruzicka’s) rants ignited [rpkg2][] project which aims to provide exactly that. If you’re interested in writing you own packaging tools such as new fedpkg/copr-cli we deserve, [rpkg2][] seems like a good place to start and influence with good ideas.

[rpkg2]: https://pagure.io/rpkg2

## Installation

### from Fedora/EPEL repos (default)

rdopkg is available on Fedora 25 and newer:

dnf install rdopkg

On CentOS/RHEL 7, rdopkg is available from [EPEL](https://fedoraproject.org/wiki/EPEL).

On CentOS 7:

yum install epel-release yum install rdopkg

On RHEL 7:

yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm yum install rdopkg

### from source

If you want to hack rdopkg or just have the latest fixes without waiting for next release, I suggest using the git repo directly:

git clone https://github.com/softwarefactory-project/rdopkg cd rdopkg python setup.py develop –user

You may set the preference over rdopkg RPM by correctly positioning ~/.local/bin/rdopkg in your $PATH.

Or you can use virtualenv to avoid conflicts with RPM:

git clone https://github.com/softwarefactory-project/rdopkg cd rdopkg virtualenv –system-site-packages ~/rdopkg-venv source ~/rdopkg-venv/bin/activate python setup.py develop ln which rdopkg ~/bin/rdopkg-dev

rdopkg-dev –version

Required python modules are listed in [requirements.txt](requirements.txt) and also in [rdopkg.spec](https://src.fedoraproject.org/rpms/rdopkg/blob/master/f/rdopkg.spec) as RPM Requires.

### from PyPI

For your convenience, rdopkg is also available from the Cheese Shop. This should come in handy especially if you want to reuse rdopkg as a module.

pip install rdopkg

Note that you need to have python2-rpm(resp. python3-rpm) package installed in order for RPM macro related featuers to work as it isn’t available from PyPI.

## The Manual

Exhaustive rdopkg manual is available, you can:

You might also be interested in [RDO packaging intro](https://www.rdoproject.org/documentation/intro-packaging/) which contains some examples of rdopkg usage and more.

## Bugs

Please use the [github Issues](https://github.com/softwarefactory-project/rdopkg/issues) to report bugs. I usually fix critical bugs within days.

Project details


Download files

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

Source Distribution

rdopkg-0.52.0.tar.gz (120.5 kB view details)

Uploaded Source

Built Distribution

rdopkg-0.52.0-py2-none-any.whl (70.1 kB view details)

Uploaded Python 2

File details

Details for the file rdopkg-0.52.0.tar.gz.

File metadata

  • Download URL: rdopkg-0.52.0.tar.gz
  • Upload date:
  • Size: 120.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.14.2 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.19.6 CPython/2.7.5

File hashes

Hashes for rdopkg-0.52.0.tar.gz
Algorithm Hash digest
SHA256 7b7009a18b37c55cc8d806dada4a512904dff72c089006d89b18241422226893
MD5 560943596c3e616c78b05320277906da
BLAKE2b-256 75a509ae4ec03fe76652c519909dd590db6ea2e489fa0ab5d4c1204c54ee8d4d

See more details on using hashes here.

File details

Details for the file rdopkg-0.52.0-py2-none-any.whl.

File metadata

  • Download URL: rdopkg-0.52.0-py2-none-any.whl
  • Upload date:
  • Size: 70.1 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.14.2 setuptools/39.2.0 requests-toolbelt/0.8.0 tqdm/4.19.6 CPython/2.7.5

File hashes

Hashes for rdopkg-0.52.0-py2-none-any.whl
Algorithm Hash digest
SHA256 3bbb7a9bceda3bf802eb1e8bbb5c718f72b1fb9eb317145514c8a68bb478946b
MD5 841e53f537f956d4ae7c1d2c9eb9e862
BLAKE2b-256 29e2502e89a724c627199d4a731914fec5ce78082fbb25907746f2db306b039a

See more details on using hashes here.

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