python实现一个通用的插件类

import abc
from functools import wraps
from typing import callable, dict

from pydantic import (
    basemodel,
    validate_arguments,
    validationerror as pydanticvalidationerror,
)

def import_string(dotted_path: str) -> callable:
    """import a dotted module path and return the attribute/class designated by the
    last name in the path. raise importerror if the import failed.

    args:
        dotted_path: 字符串表示的模块类，module.class
    returns:
        返回加载的模块中的对象
    """
    try:
        module_path, class_name = dotted_path.rsplit(".", 1)
    except valueerror:
        raise importerror("{} doesn't look like a module path".format(dotted_path))

    module: moduletype = import_module(module_path)

    try:
        # 返回模块中的类
        return getattr(module, class_name)
    except attributeerror:
        raise importerror(
            'module "{}" does not define a "{}" attribute/class'.format(
                module_path, class_name
            )
        )


class functionsmanager:
    """函数管理器 ."""
    # 存放注册的可执行对象
    __hub = {}  # type: ignore

    @classmethod
    def register_invocation_cls(cls, invocation_cls: invocationmeta, name=none) -> none:
        if not name:
            func_name = invocation_cls.meta.func_name
        else:
            func_name = name
        if not isinstance(func_name, str):
            raise valueerror(f"func_name {func_name} should be string")
        existed_invocation_cls = cls.__hub.get(func_name)
        if existed_invocation_cls:
            raise runtimeerror(
                "func register error, {}'s func_name {} conflict with {}".format(
                    existed_invocation_cls, func_name, invocation_cls
                )
            )

        # 存放类的实例
        cls.__hub[func_name] = invocation_cls()

    @classmethod
    def register_funcs(cls, func_dict) -> none:
        for func_name, func_obj in func_dict.items():
            if not isinstance(func_name, str):
                raise valueerror(f"func_name {func_name} should be string")
            if func_name in cls.__hub:
                raise valueerror(
                    "func register error, {}'s func_name {} conflict with {}".format(
                        func_obj, func_name, cls.__hub[func_name]
                    )
                )
            if isinstance(func_obj, str):
                func = import_string(func_obj)
            elif isinstance(func_obj, callable):
                func = func_obj
            else:
                raise valueerror(
                    "func register error, {} is not be callable".format(
                        func_obj, func_name
                    )
                )

            cls.__hub[func_name] = func

    @classmethod
    def clear(cls) -> none:
        """清空注册信息 ."""
        cls.__hub = {}

    @classmethod
    def all_funcs(cls) -> dict:
        """获得所有的注册信息. """
        return cls.__hub

    @classmethod
    def get_func(cls, func_name: str) -> callable:
        """获得注册的函数 ."""
        func_obj = cls.__hub.get(func_name)
        if not func_obj:
            raise valueerror("func object {} not found".format(func_name))
        return func_obj

    @classmethod
    def func_call(cls, func_name: str, *args, **kwargs):
        """根据函数名执行注册的函数 ."""
        func = cls.get_func(func_name)
        return func(*args, **kwargs)

class invocationmeta(type):
    """
    metaclass for function invocation
    """

    def __new__(cls, name, bases, dct):
        # ensure initialization is only performed for subclasses of plugin
        parents = [b for b in bases if isinstance(b, invocationmeta)]
        if not parents:
            return super().__new__(cls, name, bases, dct)

        new_cls = super().__new__(cls, name, bases, dct)

        # meta validation
        meta_obj = getattr(new_cls, "meta", none)
        if not meta_obj:
            raise attributeerror("meta class is required")

        func_name = getattr(meta_obj, "func_name", none)
        if not func_name:
            raise attributeerror("func_name is required in meta")

        desc = getattr(meta_obj, "desc", none)
        if desc is not none and not isinstance(desc, str):
            raise attributeerror("desc in meta should be str")

        # register func
        functionsmanager.register_invocation_cls(new_cls)

        return new_cls

class baseinvocation(metaclass=invocationmeta):
    """
    base class for function invocation
    """

    class inputs(basemodel):
        """
        输入校验器
        """

        pass

    @validate_arguments  # type: ignore
    def __call__(self, *args, **kwargs):

        # 输入参数校验, 仅可能是 args 或 kwargs 之一
        try:
            params = {}
            if args:
                inputs_meta = getattr(self.inputs, "meta", none)
                inputs_ordering = getattr(inputs_meta, "ordering", none)
                if isinstance(inputs_ordering, list):
                    if len(args) > len(inputs_ordering):
                        raise exception(f"too many arguments for inputs: {args}")
                    params = dict(zip(inputs_ordering, args))
            elif kwargs:
                params = kwargs

            # 参数校验
            if params:
                self.inputs(**params)
        except pydanticvalidationerror as e:
            raise exception(e)

        # 执行自定义业务逻辑
        return self.invoke(*args, **kwargs)

    @abc.abstractmethod
    def invoke(self, *args, **kwargs):
        """自定义业务逻辑 ."""
        raise notimplementederror()

def register_class(name: str):
    def _register_class(cls: baseinvocation):
        functionsmanager.register_invocation_cls(cls, name=name)

        @wraps(cls)
        def wrapper():
            return cls()

        return wrapper

    return _register_class


def register_func(name: str):
    def _register_func(func: callable):
        functionsmanager.register_funcs({name: func})

        @wraps(func)
        def wrapper(*args, **kwargs):
            return func(*args, **kwargs)

        return wrapper

    return _register_func

from pydantic import basemodel

from .register import functionsmanager, register_func, register_class, baseinvocation


@register_func("add")
def add(x: int, y: int) -> int:
    return x + y


class add(baseinvocation):
    class meta:
        func_name = "multiply"

    class inputs(basemodel):
        """
        输入校验器
        """
        x: int
        y: int

        class meta:
            ordering = ["x", "y"]

    def invoke(self, x: int, y: int) -> int:
        return x * y


@register_class("subtract")
class subtract:
    class inputs(basemodel):
        """
        输入校验器
        """
        x: int
        y: int

        class meta:
            ordering = ["x", "y"]

    def __call__(self, x: int, y: int) -> int:
        return x - y


class testfunctionsmanager:
    def test_register_func(self):
        func = functionsmanager.get_func("add")
        assert func(2, 3) == 5

    def test_register_class(self):
        func = functionsmanager.get_func("subtract")
        assert func(2, 3) == -1

    def test_metaclass(self):
        func = functionsmanager.get_func("multiply")
        assert func(2, 3) == 6