Skip to content

Changelog

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Fixed

  • NamespacePackageSource finds a module added since the previous scan even when the package directory's modification time has not changed, as happens within one timestamp tick on Linux.

[0.1.0] - 2026-11-21

This is the first release of Plushy, a plugin framework for Python 3.11 and later whose only dependency is Pluggy. It was developed under the name pluxeo.

Added

  • PluginManager, owning one namespace: discovers its plugins, loads them, keeps their state, and calls their hooks.
  • Plugins as Plugin subclasses or @plugin functions, with should_load(), load() and declared requires.
  • Discovery from entry points (the default), from an index file written by plushy index, by scanning a package, or by register(). Entry-point and index discovery import no plugin code until a plugin is loaded.
  • A lifecycle with states (DISCOVERED, INSTANTIATED, LOADED, DISABLED, ERRORED), lifecycle listeners, and failures contained per plugin; error(name) keeps the exception.
  • load_all(strict=True): load every plugin, then raise an ExceptionGroup of one PluginError per plugin that failed.
  • Hooks through Pluggy: collect-all, firstresult, historic hooks, wrappers, tryfirst/trylast. A plugin's hooks are called only while it is loaded and enabled.
  • Async calls: pm.hook.<name>.aio() in order, .aio_gather() concurrently. No async wrappers.
  • Cleanup: a generator load() yields its result and cleans up after the yield; unload(name) runs it, after unloading the plugins that require it; refresh() unloads everything in reverse load order.
  • Enablement: disabled=, an EnablementPolicy, and enable()/disable() at runtime.
  • Contracts: a typing.Protocol checked when each plugin loads, with a strict or lenient ContractPolicy.
  • The plushy index command; it fails on a module it cannot import, unless --keep-going.
  • A documentation site, built with Zensical from docs/, whose examples are run by the test suite.