Changelog¶
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]¶
Fixed¶
NamespacePackageSourcefinds 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
Pluginsubclasses or@pluginfunctions, withshould_load(),load()and declaredrequires. - Discovery from entry points (the default), from an index file written by
plushy index, by scanning a package, or byregister(). 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 anExceptionGroupof onePluginErrorper 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 theyield;unload(name)runs it, after unloading the plugins that require it;refresh()unloads everything in reverse load order. - Enablement:
disabled=, anEnablementPolicy, andenable()/disable()at runtime. - Contracts: a
typing.Protocolchecked when each plugin loads, with a strict or lenientContractPolicy. - The
plushy indexcommand; 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.