NAME¶

pkgos-generate-snapshot - build an upstream snapshot tarball of a Python project

SYNOPSIS¶

pkgos-generate-snapshot

DESCRIPTION¶

pkgos-generate-snapshot builds an upstream source distribution with python3 setup.py sdist , then moves the resulting tarball to ~/tarballs/<pkg_name>_<deb_version>.orig.tar.gz, converting the version to a Debian compatible upstream version: ".0a" becomes "~a", ".0b" becomes "~b", and ".dev" becomes "~dev". It must be run from the root of the package source tree, and a dist folder may exist, as its content is removed first.

OPTIONS¶

None.

FILES¶

~/tarballs/

Destination folder for the generated .orig.tar.gz, which is created if missing.

EXAMPLES¶

pkgos-generate-snapshot && dpkg-source -x ~/tarballs/$(ls -t ~/tarballs | head -1) ./new-upstream-source

AUTHOR¶

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