betty.service module#

An API for providing application-wide services.

final class betty.service.Service#

Bases: Generic

Wrap a service so it can be type-checked as such.

exception betty.service.ServiceAlreadyInitialized#

A service was unexpectedly initialized already.

exception betty.service.ServiceError#

Bases: RuntimeError

A service API error.

class betty.service.ServiceManager#

Bases: Prop[ServiceProviderT, GetServiceT, Never], Generic

Manage a single service for a service provider.

__init__(factory: ServiceOrFactory[ServiceProviderT, ServiceT, FactoryServiceT], /)#

final get(service_provider: ServiceProviderT, /) → GetServiceT#: Get the property value from the owner.

init_owner(service_provider: ServiceProviderT, /) → None#: Initialize the property on an owner.

final override(service_provider: ServiceProviderT, service: ServiceOrFactory[ServiceProviderT, ServiceT, FactoryServiceT], /) → None#

Override the service for the given service provider.

Calling this will prevent the existing factory from being called.

This MUST only be called from instance.__init__().

exception betty.service.ServiceNotYetInitialized#

A service was unexpectedly not yet initialized.

class betty.service.ServiceProvider#

Bases: HasProps

A service provider.

services: Final[ServiceLevel]#: The service level the services are provided for.