New Upstream Snapshot - stdeb

Ready changes

Summary

Merged new upstream version: 0.10.0+git20210619.1.bc37aa1 (was: 0.10.0).

Resulting package

Built on 2023-01-19T08:04 (took 4m55s)

The resulting binary packages can be installed (if you have the apt repository enabled) by running one of:

apt install -t fresh-snapshots python3-stdeb

Lintian Result

Diff

diff --git a/.gitignore b/.gitignore
deleted file mode 100644
index 852f550..0000000
--- a/.gitignore
+++ /dev/null
@@ -1,11 +0,0 @@
-build
-deb_dist
-*.pyc
-stdeb.egg-info/PKG-INFO
-stdeb.egg-info/SOURCES.txt
-stdeb.egg-info/dependency_links.txt
-stdeb.egg-info/entry_points.txt
-stdeb.egg-info/top_level.txt
-dist
-*~
-MANIFEST
diff --git a/.travis.yml b/.travis.yml
index f061948..b9c2752 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,8 @@
 # http://travis-ci.org/#!/astraw/stdeb
 language: python
+arch:
+    - amd64
+    - ppc64le
 python:
     - "2.7_with_system_site_packages"
     - "3.5_with_system_site_packages"
diff --git a/PKG-INFO b/PKG-INFO
index 527ba79..9c1df75 100644
--- a/PKG-INFO
+++ b/PKG-INFO
@@ -1,4 +1,4 @@
-Metadata-Version: 1.1
+Metadata-Version: 2.1
 Name: stdeb
 Version: 0.10.0
 Summary: Python to Debian source package conversion utility
@@ -6,903 +6,6 @@ Home-page: http://github.com/astraw/stdeb
 Author: Andrew Straw
 Author-email: strawman@astraw.com
 License: MIT
-Description: .. image:: https://travis-ci.org/astraw/stdeb.png?branch=master
-                :target: https://travis-ci.org/astraw/stdeb
-        
-        stdeb - Python to Debian source package conversion utility
-        ==========================================================
-        
-        `stdeb <http://github.com/astraw/stdeb>`_ produces Debian source
-        packages from Python packages via a new distutils command,
-        ``sdist_dsc``. Automatic defaults are provided for the Debian package,
-        but many aspects of the resulting package can be customized (see the
-        customizing section, below). An additional command, ``bdist_deb``,
-        creates a Debian binary package, a .deb file. The ``install_deb``
-        command installs this .deb file. The ``debianize`` command builds a
-        ``debian/`` directory directly alongside your setup.py.
-        
-        Several convenience utilities are also provided:
-        
-        * ``pypi-download`` will query the `Python Package Index (PyPI)
-          <http://pypi.python.org/>`_ for a package and download it.
-        * ``pypi-install`` will query the `Python Package Index (PyPI)
-          <http://pypi.python.org/>`_ for a package, download it, create a
-          .deb from it, and then install the .deb.
-        * ``py2dsc`` will convert a distutils-built source tarball into a
-          Debian source package.
-        * ``py2dsc-deb`` will convert a distutils-built source tarball into a
-          Debian source package and then use the Debian machinery to build a
-          .deb file from this.
-        
-        .. contents::
-        
-        
-        Python 3 support
-        ----------------
-        
-        As explained in more detail below, the heart of stdeb is the sdist_dsc
-        distutils command. This command runs once to generate a Debian source
-        package. This Debian source package can specify building packages for
-        Python 2, Python 3, or both. Furthermore, this generation can be done
-        with the Python 2 or Python 3 interpreter. By default, only packages
-        are built for the version of Python being used. To override this, use
-        ``--with-python2=True`` or ``--with-python3=True`` as an argument to
-        the sdist_dsc distutils command (or use both to be sure). For example,
-        to build only a Python 3 package using the Python 3 interpreter::
-        
-          python3 setup.py --command-packages=stdeb.command bdist_deb
-        
-        To build both Python 2 and Python 3 packages using the Python 3
-        interpreter (and only the Python3 package installs scripts)::
-        
-          python3 setup.py --command-packages=stdeb.command sdist_dsc --with-python2=True --with-python3=True --no-python2-scripts=True bdist_deb
-        
-        News
-        ----
-        
-         * 2020-10-28: **Version 0.10.0**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.10.0>`__.
-        
-          * Bugfixes:
-        
-            * add sleep between PyPI API calls to avoid rate limit (#173)
-        
-          * Improvements:
-        
-            * use SOURCE_DATE_EPOCH if set for timestamp in generated changelog to
-              generate reproducbile artifacts (#166)
-            * update debhelper compat version from 7 to 9 (#158)
-            * added flag --with-dh-systemd (#162)
-            * add support for DEBEMAIL envvar (#168)
-            * use setuptools "url" field for "Homepage" field in debian/control (#169)
-            * dh_virtualenv: specify Python version (#165)
-            * added compat flag to modify Debian compatibility level (#163)
-        
-          * Cosmetic:
-            * remove excess newlines from debian/control and rules file (#167)
-            * use flake8 to check style in Travis CI, update code to comply (#171)
-        
-         * 2020-06-11: **Version 0.9.1**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.9.1>`__.
-        
-          * Bugfixes:
-        
-            * handle path with spaces in zip tarball (#150)
-            * fix map() iterator issue in Python 3 (#152)
-            * fix checking for python3-all (instead of python-all) when using only
-              Python 3 (#154)
-        
-          * Improvements:
-        
-            * get date in Python, avoiding requiring ``date`` on macOS (#115)
-            * add configuration file option ``Python2-Depends-Name`` (#156)
-            * add an option ``--with-dh-virtualenv`` (#155)
-            * add an option named ``ignore-source-changes`` (#151)
-        
-         * 2019-12-09: **Version 0.9.0**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.9.0>`__.
-        
-          * Bugfixes:
-        
-            * fix applying patch files under Python 3
-        
-          * Improvements:
-        
-            * add ``--sign-results`` to sdist_dsc and bdist_deb command
-            * add ``--debian-version`` to CLI program options
-            * add support for ``Breaks`` / ``Breaks3`` in debian/control
-            * add support for ``Suite3`` option
-            * support zip files in pypi-install
-        
-          * Breaking changes:
-        
-            * remove deprecated ``dh_desktop`` call
-        
-         * 2015-02-18: **Version 0.8.5**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.8.5>`__. Bugfixes: reverted
-           change that installed into virtualenv when built in
-           virtualenv. Improvements: Added
-           `--allow-virtualenv-install-location` to allow installing into
-           virtualenv location. Supports Debian Squeeze (6), Debian Wheezy
-           (7), Ubuntu Precise (12.04), Ubuntu Trusty (14.04) and later
-           releases.
-        
-         * 2015-02-16: **Version 0.8.4**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.8.4>`__. Bugfixes: works on
-           Python 3.4 (e.g. Ubuntu Trusty) again. Improvements: Improved
-           customization for Python 3 (Dirk Thomas added
-           `force-x-python3-version` and `X-Python3-Version` and Louis for
-           `Recommends3`, `Suggests3`, `Provides3` and `Replaces3`
-           support. Supports Debian Squeeze (6), Debian Wheezy (7), Ubuntu
-           Precise (12.04), Ubuntu Trusty (14.04) and later releases.
-        
-         * 2015-02-14: **Version 0.8.3**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.8.3>`__. This is a bugfix
-           release which fixes several aspects of Unicode support. Tests pass
-           on Debian Squeeze (6), Debian Wheezy (7), and Ubuntu Precise
-           (12.04). Support for Python 3.4 (e.g. Ubuntu Trusty 14.04) was
-           mistakenly broken and was fixed in the 0.8.3 release.
-        
-         * 2014-8-14: **Version 0.8.2**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.8.2>`__. This is a bugfix
-           release fixing a serious issue that would cause a Python 2 package
-           to be built if only a Python 3 package was requested in some
-           circumstances.
-        
-         * 2014-8-10: **Version 0.8.1**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.8.1>`__. Due
-           to bugs in 0.8.0, this release is the first announced from the 0.8
-           series. Highlights since 0.7.1:
-        
-           - Full support for Python 3. This includes being run from Python 3
-             and generating packages for Python 3. The default is to build
-             Python 3 packages when run with Python 3 and to build Python 2
-             packages when run from Python 2. Command line options can be used
-             to build packages for the other Python interpreter, too.
-        
-           - Build .changes file for source package. While this still must be
-             signed for upload to a PPA, for example, it should still be
-             useful in some cases.
-        
-           - Switch to Debian source format 3.0 (quilt). Practically speaking,
-             the .diff.gz file that used to come with a source package is now
-             replaced by a .debian.tar.gz file.
-        
-           - Verify SSL certificates when talking to PyPI using
-             Requests. (Verification requires Requests >= 0.8.8.)
-        
-           - Many bugfixes.
-        
-         * 2014-05-05: **Version 0.7.1**. See the `download page
-           <https://pypi.python.org/pypi/stdeb/0.7.1>`__. Highlights for this
-           release (you may also wish to consult the full `changelog
-           <http://github.com/astraw/stdeb/blob/release-0.7.1/CHANGELOG.txt>`__). Due
-           to bugs in 0.7.0, this release is the first announced from the 0.7
-           series. Highlights since 0.6.0:
-        
-           - New commands: pypi-download and pypi-install to directly download
-             and install packages from PyPI, respectively. py2dsc-deb directly
-             creates a .deb file from a source tarball.
-        
-           - New distutils command: install_deb lets you directly install a
-             python package as a standard system package.
-        
-           - Many bugfixes, including the new URL for PyPI.
-        
-           - Automated runs of test suite, thanks to Travis CI
-        
-           - Thanks to many, especially Piotr Ożarowski for help with stdeb.
-        
-         * 2010-06-18: **Version 0.6.0**. See the `download page
-           <http://pypi.python.org/pypi/stdeb/0.6.0>`__. Highlights for this
-           release (you may also wish to consult the full `changelog
-           <http://github.com/astraw/stdeb/blob/release-0.6.0/CHANGELOG.txt>`__):
-        
-           - A new ``debianize`` command to build a ``debian/`` directory
-             alongside your setup.py file.
-        
-           - Bugfixes.
-        
-         * 2010-01-09: **Version 0.5.1**. Bugfix release. See the `download
-           page <http://pypi.python.org/pypi/stdeb/0.5.1>`__, the `changelog
-           <http://github.com/astraw/stdeb/blob/release-0.5.1/CHANGELOG.txt>`__
-           and `release notes
-           <http://github.com/astraw/stdeb/blob/release-0.5.1/RELEASE_NOTES.txt>`__.
-        
-         * 2009-12-30: **Version 0.5.0**. See the `download page
-           <http://pypi.python.org/pypi/stdeb/0.5.0>`__. Highlights for this
-           release (you may also wish to consult the full `changelog
-           <http://github.com/astraw/stdeb/blob/release-0.5.0/CHANGELOG.txt>`__):
-        
-           - A new ``pypi-install`` script will automatically download, make a
-             .deb, and install packages from the `Python Package Index (PyPI)`_.
-        
-           - Removal of the setuptools dependency.
-        
-           - New option (`--guess-conflicts-provides-replaces`) to query
-             original Debian packages for Conflicts/Provides/Replaces
-             information.
-        
-           - As a result of these changes and to fix a couple bugs/warts, some
-             minor backwards incompatible changes and deprecations were
-             made. Please check the `release notes
-             <http://github.com/astraw/stdeb/blob/release-0.5.0/RELEASE_NOTES.txt>`__.
-        
-         * 2009-12-28: Version 0.4.3 Released. See the `download page`__. See the
-           `changelog`__ and `release notes`__.
-         * 2009-11-02: Version 0.4.2 Released. See the `download page`__. See the
-           `changelog`__ and `release notes`__.
-         * 2009-10-04: Version 0.4.1 Released. See the `download page`__. See the
-           `changelog`__ and `release notes`__.
-         * 2009-09-27: Version 0.4 Released. See the `download page`__. This
-           version switches to debhelper 7. See the `Changelog for 0.4`__.
-        
-        __ http://pypi.python.org/pypi/stdeb/0.4.3
-        __ http://github.com/astraw/stdeb/blob/release-0.4.3/CHANGELOG.txt
-        __ http://github.com/astraw/stdeb/blob/release-0.4.3/RELEASE_NOTES.txt
-        __ http://pypi.python.org/pypi/stdeb/0.4.2
-        __ http://github.com/astraw/stdeb/blob/release-0.4.2/CHANGELOG.txt
-        __ http://github.com/astraw/stdeb/blob/release-0.4.2/RELEASE_NOTES.txt
-        __ http://pypi.python.org/pypi/stdeb/0.4.1
-        __ http://github.com/astraw/stdeb/blob/release-0.4.1/CHANGELOG.txt
-        __ http://github.com/astraw/stdeb/blob/release-0.4.1/RELEASE_NOTES.txt
-        __ http://pypi.python.org/pypi/stdeb/0.4
-        __ http://github.com/astraw/stdeb/blob/release-0.4/CHANGELOG.txt
-        
-        Releases up to and including 0.3.2 are compatible with Ubuntu Hardy.
-        
-         * 2009-10-04: Version 0.3.2 Released. See the `download page`__. See the `Changelog for 0.3.2`__
-         * 2009-09-27: Version 0.3.1 Released. See the `download page`__. See the `Changelog for 0.3.1`__
-         * 2009-03-21: Version 0.3 Released. See the `download page`__. See the `Changelog for 0.3`__
-         * 2009-02-17: Version 0.2.3 Released. See the `download page`__. See the `Changelog for 0.2.3`__
-         * 2009-01-29: Version 0.2.2 Released. See the `download page`__. See the `Changelog for 0.2.2`__
-         * 2008-04-26: Version 0.2.1 Released. See the `download page`__. See the `Changelog for 0.2.1`__
-         * 2008-04-26: Version 0.2 Released. See the `download page`__. See the `Changelog for 0.2`__
-         * 2007-04-02: Version 0.2.a1 Released. See the `old download page`_.
-         * 2006-06-19: Version 0.1 Released. See the `old download page`_.
-        
-        __ http://pypi.python.org/pypi/stdeb/0.3.2
-        __ http://github.com/astraw/stdeb/blob/release-0.3.2/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.3.1
-        __ http://github.com/astraw/stdeb/blob/release-0.3.1/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.3
-        __ http://github.com/astraw/stdeb/blob/release-0.3/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.2.3
-        __ http://github.com/astraw/stdeb/blob/release-0.2.3/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.2.2
-        __ http://github.com/astraw/stdeb/blob/release-0.2.2/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.2.1
-        __ http://github.com/astraw/stdeb/blob/release-0.2.1/CHANGELOG.txt
-        __ http://pypi.python.org/pypi/stdeb/0.2
-        __ http://github.com/astraw/stdeb/blob/release-0.2/CHANGELOG.txt
-        
-        The commands
-        ------------
-        
-        pypi-download, command-line command
-        ```````````````````````````````````
-        
-        ``pypi-download`` takes a package name, queries PyPI for it and downloads
-        it::
-        
-          pypi-download [options] mypackage
-        
-        pypi-install, command-line command
-        ``````````````````````````````````
-        
-        ``pypi-install`` takes a package name, queries PyPI for it, downloads
-        it, builds a Debian source package and then .deb from it, and this
-        installs it::
-        
-          pypi-install [options] mypackage
-        
-        py2dsc, command-line command
-        ````````````````````````````
-        
-        ``py2dsc`` takes a .tar.gz source package and build a Debian source
-        package from it::
-        
-          py2dsc [options] mypackage-0.1.tar.gz # uses pre-built Python source package
-        
-        py2dsc-deb, command-line command
-        ````````````````````````````````
-        
-        ``py2dsc-deb`` takes a .tar.gz source package and build a Debian source
-        package and then a .deb file from it::
-        
-          py2dsc-deb [options] mypackage-0.1.tar.gz # uses pre-built Python source package
-        
-        sdist_dsc, distutils command
-        ````````````````````````````
-        All methods eventually result in a call to the ``sdist_dsc`` distutils
-        command. You may prefer to do so directly::
-        
-          python setup.py --command-packages=stdeb.command sdist_dsc
-        
-        A Debian source package is produced from unmodified
-        Python packages. The following files are produced in a newly created
-        subdirectory ``deb_dist``:
-        
-         * ``packagename_versionname.orig.tar.gz``
-         * ``packagename_versionname-debianversion.dsc``
-         * ``packagename_versionname-debianversion.diff.gz``
-        
-        These can then be compiled into binary packages using the standard
-        Debian machinery (e.g. dpkg-buildpackage).
-        
-        bdist_deb, distutils command
-        ````````````````````````````
-        A ``bdist_deb`` distutils command is installed. This calls the
-        sdist_dsc command and then runs dpkg-buildpackage on the result::
-        
-          python setup.py --command-packages=stdeb.command bdist_deb
-        
-        install_deb, distutils command
-        ``````````````````````````````
-        
-        The ``install_deb`` distutils command calls the bdist_deb command and
-        then installs the result. You need to run this with superuser privilege::
-        
-          sudo python setup.py --command-packages=stdeb.command install_deb
-        
-        debianize, distutils command
-        ````````````````````````````
-        The ``debianize`` distutils command builds the same ``debian/``
-        directory as used in the previous command, but the output is placed
-        directly in the project's root folder (alongside setup.py). This is
-        useful for customizing the Debian package directly (rather than using
-        the various stdeb options to tune the generated package).
-        
-        ::
-        
-          python setup.py --command-packages=stdeb.command debianize
-        
-        A note about telling distutils to use the stdeb distutils commands
-        ``````````````````````````````````````````````````````````````````
-        
-        Distutils command packages can also be specified in distutils
-        configuration files (rather than using the ``--command-packages``
-        command line argument to ``setup.py``), as specified in the `distutils
-        documentation
-        <https://docs.python.org/2/distutils/extending.html>`_. Specifically,
-        you could include this in your ``~/.pydistutils.cfg`` file::
-        
-          [global]
-          command-packages: stdeb.command
-        
-        Examples
-        --------
-        
-        These all assume you have stdeb installed in your system Python
-        path. stdeb also works from a non-system Python path (e.g. a
-        `virtualenv <http://pypi.python.org/pypi/virtualenv>`_).
-        
-        Quickstart 1: Install something from PyPI now, I don't care about anything else
-        ```````````````````````````````````````````````````````````````````````````````
-        
-        Do this from the command line::
-        
-          pypi-install mypackage
-        
-        **Warning: Despite doing its best, there is absolutely no way stdeb
-        can guarantee all the Debian package dependencies will be properly
-        fulfilled without manual intervention. Using pypi-install bypasses
-        your ability to customize stdeb's behavior. Read the rest of this
-        document to understand how to make better packages.**
-        
-        Quickstart 2: Just tell me the fastest way to make a .deb
-        `````````````````````````````````````````````````````````
-        
-        (First, install stdeb as you normally install Python packages.)
-        
-        Do this from the directory with your `setup.py` file::
-        
-          python setup.py --command-packages=stdeb.command bdist_deb
-        
-        This will make a Debian source package (.dsc, .orig.tar.gz and
-        .diff.gz files) and then compile it to a Debian binary package (.deb)
-        for your current system. The result will be in ``deb_dist``.
-        
-        **Warning: installing the .deb file on other versions of Ubuntu or
-        Debian than the one on which it was compiled will result in undefined
-        behavior. If you have extension modules, they will probably
-        break. Even in the absence of extension modules, bad stuff will likely
-        happen.**
-        
-        For this reason, it is much better to build the Debian source package
-        and then compile that (e.g. using `Ubuntu's PPA`__) for each target
-        version of Debian or Ubuntu.
-        
-        __ https://help.launchpad.net/Packaging/PPA
-        
-        Quickstart 3: I read the warning, so show me how to make a source package, then compile it
-        ``````````````````````````````````````````````````````````````````````````````````````````
-        
-        This generates a source package::
-        
-          wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
-          py2dsc Reindent-0.1.0.tar.gz
-        
-        This turns it into a .deb using the standard Debian tools. (Do *this*
-        on the same source package for each target distribution)::
-        
-          cd deb_dist/reindent-0.1.0/
-          dpkg-buildpackage -rfakeroot -uc -us
-        
-        This installs it::
-        
-          cd ..
-          sudo dpkg -i python-reindent_0.1.0-1_all.deb
-        
-        Quickstart 4: Install from a Python package direct to a debian system package
-        `````````````````````````````````````````````````````````````````````````````
-        
-        (First, install stdeb as you normally install Python packages.)
-        
-        Do this from the directory with your `setup.py` file::
-        
-          python setup.py --command-packages=stdeb.command install_deb
-        
-        This will make a Debian source package (.dsc, .orig.tar.gz and
-        .diff.gz files), compile it to a Debian binary package (.deb) for your
-        current system and then install it using ``dpkg``.
-        
-        
-        Another example, with more explanation
-        ``````````````````````````````````````
-        
-        This example is more useful if you don't have a Python source package
-        (.tar.gz file generated by ``python setup.py sdist``). For the sake of
-        illustration, we do download such a tarball, but immediately unpack it
-        (alternatively, use a version control system to grab the unpacked
-        source of a package)::
-        
-          wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
-          tar xzf Reindent-0.1.0.tar.gz
-          cd Reindent-0.1.0
-        
-        The following will generate a directory ``deb_dist`` containing the
-        files ``reindent_0.1.0-1.dsc``, ``reindent_0.1.0.orig.tar.gz`` and
-        ``reindent_0.1.0-1.diff.gz``, which, together, are a debian source
-        package::
-        
-          python setup.py --command-packages=stdeb.command sdist_dsc
-        
-        The source generated in the above way is also extracted (using
-        ``dpkg-source -x``) and placed in the ``deb_dist`` subdirectory. To
-        continue the example above::
-        
-          cd deb_dist/reindent-0.1.0
-          dpkg-buildpackage -rfakeroot -uc -us
-        
-        Finally, the generated package can be installed::
-        
-          cd ..
-          sudo dpkg -i python-reindent_0.1.0-1_all.deb
-        
-        For yet another example of use, with still more explanation, see
-        `allmydata-tahoe ticket 251`_.
-        
-        .. _allmydata-tahoe ticket 251: http://allmydata.org/trac/tahoe/ticket/251
-        
-        Download
-        --------
-        
-        Files are available at the `download page`_ (for ancient releases, see
-        the `old download page`_).
-        
-        .. _download page: https://pypi.python.org/pypi/stdeb
-        .. _old download page: http://stdeb.python-hosting.com/wiki/Download
-        
-        The git repository is available at
-        http://github.com/astraw/stdeb
-        
-        Install (or, using stdeb to create an stdeb installer)
-        ------------------------------------------------------
-        
-        For a bit of fun, here's how to install stdeb using stdeb. Note that
-        stdeb is also in Debian and Ubuntu, so this recipe is only necessary
-        to install a more recent stdeb.
-        
-        ::
-        
-          STDEB_VERSION="0.10.0"
-        
-          # Download stdeb
-          wget http://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
-        
-          # Extract it
-          tar xzf stdeb-$STDEB_VERSION.tar.gz
-        
-          # Enter extracted source package
-          cd stdeb-$STDEB_VERSION
-        
-          # Build .deb (making use of stdeb package directory in sys.path).
-          python setup.py --command-packages=stdeb.command bdist_deb
-        
-          # Install it
-          sudo dpkg -i deb_dist/python-stdeb_$STDEB_VERSION-1_all.deb
-        
-        Background
-        ----------
-        
-        For the average Python package, its source distribution
-        (python_package.tar.gz created with ``python setup.py sdist``)
-        contains nearly everything necessary to make a Debian source
-        package. This near-equivalence encouraged me to write this distutils
-        extension, which executes the setup.py file to extract relevant
-        information. `setuptools
-        <http://peak.telecommunity.com/DevCenter/setuptools>`_ may optionally
-        be used.
-        
-        I wrote this initially to Debianize several Python packages of my own,
-        but I have the feeling it could be generally useful. It appears
-        similar, at least in theory, to easydeb_, `Logilab's Devtools`_,
-        bdist_dpkg_, bdist_deb_, pkgme_ and `dh-virtualenv
-        <https://github.com/spotify/dh-virtualenv>`__.
-        
-        .. _easydeb: http://easy-deb.sourceforge.net/
-        .. _Logilab's DevTools: http://www.logilab.org/projects/devtools
-        .. _bdist_dpkg: http://svn.python.org/view/sandbox/trunk/Lib/bdist_dpkg.py
-        .. _bdist_deb: http://bugs.python.org/issue1054967
-        .. _pkgme: https://launchpad.net/pkgme
-        
-        Features
-        --------
-        
-        * Create a package for all Python versions supported by
-          python-support. (Limiting this range is possible with the
-          ``XS-Python-Version:`` config option.)
-        
-        * Automatic conversion of Python package names into valid Debian
-          package names.
-        
-        * Attempt to automatically convert version numbers such that ordering
-          is maintained. See also the config option
-          ``Forced-Upstream-Version``.
-        
-        * Fine grained control of version numbers. (``Debian-Version``,
-          ``Forced-Upstream-Version``, ``Upstream-Version-Prefix``,
-          ``Upstream-Version-Suffix`` config options.)
-        
-        * Install .desktop files. (``MIME-Desktop-Files`` config option.)
-        
-        * Install .mime and .sharedmimeinfo files. (``MIME-File`` and
-          ``Shared-MIME-File`` config options.)
-        
-        * Install copyright files. (``Copyright-File`` config option.)
-        
-        * Apply patches to upstream sources. (``Stdeb-Patch-File`` config
-          option.)
-        
-        * Pass environment variables to setup.py script. (``Setup-Env-Vars``
-          config option.)
-        
-        Customizing the produced Debian source package (config options)
-        ---------------------------------------------------------------
-        
-        stdeb will attempt to provide reasonable defaults, but these are only
-        guesses.
-        
-        There are two ways to customize the Debian source package produced by
-        stdeb. First, you may provide options to the distutils
-        commands. Second, you may provide an ``stdeb.cfg`` file.
-        
-        stdeb distutils command options
-        ```````````````````````````````
-        
-        The sdist_dsc command takes command-line options to the distutils
-        command. For example::
-        
-          python setup.py --command-packages=stdeb.command sdist_dsc --debian-version 0MyName1
-        
-        This creates a Debian package with the Debian version set to
-        "0MyName1".
-        
-        These options can also be set via distutils configuration
-        files. (These are the ``setup.cfg`` file alongside ``setup.py`` and
-        the ~/.pydistutils.cfg file.) In that case, put the arguments in the
-        ``[sdist_dsc]`` section. For example, a project's ``~/.setup.cfg``
-        file might have this::
-        
-          [sdist_dsc]
-          debian-version: 0MyName1
-        
-        To pass these commands to sdist_dsc when calling bdist_deb, do this::
-        
-          python setup.py sdist_dsc --debian-version 0MyName1 bdist_deb
-        
-        ====================================== =========================================
-                Command line option                      Effect
-        ====================================== =========================================
-          --with-python2                       build Python 2 package (default=True)
-          --with-python3                       build Python 3 package (default=False)
-          --no-python2-scripts                 disable installation of Python 2 scripts (default=False)
-          --no-python3-scripts                 disable installation of Python 3 scripts (default=False)
-          --force-x-python3-version            Override default minimum python3:any
-                                               dependency with value from x-python3-
-                                               version
-          --allow-virtualenv-install-location  Allow installing into
-                                               /some/random/virtualenv-path
-          --with-dh-virtualenv                 Build the package using dh_virtualenv, so all dependencies
-                                               are embedded into the packages.
-          --with-dh-systemd                    Add the systemd addon that will add dh_systemd_enable and
-                                               dh_systemd_start helpers at the correct time during build.
-          --sign-results                       Use gpg to sign the resulting .dsc and
-                                               .changes file
-          --dist-dir (-d)                      directory to put final built
-                                               distributions in (default='deb_dist')
-          --patch-already-applied (-a)         patch was already applied (used when
-                                               py2dsc calls sdist_dsc)
-          --default-distribution               deprecated (see --suite)
-          --compat                             debian compatibility level (default=9)
-          --suite (-z)                         distribution name to use if not
-                                               specified in .cfg (default='unstable')
-          --default-maintainer                 deprecated (see --maintainer)
-          --maintainer (-m)                    maintainer name and email to use if not
-                                               specified in .cfg (default from
-                                               setup.py)
-          --extra-cfg-file (-x)                additional .cfg file (in addition to
-                                               stdeb.cfg if present)
-          --patch-file (-p)                    patch file applied before setup.py
-                                               called (incompatible with file
-                                               specified in .cfg)
-          --patch-level (-l)                   patch file applied before setup.py
-                                               called (incompatible with file
-                                               specified in .cfg)
-          --patch-posix (-q)                   apply the patch with --posix mode
-          --remove-expanded-source-dir (-r)    remove the expanded source directory
-          --ignore-install-requires (-i)       ignore the requirements from
-                                               requires.txt in the egg-info directory
-          --ignore-source-changes              ignore all changes on source when
-                                               building source package (add -i.*
-                                               option to dpkg-source)
-          --no-backwards-compatibility         This option has no effect, is here for
-                                               backwards compatibility, and may be
-                                               removed someday.
-          --guess-conflicts-provides-replaces  If True, attempt to guess
-                                               Conflicts/Provides/Replaces in
-                                               debian/control based on apt-cache
-                                               output. (Default=False).
-          --use-premade-distfile (-P)          use .zip or .tar.gz file already made
-                                               by sdist command
-          --source                             debian/control Source: (Default:
-                                               <source-debianized-setup-name>)
-          --package                            debian/control Package: (Default:
-                                               python-<debianized-setup-name>)
-          --suite                              suite (e.g. stable, lucid) in changelog
-                                               (Default: unstable)
-          --maintainer                         debian/control Maintainer: (Default:
-                                               <setup-maintainer-or-author>)
-          --debian-version                     debian version (Default: 1)
-          --section                            debian/control Section: (Default:
-                                               python)
-          --epoch                              version epoch
-          --forced-upstream-version            forced upstream version
-          --upstream-version-prefix            upstream version prefix
-          --upstream-version-suffix            upstream version suffix
-          --uploaders                          uploaders
-          --copyright-file                     copyright file
-          --build-depends                      debian/control Build-Depends:
-          --build-conflicts                    debian/control Build-Conflicts:
-          --stdeb-patch-file                   file containing patches for stdeb to
-                                               apply
-          --stdeb-patch-level                  patch level provided to patch command
-          --depends                            debian/control Depends:
-          --suggests                           debian/control Suggests:
-          --recommends                         debian/control Recommends:
-          --xs-python-version                  debian/control XS-Python-Version:
-          --x-python3-version                  debian/control X-Python3-Version:
-          --dpkg-shlibdeps-params              parameters passed to dpkg-shlibdeps
-          --conflicts                          debian/control Conflicts:
-          --provides                           debian/control Provides:
-          --replaces                           debian/control Replaces:
-          --mime-desktop-files                 MIME desktop files
-          --mime-file                          MIME file
-          --shared-mime-file                   shared MIME file
-          --setup-env-vars                     environment variables passed to
-                                               setup.py
-          --udev-rules                         file with rules to install to udev
-        
-        ====================================== =========================================
-        
-        
-        You may also pass any arguments described below for the stdeb.cfg file
-        via distutils options. Passing the arguments this way (either on the
-        command line, or in the ``[sdist_dsc]`` section of a distutils .cfg
-        file) will take precedence. The option name should be given in lower
-        case.
-        
-        stdeb.cfg configuration file
-        ````````````````````````````
-        
-        You may write config files of the format understood by `ConfigParser
-        <http://docs.python.org/lib/module-ConfigParser.html>`_. When building
-        each package, stdeb looks for the existence of a ``stdeb.cfg`` in the
-        directory with ``setup.py``. You may specify an additional config file
-        with the command-line option --extra-cfg-file. The section should
-        should either be [DEFAULT] or [package_name], which package_name is
-        specified as the name argument to the setup() command. An example
-        stdeb.cfg file is::
-        
-          [DEFAULT]
-          Depends: python-numpy
-          XS-Python-Version: >= 2.6
-        
-        All available options:
-        
-        ====================================== =========================================
-          Config file option                     Effect
-        ====================================== =========================================
-          Source                               debian/control Source: (Default:
-                                               <source-debianized-setup-name>)
-          Package                              debian/control Package: (Default:
-                                               python-<debianized-setup-name>)
-          Package3                             debian/control Package: for python3
-                                               (Default:
-                                               python3-<debianized-setup-name>)
-          Suite                                suite (e.g. stable, lucid) in changelog
-                                               (Default: unstable)
-          Suite3                               suite (e.g. stable, lucid) for python3
-                                               (Default: uses value of Suite option)
-          Maintainer                           debian/control Maintainer: (Default:
-                                               <setup-maintainer-or-author>)
-          Debian-Version                       debian version (Default: 1)
-          Section                              debian/control Section: (Default:
-                                               python)
-          Epoch                                version epoch
-          Forced-Upstream-Version              forced upstream version
-          Upstream-Version-Prefix              upstream version prefix
-          Upstream-Version-Suffix              upstream version suffix
-          Uploaders                            uploaders
-          Copyright-File                       copyright file
-          Build-Depends                        debian/control Build-Depends:
-          Build-Conflicts                      debian/control Build-Conflicts:
-          Stdeb-Patch-File                     file containing patches for stdeb to
-                                               apply
-          Stdeb-Patch-Level                    patch level provided to patch command
-          Depends                              debian/control Depends:
-          Depends3                             debian/control Depends: for python3
-          Suggests                             debian/control Suggests:
-          Suggests3                            debian/control Suggests: for python3
-          Recommends                           debian/control Recommends:
-          Recommends3                          debian/control Recommends: for python3
-          XS-Python-Version                    debian/control XS-Python-Version:
-          X-Python3-Version                    debian/control X-Python3-Version:
-          Dpkg-Shlibdeps-Params                parameters passed to dpkg-shlibdeps
-          Conflicts                            debian/control Conflicts:
-          Conflicts3                           debian/control Conflicts: for python3
-          Breaks                               debian/control Breaks:
-          Breaks3                              debian/control Breaks: for python3
-          Provides                             debian/control Provides:
-          Provides3                            debian/control Provides: for python3
-          Replaces                             debian/control Replaces:
-          Replaces3                            debian/control Replaces: for python3
-          MIME-Desktop-Files                   MIME desktop files
-          MIME-File                            MIME file
-          Shared-MIME-File                     shared MIME file
-          Setup-Env-Vars                       environment variables passed to
-                                               setup.py
-          Udev-Rules                           file with rules to install to udev
-          Python2-Depends-Name                 override Python 2 Debian package name in
-                                               ${python:Depends}
-        ====================================== =========================================
-        
-        The option names in stdeb.cfg files are not case sensitive.
-        
-        Reproducible builds
-        -------------------
-        
-        By default stdeb uses the current time for the the timestamp in the generated
-        changelog file. This results in a non-reproducible build since every invocation
-        generates a different changelog / ``.deb``.
-        The environment variable ``SOURCE_DATE_EPOCH`` can be set to a fixed timestamp
-        (e.g. when the version was tagged or of the last commit was made) which will be
-        used in the changelog instead. This will ensure that the produced ``.deb`` is
-        reproducible on repeated invocations.
-        
-        For more information about reproducible builds and this specific environment
-        variable please see https://reproducible-builds.org/docs/source-date-epoch/
-        
-        Prerequisites
-        -------------
-        
-         * Python 2.7 or Python 3.x
-         * Standard Debian utilities such as ``date``, ``dpkg-source`` and
-           Debhelper 7 (use stdeb 0.3.x if you need to support older
-           distributions without dh7)
-         * If your setup.py uses the setuptools features ``setup_requires`` or
-           ``install_requires``, you must run ``apt-file update`` prior to
-           running any stdeb command.
-        
-        TODO
-        ----
-        
-        * Make output meet `Debian Python Policy`_ specifications or the `new
-          python policy`_. This will include several things, among which are:
-        
-          - the ability to make custom changelogs
-          - the ability to include project-supplied documentation as a -doc package
-          - include license information in debian/copyright
-          - the ability to include project-supplied examples, tests, and data
-            as a separate package
-          - much more not listed
-        
-        * Create (better) documentation
-        
-        * Log output using standard distutils mechanisms
-        
-        * Refactor the source code to have a simpler, more sane design
-        
-        .. _debian python policy: http://www.debian.org/doc/packaging-manuals/python-policy/
-        .. _new python policy: http://wiki.debian.org/DebianPython/NewPolicy
-        
-        Call for volunteers
-        -------------------
-        
-        I don't have a lot of time for this. This project stands a very real
-        chance of being only a shadow of its potential self unless people step
-        up and contribute. There are numerous ways in which people could
-        help. In particular, I'd be interested in finding a co-maintainer or
-        maintainer if the project generates any interest. Secondarily, I would
-        appreciate advice from Debian developers or Ubuntu MOTUs about the
-        arcane details of Python packaging.
-        
-        Mailing list
-        ------------
-        
-        Please address all questions to the distutils-SIG_
-        
-        .. _distutils-SIG: http://mail.python.org/mailman/listinfo/distutils-sig
-        
-        License
-        -------
-        
-        MIT-style license. Copyright (c) 2006-2015 stdeb authors.
-        
-        See the LICENSE.txt file provided with the source distribution for
-        full details.
-        
-        Authors
-        -------
-        
-        * Andrew Straw <strawman@astraw.com>
-        * Pedro Algarvio, aka, s0undt3ch <ufs@ufsoft.org>
-        * Gerry Reno (initial bdist_deb implementation)
-        
-        Additional Credits
-        ------------------
-        
-        * Zooko O'Whielacronx for the autofind-depends patch.
-        * Brett (last name unknown) for the --ignore-install-requires patch.
-        * Ximin Luo for a bug fix.
-        * Alexander D. Sedov for bug fixes and suggestions.
-        * Michele Mattioni for bug fix.
-        * Alexander V. Nikolaev for the debhelper buildsystem specification.
-        * Roland Sommer for the description field bugfix.
-        * Barry Warsaw for suggesting the debianize command.
-        * Asheesh Laroia for updating the PyPI URL.
-        * Piotr Ożarowski for implementing dh_python2 support.
-        * Nikita Burtsev for unicode tests and fixes
-        * Mikołaj Siedlarek for a bugfix
-        * Dirk Thomas for --force-x-python3-version and X-Python3-Version
-        * Louis for Recommends3, Suggests3, Provides3 and Replaces3 support
-        * kzwin for interop with virtualenv
-        * GitHub_ for hosting services.
-        * WebFaction_ (aka `python-hosting`_) for previous hosting services.
-        * TravisCI_ for continuous integration
-        
-        .. _GitHub: http://github.com/
-        .. _WebFaction: http://webfaction.com/
-        .. _python-hosting: http://python-hosting.com/
-        ..  _TravisCI: http://travis-ci.org/
-        
-        
-        .. image:: https://badges.gitter.im/Join%20Chat.svg
-           :alt: Join the chat at https://gitter.im/astraw/stdeb
-           :target: https://gitter.im/astraw/stdeb?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
-        
-Platform: UNKNOWN
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
@@ -910,3 +13,900 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
+License-File: LICENSE.txt
+
+.. image:: https://travis-ci.org/astraw/stdeb.png?branch=master
+        :target: https://travis-ci.org/astraw/stdeb
+
+stdeb - Python to Debian source package conversion utility
+==========================================================
+
+`stdeb <http://github.com/astraw/stdeb>`_ produces Debian source
+packages from Python packages via a new distutils command,
+``sdist_dsc``. Automatic defaults are provided for the Debian package,
+but many aspects of the resulting package can be customized (see the
+customizing section, below). An additional command, ``bdist_deb``,
+creates a Debian binary package, a .deb file. The ``install_deb``
+command installs this .deb file. The ``debianize`` command builds a
+``debian/`` directory directly alongside your setup.py.
+
+Several convenience utilities are also provided:
+
+* ``pypi-download`` will query the `Python Package Index (PyPI)
+  <http://pypi.python.org/>`_ for a package and download it.
+* ``pypi-install`` will query the `Python Package Index (PyPI)
+  <http://pypi.python.org/>`_ for a package, download it, create a
+  .deb from it, and then install the .deb.
+* ``py2dsc`` will convert a distutils-built source tarball into a
+  Debian source package.
+* ``py2dsc-deb`` will convert a distutils-built source tarball into a
+  Debian source package and then use the Debian machinery to build a
+  .deb file from this.
+
+.. contents::
+
+
+Python 3 support
+----------------
+
+As explained in more detail below, the heart of stdeb is the sdist_dsc
+distutils command. This command runs once to generate a Debian source
+package. This Debian source package can specify building packages for
+Python 2, Python 3, or both. Furthermore, this generation can be done
+with the Python 2 or Python 3 interpreter. By default, only packages
+are built for the version of Python being used. To override this, use
+``--with-python2=True`` or ``--with-python3=True`` as an argument to
+the sdist_dsc distutils command (or use both to be sure). For example,
+to build only a Python 3 package using the Python 3 interpreter::
+
+  python3 setup.py --command-packages=stdeb.command bdist_deb
+
+To build both Python 2 and Python 3 packages using the Python 3
+interpreter (and only the Python3 package installs scripts)::
+
+  python3 setup.py --command-packages=stdeb.command sdist_dsc --with-python2=True --with-python3=True --no-python2-scripts=True bdist_deb
+
+News
+----
+
+ * 2020-10-28: **Version 0.10.0**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.10.0>`__.
+
+  * Bugfixes:
+
+    * add sleep between PyPI API calls to avoid rate limit (#173)
+
+  * Improvements:
+
+    * use SOURCE_DATE_EPOCH if set for timestamp in generated changelog to
+      generate reproducbile artifacts (#166)
+    * update debhelper compat version from 7 to 9 (#158)
+    * added flag --with-dh-systemd (#162)
+    * add support for DEBEMAIL envvar (#168)
+    * use setuptools "url" field for "Homepage" field in debian/control (#169)
+    * dh_virtualenv: specify Python version (#165)
+    * added compat flag to modify Debian compatibility level (#163)
+
+  * Cosmetic:
+    * remove excess newlines from debian/control and rules file (#167)
+    * use flake8 to check style in Travis CI, update code to comply (#171)
+
+ * 2020-06-11: **Version 0.9.1**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.9.1>`__.
+
+  * Bugfixes:
+
+    * handle path with spaces in zip tarball (#150)
+    * fix map() iterator issue in Python 3 (#152)
+    * fix checking for python3-all (instead of python-all) when using only
+      Python 3 (#154)
+
+  * Improvements:
+
+    * get date in Python, avoiding requiring ``date`` on macOS (#115)
+    * add configuration file option ``Python2-Depends-Name`` (#156)
+    * add an option ``--with-dh-virtualenv`` (#155)
+    * add an option named ``ignore-source-changes`` (#151)
+
+ * 2019-12-09: **Version 0.9.0**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.9.0>`__.
+
+  * Bugfixes:
+
+    * fix applying patch files under Python 3
+
+  * Improvements:
+
+    * add ``--sign-results`` to sdist_dsc and bdist_deb command
+    * add ``--debian-version`` to CLI program options
+    * add support for ``Breaks`` / ``Breaks3`` in debian/control
+    * add support for ``Suite3`` option
+    * support zip files in pypi-install
+
+  * Breaking changes:
+
+    * remove deprecated ``dh_desktop`` call
+
+ * 2015-02-18: **Version 0.8.5**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.8.5>`__. Bugfixes: reverted
+   change that installed into virtualenv when built in
+   virtualenv. Improvements: Added
+   `--allow-virtualenv-install-location` to allow installing into
+   virtualenv location. Supports Debian Squeeze (6), Debian Wheezy
+   (7), Ubuntu Precise (12.04), Ubuntu Trusty (14.04) and later
+   releases.
+
+ * 2015-02-16: **Version 0.8.4**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.8.4>`__. Bugfixes: works on
+   Python 3.4 (e.g. Ubuntu Trusty) again. Improvements: Improved
+   customization for Python 3 (Dirk Thomas added
+   `force-x-python3-version` and `X-Python3-Version` and Louis for
+   `Recommends3`, `Suggests3`, `Provides3` and `Replaces3`
+   support. Supports Debian Squeeze (6), Debian Wheezy (7), Ubuntu
+   Precise (12.04), Ubuntu Trusty (14.04) and later releases.
+
+ * 2015-02-14: **Version 0.8.3**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.8.3>`__. This is a bugfix
+   release which fixes several aspects of Unicode support. Tests pass
+   on Debian Squeeze (6), Debian Wheezy (7), and Ubuntu Precise
+   (12.04). Support for Python 3.4 (e.g. Ubuntu Trusty 14.04) was
+   mistakenly broken and was fixed in the 0.8.3 release.
+
+ * 2014-8-14: **Version 0.8.2**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.8.2>`__. This is a bugfix
+   release fixing a serious issue that would cause a Python 2 package
+   to be built if only a Python 3 package was requested in some
+   circumstances.
+
+ * 2014-8-10: **Version 0.8.1**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.8.1>`__. Due
+   to bugs in 0.8.0, this release is the first announced from the 0.8
+   series. Highlights since 0.7.1:
+
+   - Full support for Python 3. This includes being run from Python 3
+     and generating packages for Python 3. The default is to build
+     Python 3 packages when run with Python 3 and to build Python 2
+     packages when run from Python 2. Command line options can be used
+     to build packages for the other Python interpreter, too.
+
+   - Build .changes file for source package. While this still must be
+     signed for upload to a PPA, for example, it should still be
+     useful in some cases.
+
+   - Switch to Debian source format 3.0 (quilt). Practically speaking,
+     the .diff.gz file that used to come with a source package is now
+     replaced by a .debian.tar.gz file.
+
+   - Verify SSL certificates when talking to PyPI using
+     Requests. (Verification requires Requests >= 0.8.8.)
+
+   - Many bugfixes.
+
+ * 2014-05-05: **Version 0.7.1**. See the `download page
+   <https://pypi.python.org/pypi/stdeb/0.7.1>`__. Highlights for this
+   release (you may also wish to consult the full `changelog
+   <http://github.com/astraw/stdeb/blob/release-0.7.1/CHANGELOG.txt>`__). Due
+   to bugs in 0.7.0, this release is the first announced from the 0.7
+   series. Highlights since 0.6.0:
+
+   - New commands: pypi-download and pypi-install to directly download
+     and install packages from PyPI, respectively. py2dsc-deb directly
+     creates a .deb file from a source tarball.
+
+   - New distutils command: install_deb lets you directly install a
+     python package as a standard system package.
+
+   - Many bugfixes, including the new URL for PyPI.
+
+   - Automated runs of test suite, thanks to Travis CI
+
+   - Thanks to many, especially Piotr Ożarowski for help with stdeb.
+
+ * 2010-06-18: **Version 0.6.0**. See the `download page
+   <http://pypi.python.org/pypi/stdeb/0.6.0>`__. Highlights for this
+   release (you may also wish to consult the full `changelog
+   <http://github.com/astraw/stdeb/blob/release-0.6.0/CHANGELOG.txt>`__):
+
+   - A new ``debianize`` command to build a ``debian/`` directory
+     alongside your setup.py file.
+
+   - Bugfixes.
+
+ * 2010-01-09: **Version 0.5.1**. Bugfix release. See the `download
+   page <http://pypi.python.org/pypi/stdeb/0.5.1>`__, the `changelog
+   <http://github.com/astraw/stdeb/blob/release-0.5.1/CHANGELOG.txt>`__
+   and `release notes
+   <http://github.com/astraw/stdeb/blob/release-0.5.1/RELEASE_NOTES.txt>`__.
+
+ * 2009-12-30: **Version 0.5.0**. See the `download page
+   <http://pypi.python.org/pypi/stdeb/0.5.0>`__. Highlights for this
+   release (you may also wish to consult the full `changelog
+   <http://github.com/astraw/stdeb/blob/release-0.5.0/CHANGELOG.txt>`__):
+
+   - A new ``pypi-install`` script will automatically download, make a
+     .deb, and install packages from the `Python Package Index (PyPI)`_.
+
+   - Removal of the setuptools dependency.
+
+   - New option (`--guess-conflicts-provides-replaces`) to query
+     original Debian packages for Conflicts/Provides/Replaces
+     information.
+
+   - As a result of these changes and to fix a couple bugs/warts, some
+     minor backwards incompatible changes and deprecations were
+     made. Please check the `release notes
+     <http://github.com/astraw/stdeb/blob/release-0.5.0/RELEASE_NOTES.txt>`__.
+
+ * 2009-12-28: Version 0.4.3 Released. See the `download page`__. See the
+   `changelog`__ and `release notes`__.
+ * 2009-11-02: Version 0.4.2 Released. See the `download page`__. See the
+   `changelog`__ and `release notes`__.
+ * 2009-10-04: Version 0.4.1 Released. See the `download page`__. See the
+   `changelog`__ and `release notes`__.
+ * 2009-09-27: Version 0.4 Released. See the `download page`__. This
+   version switches to debhelper 7. See the `Changelog for 0.4`__.
+
+__ http://pypi.python.org/pypi/stdeb/0.4.3
+__ http://github.com/astraw/stdeb/blob/release-0.4.3/CHANGELOG.txt
+__ http://github.com/astraw/stdeb/blob/release-0.4.3/RELEASE_NOTES.txt
+__ http://pypi.python.org/pypi/stdeb/0.4.2
+__ http://github.com/astraw/stdeb/blob/release-0.4.2/CHANGELOG.txt
+__ http://github.com/astraw/stdeb/blob/release-0.4.2/RELEASE_NOTES.txt
+__ http://pypi.python.org/pypi/stdeb/0.4.1
+__ http://github.com/astraw/stdeb/blob/release-0.4.1/CHANGELOG.txt
+__ http://github.com/astraw/stdeb/blob/release-0.4.1/RELEASE_NOTES.txt
+__ http://pypi.python.org/pypi/stdeb/0.4
+__ http://github.com/astraw/stdeb/blob/release-0.4/CHANGELOG.txt
+
+Releases up to and including 0.3.2 are compatible with Ubuntu Hardy.
+
+ * 2009-10-04: Version 0.3.2 Released. See the `download page`__. See the `Changelog for 0.3.2`__
+ * 2009-09-27: Version 0.3.1 Released. See the `download page`__. See the `Changelog for 0.3.1`__
+ * 2009-03-21: Version 0.3 Released. See the `download page`__. See the `Changelog for 0.3`__
+ * 2009-02-17: Version 0.2.3 Released. See the `download page`__. See the `Changelog for 0.2.3`__
+ * 2009-01-29: Version 0.2.2 Released. See the `download page`__. See the `Changelog for 0.2.2`__
+ * 2008-04-26: Version 0.2.1 Released. See the `download page`__. See the `Changelog for 0.2.1`__
+ * 2008-04-26: Version 0.2 Released. See the `download page`__. See the `Changelog for 0.2`__
+ * 2007-04-02: Version 0.2.a1 Released. See the `old download page`_.
+ * 2006-06-19: Version 0.1 Released. See the `old download page`_.
+
+__ http://pypi.python.org/pypi/stdeb/0.3.2
+__ http://github.com/astraw/stdeb/blob/release-0.3.2/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.3.1
+__ http://github.com/astraw/stdeb/blob/release-0.3.1/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.3
+__ http://github.com/astraw/stdeb/blob/release-0.3/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.2.3
+__ http://github.com/astraw/stdeb/blob/release-0.2.3/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.2.2
+__ http://github.com/astraw/stdeb/blob/release-0.2.2/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.2.1
+__ http://github.com/astraw/stdeb/blob/release-0.2.1/CHANGELOG.txt
+__ http://pypi.python.org/pypi/stdeb/0.2
+__ http://github.com/astraw/stdeb/blob/release-0.2/CHANGELOG.txt
+
+The commands
+------------
+
+pypi-download, command-line command
+```````````````````````````````````
+
+``pypi-download`` takes a package name, queries PyPI for it and downloads
+it::
+
+  pypi-download [options] mypackage
+
+pypi-install, command-line command
+``````````````````````````````````
+
+``pypi-install`` takes a package name, queries PyPI for it, downloads
+it, builds a Debian source package and then .deb from it, and this
+installs it::
+
+  pypi-install [options] mypackage
+
+py2dsc, command-line command
+````````````````````````````
+
+``py2dsc`` takes a .tar.gz source package and build a Debian source
+package from it::
+
+  py2dsc [options] mypackage-0.1.tar.gz # uses pre-built Python source package
+
+py2dsc-deb, command-line command
+````````````````````````````````
+
+``py2dsc-deb`` takes a .tar.gz source package and build a Debian source
+package and then a .deb file from it::
+
+  py2dsc-deb [options] mypackage-0.1.tar.gz # uses pre-built Python source package
+
+sdist_dsc, distutils command
+````````````````````````````
+All methods eventually result in a call to the ``sdist_dsc`` distutils
+command. You may prefer to do so directly::
+
+  python setup.py --command-packages=stdeb.command sdist_dsc
+
+A Debian source package is produced from unmodified
+Python packages. The following files are produced in a newly created
+subdirectory ``deb_dist``:
+
+ * ``packagename_versionname.orig.tar.gz``
+ * ``packagename_versionname-debianversion.dsc``
+ * ``packagename_versionname-debianversion.diff.gz``
+
+These can then be compiled into binary packages using the standard
+Debian machinery (e.g. dpkg-buildpackage).
+
+bdist_deb, distutils command
+````````````````````````````
+A ``bdist_deb`` distutils command is installed. This calls the
+sdist_dsc command and then runs dpkg-buildpackage on the result::
+
+  python setup.py --command-packages=stdeb.command bdist_deb
+
+install_deb, distutils command
+``````````````````````````````
+
+The ``install_deb`` distutils command calls the bdist_deb command and
+then installs the result. You need to run this with superuser privilege::
+
+  sudo python setup.py --command-packages=stdeb.command install_deb
+
+debianize, distutils command
+````````````````````````````
+The ``debianize`` distutils command builds the same ``debian/``
+directory as used in the previous command, but the output is placed
+directly in the project's root folder (alongside setup.py). This is
+useful for customizing the Debian package directly (rather than using
+the various stdeb options to tune the generated package).
+
+::
+
+  python setup.py --command-packages=stdeb.command debianize
+
+A note about telling distutils to use the stdeb distutils commands
+``````````````````````````````````````````````````````````````````
+
+Distutils command packages can also be specified in distutils
+configuration files (rather than using the ``--command-packages``
+command line argument to ``setup.py``), as specified in the `distutils
+documentation
+<https://docs.python.org/2/distutils/extending.html>`_. Specifically,
+you could include this in your ``~/.pydistutils.cfg`` file::
+
+  [global]
+  command-packages: stdeb.command
+
+Examples
+--------
+
+These all assume you have stdeb installed in your system Python
+path. stdeb also works from a non-system Python path (e.g. a
+`virtualenv <http://pypi.python.org/pypi/virtualenv>`_).
+
+Quickstart 1: Install something from PyPI now, I don't care about anything else
+```````````````````````````````````````````````````````````````````````````````
+
+Do this from the command line::
+
+  pypi-install mypackage
+
+**Warning: Despite doing its best, there is absolutely no way stdeb
+can guarantee all the Debian package dependencies will be properly
+fulfilled without manual intervention. Using pypi-install bypasses
+your ability to customize stdeb's behavior. Read the rest of this
+document to understand how to make better packages.**
+
+Quickstart 2: Just tell me the fastest way to make a .deb
+`````````````````````````````````````````````````````````
+
+(First, install stdeb as you normally install Python packages.)
+
+Do this from the directory with your `setup.py` file::
+
+  python setup.py --command-packages=stdeb.command bdist_deb
+
+This will make a Debian source package (.dsc, .orig.tar.gz and
+.diff.gz files) and then compile it to a Debian binary package (.deb)
+for your current system. The result will be in ``deb_dist``.
+
+**Warning: installing the .deb file on other versions of Ubuntu or
+Debian than the one on which it was compiled will result in undefined
+behavior. If you have extension modules, they will probably
+break. Even in the absence of extension modules, bad stuff will likely
+happen.**
+
+For this reason, it is much better to build the Debian source package
+and then compile that (e.g. using `Ubuntu's PPA`__) for each target
+version of Debian or Ubuntu.
+
+__ https://help.launchpad.net/Packaging/PPA
+
+Quickstart 3: I read the warning, so show me how to make a source package, then compile it
+``````````````````````````````````````````````````````````````````````````````````````````
+
+This generates a source package::
+
+  wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
+  py2dsc Reindent-0.1.0.tar.gz
+
+This turns it into a .deb using the standard Debian tools. (Do *this*
+on the same source package for each target distribution)::
+
+  cd deb_dist/reindent-0.1.0/
+  dpkg-buildpackage -rfakeroot -uc -us
+
+This installs it::
+
+  cd ..
+  sudo dpkg -i python-reindent_0.1.0-1_all.deb
+
+Quickstart 4: Install from a Python package direct to a debian system package
+`````````````````````````````````````````````````````````````````````````````
+
+(First, install stdeb as you normally install Python packages.)
+
+Do this from the directory with your `setup.py` file::
+
+  python setup.py --command-packages=stdeb.command install_deb
+
+This will make a Debian source package (.dsc, .orig.tar.gz and
+.diff.gz files), compile it to a Debian binary package (.deb) for your
+current system and then install it using ``dpkg``.
+
+
+Another example, with more explanation
+``````````````````````````````````````
+
+This example is more useful if you don't have a Python source package
+(.tar.gz file generated by ``python setup.py sdist``). For the sake of
+illustration, we do download such a tarball, but immediately unpack it
+(alternatively, use a version control system to grab the unpacked
+source of a package)::
+
+  wget http://pypi.python.org/packages/source/R/Reindent/Reindent-0.1.0.tar.gz
+  tar xzf Reindent-0.1.0.tar.gz
+  cd Reindent-0.1.0
+
+The following will generate a directory ``deb_dist`` containing the
+files ``reindent_0.1.0-1.dsc``, ``reindent_0.1.0.orig.tar.gz`` and
+``reindent_0.1.0-1.diff.gz``, which, together, are a debian source
+package::
+
+  python setup.py --command-packages=stdeb.command sdist_dsc
+
+The source generated in the above way is also extracted (using
+``dpkg-source -x``) and placed in the ``deb_dist`` subdirectory. To
+continue the example above::
+
+  cd deb_dist/reindent-0.1.0
+  dpkg-buildpackage -rfakeroot -uc -us
+
+Finally, the generated package can be installed::
+
+  cd ..
+  sudo dpkg -i python-reindent_0.1.0-1_all.deb
+
+For yet another example of use, with still more explanation, see
+`allmydata-tahoe ticket 251`_.
+
+.. _allmydata-tahoe ticket 251: http://allmydata.org/trac/tahoe/ticket/251
+
+Download
+--------
+
+Files are available at the `download page`_ (for ancient releases, see
+the `old download page`_).
+
+.. _download page: https://pypi.python.org/pypi/stdeb
+.. _old download page: http://stdeb.python-hosting.com/wiki/Download
+
+The git repository is available at
+http://github.com/astraw/stdeb
+
+Install (or, using stdeb to create an stdeb installer)
+------------------------------------------------------
+
+For a bit of fun, here's how to install stdeb using stdeb. Note that
+stdeb is also in Debian and Ubuntu, so this recipe is only necessary
+to install a more recent stdeb.
+
+::
+
+  STDEB_VERSION="0.10.0"
+
+  # Download stdeb
+  wget https://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
+
+  # Extract it
+  tar xzf stdeb-$STDEB_VERSION.tar.gz
+
+  # Enter extracted source package
+  cd stdeb-$STDEB_VERSION
+
+  # Build .deb (making use of stdeb package directory in sys.path).
+  python setup.py --command-packages=stdeb.command bdist_deb
+
+  # Install it
+  sudo dpkg -i deb_dist/python-stdeb_$STDEB_VERSION-1_all.deb
+
+Background
+----------
+
+For the average Python package, its source distribution
+(python_package.tar.gz created with ``python setup.py sdist``)
+contains nearly everything necessary to make a Debian source
+package. This near-equivalence encouraged me to write this distutils
+extension, which executes the setup.py file to extract relevant
+information. `setuptools
+<http://peak.telecommunity.com/DevCenter/setuptools>`_ may optionally
+be used.
+
+I wrote this initially to Debianize several Python packages of my own,
+but I have the feeling it could be generally useful. It appears
+similar, at least in theory, to easydeb_, `Logilab's Devtools`_,
+bdist_dpkg_, bdist_deb_, pkgme_ and `dh-virtualenv
+<https://github.com/spotify/dh-virtualenv>`__.
+
+.. _easydeb: http://easy-deb.sourceforge.net/
+.. _Logilab's DevTools: http://www.logilab.org/projects/devtools
+.. _bdist_dpkg: http://svn.python.org/view/sandbox/trunk/Lib/bdist_dpkg.py
+.. _bdist_deb: http://bugs.python.org/issue1054967
+.. _pkgme: https://launchpad.net/pkgme
+
+Features
+--------
+
+* Create a package for all Python versions supported by
+  python-support. (Limiting this range is possible with the
+  ``XS-Python-Version:`` config option.)
+
+* Automatic conversion of Python package names into valid Debian
+  package names.
+
+* Attempt to automatically convert version numbers such that ordering
+  is maintained. See also the config option
+  ``Forced-Upstream-Version``.
+
+* Fine grained control of version numbers. (``Debian-Version``,
+  ``Forced-Upstream-Version``, ``Upstream-Version-Prefix``,
+  ``Upstream-Version-Suffix`` config options.)
+
+* Install .desktop files. (``MIME-Desktop-Files`` config option.)
+
+* Install .mime and .sharedmimeinfo files. (``MIME-File`` and
+  ``Shared-MIME-File`` config options.)
+
+* Install copyright files. (``Copyright-File`` config option.)
+
+* Apply patches to upstream sources. (``Stdeb-Patch-File`` config
+  option.)
+
+* Pass environment variables to setup.py script. (``Setup-Env-Vars``
+  config option.)
+
+Customizing the produced Debian source package (config options)
+---------------------------------------------------------------
+
+stdeb will attempt to provide reasonable defaults, but these are only
+guesses.
+
+There are two ways to customize the Debian source package produced by
+stdeb. First, you may provide options to the distutils
+commands. Second, you may provide an ``stdeb.cfg`` file.
+
+stdeb distutils command options
+```````````````````````````````
+
+The sdist_dsc command takes command-line options to the distutils
+command. For example::
+
+  python setup.py --command-packages=stdeb.command sdist_dsc --debian-version 0MyName1
+
+This creates a Debian package with the Debian version set to
+"0MyName1".
+
+These options can also be set via distutils configuration
+files. (These are the ``setup.cfg`` file alongside ``setup.py`` and
+the ~/.pydistutils.cfg file.) In that case, put the arguments in the
+``[sdist_dsc]`` section. For example, a project's ``~/.setup.cfg``
+file might have this::
+
+  [sdist_dsc]
+  debian-version: 0MyName1
+
+To pass these commands to sdist_dsc when calling bdist_deb, do this::
+
+  python setup.py sdist_dsc --debian-version 0MyName1 bdist_deb
+
+====================================== =========================================
+        Command line option                      Effect
+====================================== =========================================
+  --with-python2                       build Python 2 package (default=True)
+  --with-python3                       build Python 3 package (default=False)
+  --no-python2-scripts                 disable installation of Python 2 scripts (default=False)
+  --no-python3-scripts                 disable installation of Python 3 scripts (default=False)
+  --force-x-python3-version            Override default minimum python3:any
+                                       dependency with value from x-python3-
+                                       version
+  --allow-virtualenv-install-location  Allow installing into
+                                       /some/random/virtualenv-path
+  --with-dh-virtualenv                 Build the package using dh_virtualenv, so all dependencies
+                                       are embedded into the packages.
+  --with-dh-systemd                    Add the systemd addon that will add dh_systemd_enable and
+                                       dh_systemd_start helpers at the correct time during build.
+  --sign-results                       Use gpg to sign the resulting .dsc and
+                                       .changes file
+  --dist-dir (-d)                      directory to put final built
+                                       distributions in (default='deb_dist')
+  --patch-already-applied (-a)         patch was already applied (used when
+                                       py2dsc calls sdist_dsc)
+  --default-distribution               deprecated (see --suite)
+  --compat                             debian compatibility level (default=9)
+  --suite (-z)                         distribution name to use if not
+                                       specified in .cfg (default='unstable')
+  --default-maintainer                 deprecated (see --maintainer)
+  --maintainer (-m)                    maintainer name and email to use if not
+                                       specified in .cfg (default from
+                                       setup.py)
+  --extra-cfg-file (-x)                additional .cfg file (in addition to
+                                       stdeb.cfg if present)
+  --patch-file (-p)                    patch file applied before setup.py
+                                       called (incompatible with file
+                                       specified in .cfg)
+  --patch-level (-l)                   patch file applied before setup.py
+                                       called (incompatible with file
+                                       specified in .cfg)
+  --patch-posix (-q)                   apply the patch with --posix mode
+  --remove-expanded-source-dir (-r)    remove the expanded source directory
+  --ignore-install-requires (-i)       ignore the requirements from
+                                       requires.txt in the egg-info directory
+  --ignore-source-changes              ignore all changes on source when
+                                       building source package (add -i.*
+                                       option to dpkg-source)
+  --no-backwards-compatibility         This option has no effect, is here for
+                                       backwards compatibility, and may be
+                                       removed someday.
+  --guess-conflicts-provides-replaces  If True, attempt to guess
+                                       Conflicts/Provides/Replaces in
+                                       debian/control based on apt-cache
+                                       output. (Default=False).
+  --use-premade-distfile (-P)          use .zip or .tar.gz file already made
+                                       by sdist command
+  --source                             debian/control Source: (Default:
+                                       <source-debianized-setup-name>)
+  --package                            debian/control Package: (Default:
+                                       python-<debianized-setup-name>)
+  --suite                              suite (e.g. stable, lucid) in changelog
+                                       (Default: unstable)
+  --maintainer                         debian/control Maintainer: (Default:
+                                       <setup-maintainer-or-author>)
+  --debian-version                     debian version (Default: 1)
+  --section                            debian/control Section: (Default:
+                                       python)
+  --epoch                              version epoch
+  --forced-upstream-version            forced upstream version
+  --upstream-version-prefix            upstream version prefix
+  --upstream-version-suffix            upstream version suffix
+  --uploaders                          uploaders
+  --copyright-file                     copyright file
+  --build-depends                      debian/control Build-Depends:
+  --build-conflicts                    debian/control Build-Conflicts:
+  --stdeb-patch-file                   file containing patches for stdeb to
+                                       apply
+  --stdeb-patch-level                  patch level provided to patch command
+  --depends                            debian/control Depends:
+  --suggests                           debian/control Suggests:
+  --recommends                         debian/control Recommends:
+  --xs-python-version                  debian/control XS-Python-Version:
+  --x-python3-version                  debian/control X-Python3-Version:
+  --dpkg-shlibdeps-params              parameters passed to dpkg-shlibdeps
+  --conflicts                          debian/control Conflicts:
+  --provides                           debian/control Provides:
+  --replaces                           debian/control Replaces:
+  --mime-desktop-files                 MIME desktop files
+  --mime-file                          MIME file
+  --shared-mime-file                   shared MIME file
+  --setup-env-vars                     environment variables passed to
+                                       setup.py
+  --udev-rules                         file with rules to install to udev
+
+====================================== =========================================
+
+
+You may also pass any arguments described below for the stdeb.cfg file
+via distutils options. Passing the arguments this way (either on the
+command line, or in the ``[sdist_dsc]`` section of a distutils .cfg
+file) will take precedence. The option name should be given in lower
+case.
+
+stdeb.cfg configuration file
+````````````````````````````
+
+You may write config files of the format understood by `ConfigParser
+<http://docs.python.org/lib/module-ConfigParser.html>`_. When building
+each package, stdeb looks for the existence of a ``stdeb.cfg`` in the
+directory with ``setup.py``. You may specify an additional config file
+with the command-line option --extra-cfg-file. The section should
+should either be [DEFAULT] or [package_name], which package_name is
+specified as the name argument to the setup() command. An example
+stdeb.cfg file is::
+
+  [DEFAULT]
+  Depends: python-numpy
+  XS-Python-Version: >= 2.6
+
+All available options:
+
+====================================== =========================================
+  Config file option                     Effect
+====================================== =========================================
+  Source                               debian/control Source: (Default:
+                                       <source-debianized-setup-name>)
+  Package                              debian/control Package: (Default:
+                                       python-<debianized-setup-name>)
+  Package3                             debian/control Package: for python3
+                                       (Default:
+                                       python3-<debianized-setup-name>)
+  Suite                                suite (e.g. stable, lucid) in changelog
+                                       (Default: unstable)
+  Suite3                               suite (e.g. stable, lucid) for python3
+                                       (Default: uses value of Suite option)
+  Maintainer                           debian/control Maintainer: (Default:
+                                       <setup-maintainer-or-author>)
+  Debian-Version                       debian version (Default: 1)
+  Section                              debian/control Section: (Default:
+                                       python)
+  Epoch                                version epoch
+  Forced-Upstream-Version              forced upstream version
+  Upstream-Version-Prefix              upstream version prefix
+  Upstream-Version-Suffix              upstream version suffix
+  Uploaders                            uploaders
+  Copyright-File                       copyright file
+  Build-Depends                        debian/control Build-Depends:
+  Build-Conflicts                      debian/control Build-Conflicts:
+  Stdeb-Patch-File                     file containing patches for stdeb to
+                                       apply
+  Stdeb-Patch-Level                    patch level provided to patch command
+  Depends                              debian/control Depends:
+  Depends3                             debian/control Depends: for python3
+  Suggests                             debian/control Suggests:
+  Suggests3                            debian/control Suggests: for python3
+  Recommends                           debian/control Recommends:
+  Recommends3                          debian/control Recommends: for python3
+  XS-Python-Version                    debian/control XS-Python-Version:
+  X-Python3-Version                    debian/control X-Python3-Version:
+  Dpkg-Shlibdeps-Params                parameters passed to dpkg-shlibdeps
+  Conflicts                            debian/control Conflicts:
+  Conflicts3                           debian/control Conflicts: for python3
+  Breaks                               debian/control Breaks:
+  Breaks3                              debian/control Breaks: for python3
+  Provides                             debian/control Provides:
+  Provides3                            debian/control Provides: for python3
+  Replaces                             debian/control Replaces:
+  Replaces3                            debian/control Replaces: for python3
+  MIME-Desktop-Files                   MIME desktop files
+  MIME-File                            MIME file
+  Shared-MIME-File                     shared MIME file
+  Setup-Env-Vars                       environment variables passed to
+                                       setup.py
+  Udev-Rules                           file with rules to install to udev
+  Python2-Depends-Name                 override Python 2 Debian package name in
+                                       ${python:Depends}
+====================================== =========================================
+
+The option names in stdeb.cfg files are not case sensitive.
+
+Reproducible builds
+-------------------
+
+By default stdeb uses the current time for the the timestamp in the generated
+changelog file. This results in a non-reproducible build since every invocation
+generates a different changelog / ``.deb``.
+The environment variable ``SOURCE_DATE_EPOCH`` can be set to a fixed timestamp
+(e.g. when the version was tagged or of the last commit was made) which will be
+used in the changelog instead. This will ensure that the produced ``.deb`` is
+reproducible on repeated invocations.
+
+For more information about reproducible builds and this specific environment
+variable please see https://reproducible-builds.org/docs/source-date-epoch/
+
+Prerequisites
+-------------
+
+ * Python 2.7 or Python 3.x
+ * Standard Debian utilities such as ``date``, ``dpkg-source`` and
+   Debhelper 7 (use stdeb 0.3.x if you need to support older
+   distributions without dh7)
+ * If your setup.py uses the setuptools features ``setup_requires`` or
+   ``install_requires``, you must run ``apt-file update`` prior to
+   running any stdeb command.
+
+TODO
+----
+
+* Make output meet `Debian Python Policy`_ specifications or the `new
+  python policy`_. This will include several things, among which are:
+
+  - the ability to make custom changelogs
+  - the ability to include project-supplied documentation as a -doc package
+  - include license information in debian/copyright
+  - the ability to include project-supplied examples, tests, and data
+    as a separate package
+  - much more not listed
+
+* Create (better) documentation
+
+* Log output using standard distutils mechanisms
+
+* Refactor the source code to have a simpler, more sane design
+
+.. _debian python policy: http://www.debian.org/doc/packaging-manuals/python-policy/
+.. _new python policy: http://wiki.debian.org/DebianPython/NewPolicy
+
+Call for volunteers
+-------------------
+
+I don't have a lot of time for this. This project stands a very real
+chance of being only a shadow of its potential self unless people step
+up and contribute. There are numerous ways in which people could
+help. In particular, I'd be interested in finding a co-maintainer or
+maintainer if the project generates any interest. Secondarily, I would
+appreciate advice from Debian developers or Ubuntu MOTUs about the
+arcane details of Python packaging.
+
+Mailing list
+------------
+
+Please address all questions to the distutils-SIG_
+
+.. _distutils-SIG: http://mail.python.org/mailman/listinfo/distutils-sig
+
+License
+-------
+
+MIT-style license. Copyright (c) 2006-2015 stdeb authors.
+
+See the LICENSE.txt file provided with the source distribution for
+full details.
+
+Authors
+-------
+
+* Andrew Straw <strawman@astraw.com>
+* Pedro Algarvio, aka, s0undt3ch <ufs@ufsoft.org>
+* Gerry Reno (initial bdist_deb implementation)
+
+Additional Credits
+------------------
+
+* Zooko O'Whielacronx for the autofind-depends patch.
+* Brett (last name unknown) for the --ignore-install-requires patch.
+* Ximin Luo for a bug fix.
+* Alexander D. Sedov for bug fixes and suggestions.
+* Michele Mattioni for bug fix.
+* Alexander V. Nikolaev for the debhelper buildsystem specification.
+* Roland Sommer for the description field bugfix.
+* Barry Warsaw for suggesting the debianize command.
+* Asheesh Laroia for updating the PyPI URL.
+* Piotr Ożarowski for implementing dh_python2 support.
+* Nikita Burtsev for unicode tests and fixes
+* Mikołaj Siedlarek for a bugfix
+* Dirk Thomas for --force-x-python3-version and X-Python3-Version
+* Louis for Recommends3, Suggests3, Provides3 and Replaces3 support
+* kzwin for interop with virtualenv
+* GitHub_ for hosting services.
+* WebFaction_ (aka `python-hosting`_) for previous hosting services.
+* TravisCI_ for continuous integration
+
+.. _GitHub: http://github.com/
+.. _WebFaction: http://webfaction.com/
+.. _python-hosting: http://python-hosting.com/
+..  _TravisCI: http://travis-ci.org/
+
+
+.. image:: https://badges.gitter.im/Join%20Chat.svg
+   :alt: Join the chat at https://gitter.im/astraw/stdeb
+   :target: https://gitter.im/astraw/stdeb?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
diff --git a/debian/changelog b/debian/changelog
index 60dfee9..9629909 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+stdeb (0.10.0+git20210619.1.bc37aa1-1) UNRELEASED; urgency=low
+
+  * New upstream snapshot.
+
+ -- Debian Janitor <janitor@jelmer.uk>  Thu, 19 Jan 2023 08:01:36 -0000
+
 stdeb (0.10.0-2) unstable; urgency=medium
 
   * Bump debhelper from old 12 to 13.
diff --git a/debian/patches/add_debian_watch.patch b/debian/patches/add_debian_watch.patch
index 2193da5..068b8d3 100644
--- a/debian/patches/add_debian_watch.patch
+++ b/debian/patches/add_debian_watch.patch
@@ -8,11 +8,11 @@ Patch-Name: add_debian_watch.patch
  stdeb/util.py | 8 ++++++++
  1 file changed, 8 insertions(+)
 
-diff --git a/stdeb/util.py b/stdeb/util.py
-index 654a423..3640294 100644
---- a/stdeb/util.py
-+++ b/stdeb/util.py
-@@ -1308,6 +1308,14 @@ def build_dsc(debinfo,
+Index: stdeb.git/stdeb/util.py
+===================================================================
+--- stdeb.git.orig/stdeb/util.py
++++ stdeb.git/stdeb/util.py
+@@ -1426,6 +1426,14 @@ def build_dsc(debinfo,
      fd.write('3.0 (quilt)\n')
      fd.close()
  
diff --git a/debian/patches/bump_standards-version.patch b/debian/patches/bump_standards-version.patch
index 5e39139..04a4ee9 100644
--- a/debian/patches/bump_standards-version.patch
+++ b/debian/patches/bump_standards-version.patch
@@ -8,11 +8,11 @@ Patch-Name: bump_standards-version.patch
  stdeb/util.py | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)
 
-diff --git a/stdeb/util.py b/stdeb/util.py
-index fec729e..654a423 100644
---- a/stdeb/util.py
-+++ b/stdeb/util.py
-@@ -1406,7 +1406,7 @@ Maintainer: %(maintainer)s
+Index: stdeb.git/stdeb/util.py
+===================================================================
+--- stdeb.git.orig/stdeb/util.py
++++ stdeb.git/stdeb/util.py
+@@ -1538,7 +1538,7 @@ Maintainer: %(maintainer)s
  %(uploaders)sSection: %(debian_section)s
  Priority: optional
  Build-Depends: %(build_depends)s
diff --git a/debian/patches/python3.patch b/debian/patches/python3.patch
index cc4f124..fde993a 100644
--- a/debian/patches/python3.patch
+++ b/debian/patches/python3.patch
@@ -9,40 +9,40 @@ Subject: python3
  scripts/pypi-install  | 2 +-
  4 files changed, 4 insertions(+), 4 deletions(-)
 
-diff --git a/scripts/py2dsc b/scripts/py2dsc
-index fe4ce58..e3b30d3 100755
---- a/scripts/py2dsc
-+++ b/scripts/py2dsc
+Index: stdeb.git/scripts/py2dsc
+===================================================================
+--- stdeb.git.orig/scripts/py2dsc
++++ stdeb.git/scripts/py2dsc
 @@ -1,4 +1,4 @@
 -#!/usr/bin/env python
 +#!/usr/bin/env python3
  
  import stdeb.cli_runner
  import sys
-diff --git a/scripts/py2dsc-deb b/scripts/py2dsc-deb
-index 5507032..507c759 100755
---- a/scripts/py2dsc-deb
-+++ b/scripts/py2dsc-deb
+Index: stdeb.git/scripts/py2dsc-deb
+===================================================================
+--- stdeb.git.orig/scripts/py2dsc-deb
++++ stdeb.git/scripts/py2dsc-deb
 @@ -1,4 +1,4 @@
 -#!/usr/bin/env python
 +#!/usr/bin/env python3
  
  import stdeb.cli_runner
  import sys
-diff --git a/scripts/pypi-download b/scripts/pypi-download
-index 32216f3..7d70879 100755
---- a/scripts/pypi-download
-+++ b/scripts/pypi-download
+Index: stdeb.git/scripts/pypi-download
+===================================================================
+--- stdeb.git.orig/scripts/pypi-download
++++ stdeb.git/scripts/pypi-download
 @@ -1,4 +1,4 @@
 -#!/usr/bin/env python
 +#!/usr/bin/env python3
  import sys
  from optparse import OptionParser
  from stdeb.downloader import myprint, get_source_tarball
-diff --git a/scripts/pypi-install b/scripts/pypi-install
-index 2803f7b..4606306 100755
---- a/scripts/pypi-install
-+++ b/scripts/pypi-install
+Index: stdeb.git/scripts/pypi-install
+===================================================================
+--- stdeb.git.orig/scripts/pypi-install
++++ stdeb.git/scripts/pypi-install
 @@ -1,4 +1,4 @@
 -#!/usr/bin/env python
 +#!/usr/bin/env python3
diff --git a/debian/patches/use_pybuild_buildsystem.patch b/debian/patches/use_pybuild_buildsystem.patch
index dbc67f2..a8662f3 100644
--- a/debian/patches/use_pybuild_buildsystem.patch
+++ b/debian/patches/use_pybuild_buildsystem.patch
@@ -8,9 +8,11 @@ Patch-Name: use_pybuild_buildsystem.patch
  stdeb/util.py | 96 +++++------------------------------------------------------
  1 file changed, 8 insertions(+), 88 deletions(-)
 
---- a/stdeb/util.py
-+++ b/stdeb/util.py
-@@ -865,7 +865,7 @@
+Index: stdeb.git/stdeb/util.py
+===================================================================
+--- stdeb.git.orig/stdeb/util.py
++++ stdeb.git/stdeb/util.py
+@@ -865,7 +865,7 @@ class DebianInfo:
          self.uploaders = parse_vals(cfg, module_name, 'Uploaders')
          self.date822 = get_date_822()
  
@@ -19,7 +21,7 @@ Patch-Name: use_pybuild_buildsystem.patch
          if use_setuptools:
              if with_python2:
                  build_deps.append('python-setuptools (>= 0.6b3)')
-@@ -1151,52 +1151,10 @@
+@@ -1151,52 +1151,10 @@ class DebianInfo:
          else:
              self.install_prefix = ''
  
@@ -76,7 +78,7 @@ Patch-Name: use_pybuild_buildsystem.patch
  
          if force_x_python3_version and with_python3 and x_python3_version and \
                  x_python3_version[0]:
-@@ -1205,15 +1163,6 @@
+@@ -1205,15 +1163,6 @@ class DebianInfo:
              version = x_python3_version[0]
              if not version.endswith('~'):
                  version += '~'
@@ -92,7 +94,7 @@ Patch-Name: use_pybuild_buildsystem.patch
          sequencer_options = ['--with '+','.join(sequencer_with)]
  
          if with_dh_virtualenv:
-@@ -1226,7 +1175,7 @@
+@@ -1226,7 +1175,7 @@ class DebianInfo:
  
              sequencer_options.append('--with python-virtualenv')
          else:
@@ -101,7 +103,7 @@ Patch-Name: use_pybuild_buildsystem.patch
              self.override_dh_virtualenv_py = ''
  
          if with_dh_systemd:
-@@ -1235,7 +1184,7 @@
+@@ -1235,7 +1184,7 @@ class DebianInfo:
          self.sequencer_options = ' '.join(sequencer_options)
  
          setup_env_vars = parse_vals(cfg, module_name, 'Setup-Env-Vars')
@@ -110,7 +112,7 @@ Patch-Name: use_pybuild_buildsystem.patch
          if len(setup_env_vars):
              self.exports += '\n'
              self.exports += '#exports specified using stdeb Setup-Env-Vars:\n'
-@@ -1477,10 +1426,6 @@
+@@ -1477,10 +1426,6 @@ def build_dsc(debinfo,
      fd.write('3.0 (quilt)\n')
      fd.close()
  
@@ -121,7 +123,7 @@ Patch-Name: use_pybuild_buildsystem.patch
      if debian_dir_only:
          return
  
-@@ -1626,75 +1571,16 @@
+@@ -1626,75 +1571,16 @@ RULES_MAIN = """\
  %(percent_symbol)s:
          dh $@ %(sequencer_options)s
  
diff --git a/setup.cfg b/setup.cfg
new file mode 100644
index 0000000..8bfd5a1
--- /dev/null
+++ b/setup.cfg
@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+
diff --git a/README.rst b/stdeb.egg-info/PKG-INFO
similarity index 98%
rename from README.rst
rename to stdeb.egg-info/PKG-INFO
index b1ad9fd..9c1df75 100644
--- a/README.rst
+++ b/stdeb.egg-info/PKG-INFO
@@ -1,3 +1,20 @@
+Metadata-Version: 2.1
+Name: stdeb
+Version: 0.10.0
+Summary: Python to Debian source package conversion utility
+Home-page: http://github.com/astraw/stdeb
+Author: Andrew Straw
+Author-email: strawman@astraw.com
+License: MIT
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+License-File: LICENSE.txt
+
 .. image:: https://travis-ci.org/astraw/stdeb.png?branch=master
         :target: https://travis-ci.org/astraw/stdeb
 
@@ -501,7 +518,7 @@ to install a more recent stdeb.
   STDEB_VERSION="0.10.0"
 
   # Download stdeb
-  wget http://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
+  wget https://pypi.python.org/packages/source/s/stdeb/stdeb-$STDEB_VERSION.tar.gz
 
   # Extract it
   tar xzf stdeb-$STDEB_VERSION.tar.gz
diff --git a/stdeb.egg-info/SOURCES.txt b/stdeb.egg-info/SOURCES.txt
new file mode 100644
index 0000000..188fedb
--- /dev/null
+++ b/stdeb.egg-info/SOURCES.txt
@@ -0,0 +1,41 @@
+.travis.yml
+CHANGELOG.txt
+LICENSE.txt
+MANIFEST.in
+README.rst
+RELEASE_NOTES.txt
+Vagrantfile.debian-7-wheezy.rb
+Vagrantfile.debian-8-jessie.rb
+Vagrantfile.ubuntu-12.04-precise.rb
+Vagrantfile.ubuntu-14.04-trusty.rb
+setup.py
+stdeb.cfg
+test-pypi-install.sh
+test.sh
+test2and3.sh
+scripts/py2dsc
+scripts/py2dsc-deb
+scripts/pypi-download
+scripts/pypi-install
+stdeb/__init__.py
+stdeb/cli_runner.py
+stdeb/downloader.py
+stdeb/transport.py
+stdeb/util.py
+stdeb.egg-info/PKG-INFO
+stdeb.egg-info/SOURCES.txt
+stdeb.egg-info/dependency_links.txt
+stdeb.egg-info/top_level.txt
+stdeb/command/__init__.py
+stdeb/command/bdist_deb.py
+stdeb/command/common.py
+stdeb/command/debianize.py
+stdeb/command/install_deb.py
+stdeb/command/sdist_dsc.py
+test_data/py2_only_pkg/setup.py
+test_data/py2_only_pkg/py2_only_pkg/__init__.py
+test_data/py2_only_pkg/py2_only_pkg/py2_module.py
+test_data/py3_only_pkg/setup.py
+test_data/py3_only_pkg/py3_only_pkg/py3_module.py
+test_data/simple_pkg/setup.py
+test_data/simple_pkg/simple_pkg/__init__.py
\ No newline at end of file
diff --git a/stdeb.egg-info/dependency_links.txt b/stdeb.egg-info/dependency_links.txt
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/stdeb.egg-info/dependency_links.txt
@@ -0,0 +1 @@
+
diff --git a/stdeb.egg-info/top_level.txt b/stdeb.egg-info/top_level.txt
new file mode 100644
index 0000000..4e1a305
--- /dev/null
+++ b/stdeb.egg-info/top_level.txt
@@ -0,0 +1 @@
+stdeb

Debdiff

File lists identical (after any substitutions)

No differences were encountered in the control files

More details

Full run details