mirror of
https://github.com/checktheroads/hyperglass
synced 2024-05-11 05:55:08 +00:00
75 lines
2.1 KiB
Python
75 lines
2.1 KiB
Python
"""Base Plugin Definition."""
|
|
|
|
# Standard Library
|
|
import typing as t
|
|
from abc import ABC
|
|
from inspect import Signature
|
|
|
|
# Third Party
|
|
from pydantic import BaseModel, PrivateAttr
|
|
|
|
PluginType = t.Union[t.Literal["output"], t.Literal["input"]]
|
|
SupportedMethod = t.TypeVar("SupportedMethod")
|
|
|
|
|
|
class HyperglassPlugin(BaseModel, ABC):
|
|
"""Plugin to interact with device command output."""
|
|
|
|
__hyperglass_builtin__: bool = PrivateAttr(False)
|
|
name: str
|
|
common: bool = False
|
|
ref: t.Optional[str] = None
|
|
|
|
@property
|
|
def _signature(self) -> Signature:
|
|
"""Get this instance's class signature."""
|
|
return self.__class__.__signature__
|
|
|
|
def __eq__(self, other: "HyperglassPlugin") -> bool:
|
|
"""Other plugin is equal to this plugin."""
|
|
if hasattr(other, "_signature"):
|
|
return other and self._signature == other._signature
|
|
return False
|
|
|
|
def __ne__(self, other: "HyperglassPlugin") -> bool:
|
|
"""Other plugin is not equal to this plugin."""
|
|
return not self.__eq__(other)
|
|
|
|
def __hash__(self) -> int:
|
|
"""Create a hashed representation of this plugin's name."""
|
|
return hash(self._signature)
|
|
|
|
def __str__(self) -> str:
|
|
"""Represent plugin by its name."""
|
|
return self.name
|
|
|
|
@classmethod
|
|
def __init_subclass__(cls, **kwargs: t.Any) -> None:
|
|
"""Initialize plugin object."""
|
|
name = kwargs.pop("name", None) or cls.__name__
|
|
cls.name = name
|
|
super().__init_subclass__()
|
|
|
|
def __init__(self, **kwargs: t.Any) -> None:
|
|
"""Initialize plugin instance."""
|
|
name = kwargs.pop("name", None) or self.__class__.__name__
|
|
super().__init__(name=name, **kwargs)
|
|
|
|
|
|
class DirectivePlugin(BaseModel):
|
|
"""Plugin associated with directives.
|
|
|
|
Should always be subclassed with `HyperglassPlugin`.
|
|
"""
|
|
|
|
directives: t.Sequence[str] = ()
|
|
|
|
|
|
class PlatformPlugin(BaseModel):
|
|
"""Plugin associated with specific device platform.
|
|
|
|
Should always be subclassed with `HyperglassPlugin`.
|
|
"""
|
|
|
|
platforms: t.Sequence[str] = ()
|