init_plugin

The application configuration plugin and config object.

Example

from starlite import Starlite, get

from starlite_saqlalchemy import ConfigureApp


@get("/example")
def example_handler() -> dict:
    return {"hello": "world"}


app = Starlite(route_handlers=[example_handler], on_app_init=[ConfigureApp()])

The plugin can be configured by passing an instance of PluginConfig to ConfigureApp on

instantiation

app = Starlite(
    route_handlers=[example_handler],
    on_app_init[ConfigureApp(PluginConfig(do_openapi=False))],
)

The PluginConfig has switches to disable every aspect of the plugin behavior.

ConfigureApp

ConfigureApp(config=PluginConfig())

Starlite application configuration.

__call__

__call__(app_config)

Entrypoint to the app config plugin.

Receives the AppConfig object and modifies it.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	Passed to the plugin from the Starlite instance on instantiation.	required

Returns:

Type	Description
AppConfig	The modified AppConfig object.

configure_after_exception

configure_after_exception(app_config)

Add the logging after exception hook handler.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_cache

configure_cache(app_config)

Configure the application cache.

We only overwrite if DEFAULT_CACHE_CONFIG is the standing configuration object.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_collection_dependencies

configure_collection_dependencies(app_config)

Add the required Provide instances to the app dependency mapping.

If a dependency has already been provided with the same key we do not overwrite it.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_compression

configure_compression(app_config)

Configure application compression.

No-op if AppConfig.compression_config has already been set.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_debug

configure_debug(app_config)

Set the Starlite debug parameter.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_exception_handlers

configure_exception_handlers(app_config)

Add the handlers that translate service and repository exceptions into HTTP exceptions.

Does not overwrite handlers that may already exist for the exception types.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_health_check

configure_health_check(app_config)

Add health check controller.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_logging

configure_logging(app_config)

Configure application logging.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_openapi

configure_openapi(app_config)

Configure the OpenAPI docs.

We only overwrite if DEFAULT_OPENAPI_CONFIG is the standing configuration.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_sentry

configure_sentry(app_config)

Add handler to configure Sentry integration.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_sqlalchemy_plugin

configure_sqlalchemy_plugin(app_config)

Configure SQLAlchemy for the application.

Adds a configured SQLAlchemyPlugin to AppConfig.plugins.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_type_encoders

configure_type_encoders(app_config)

Set mapping of type encoders on the application config.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

configure_worker

configure_worker(app_config)

Configure the SAQ async worker.

No-op if there are no worker functions set on PluginConfig.

Parameters:

Name	Type	Description	Default
app_config	AppConfig	The Starlite application config object.	required

PluginConfig

Bases: BaseModel

Configure behavior of the ConfigureApp object.

Each feature that the plugin enables can be toggled with the do_<behavior> switch, e.g., PluginConfig(do_after_exception=False) will tell ConfigureApp not to add the after exception logging hook handler to the application.

do_after_exception class-attribute

do_after_exception: bool = True

Configure after exception handler.

Add the hook handler to AppConfig.after_exception.

do_cache class-attribute

do_cache: bool = True

Configure redis cache backend.

Add configuration for the redis-backed cache to AppConfig.cache_config.

do_collection_dependencies class-attribute

do_collection_dependencies = True

Add collection route dependencies.

Add the Provide's for collection route dependencies to AppConfig.dependencies.

do_compression class-attribute

do_compression: bool = True

Confiture compression backend.

Add configuration for gzip compression to AppConfig.compression_config.

do_exception_handlers class-attribute

do_exception_handlers: bool = True

Configure exception handlers.

Add the repository/service exception http translation handlers to AppConfig.exception_handlers.

do_health_check class-attribute

do_health_check: bool = True

Configure a health check.

Add the health check controller to AppConfig.route_handlers.

do_logging class-attribute

do_logging: bool = True

Configure logging.

Set the logging configuration object to AppConfig.logging_config.

do_openapi class-attribute

do_openapi: bool = True

Configure OpenAPI.

Set the OpenAPI config object to AppConfig.openapi_config.

do_sentry class-attribute

do_sentry: bool | None = None

Configure sentry.

Configure the application to initialize Sentry on startup. Adds a handler to AppConfig.on_startup.

do_set_debug class-attribute

do_set_debug: bool = True

Configure Starlite debug mode.

Allow the plugin to set the starlite debug parameter. Parameter set to value of AppConfig.debug.

do_sqlalchemy_plugin class-attribute

do_sqlalchemy_plugin: bool = True

Configure SQLAlchemy plugin.

Set the SQLAlchemy plugin on the application. Adds the plugin to AppConfig.plugins.

do_type_encoders class-attribute

do_type_encoders: bool = True

Configure custom type encoders on the app.

do_worker class-attribute

do_worker: bool = True

Configure the async worker on the application.

This action instantiates a worker instance and sets handlers for AppConfig.on_startup and AppConfig.on_shutdown that manage the lifecycle of the SAQ worker.

log_processors class-attribute

log_processors: Sequence[Processor] = log.default_processors

Chain of structlog log processors.

type_encoders class-attribute

type_encoders: TypeEncodersMap = type_encoders_map

Map of type to serializer callable.

worker_functions class-attribute

worker_functions: list[Callable[..., Any] | tuple[str, Callable[..., Any]]] = [
    (make_service_callback.__qualname__, make_service_callback)
]

Queue worker functions.