Pluggy

=========================

Features
--------

- `177 <https://github.com/pytest-dev/pluggy/issues/177>`_: Add ``get_hookimpls()`` method to hook callers.



Trivial/Internal Changes
------------------------

- `165 <https://github.com/pytest-dev/pluggy/issues/165>`_: Add changelog in long package description and documentation.


- `172 <https://github.com/pytest-dev/pluggy/issues/172>`_: Add a test exemplifying the opt-in nature of spec defined args.


- `57 <https://github.com/pytest-dev/pluggy/issues/57>`_: Encapsulate hook specifications in a type for easier introspection.

=========================

Deprecations and Removals
-------------------------

- `116 <https://github.com/pytest-dev/pluggy/issues/116>`_: Deprecate the ``implprefix`` kwarg to ``PluginManager`` and instead
expect users to start using explicit ``HookimplMarker`` everywhere.



Features
--------

- `122 <https://github.com/pytest-dev/pluggy/issues/122>`_: Add ``.plugin`` member to ``PluginValidationError`` to access failing plugin during post-mortem.


- `138 <https://github.com/pytest-dev/pluggy/issues/138>`_: Add per implementation warnings support for hookspecs allowing for both
deprecation and future warnings of legacy and (future) experimental hooks
respectively.



Bug Fixes
---------

- `110 <https://github.com/pytest-dev/pluggy/issues/110>`_: Fix a bug where ``_HookCaller.call_historic()`` would call the ``proc``
arg even when the default is ``None`` resulting in a ``TypeError``.

- `160 <https://github.com/pytest-dev/pluggy/issues/160>`_: Fix problem when handling ``VersionConflict`` errors when loading setuptools plugins.



Improved Documentation
----------------------

- `123 <https://github.com/pytest-dev/pluggy/issues/123>`_: Document how exceptions are handled and how the hook call loop
terminates immediately on the first error which is then delivered
to any surrounding wrappers.


- `136 <https://github.com/pytest-dev/pluggy/issues/136>`_: Docs rework including a much better introduction and comprehensive example
set for new users. A big thanks goes out to obestwalter for the great work!



Trivial/Internal Changes
------------------------

- `117 <https://github.com/pytest-dev/pluggy/issues/117>`_: Break up the main monolithic package modules into separate modules by concern


- `131 <https://github.com/pytest-dev/pluggy/issues/131>`_: Automate ``setuptools`` wheels building and PyPi upload using TravisCI.


- `153 <https://github.com/pytest-dev/pluggy/issues/153>`_: Reorganize tests more appropriately by modules relating to each
internal component/feature. This is in an effort to avoid (future)
duplication and better separation of concerns in the test set.


- `156 <https://github.com/pytest-dev/pluggy/issues/156>`_: Add ``HookImpl.__repr__()`` for better debugging.


- `66 <https://github.com/pytest-dev/pluggy/issues/66>`_: Start using ``towncrier`` and a custom ``tox`` environment to prepare releases!

=========================

* `160 <https://github.com/pytest-dev/pluggy/issues/160>`_: We discovered a deployment issue so this version was never released to PyPI, only the tag exists.

=========================

- Add CI testing for the features, release, and master
branches of ``pytest`` (PR `79`_).
- Document public API for ``_Result`` objects passed to wrappers
(PR `85`_).
- Document and test hook LIFO ordering (PR `85`_).
- Turn warnings into errors in test suite (PR `89`_).
- Deprecate ``_Result.result`` (PR `88`_).
- Convert ``_Multicall`` to a simple function distinguishing it from
the legacy version (PR `90`_).
- Resolve E741 errors (PR `96`_).
- Test and bug fix for unmarked hook collection (PRs `97`_ and
`102`_).
- Drop support for EOL Python 2.6 and 3.3 (PR `103`_).
- Fix ``inspect`` based arg introspection on py3.6 (PR `94`_).

.. _79: https://github.com/pytest-dev/pluggy/pull/79
.. _85: https://github.com/pytest-dev/pluggy/pull/85
.. _88: https://github.com/pytest-dev/pluggy/pull/88
.. _89: https://github.com/pytest-dev/pluggy/pull/89
.. _90: https://github.com/pytest-dev/pluggy/pull/90
.. _94: https://github.com/pytest-dev/pluggy/pull/94
.. _96: https://github.com/pytest-dev/pluggy/pull/96
.. _97: https://github.com/pytest-dev/pluggy/pull/97
.. _102: https://github.com/pytest-dev/pluggy/pull/102
.. _103: https://github.com/pytest-dev/pluggy/pull/103

=========================

- fix bug where ``firstresult`` wrappers were being sent an incorrectly configured
``_Result`` (a list was set instead of a single value). Add tests to check for
this as well as ``_Result.force_result()`` behaviour. Thanks to `tgoodlet`_
for the PR `72`_.

- fix incorrect ``getattr`` of ``DeprecationWarning`` from the ``warnings``
module. Thanks to `nicoddemus`_ for the PR `77`_.

- hide ``pytest`` tracebacks in certain core routines. Thanks to
`nicoddemus`_ for the PR `80`_.

.. _72: https://github.com/pytest-dev/pluggy/pull/72
.. _77: https://github.com/pytest-dev/pluggy/pull/77
.. _80: https://github.com/pytest-dev/pluggy/pull/80

=========================

- fix a bug and add tests for case where ``firstresult`` hooks return
``None`` results. Thanks to `RonnyPfannschmidt`_ and `tgoodlet`_
for the issue (`68`_) and PR (`69`_) respectively.

.. _69: https://github.com/pytest-dev/pluggy/pull/69
.. _68: https://github.com/pytest-dev/pluggy/issues/68