merge: testing → main (reconcile 2-week divergence)

decnet/web/db/factory.py

@@ -1,18 +1,33 @@
+"""
+Repository factory — selects a :class:`BaseRepository` implementation based on
+``DECNET_DB_TYPE`` (``sqlite`` or ``mysql``).
+"""
+from __future__ import annotations
+
+import os
 from typing import Any
-from decnet.env import os
+
 from decnet.web.db.repository import BaseRepository
 
+
 def get_repository(**kwargs: Any) -> BaseRepository:
-    """Factory function to instantiate the correct repository implementation based on environment."""
+    """Instantiate the repository implementation selected by ``DECNET_DB_TYPE``.
+
+    Keyword arguments are forwarded to the concrete implementation:
+
+    * SQLite accepts ``db_path``.
+    * MySQL accepts ``url`` and engine tuning knobs (``pool_size``, …).
+    """
     db_type = os.environ.get("DECNET_DB_TYPE", "sqlite").lower()
 
     if db_type == "sqlite":
         from decnet.web.db.sqlite.repository import SQLiteRepository
-        return SQLiteRepository(**kwargs)
+        repo = SQLiteRepository(**kwargs)
     elif db_type == "mysql":
-        # Placeholder for future implementation
-        # from decnet.web.db.mysql.repository import MySQLRepository
-        # return MySQLRepository()
-        raise NotImplementedError("MySQL support is planned but not yet implemented.")
+        from decnet.web.db.mysql.repository import MySQLRepository
+        repo = MySQLRepository(**kwargs)
     else:
         raise ValueError(f"Unsupported database type: {db_type}")
+
+    from decnet.telemetry import wrap_repository
+    return wrap_repository(repo)