orionis.console.core.contracts.loader.ILoader

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

class documentation

class ILoader(ABC): (source)

Known subclasses: orionis.console.core.loader.Loader

View In Hierarchy

Undocumented

Method	`addFluentCommand`	Define a new command using the fluent interface.
Async Method	`all`	Return all loaded commands.
Async Method	`get`	Retrieve a command instance by its signature.
Async Method	`load`	Load all command classes and their metadata.

@abstractmethod

def addFluentCommand(self, signature: str, handler: list[type[Any], str | None]) -> ICommand: (source) ¶

overridden in orionis.console.core.loader.Loader

Define a new command using the fluent interface.

Create a command with the given signature and handler. The handler must be a list containing the class and optionally the method name. Validate input types and conventions. Return the created ICommand instance.

Parameters
signature:`str`	Unique identifier for the command.
handler:`list of Any`	List containing the class and optionally the method name.

Returns
`ICommand`	The created FluentCommand instance.

Raises
`TypeError`	If the signature is not a string or the handler is not a valid list.
`ValueError`	If the signature does not meet naming conventions.

@abstractmethod

async def all(self) -> dict[str, Command]: (source) ¶

overridden in orionis.console.core.loader.Loader

Return all loaded commands.

Returns
`dict[str, Command]`	A dictionary mapping command signatures to Command instances.

@abstractmethod

async def get(self, signature: str) -> Command | None: (source) ¶

overridden in orionis.console.core.loader.Loader

Retrieve a command instance by its signature.

Parameters
signature:`str`	The unique signature identifying the command.

Returns
`Command \| None`	The Command instance if found, otherwise None.

@abstractmethod

async def load(self): (source) ¶

overridden in orionis.console.core.loader.Loader

Load all command classes and their metadata.

This method loads command metadata from cache if available, otherwise discovers core commands, custom commands, and fluent commands. It then builds Command instances for each command and populates the internal commands dictionary.

Returns
`None`	This method populates the internal commands dictionary and does not return a value.