Extension class

This is the reference for the main object Extension. It is optionally wrapped by a Pluggable.

ravyn.Extension

Extension(app=None, **kwargs)

Bases: ABC, ExtensionProtocol

Extension object is the one being used to add the logic that will originate the pluggable in the application.

The Extension must implement the extend function.

Read more about the Extension and learn how to use it.

Example

from typing import Optional

from ravyn import Ravyn, Extension
from ravyn.types import DictAny


class MyExtension(Extension):
    def __init__(self, app: Optional["Ravyn"] = None, **kwargs: "DictAny"):
        super().__init__(app)
        self.kwargs = kwargs

    def extend(self, **kwargs: "DictAny") -> None:
        '''
        Function that should always be implemented when extending
        the Extension class or a `NotImplementedError` is raised.
        '''
        # Do something here

PARAMETER	DESCRIPTION
app	An Ravyn application instance or subclasses of Ravyn. TYPE: Optional[Ravyn] DEFAULT: None
**kwargs	Any additional kwargs needed. TYPE: Any DEFAULT: {}

Source code in ravyn/pluggables/base.py

def __init__(
    self,
    app: Annotated[
        Optional[Ravyn],
        Doc(
            """
            An `Ravyn` application instance or subclasses of Ravyn.
            """
        ),
    ] = None,
    **kwargs: Annotated[
        Any,
        Doc("""Any additional kwargs needed."""),
    ],
):
    super().__init__()
    self.app = app

app instance-attribute

app = app

extend abstractmethod

extend(**kwargs)

Source code in ravyn/pluggables/base.py

@abstractmethod
def extend(self, **kwargs: Any) -> None:
    raise NotImplementedError("Extension must be implemented by the subclasses.")