interface-meta

What it is and what it does

InterfaceMeta is a metaclass-based library for building well-structured, extensible plugin systems in Python. It enforces that subclasses conform to their parent's API—including method signatures—while allowing optional additional parameters on overridden methods. The library automatically generates composite docstrings that merge base interface documentation with implementation-specific quirks, making it clear how each subclass extends or modifies the parent behavior.

The package is designed around the idea that subclassing alone should be sufficient to register a plugin and ensure compliance. It supports hierarchical property and method checking, optional explicit override decorators for clarity, and integration with Python's standard ABCMeta. This makes it particularly useful for libraries that expose plugin architectures where consistency and documentation quality are important.

Use it for:

• Building a plugin system where subclasses auto-register and must conform to a parent API contract.
• Creating extensible data connector libraries where implementations must follow consistent method signatures.
• Generating unified API documentation that combines base interface specs with implementation-specific behavior notes.
• Enforcing method signature compliance across a hierarchy of abstract and concrete classes at definition time.
• Developing framework-like libraries where third-party developers extend core interfaces with custom implementations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a metaclass-based system for building extensible APIs with enforced method signatures, automatic documentation stitching, and plugin registration hooks.

Yes, if you are building an extensible plugin architecture or framework where API consistency, automatic documentation, and registration hooks matter. The zero-dependency design and permissive license make adoption low-risk. The active maintenance and broad Python version support (3.10–3.14) provide confidence in long-term usability. Not necessary for simple single-class hierarchies or projects that don't require enforced API contracts.

Install

interface-meta on PyPI

pip install interface-meta

uv add interface-meta

poetry add interface-meta

Installing interface-meta

Before you install

Low install friction with no runtime dependencies. Active maintenance as of 2026-04-30 with support for Python 3.10 through 3.14.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.

Quickstart

from interface_meta import InterfaceMeta, inherit_docs, override
from abc import abstractmethod

class MyInterface(metaclass=InterfaceMeta):
    @property
    @abstractmethod
    def name(self) -> str:
        """The name of this interface."""

class MyImplementation(MyInterface):
    @override
    @property
    def name(self) -> str:
        return "example"

Requires Python 3.10 or later.

Verify before relying

• Whether the package is actively maintained beyond the 2026-04-30 release date or if that represents a stable final version.
• Practical performance characteristics when used with deeply nested class hierarchies or large plugin registries.

Package facts

Evidence: interface_meta-2.0.1-py3-none-any.whl

Tags

More Application Frameworks packages