Scroll to navigation

PKGOS-MODERNIZE(1) Debian OpenStack packaging PKGOS-MODERNIZE(1)

NAME

pkgos-modernize - modernize the packaging of a Debian OpenStack package

SYNOPSIS

pkgos-modernize [--ask-upstream-git]

DESCRIPTION

pkgos-modernize brings the packaging of a Debian OpenStack package up to the current standards of the team. It must be run from the top of the package's Git repository, whose working tree must be clean, so that each operation can produce an atomic git commit.

Every operation is idempotent: when there is nothing to do, it does nothing at all. Each operation that does change something writes its own debian/changelog bullet and performs an atomic git commit, using the operation's description as the commit message. When the current version was already uploaded to unstable (checked with rmadison), the version is first bumped with dch -i and the operation's bullet becomes the first bullet of the new entry; otherwise bullets are appended to the current entry. Consecutive operations of a single run share the same changelog entry.

The following operations are performed:

Rewrites debian/salsa-ci.yml to the team's standard content (the Salsa CI pipeline with build-package-i386 disabled), creating it if it is absent.
Rewrites debian/watch to the team's standard version=4 mode=git form, with the usual uversionmangle of the release candidates and beta versions. The upstream Git URL is taken from the UPSTREAM_GIT variable of debian/rules when it is defined, and otherwise guessed as https://github.com/openstack/<source-package>, which is verified to exist with git ls-remote before being written; when the verification fails, the operation is skipped with a warning. An already modern debian/watch is never touched, whatever URL it carries.
The Priority: field is deprecated in Debian.
Removes the deprecated debian/compat file if there is one, and rewrites the debhelper build-dependency to debhelper-compat at the configured level.
Rewrites the Standards-Version field of debian/control, adding it after Source: when the field is absent.

OPTIONS

When rewriting debian/watch and no UPSTREAM_GIT is defined in debian/rules, prompt for the upstream Git URL instead of silently guessing https://github.com/openstack/<source-package>.

FILES

/etc/pkgos/pkgos.conf
Global OpenStack packaging tools configuration file. The path can be overridden with the PKGOS_CONF variable. The following variables are used:
The debhelper-compat version that packages are upgraded to (default: 13).
The Standards-Version that packages are upgraded to (default: 4.7.4).

SEE ALSO

dch(1), rmadison(1), uscan(1).

AUTHOR

This script and its man page: (c) 2026, Thomas Goirand <zigo@debian.org>, released under the Apache-2.0 license.

15 October 2026 openstack-pkg-tools