apexdevkit 1.14.1__tar.gz → 1.14.3__tar.gz

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apexdevkit
-Version: 1.14.1
+Version: 1.14.3
 Summary: Apex Development Tools for python.
 Author: Apex Dev
 Author-email: dev@apex.ge

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/builder.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from typing import Any, Self
@@ -53,12 +55,12 @@ class RestfulServiceBuilder(ABC):
     parent_id: str = field(init=False)
     user: Any = field(init=False)
 
-    def with_user(self, user: Any) -> "RestfulServiceBuilder":
+    def with_user(self, user: Any) -> RestfulServiceBuilder:
         self.user = user
 
         return self
 
-    def with_parent(self, identity: str) -> "RestfulServiceBuilder":
+    def with_parent(self, identity: str) -> RestfulServiceBuilder:
         self.parent_id = identity
 
         return self

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/dependable.py

@@ -1,5 +1,5 @@
-from dataclasses import dataclass, field
-from typing import Annotated, Any, Callable, Protocol, Self
+from dataclasses import dataclass
+from typing import Annotated, Any, Callable, Protocol
 
 from fastapi import Depends, Path
 from fastapi.requests import Request
@@ -23,7 +23,7 @@ class _Dependency(Protocol):
         pass
 
 
-@dataclass
+@dataclass(frozen=True)
 class ServiceDependency:
     dependency: _Dependency
 
@@ -36,7 +36,7 @@ class ServiceDependency:
         return Annotated[RestfulService, Depends(_)]
 
 
-@dataclass
+@dataclass(frozen=True)
 class ParentDependency:
     parent: RestfulName
     dependency: _Dependency
@@ -56,7 +56,7 @@ class ParentDependency:
         return Annotated[RestfulServiceBuilder, Depends(_)]
 
 
-@dataclass
+@dataclass(frozen=True)
 class UserDependency:
     extract_user: Callable[..., Any]
     dependency: _Dependency
@@ -71,7 +71,7 @@ class UserDependency:
         return Annotated[RestfulServiceBuilder, Depends(_)]
 
 
-@dataclass
+@dataclass(frozen=True)
 class InfraDependency:
     infra: RestfulServiceBuilder
 
@@ -82,26 +82,24 @@ class InfraDependency:
         return Annotated[RestfulServiceBuilder, Depends(_)]
 
 
-@dataclass
+@dataclass(frozen=True)
 class DependableBuilder:
-    dependency: _Dependency = field(init=False)
+    dependency: _Dependency | None = None
 
-    def from_infra(self, value: RestfulServiceBuilder) -> Self:
-        self.dependency = InfraDependency(value)
+    def from_infra(self, value: RestfulServiceBuilder) -> "DependableBuilder":
+        return DependableBuilder(InfraDependency(value))
 
-        return self
+    def with_parent(self, value: RestfulName) -> "DependableBuilder":
+        if self.dependency is None:
+            raise RuntimeError("RestfulServiceBuilder type not set")
+        return DependableBuilder(ParentDependency(value, self.dependency))
 
-    def with_parent(self, value: RestfulName) -> Self:
-        dependable = DependableBuilder()
-        dependable.dependency = ParentDependency(value, self.dependency)
-
-        return dependable
-
-    def with_user(self, extract_user: Callable[..., Any]) -> Self:
-        dependable = DependableBuilder()
-        dependable.dependency = UserDependency(extract_user, self.dependency)
-
-        return dependable
+    def with_user(self, extract_user: Callable[..., Any]) -> "DependableBuilder":
+        if self.dependency is None:
+            raise RuntimeError("RestfulServiceBuilder type not set")
+        return DependableBuilder(UserDependency(extract_user, self.dependency))
 
     def as_dependable(self) -> type[RestfulService]:
+        if self.dependency is None:
+            raise RuntimeError("RestfulServiceBuilder type not set")
         return ServiceDependency(self.dependency).as_dependable()

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/resource.py

@@ -10,7 +10,7 @@ _Response = JSONResponse | dict[str, Any]
 _Endpoint = Callable[..., _Response]
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestfulResource:
     response: RestfulResponse
 

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/response.py

@@ -7,7 +7,7 @@ from apexdevkit.error import DoesNotExistError, ExistsError, ForbiddenError
 from apexdevkit.testing import RestfulName
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestfulResponse:
     name: RestfulName
 

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/schema.py

@@ -24,7 +24,7 @@ class SchemaFields(ABC):
         pass
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestfulSchema:
     name: RestfulName
     fields: SchemaFields

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fastapi/service.py

@@ -1,6 +1,8 @@
+from __future__ import annotations
+
 from abc import ABC
-from dataclasses import dataclass, field
-from typing import Any, Dict, Generic, Iterable, Self, TypeVar
+from dataclasses import dataclass
+from typing import Any, Dict, Generic, Iterable, TypeVar
 
 from apexdevkit.formatter import Formatter
 from apexdevkit.repository.decorator import BatchRepositoryDecorator
@@ -50,26 +52,28 @@ class RestfulService(ABC):  # pragma: no cover
 ItemT = TypeVar("ItemT")
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestfulRepositoryBuilder(Generic[ItemT]):
-    formatter: Formatter[dict[str, Any], ItemT] = field(init=False)
-    repository: Repository[ItemT] = field(init=False)
-
-    def with_formatter(self, formatter: Formatter[dict[str, Any], ItemT]) -> Self:
-        self.formatter = formatter
-
-        return self
+    formatter: Formatter[dict[str, Any], ItemT] | None = None
+    repository: Repository[ItemT] | None = None
 
-    def with_repository(self, repository: Repository[ItemT]) -> Self:
-        self.repository = repository
+    def with_formatter(
+        self, formatter: Formatter[dict[str, Any], ItemT]
+    ) -> RestfulRepositoryBuilder[ItemT]:
+        return RestfulRepositoryBuilder[ItemT](formatter, self.repository)
 
-        return self
+    def with_repository(
+        self, repository: Repository[ItemT]
+    ) -> RestfulRepositoryBuilder[ItemT]:
+        return RestfulRepositoryBuilder[ItemT](self.formatter, repository)
 
     def build(self) -> RestfulService:
+        if self.formatter is None or self.repository is None:
+            raise RuntimeError("Formatter or repository not provided.")
         return _RestfulRepository(self.formatter, self.repository)
 
 
-@dataclass
+@dataclass(frozen=True)
 class _RestfulRepository(RestfulService, Generic[ItemT]):
     formatter: Formatter[dict[str, Any], ItemT]
     repository: Repository[ItemT]

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/fluent.py

@@ -26,7 +26,7 @@ class FluentDict(dict[str, ItemT]):
         return FluentDict[ItemT]({k: v for k, v in self.items() if k in keys})
 
 
-@dataclass
+@dataclass(frozen=True)
 class FluentElement(Generic[ItemT]):
     value: ItemT
 

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/formatter.py

@@ -1,9 +1,11 @@
+import pickle
 from copy import deepcopy
 from dataclasses import asdict, dataclass, field
 from typing import Any, Generic, Protocol, Self, TypeVar
 
 _SourceT = TypeVar("_SourceT")
 _TargetT = TypeVar("_TargetT")
+_ItemT = TypeVar("_ItemT")
 
 
 class Formatter(Protocol[_SourceT, _TargetT]):  # pragma: no cover
@@ -14,13 +16,12 @@ class Formatter(Protocol[_SourceT, _TargetT]):  # pragma: no cover
         pass
 
 
-@dataclass
-class NoFormatter(Formatter[Any, Any]):
-    def load(self, source: Any) -> Any:
-        return source
+class PickleFormatter(Generic[_ItemT]):
+    def dump(self, item: _ItemT) -> bytes:
+        return pickle.dumps(item)
 
-    def dump(self, target: Any) -> Any:
-        return target
+    def load(self, raw: bytes) -> _ItemT:
+        return pickle.loads(raw)  # type: ignore
 
 
 @dataclass

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/http/fake.py

@@ -7,7 +7,7 @@ from apexdevkit.http.fluent import HttpMethod, HttpResponse
 from apexdevkit.http.json import JsonDict
 
 
-@dataclass
+@dataclass(frozen=True)
 class FakeResponse:
     content: Any = field(default_factory=dict)
     status_code: int = 200

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/http/httpx.py

@@ -46,7 +46,7 @@ class Httpx:
         )
 
 
-@dataclass
+@dataclass(frozen=True)
 class _HttpxResponse:
     inner: httpx.Response
 

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/key_fn.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass
 from typing import Any
 
 
-@dataclass
+@dataclass(frozen=True)
 class AttributeKey:
     name: str
 

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/repository/__init__.py

@@ -7,7 +7,7 @@ from apexdevkit.repository.database import (
     DatabaseCommand,
 )
 from apexdevkit.repository.in_memory import (
-    InMemoryKeyValueStore,
+    InMemoryByteStore,
     InMemoryRepository,
     KeyValueStore,
 )
@@ -20,7 +20,7 @@ __all__ = [
     "Database",
     "DatabaseCommand",
     "InMemoryRepository",
-    "InMemoryKeyValueStore",
+    "InMemoryByteStore",
     "KeyValueStore",
     "Repository",
     "RepositoryBase",

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/repository/connector.py

@@ -8,7 +8,7 @@ from pymongo import MongoClient
 from apexdevkit.repository import Connection
 
 
-@dataclass
+@dataclass(frozen=True)
 class SqliteFileConnector:
     dsn: str
 
@@ -19,7 +19,7 @@ class SqliteFileConnector:
         return connection
 
 
-@dataclass
+@dataclass(frozen=True)
 class SqliteInMemoryConnector:
     dsn: str = ":memory:"
 
@@ -34,7 +34,7 @@ class SqliteInMemoryConnector:
         return connection
 
 
-@dataclass
+@dataclass(frozen=True)
 class PyMongoConnector:
     dsn: str
 

apexdevkit-1.14.3/apexdevkit/repository/database.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+
+from copy import deepcopy
+from dataclasses import dataclass, field
+from typing import Any, ContextManager, Iterable, Protocol
+
+_RawData = dict[str, Any]
+
+
+@dataclass(frozen=True)
+class Database:
+    connector: Connector
+
+    def execute(self, command: DatabaseCommand) -> _CommandExecutor:
+        return Database._CommandExecutor(self.connector, command)
+
+    @dataclass(frozen=True)
+    class _CommandExecutor:
+        connector: Connector
+        command: DatabaseCommand
+
+        def fetch_none(self) -> None:
+            with self.connector.connect() as connection:
+                cursor: Cursor = connection.cursor()
+                cursor.execute(self.command.value, self.command.payload)
+                cursor.close()
+
+        def fetch_one(self) -> _RawData:
+            with self.connector.connect() as connection:
+                cursor: Cursor = connection.cursor()
+                cursor.execute(self.command.value, self.command.payload)
+                raw = cursor.fetchone()
+                cursor.close()
+
+            return dict(raw or {})
+
+        def fetch_all(self) -> Iterable[_RawData]:
+            with self.connector.connect() as connection:
+                cursor: Cursor = connection.cursor()
+                cursor.execute(self.command.value, self.command.payload)
+                raw = cursor.fetchall()
+                cursor.close()
+
+            return [dict(raw or {}) for raw in raw]
+
+
+class Connector(Protocol):  # pragma: no cover
+    def connect(self) -> ContextManager[Connection]:
+        pass
+
+
+class Connection(Protocol):  # pragma: no cover
+    def cursor(self) -> Cursor:
+        pass
+
+
+class Cursor(Protocol):  # pragma: no cover
+    def execute(self, *args: Any, **kwargs: Any) -> Any:
+        pass
+
+    def executemany(self, *args: Any, **kwargs: Any) -> Any:
+        pass
+
+    def fetchone(self, *args: Any, **kwargs: Any) -> Any:
+        pass
+
+    def fetchall(self, *args: Any, **kwargs: Any) -> Any:
+        pass
+
+    def close(self) -> None:
+        pass
+
+
+@dataclass(frozen=True)
+class DatabaseCommand:
+    value: str = field(default_factory=str)
+    payload: _RawData | list[_RawData] = field(default_factory=dict)
+
+    def with_data(
+        self, value: _RawData | None = None, **fields: Any
+    ) -> DatabaseCommand:
+        assert isinstance(self.payload, dict)
+
+        payload = deepcopy(self.payload)
+        payload.update(value or {})
+        payload.update(fields)
+
+        return DatabaseCommand(self.value, payload)
+
+    def with_collection(self, value: list[_RawData]) -> DatabaseCommand:
+        return DatabaseCommand(self.value, value)
+
+    def __str__(self) -> str:  # pragma: no cover
+        return self.value

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/repository/in_memory.py

@@ -1,54 +1,65 @@
 from __future__ import annotations
 
+from contextlib import suppress
 from dataclasses import dataclass, field
 from typing import Any, Callable, Generic, Iterable, Iterator, Protocol, Self
 
 from apexdevkit.error import DoesNotExistError, ExistsError
-from apexdevkit.formatter import Formatter, NoFormatter
+from apexdevkit.formatter import Formatter, PickleFormatter
 from apexdevkit.key_fn import AttributeKey
 from apexdevkit.repository import RepositoryBase
 from apexdevkit.repository.interface import ItemT, Repository
 
-KeyFunction = Callable[[Any], str]
-_Raw = dict[str, Any]
+_KeyFunction = Callable[[ItemT], str]
 
 
-@dataclass
+@dataclass(frozen=True)
 class InMemoryRepository(Generic[ItemT]):
-    store: KeyValueStore[ItemT] = field(default_factory=lambda: InMemoryKeyValueStore())
-    keys: list[KeyFunction] = field(default_factory=list)
-    seeds: list[ItemT] = field(default_factory=list)
-
-    def with_formatter(self, value: Formatter[_Raw, ItemT]) -> Self:
-        return self.with_store(InMemoryKeyValueStore(value))
-
-    def with_store(self, value: KeyValueStore[ItemT]) -> Self:
-        self.store = value
-
-        return self
-
-    def and_key(self, function: KeyFunction) -> Self:
+    store: KeyValueStore[ItemT] = field(default_factory=lambda: InMemoryByteStore())
+    keys: list[_KeyFunction[ItemT]] = field(default_factory=list)
+    seeds: frozenset[ItemT] = field(default_factory=frozenset)
+
+    def with_namespace(self, value: str) -> InMemoryRepository[ItemT]:
+        return InMemoryRepository[ItemT](
+            store=StoreNamespace(value, self.store),
+            keys=self.keys,
+            seeds=self.seeds,
+        )
+
+    def with_store(self, value: KeyValueStore[ItemT]) -> InMemoryRepository[ItemT]:
+        return InMemoryRepository[ItemT](
+            store=value,
+            keys=self.keys,
+            seeds=self.seeds,
+        )
+
+    def and_key(self, function: _KeyFunction[ItemT]) -> InMemoryRepository[ItemT]:
         return self.with_key(function)
 
-    def with_key(self, function: KeyFunction) -> Self:
-        self.keys.append(function)
+    def with_key(self, function: _KeyFunction[ItemT]) -> InMemoryRepository[ItemT]:
+        return InMemoryRepository[ItemT](
+            store=self.store,
+            keys=[*self.keys, function],
+            seeds=self.seeds,
+        )
 
-        return self
-
-    def and_seeded(self, *items: ItemT) -> Self:
+    def and_seeded(self, *items: ItemT) -> InMemoryRepository[ItemT]:
         return self.with_seeded(*items)
 
-    def with_seeded(self, *items: ItemT) -> Self:
-        self.seeds.extend(items)
-
-        return self
+    def with_seeded(self, *items: ItemT) -> InMemoryRepository[ItemT]:
+        return InMemoryRepository(
+            store=self.store,
+            keys=self.keys,
+            seeds=self.seeds.union(set(items)),
+        )
 
     def build(self) -> Repository[ItemT]:
         return self._seed(self._create())
 
     def _seed(self, repository: Repository[ItemT]) -> Repository[ItemT]:
         for seed in self.seeds:
-            repository.create(seed)
+            with suppress(ExistsError):
+                repository.create(seed)
 
         return repository
 
@@ -80,9 +91,10 @@ class KeyValueStore(Protocol[ItemT]):  # pragma: no cover
 
 
 @dataclass
-class InMemoryKeyValueStore(Generic[ItemT]):
-    formatter: Formatter[_Raw, ItemT] = field(default_factory=NoFormatter)
-    items: dict[str, _Raw] = field(default_factory=dict)
+class InMemoryByteStore(Generic[ItemT]):
+    formatter: Formatter[bytes, ItemT] = field(default_factory=PickleFormatter)
+
+    items: dict[str, bytes] = field(default_factory=dict)
 
     def count(self) -> int:
         return len(self.items)
@@ -101,10 +113,34 @@ class InMemoryKeyValueStore(Generic[ItemT]):
             yield self.formatter.load(raw)
 
 
+@dataclass
+class StoreNamespace(Generic[ItemT]):
+    name: str
+    inner: KeyValueStore[ItemT]
+
+    def count(self) -> int:
+        return self.inner.count()
+
+    def values(self) -> Iterable[ItemT]:
+        return self.inner.values()
+
+    def set(self, key: str, value: ItemT) -> None:
+        self.inner.set(self._expand(key), value)
+
+    def get(self, key: str) -> ItemT:
+        return self.inner.get(self._expand(key))
+
+    def drop(self, key: str) -> None:
+        self.inner.drop(self._expand(key))
+
+    def _expand(self, key: str) -> str:
+        return "-".join([self.name, key])
+
+
 @dataclass
 class _SingleKeyRepository(RepositoryBase[ItemT]):
     store: KeyValueStore[ItemT]
-    pk: KeyFunction
+    pk: _KeyFunction[ItemT]
 
     def bind(self, **kwargs: Any) -> Self:  # pragma: no cover
         return self
@@ -150,7 +186,7 @@ class _SingleKeyRepository(RepositoryBase[ItemT]):
 class _ManyKeyRepository(RepositoryBase[ItemT]):
     store: KeyValueStore[ItemT]
 
-    keys: list[KeyFunction] = field(default_factory=list)
+    keys: list[_KeyFunction[ItemT]] = field(default_factory=list)
 
     def bind(self, **kwargs: Any) -> Self:  # pragma: no cover
         return self
@@ -171,7 +207,7 @@ class _ManyKeyRepository(RepositoryBase[ItemT]):
 
             error.fire()
 
-    def _pk(self, item: ItemT) -> Any:
+    def _pk(self, item: ItemT) -> str:
         return self.keys[0](item)
 
     def update(self, item: ItemT) -> None:

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/repository/mongo.py

@@ -19,7 +19,7 @@ class _Item(Protocol):  # pragma: no cover
 ItemT = TypeVar("ItemT", bound=_Item)
 
 
-@dataclass
+@dataclass(frozen=True)
 class MongoRepository(Generic[ItemT]):
     connector: MongoConnector
     database_name: str

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/repository/sqlite.py

@@ -9,7 +9,7 @@ from apexdevkit.repository import Database, DatabaseCommand, RepositoryBase
 from apexdevkit.repository.interface import ItemT
 
 
-@dataclass
+@dataclass(frozen=True)
 class SqliteRepository(RepositoryBase[ItemT]):
     db: Database
     table: SqlTable[ItemT]

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/testing/database.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from contextlib import nullcontext
 from dataclasses import dataclass, field
 from typing import Any, ContextManager, Self
@@ -5,15 +7,13 @@ from typing import Any, ContextManager, Self
 from apexdevkit.repository import DatabaseCommand
 
 
-@dataclass
+@dataclass(frozen=True)
 class FakeConnector:
     commands: list[tuple[str, Any]] = field(default_factory=list)
-    results: list[Any] = field(init=False, default_factory=list)
-
-    def with_result(self, values: Any) -> Self:
-        self.results = [values, *self.results]
+    results: list[Any] = field(default_factory=list)
 
-        return self
+    def with_result(self, values: Any) -> FakeConnector:
+        return FakeConnector(self.commands, [values, *self.results])
 
     def execute(self, command: str, data: Any) -> None:
         self.commands.append((command, data))

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/testing/fake.py

@@ -9,7 +9,7 @@ from apexdevkit.http import JsonDict
 ItemT = TypeVar("ItemT")
 
 
-@dataclass
+@dataclass(frozen=True)
 class Fake:
     faker: Faker = field(default_factory=Faker)
 
@@ -50,7 +50,7 @@ class Fake:
         return bool(self.faker.boolean())
 
 
-@dataclass
+@dataclass(frozen=True)
 class FakeResource(Generic[ItemT]):
     item_type: Type[ItemT] = field()
     fake: Fake = field(default_factory=Fake)

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/apexdevkit/testing/rest.py

@@ -8,7 +8,7 @@ from apexdevkit.http import Http, HttpUrl, JsonDict
 from apexdevkit.http.fluent import HttpMethod, HttpResponse
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestResource:
     http: Http
     name: RestfulName
@@ -95,13 +95,13 @@ class RestResource:
         )
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestCollection(RestResource):
     def sub_resource(self, name: str) -> RestItem:
         return RestItem(self.http.with_endpoint(self.name.plural), RestfulName(name))
 
 
-@dataclass
+@dataclass(frozen=True)
 class RestItem(RestResource):
     def sub_resource(self, name: str) -> RestItem:
         return RestItem(self.http.with_endpoint(self.name.singular), RestfulName(name))

{apexdevkit-1.14.1 → apexdevkit-1.14.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "apexdevkit"
-version = "1.14.1"
+version = "1.14.3"
 description = "Apex Development Tools for python."
 authors = ["Apex Dev <dev@apex.ge>"]
 readme = "README.md"

apexdevkit-1.14.1/apexdevkit/repository/database.py

@@ -1,90 +0,0 @@
-from __future__ import annotations
-
-from dataclasses import dataclass, field
-from typing import Any, ContextManager, Iterable, Protocol, Self
-
-_RawData = dict[str, Any]
-
-
-@dataclass
-class Database:
-    connector: Connector
-
-    command: DatabaseCommand = field(init=False)
-
-    def execute(self, command: DatabaseCommand) -> Self:
-        self.command = command
-
-        return self
-
-    def fetch_none(self) -> None:
-        with self.connector.connect() as connection:
-            cursor: Cursor = connection.cursor()
-            cursor.execute(self.command.value, self.command.payload)
-            cursor.close()
-
-    def fetch_one(self) -> _RawData:
-        with self.connector.connect() as connection:
-            cursor: Cursor = connection.cursor()
-            cursor.execute(self.command.value, self.command.payload)
-            raw = cursor.fetchone()
-            cursor.close()
-
-        return dict(raw or {})
-
-    def fetch_all(self) -> Iterable[_RawData]:
-        with self.connector.connect() as connection:
-            cursor: Cursor = connection.cursor()
-            cursor.execute(self.command.value, self.command.payload)
-            raw = cursor.fetchall()
-            cursor.close()
-
-        return [dict(raw or {}) for raw in raw]
-
-
-class Connector(Protocol):  # pragma: no cover
-    def connect(self) -> ContextManager[Connection]:
-        pass
-
-
-class Connection(Protocol):  # pragma: no cover
-    def cursor(self) -> Cursor:
-        pass
-
-
-class Cursor(Protocol):  # pragma: no cover
-    def execute(self, *args: Any, **kwargs: Any) -> Any:
-        pass
-
-    def executemany(self, *args: Any, **kwargs: Any) -> Any:
-        pass
-
-    def fetchone(self, *args: Any, **kwargs: Any) -> Any:
-        pass
-
-    def fetchall(self, *args: Any, **kwargs: Any) -> Any:
-        pass
-
-    def close(self) -> None:
-        pass
-
-
-@dataclass
-class DatabaseCommand:
-    value: str
-    payload: _RawData | list[_RawData] = field(init=False, default_factory=dict)
-
-    def with_data(self, value: _RawData | None = None, **fields: Any) -> Self:
-        assert isinstance(self.payload, dict)
-        self.payload.update(value or {})
-        self.payload.update(fields)
-
-        return self
-
-    def with_collection(self, value: list[_RawData]) -> Self:
-        self.payload = value
-
-        return self
-
-    def __str__(self) -> str:  # pragma: no cover
-        return self.value