rebase-helper is a tool which helps package maintainers to rebase their packages to latest upstream versions.

It should be executed from a directory containing spec file, sources and patches (usually cloned dist-git repository).

The new version is specified by SOURCES argument, which can be either version number or filename of the new source archive. Starting with version 0.10.0, this argument can be omitted and the new version determined automatically using one of available versioneers.


Positional arguments

new upstream sources

Optional arguments

-h, --help
show help message and exit
show rebase-helper version and exit
-v, --verbose
be more verbose (recommended)
-b, --build-only
only build SRPM and RPMs
--comparepkgs-only COMPAREPKGS_DIR
compare already built packages, COMPAREPKGS_DIR must be a directory with the following structure: <dir_name>/{old,new}/RPM
-p, --patch-only
only apply patches
--buildtool {copr,rpmbuild,mock}
build tool to use, defaults to mock
--srpm-buildtool {rpmbuild,mock}
SRPM build tool to use, defaults to rpmbuild
--pkgcomparetool {rpmdiff,abipkgdiff,pkgdiff,csmock}
set of tools to use for package comparison, defaults to rpmdiff,abipkgdiff,pkgdiff
--outputtool {text,json}
tool to use for formatting rebase output, defaults to text
--versioneer {cpan,pypi,rubygems,anitya,npmjs}
tool to use for determining latest upstream version
do not download sources
-w, --keep-workspace
do not remove workspace directory after finishing
-c, --continue
continue previously interrupted rebase
--color {always,never,auto}
colorize the output, defaults to auto
disable inapplicable patches in rebased SPEC file
do not interact with user
--build-tasks OLD_TASK,NEW_TASK
comma-separated remote build task ids
do not wait for remote builds to finish
enable arbitrary local builder option(s), enclose BUILDER_OPTIONS in quotes and note that = before it is mandatory
enable arbitrary local srpm builder option(s), enclose SRPM_BUILDER_OPTIONS in quotes and note that = before it is mandatory
--build-retries BUILD_RETRIES
number of retries of a failed build, defaults to 2
--results-dir RESULTS_DIR
directory where rebase-helper output will be stored
do not build old sources, download latest build from Koji instead
--changelog-entry CHANGELOG_ENTRY
text to use as changelog entry, can contain RPM macros, which will be expanded
--conf CONF
custom path to configuration file