saturnin.component.service

Saturnin base module for implementation of Firebird Butler Services

Constants and variables

saturnin.component.service.SVC_CHN: Final[str]

Channel name

Classes

class saturnin.component.service.ServiceConfig(name: str)

Bases: ComponentConfig

Base data provider/consumer microservice configuration.

Parameters:

name (str) – Default configuration section name (service name)

endpoints: ListOption

Service endpoint addresses

class saturnin.component.service.Service(*args, **kwargs)

Bases: MicroService

Base Firebird Butler Service.

__init__(zmq_context: Context, descriptor: ServiceDescriptor, *, peer_uid: UUID = None)

Parameters:

• zmq_context (Context) – ZeroMQ Context.

• descriptor (ServiceDescriptor) – Service descriptor.

• peer_uid (UUID) – Peer ID, None means that newly generated UUID type 1 should be used.

initialize(config: ServiceConfig) → None

Verify configuration and assemble service structural parts.

Parameters:

config (ServiceConfig) – Service configuration.

Return type:

None

abstract register_api_handlers(service: FBSPService) → None

Called by initialize() for registration of service API handlers and FBSP service event handlers.

Parameters:

service (FBSPService) – Service instance

Return type:

None

start_activities() → None

Start normal service activities.

Must raise an exception when start fails.

Return type:

None

stop_activities() → None

Stop service activities.

Calls FBSPService.close and disables receiving incoming messages on the channel.

Return type:

None

svc_channel: RouterChannel

Channel for communication with service clients.