__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oc_chat/registry/backends/__init__.py
 
# OCT-LINT: disable=tests_exist reason="Covered by oc_chat/tests/registry/test_storage_foundation.py"
"""
Public backend exports for registry storage.
 
Purpose
-------
Expose the backend ABC, capability error, and SQLite implementation from
one import location.
 
Responsibilities
----------------
- Re-export :class:`StorageBackend`.
- Re-export :class:`BackendCapabilityError`.
- Re-export backend return types.
- Re-export :class:`SQLiteBackend`.
 
Diagnostics
-----------
Domain: OC_CHAT.MAIN
Levels:
    L2 - lifecycle events
    L3 - semantic details
    L4 - deep tracing
 
Contracts
---------
- This module is import-only and has no database side effects.
 
Dependencies
------------
- oc_diagnostics (structured debug logging via _dbg)
- oc_chat.registry.backends.base (re-exported StorageBackend contract, capability error and return types)
- oc_chat.registry.backends.sqlite (re-exported SQLiteBackend implementation)
"""
from __future__ import annotations
 
from oc_diagnostics import _dbg
 
from oc_chat.registry.backends.base import (
    BackendCapabilityError,
    LockHandle,
    OperationLogRow,
    StorageBackend,
)
from oc_chat.registry.backends.sqlite import SQLiteBackend
 
_dbg("OC_CHAT.MAIN", "module", "loaded", 4)
 
__all__ = [
    "BackendCapabilityError",
    "LockHandle",
    "OperationLogRow",
    "SQLiteBackend",
    "StorageBackend",
]