pincer.commands.interactable

Complexity

Total Complexity

6

Size/Duplication

Total Lines	55
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	PartialInteractable.__call__()	0	2	1
A	PartialInteractable.register()	0	3	1
A	PartialInteractable.__init__()	0	4	1
A	Interactable.__init__()	0	4	3

# Copyright Pincer 2021-Present

Missing module docstring

# Full MIT License can be found in `LICENSE` at the project root.

from __future__ import annotations

from abc import ABC, abstractmethod
from typing import TYPE_CHECKING, Type, TypeVar

if TYPE_CHECKING:
    from typing import Any, Awaitable, Callable

T = TypeVar("T")


class PartialInteractable(ABC):
    """
    Represents a command or message component to be registered to a class.

    Parameters
    ----------
    func : Callable[..., Awaitable[Any]]
        The function to run for this interaction.
    args : Any
        Args to be stored to used in register.
    kwargs : Any
        Kwargs to store to be used in register.
    """

    def __init__(self, func: Callable[..., Awaitable[Any]], *args: Any, **kwargs: Any):
        self.func = func
        self.args = args
        self.kwargs = kwargs

    def __call__(self, *args: Any, **kwds: Any) -> Any:
        return self.func(*args, **kwds)

    @abstractmethod
    def register(self, manager: Any) -> Type[T]:
        """Registers a command to a command handler to be called later"""


class Interactable:
    """
    Class that can register :class:`~pincer.commands.interactable.PartialInteractable`
    objects. Any class that subclasses this class can register Application Commands and
    Message Components.
    PartialInteractable objects are registered by running the register function and
    setting an attribute of the client to the result.
    """

    def __init__(self):
        for key, value in vars(type(self)).items():
            if isinstance(value, PartialInteractable):
                setattr(self, key, value.register(self))