apexdevkit 1.14.2__tar.gz → 1.14.4__tar.gz

{apexdevkit-1.14.2 → apexdevkit-1.14.4}/PKG-INFO

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

{apexdevkit-1.14.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/apexdevkit/http/httpx.py

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

{apexdevkit-1.14.2 → apexdevkit-1.14.4}/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.4/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.4/apexdevkit/synchronization.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Generic, Iterable, Iterator, Protocol, TypeVar
+
+ItemT = TypeVar("ItemT")
+
+
+@dataclass(frozen=True)
+class Sync(Generic[ItemT]):
+    source: _Source[ItemT]
+    target: _Target[ItemT]
+
+    def sync(self) -> None:
+        items = self.source.value_of(list(self.target))
+        self.target.update_many(list(items))
+
+
+class _Source(Protocol[ItemT]):
+    def value_of(self, items: Iterable[ItemT]) -> Iterable[ItemT]:
+        pass
+
+
+class _Target(Protocol[ItemT]):
+    def __iter__(self) -> Iterator[ItemT]:
+        pass
+
+    def update_many(self, items: Iterable[ItemT]) -> None:
+        pass
+
+
+@dataclass(frozen=True)
+class FullSync(Generic[ItemT]):
+    source: Iterable[ItemT]
+    target: _FullTarget[ItemT]
+
+    def sync(self) -> None:
+        items = list(self.source)
+        self.target.update_many(items)
+
+
+ItemR = TypeVar("ItemR", contravariant=True)
+
+
+class _FullTarget(Protocol[ItemR]):
+    def update_many(self, items: Iterable[ItemR]) -> None:
+        pass

{apexdevkit-1.14.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/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.2 → apexdevkit-1.14.4}/pyproject.toml

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

apexdevkit-1.14.2/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