harp.config.applications

class Application

Bases: object

__init__(*, on_bind=None, on_bound=None, on_ready=None, on_shutdown=None, settings_type=None, dependencies=None)

Parameters:

• on_bind (Callable[[OnBindEvent], Awaitable[None]])

• on_bound (Callable[[OnBoundEvent], Awaitable[None]])

• on_ready (Callable[[OnReadyEvent], Awaitable[None]])

• on_shutdown (Callable[[OnShutdownEvent], Awaitable[None]])

• settings_type (Type)

• dependencies (list[str])

defaults()

has_application_settings_mixin()

Check if settings_type has ApplicationSettingsMixin in its inheritance chain.

normalize(settings)

on_bind: Callable[[OnBindEvent], Awaitable[None]] = None

Placeholder for factory bind event, happening before the container is built. If set, it will be attached to the factory dispatcher automatically.

on_bound: Callable[[OnBoundEvent], Awaitable[None]] = None

Placeholder for factory bound event, happening after the container is built. If set, it will be attached to the factory dispatcher automatically.

on_ready: Callable[[OnReadyEvent], Awaitable[None]] = None

Placeholder for factory build event, happening after the kernel is built. If set, it will be attached to the factory dispatcher automatically.

on_shutdown: Callable[[OnShutdownEvent], Awaitable[None]] = None

Placeholder for factory dispose event, happening after the kernel is disposed. If set, it will be attached to the factory dispatcher automatically, in reverse order of appearance (first loaded application will be disposed last).

path: str | None = None

A placeholder for the source path of the application.

settings_type: Type = None

Type definition for configuration parsing.

class ApplicationsRegistry

Bases: object

__init__(*, namespaces=None)

Parameters:

namespaces (list[str] | None)

add(*names, autoload_dependencies=False)

Add applications to the registry.

Args:

*names: Application names to add autoload_dependencies: If True, automatically add declared dependencies.

Defaults to False for backward compatibility.

Parameters:

autoload_dependencies (bool)

aslist()

defaults()

get_application(name)

Returns the application class for the given application name.

todo: add name/full_name attributes with raise if already set to different value ?

Parameters:

name (str)

Returns:

Return type:

Application

items()

Return type:

ItemsView[str, Application]

keys()

Return type:

KeysView[str]

register_events(dispatcher)

Parameters:

dispatcher (IAsyncEventDispatcher)

register_services(container, config)

Parameters:

• container (Container)

• config (dict)

remove(*names)

resolve_dependencies()

Reorder applications based on dependency order using topological sort.

resolve_name(spec)

resolve_short_name(full_name)

validate_dependencies()

Validate that all declared dependencies exist in the registry.

values()

Return type:

ValuesView[Application]

namespaces = ['harp_apps']

applications = {}

Cache for applications