./devel/py-pluggy, Plugin and hook calling mechanisms for python

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 1.5.0, Package name: py312-pluggy-1.5.0, Maintainer: pkgsrc-users

This package contains the plugin manager as used by pytest but
stripped of pytest specific details.


Required to run:
[devel/py-setuptools] [lang/python37] [devel/py-importlib-metadata]

Required to build:
[pkgtools/cwrappers] [devel/py-setuptools_scm]

Master sites:

Filesize: 66.362 KB

Version history: (Expand)


CVS history: (Expand)


   2024-04-21 09:31:15 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-pluggy: updated to 1.5.0

pluggy 1.5.0 (2024-04-19)

Features
- Add support for deprecating specific hook parameters, or more generally, for \ 
issuing a warning whenever a hook implementation requests certain parameters.
  See :ref:`warn_on_impl` for details.

Bug Fixes
- ``PluginManager.get_plugins()`` no longer returns ``None`` for blocked plugins.
   2024-01-24 23:17:20 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-pluggy: updated to 1.4.0

pluggy 1.4.0 (2024-01-24)

Features

- A warning :class:`~pluggy.PluggyTeardownRaisedWarning` is now issued when an \ 
old-style hookwrapper raises an exception during teardown.
  See the warning documentation for more details.
- Add :func:`PluginManager.unblock <pluggy.PluginManager.unblock>` method \ 
to unblock a plugin by plugin name.

Bug Fixes

- Fix :func:`~pluggy.HookCaller.call_extra()` extra methods getting ordered \ 
before everything else in some circumstances. Regressed in pluggy 1.1.0.
- Fix plugins registering other plugins in a hook when the other plugins \ 
implement the same hook itself. Regressed in pluggy 1.1.0.
   2023-08-27 04:55:26 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-pluggy: updated to 1.3.0

pluggy 1.3.0 (2023-08-26)
=========================

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

- Python 3.7 is no longer supported.

Features
--------

- Pluggy now exposes its typings to static type checkers.

  As part of this, the following changes are made:

  - Renamed ``_Result`` to ``Result``, and exported as :class:`pluggy.Result`.
  - Renamed ``_HookRelay`` to ``HookRelay``, and exported as \ 
:class:`pluggy.HookRelay`.
  - Renamed ``_HookCaller`` to ``HookCaller``, and exported as \ 
:class:`pluggy.HookCaller`.
  - Exported ``HookImpl`` as :class:`pluggy.HookImpl`.
  - Renamed ``_HookImplOpts`` to ``HookimplOpts``, and exported as \ 
:class:`pluggy.HookimplOpts`.
  - Renamed ``_HookSpecOpts`` to ``HookspecOpts``, and exported as \ 
:class:`pluggy.HookspecOpts`.
  - Some fields and classes are marked ``Final`` and ``@final``.
  - The :ref:`api-reference` is updated to clearly delineate pluggy's public API.

  Compatibility aliases are put in place for the renamed types.
  We do not plan to remove the aliases, but we strongly recommend to only import \ 
from ``pluggy.*`` to ensure future compatibility.

  Please note that pluggy is currently unable to provide strong typing for hook \ 
calls, e.g. ``pm.hook.my_hook(...)``,
  nor to statically check that a hook implementation matches the hook \ 
specification's type.
   2023-07-30 17:32:50 by Adam Ciarcinski | Files touched by this commit (19)
Log message:
Remove dependencies for Python 3.7
   2023-06-28 10:55:29 by Thomas Klausner | Files touched by this commit (2) | Package updated
Log message:
py-pluggy: update to 1.2.0.

pluggy 1.2.0 (2023-06-21)
=========================

Features
--------

- `#405 <https://github.com/pytest-dev/pluggy/issues/405>`_: The new-style \ 
hook wrappers, added in the yanked 1.1.0 release, now require an explicit \ 
``wrapper=True`` designation in the ``@hookimpl()`` decorator.

pluggy 1.1.0 (YANKED)
=====================

.. note::

  This release was yanked because unfortunately the implicit new-style hook \ 
wrappers broke some downstream projects.
  See `#403 <https://github.com/pytest-dev/pluggy/issues/403>`__ for more \ 
information.
  This was rectified in the 1.2.0 release.

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

- `#364 <https://github.com/pytest-dev/pluggy/issues/364>`_: Python 3.6 is \ 
no longer supported.

Features
--------

- `#260 <https://github.com/pytest-dev/pluggy/issues/260>`_: Added \ 
"new-style" hook wrappers, a simpler but equally powerful alternative \ 
to the existing ``hookwrapper=True`` wrappers.

  New-style wrappers are generator functions, similarly to ``hookwrapper``, but \ 
do away with the :class:`result <pluggy._callers._Result>` object.
  Instead, the return value is sent directly to the ``yield`` statement, or, if \ 
inner calls raised an exception, it is raised from the ``yield``.
  The wrapper is expected to return a value or raise an exception, which will \ 
become the result of the hook call.

  New-style wrappers are fully interoperable with old-style wrappers.
  We encourage users to use the new style, however we do not intend to deprecate \ 
the old style any time soon.

  See :ref:`hookwrappers` for the full documentation.

- `#364 <https://github.com/pytest-dev/pluggy/issues/364>`_: Python 3.11 \ 
and 3.12 are now officially supported.

- `#394 <https://github.com/pytest-dev/pluggy/issues/394>`_: Added the \ 
:meth:`~pluggy._callers._Result.force_exception` method to ``_Result``.

  ``force_exception`` allows (old-style) hookwrappers to force an exception or \ 
override/adjust an existing exception of a hook invocation,
  in a properly behaving manner. Using ``force_exception`` is preferred over \ 
raising an exception from the hookwrapper,
  because raising an exception causes other hookwrappers to be skipped.
   2023-06-06 14:42:56 by Taylor R Campbell | Files touched by this commit (1319)
Log message:
Mass-change BUILD_DEPENDS to TOOL_DEPENDS outside mk/.

Almost all uses, if not all of them, are wrong, according to the
semantics of BUILD_DEPENDS (packages built for target available for
use _by_ tools at build-time) and TOOL_DEPEPNDS (packages built for
host available for use _as_ tools at build-time).

No change to BUILD_DEPENDS as used correctly inside buildlink3.

As proposed on tech-pkg:
https://mail-index.netbsd.org/tech-pkg/2023/06/03/msg027632.html
   2023-03-29 11:34:15 by Thomas Klausner | Files touched by this commit (96)
Log message:
*: use PYTHON_VERSION instead of _PYTHON_VERSION
   2022-10-11 15:14:15 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-pluggy: updated to 1.0.0

pluggy 1.0.0 (2021-08-25)
=========================

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

- Remove deprecated ``implprefix`` support.
  Decorate hook implementations using an instance of HookimplMarker instead.
  The deprecation was announced in release ``0.7.0``.

- Remove the deprecated ``proc`` argument to ``call_historic``.
  Use ``result_callback`` instead, which has the same behavior.
  The deprecation was announced in release ``0.7.0``.

- Remove the ``_Result.result`` property. Use ``_Result.get_result()`` instead.
  Note that unlike ``result``, ``get_result()`` raises the exception if the hook \ 
raised.
  The deprecation was announced in release ``0.6.0``.

- Remove official support for Python 3.4.

- Dropped support for Python 2.
  Continue to use pluggy 0.13.x for Python 2 support.

- Remove official support for Python 3.5.

- The internal ``pluggy.callers``, ``pluggy.manager`` and ``pluggy.hooks`` are \ 
now explicitly marked private by a ``_`` prefix (e.g. ``pluggy._callers``).
  Only API exported by the top-level ``pluggy`` module is considered public.

- Remove legacy ``__multicall__`` recursive hook calling system.
  The deprecation was announced in release ``0.5.0``.

Features
--------

- When registering a hookimpl which is declared as ``hookwrapper=True`` but whose
  function is not a generator function, a ``PluggyValidationError`` exception is
  now raised.

  Previously this problem would cause an error only later, when calling the hook.

  In the unlikely case that you have a hookwrapper that *returns* a generator
  instead of yielding directly, for example:

  .. code-block:: python

      def my_hook_real_implementation(arg):
          print("before")
          yield
          print("after")

      @hookimpl(hookwrapper=True)
      def my_hook(arg):
          return my_hook_implementation(arg)

  change it to use ``yield from`` instead:

  .. code-block:: python

      @hookimpl(hookwrapper=True)
      def my_hook(arg):
          yield from my_hook_implementation(arg)

- Add official support for Python 3.9.