---
id: interface-meta
version: "2.0.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# interface-meta — `interface_meta` provides a convenient way to expose an extensible API with enforced method signatures and consistent documentation.

License: permissive · Maintenance: active · Downloads: 3.7M/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

extensible plugin architecture, enforced method signatures, interface metaclass, API documentation generation, subclass registration, abstract method enforcement, plugin system framework, plugin-architecture, metaclass-framework, api-enforcement

[View on SkillFed](https://skillfed.io/packages/interface-meta) · [View on PyPI](https://pypi.org/project/interface-meta/)