Service Composition#

ServiceGroup#

class advanced_alchemy.service._group.ServiceGroup(
session,
*,
error_messages=Empty,
execution_options=None,
uniquify=None,
count_with_window_function=None,
auto_expunge=None,
auto_refresh=None,
auto_commit=None,
wrap_exceptions=None,
)[source]#

Bases: object

Base class for composing multiple repository services on one shared SQLAlchemy session.

Declare each service as an annotated attribute on a ServiceGroup subclass:

class AuthServices(ServiceGroup):
    users: UserService
    roles: RoleService
classmethod new(
*,
session=None,
config=None,
connection=None,
error_messages=Empty,
execution_options=None,
uniquify=None,
count_with_window_function=None,
auto_expunge=None,
auto_refresh=None,
auto_commit=None,
wrap_exceptions=None,
)[source]#

Acquire a session-managed or caller-bound context yielding an instance of this group.

Return type:

_ServiceGroupContext[Self]

classmethod service_fields()[source]#

Return a read-only mapping of declared service attribute names to service classes.

Return type:

Mapping[str, type[Any]]

classmethod is_async_group()[source]#

Return True for async groups, False for sync groups, or None when undetermined.

Return type:

bool | None

Context Management#

class advanced_alchemy.service._group._ServiceGroupContext(
group_cls,
*,
session,
config,
connection,
group_kwargs,
)[source]#

Bases: Generic[ServiceGroupT]

Sync and async context manager resolving a shared session for a ServiceGroup subclass.