Deb-pkg-tools

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

Integrated support for ``dpkg-shlibdeps`` (inspired by py2deb_).

I first started (ab)using ``dpkg-shlibdeps`` in the py2deb_ project and have
since missed this functionality in other projects like deb-pkg-tools so have
decided to move some stuff around :-).

.. _Release 4.4: https://github.com/xolox/python-deb-pkg-tools/compare/4.3...4.4
.. _py2deb: https://github.com/paylogic/py2deb

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

- Make mandatory control field validation reusable.
- Include documentation in source distributions.
- Restore Python 2.6 compatibility in test suite.

.. _Release 4.3: https://github.com/xolox/python-deb-pkg-tools/compare/4.2...4.3

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

Implement cache invalidation (follow up to `12`_).

.. _Release 4.2: https://github.com/xolox/python-deb-pkg-tools/compare/4.1...4.2

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

- Merged pull request `11`_: State purpose of project in readme.
- Improve dependency parsing: Add more ``Depends`` like fields (fixes `12`_).
- Start using ``humanfriendly.testing`` to mark skipped tests.
- Changed Sphinx documentation theme.
- Add Python 3.6 to tested versions.

.. _Release 4.1: https://github.com/xolox/python-deb-pkg-tools/compare/4.0.2...4.1
.. _11: https://github.com/xolox/python-deb-pkg-tools/pull/11
.. _12: https://github.com/xolox/python-deb-pkg-tools/issues/12

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

Bug fix for inheritance of ``AlternativeRelationship``. This fixes the
following error when hashing relationship objects::

AttributeError: 'AlternativeRelationship' object has no attribute 'operator'

I'd like to add tests for this but lack the time to do so at this moment,
so hopefully I can revisit this later when I have a bit more time 😇.

.. _Release 4.0.2: https://github.com/xolox/python-deb-pkg-tools/compare/4.0.1...4.0.2

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

- Bug fix: Swallow unpickling errors instead of propagating them.

In general I am very much opposed to Python code that swallows exceptions
when it doesn't know how to handle them, because it can inadvertently obscure
an issue's root cause and/or exacerbate the issue.

But caching deserves an exception. Any code that exists solely as an
optimization should not raise exceptions caused by the caching logic. This
should avoid the following traceback which I just ran into::

Traceback (most recent call last):
File ".../lib/python2.7/site-packages/deb_pkg_tools/cli.py", line 382, in with_repository_wrapper
with_repository(directory, \*command, cache=cache)
File ".../lib/python2.7/site-packages/deb_pkg_tools/repo.py", line 366, in with_repository
cache=kw.get('cache'))
File ".../lib/python2.7/site-packages/deb_pkg_tools/repo.py", line 228, in update_repository
cache=cache)
File ".../lib/python2.7/site-packages/deb_pkg_tools/repo.py", line 91, in scan_packages
fields = dict(inspect_package_fields(archive, cache=cache))
File ".../lib/python2.7/site-packages/deb_pkg_tools/package.py", line 480, in inspect_package_fields
value = entry.get_value()
File ".../lib/python2.7/site-packages/deb_pkg_tools/cache.py", line 268, in get_value
from_fs = pickle.load(handle)
ValueError: unsupported pickle protocol: 3

- Added ``property-manager`` to intersphinx mapping (enabling links in the online documentation).

.. _Release 4.0.1: https://github.com/xolox/python-deb-pkg-tools/compare/4.0...4.0.1