apexdevkit 1.32.2__tar.gz → 1.32.4__tar.gz

{apexdevkit-1.32.2 → apexdevkit-1.32.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apexdevkit
-Version: 1.32.2
+Version: 1.32.4
 Summary: Apex Development Tools for python.
 License-File: LICENSE
 Author: Apex Dev

{apexdevkit-1.32.2 → apexdevkit-1.32.4}/apexdevkit/repository/core/decorator.py

@@ -1,4 +1,4 @@
-from collections.abc import Container, Iterable, Iterator
+from collections.abc import Collection, Iterable, Iterator
 from contextlib import suppress
 from dataclasses import dataclass, field
 
@@ -58,20 +58,20 @@ class RepositoryDecorator(Repository[ItemT]):  # pragma: no cover
 
 @dataclass(frozen=True, kw_only=True)
 class BruteForceBatch(RepositoryDecorator[ItemT]):
-    def load(self, source: Iterable[ItemT]) -> Iterable[ItemT]:
-        for item in list(source):
+    def load(self, source: Collection[ItemT]) -> Iterable[ItemT]:
+        for item in source:
             with suppress(ExistsError):
                 yield self.inner.create(item)
 
-    def prune(self, source: Container[ItemT]) -> Iterable[ItemT]:
+    def prune(self, source: Collection[ItemT]) -> Iterable[ItemT]:
         for item in list(self.inner):
             if item not in source:
                 with suppress(DoesNotExistError):
                     self.inner.delete(item.id)
                     yield item
 
-    def renew(self, source: Iterable[ItemT]) -> Iterable[ItemT]:
-        for item in list(source):
+    def renew(self, source: Collection[ItemT]) -> Iterable[ItemT]:
+        for item in source:
             with suppress(DoesNotExistError):
                 self.inner.update(item)
                 yield item

{apexdevkit-1.32.2 → apexdevkit-1.32.4}/apexdevkit/sync/sync.py

@@ -1,26 +1,41 @@
 from __future__ import annotations
 
 from collections.abc import Callable, Collection, Iterable
-from dataclasses import dataclass
+from dataclasses import dataclass, field, replace
 from typing import Any, Generic, Self, TypeVar
 
 from .observer import DefaultLog, ObservableSync
-from .source import Source
-from .target import Target
+from .source import EmptySource, Source
+from .target import NoTarget, Target
 
 T = TypeVar("T")
 
 
 @dataclass(frozen=True, kw_only=True)
 class Sync(ObservableSync, Generic[T]):
-    source: Source[T]
-    target: Target
+    source: Source[T] = field(default_factory=EmptySource)
+    target: Target[T] = field(default_factory=NoTarget)
 
     dry_run: bool = False
 
+    def and_target(self, value: Target[T]) -> Sync[T]:
+        return self.with_target(value)
+
+    def with_target(self, value: Target[T]) -> Sync[T]:
+        return replace(self, target=value)
+
+    def and_source(self, value: Source[T]) -> Sync[T]:
+        return self.with_source(value)
+
+    def with_source(self, value: Source[T]) -> Sync[T]:
+        return replace(self, source=value)
+
     def with_log(self, using: Callable[[str], None]) -> Self:
         return self.attach(DefaultLog(echo=using))
 
+    def dry(self, *, when: bool = True) -> Sync[T]:
+        return replace(self, dry_run=when)
+
     def run(self, prune: bool = True, load: bool = True, update: bool = True) -> None:
         if prune:
             self.prune()

apexdevkit-1.32.4/apexdevkit/sync/target.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+from dataclasses import dataclass, field
+from typing import Any, Generic, Protocol, TypeVar
+
+T = TypeVar("T", contravariant=True)
+
+
+class Target(Protocol[T]):  # pragma: no cover
+    def prune(self, source: Iterable[T]) -> Any:
+        pass
+
+    def load(self, source: Iterable[T]) -> Any:
+        pass
+
+    def renew(self, source: Iterable[T]) -> Any:
+        pass
+
+
+class NoTarget(Generic[T]):  # pragma: no cover
+    def prune(self, source: Iterable[T]) -> Any:
+        pass
+
+    def load(self, source: Iterable[T]) -> Any:
+        pass
+
+    def renew(self, source: Iterable[T]) -> Any:
+        pass
+
+
+@dataclass(frozen=True, kw_only=True)
+class TargetDecorator(Generic[T]):
+    inner: Target[T] = field(default_factory=NoTarget)
+
+    def prune(self, source: Iterable[T]) -> Any:
+        self.inner.prune(source)
+
+    def load(self, source: Iterable[T]) -> Any:
+        self.inner.load(source)
+
+    def renew(self, source: Iterable[T]) -> Any:
+        self.inner.renew(source)
+
+
+class TargetFailing(Generic[T]):
+    @staticmethod
+    def on_everything(using: Target[T] | None = None) -> Target[T]:
+        return TargetFailing.on_prune(
+            using=TargetFailing.on_load(
+                using=TargetFailing.on_update(
+                    using=using or NoTarget(),
+                ),
+            ),
+        )
+
+    @staticmethod
+    def on_prune(using: Target[T] | None = None) -> Target[T]:
+        return _FailOnPrune(inner=using or NoTarget())
+
+    @staticmethod
+    def on_load(using: Target[T] | None = None) -> Target[T]:
+        return _FailOnLoad(inner=using or NoTarget())
+
+    @staticmethod
+    def on_update(using: Target[T] | None = None) -> Target[T]:
+        return _FailOnUpdate(inner=using or NoTarget())
+
+
+@dataclass(frozen=True, kw_only=True)
+class _FailOnPrune(TargetDecorator[T]):
+    def prune(self, source: Iterable[T]) -> Any:  # pragma: no cover
+        raise RuntimeError(source)
+
+
+@dataclass(frozen=True, kw_only=True)
+class _FailOnLoad(TargetDecorator[T]):
+    def load(self, source: Iterable[T]) -> Any:  # pragma: no cover
+        raise RuntimeError(source)
+
+
+@dataclass(frozen=True, kw_only=True)
+class _FailOnUpdate(TargetDecorator[T]):
+    def renew(self, source: Iterable[T]) -> Any:  # pragma: no cover
+        raise RuntimeError(source)

{apexdevkit-1.32.2 → apexdevkit-1.32.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "apexdevkit"
-version = "1.32.2"
+version = "1.32.4"
 description = "Apex Development Tools for python."
 readme = "README.md"
 authors = [

apexdevkit-1.32.2/apexdevkit/sync/target.py

@@ -1,82 +0,0 @@
-from __future__ import annotations
-
-from collections.abc import Iterable
-from dataclasses import dataclass, field
-from typing import Any, Protocol, TypeVar
-
-T = TypeVar("T")
-
-
-class Target(Protocol):  # pragma: no cover
-    def prune(self, source: Iterable[T]) -> Any:
-        pass
-
-    def load(self, source: Iterable[T]) -> Any:
-        pass
-
-    def renew(self, source: Iterable[T]) -> Any:
-        pass
-
-
-class NoTarget:  # pragma: no cover
-    def prune(self, source: Iterable[T]) -> Any:
-        pass
-
-    def load(self, source: Iterable[T]) -> Any:
-        pass
-
-    def renew(self, source: Iterable[T]) -> Any:
-        pass
-
-
-@dataclass(frozen=True, kw_only=True)
-class TargetDecorator:
-    inner: Target = field(default_factory=NoTarget)
-
-    def prune(self, source: Iterable[T]) -> Any:
-        self.inner.prune(source)
-
-    def load(self, source: Iterable[T]) -> Any:
-        self.inner.load(source)
-
-    def renew(self, source: Iterable[T]) -> Any:
-        self.inner.renew(source)
-
-
-class TargetFailing:
-    @staticmethod
-    def on_everything(using: Target | None = None) -> Target:
-        return TargetFailing.on_prune(
-            using=TargetFailing.on_load(
-                using=TargetFailing.on_update(
-                    using=using or NoTarget(),
-                ),
-            ),
-        )
-
-    @staticmethod
-    def on_prune(using: Target | None = None) -> Target:
-        return TargetFailing.OnPrune(inner=using or NoTarget())
-
-    @dataclass(frozen=True, kw_only=True)
-    class OnPrune(TargetDecorator):
-        def prune(self, source: Iterable[T]) -> Any:  # pragma: no cover
-            raise RuntimeError(source)
-
-    @staticmethod
-    def on_load(using: Target | None = None) -> Target:
-        return TargetFailing.OnLoad(inner=using or NoTarget())
-
-    @dataclass(frozen=True, kw_only=True)
-    class OnLoad(TargetDecorator):
-        def load(self, source: Iterable[T]) -> Any:  # pragma: no cover
-            raise RuntimeError(source)
-
-    @staticmethod
-    def on_update(using: Target | None = None) -> Target:
-        return TargetFailing.OnUpdate(inner=using or NoTarget())
-
-    @dataclass(frozen=True, kw_only=True)
-    class OnUpdate(TargetDecorator):
-        def renew(self, source: Iterable[T]) -> Any:  # pragma: no cover
-            raise RuntimeError(source)