Py2deb

------------------------------

Disable package description conversion until I find out what's wrong with it:

- Starting from `release 0.16` pydeb would use docutils_ to convert the
``long_description`` of each Python package to HTML which was then translated
to plain text in order to generate a readme text that was embedded in the
metadata of the binary package.

- However lots of packages on PyPI (including mine) automatically embed their
``README.rst`` as the ``long_description`` in the ``setup.py`` script, making
for rather complex documents to transform.

- This interaction caused "Unable to parse package file" warnings from
``apt-get`` during installation of packages (given input packages with
complex enough long descriptions).

Given that this was a "nice to have" and I had more important things on my
plate I decided to just disable this feature for now.

.. _Release 0.18.6: https://github.com/paylogic/py2deb/compare/0.18.5...0.18.6
.. _docutils: https://pypi.org/project/docutils

------------------------------

Bug fix: Make sure the "Debian revision" part of converted version numbers
contains a digit.

.. _Release 0.18.5: https://github.com/paylogic/py2deb/compare/0.18.4...0.18.5

------------------------------

Bug fix: Tildes in Debian binary package versions considered harmful!

Because of the special semantics of ``~`` in Debian binary pakcage versions
I've decided to switch from ``~`` to ``-`` as the separator between tokens in
the version string.

About those special semantics::

$ dpkg --compare-versions '0.21.1~paylogic' '>=' '0.21.1'; echo $?
1

$ dpkg --compare-versions '0.21.1~paylogic' '>=' '0.21.1'; echo $?
1

$ dpkg --compare-versions '0.21.1-paylogic' '>=' '0.21.1'; echo $?
0

$ dpkg --compare-versions '0.21.1-paylogic-0' '>=' '0.21.1'; echo $?
0

.. _Release 0.18.4: https://github.com/paylogic/py2deb/compare/0.18.3...0.18.4

------------------------------

Bug fix: Cleanup temporary source directories.

These are created when you tell pip_ to install from a directory containing an
unpacked source distribution: pip copies the complete directory to ``/tmp``
before doing anything with it, but because this directory cannot be set using
``--build-directory`` py2deb never cleaned up directories created in this
manner.

.. _Release 0.18.3: https://github.com/paylogic/py2deb/compare/0.18.2...0.18.3

------------------------------

Automatically add the ``Vcs-Hg`` control field when possible.

This works by parsing the ``.hg_archival.txt`` file generated by the ``hg
archive`` command so for now this only supports Python source distributions
exported from Mercurial repositories.

.. _Release 0.18.2: https://github.com/paylogic/py2deb/compare/0.18.1...0.18.2

------------------------------

This release consists of more than 10 commits that were part of an effort to
prepare the py2deb project for open sourcing under the name of Paylogic_.
Here's a short summary:

- Bumped pip-accel_ requirement (to pull in an upstream bug fix) and minor
changes to be compatible wiht the new version.
- Support for default configuration files (``/etc/py2deb.ini`` and ``~/.py2deb.ini``)
- Don't copy files during builds (performance optimization).
- Add logging in order to debug handling of postinst/prerm scripts.
- Explicitly iterate postinst/prerm scripts (explicit is better than implicit).
- Bug fix: Include postinst/prerm scripts during installation!
- Bug fix: Reformat version strings to comply with Debian policy manual.
- Make ``converter.convert()`` return list of generated package archives.
- Check for duplicate files in converted dependency sets.
- Improved the documentation.

.. _Release 0.18.1: https://github.com/paylogic/py2deb/compare/0.18...0.18.1