temporalio.client.Plugin

class documentation

class Plugin(abc.ABC): (source)

Known subclasses: temporalio.plugin.SimplePlugin

Base class for client plugins that can intercept and modify client behavior.

Plugins allow customization of client creation and service connection processes through a chain of responsibility pattern. Each plugin can modify the client configuration or intercept service client connections.

If the plugin is also a temporalio.worker.Plugin, it will additionally be propagated as a worker plugin. You should likley not also provide it to the worker as that will result in the plugin being applied twice.

Method	`configure_client`	Hook called when creating a client to allow modification of configuration.
Async Method	`connect_service_client`	Hook called when connecting to the Temporal service.
Method	`name`	Get the name of this plugin. Can be overridden if desired to provide a more appropriate name.

@abstractmethod
def configure_client(self, config: ClientConfig) -> ClientConfig: (source) ¶

overridden in temporalio.plugin.SimplePlugin

Hook called when creating a client to allow modification of configuration.

This method is called during client creation and allows plugins to modify the client configuration before the client is fully initialized. Plugins can add interceptors, modify connection parameters, or change other settings.

Parameters
config:`ClientConfig`	The client configuration dictionary to potentially modify.
Returns
`ClientConfig`	The modified client configuration.

@abstractmethod
async def connect_service_client(self, config: ConnectConfig, next: Callable[[ConnectConfig], Awaitable[ServiceClient]]) -> ServiceClient: (source) ¶

overridden in temporalio.plugin.SimplePlugin

Hook called when connecting to the Temporal service.

This method is called during service client connection and allows plugins to intercept or modify the connection process. Plugins can modify connection parameters, add authentication, or provide custom connection logic.

Parameters
config:`ConnectConfig`	The service connection configuration.
next:`Callable[[ConnectConfig], Awaitable[ServiceClient]]`	Undocumented
Returns
`ServiceClient`	The connected service client.

def name(self) -> str: (source) ¶

overridden in temporalio.plugin.SimplePlugin

Get the name of this plugin. Can be overridden if desired to provide a more appropriate name.

Returns
`str`	The fully qualified name of the plugin class (module.classname).