tangl.service bootstrap and metadata¶

Service bootstrapping and bounded metadata for the manager-first API.

Use tangl.service methods for the generated service-method catalog. This page documents the bootstrap helper and metadata types that describe the public service surface.

Related design docs

Service Layer Architecture (v3.7)

Related notes

Bootstrap¶

build_service_manager(persistence_manager=None, *, backend=None, api_url=None, api_key=None, secret=None, timeout_s=None)[source]¶: Build the canonical explicit service manager.

Metadata¶

service_method(*, access, context, writeback, blocking=BlockingMode.SYNC, capability=None, operation_id=None)[source]¶: Attach bounded metadata to a canonical service-manager method.

class ServiceMethodSpec(name, access, context, writeback, blocking, capability=None, operation_id=None)[source]¶

Metadata attached to one canonical service-manager method.

with_name(name)[source]¶: Return a copy with the resolved method name.

class ServiceAccess(*values)[source]¶: Access classes for public service methods.

class ServiceContext(*values)[source]¶: Context requirements for service methods.

class ServiceWriteback(*values)[source]¶: Writeback policy for direct service-manager methods.

class BlockingMode(*values)[source]¶: Execution blocking classification for wrappers and transports.

Support types¶

class UserAuthInfo(user_id, is_privileged=False)[source]¶: Resolved authentication context for a user-bound request.

class WorldRegistry(world_dirs=None, compiler=None)[source]¶: Discover and lazily compile worlds from configured directories.