oaknut-extension 12.2.0

Entry-point plug-in framework shared by every extensible axis of the oaknut package family.

oaknut-extension

The entry-point plug-in framework shared by every extensible axis of the oaknut package family.

An axis is one extension point — a family of interchangeable plug-ins that all answer the same question. The primary axis is filesystems (each plug-in detects and operates on one disc format, in oaknut-filesystem); oaknut.command (CLI subcommands contributed by filesystem packages) is another.

Each axis declares a kind (a short identifier such as "filesystem"). Concrete extensions for that axis subclass Extension, override _kind(), and register themselves under the oaknut.<kind> entry-point namespace in their package's pyproject.toml:

[project.entry-points."oaknut.filesystem"]
acorn-dfs = "oaknut.dfs.filesystem:AcornDFS"

Consumers discover and load them through list_extensions(), create_extension(), and friends, which wrap stevedore. Because discovery is by installed entry point, a plug-in shipped by any package appears automatically — no central registry to edit.

This package is deliberately domain-agnostic: it knows nothing about discs, files, or formats. It depends only on oaknut-exception (for the shared error hierarchy) and stevedore.