kaparoo-python 0.2.0__tar.gz → 0.2.1__tar.gz

{kaparoo_python-0.2.0 → kaparoo_python-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kaparoo-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Personally common and useful Python features
 Keywords: filesystem,pathlib,paths,utilities
 Author: Jaewoo Park
@@ -66,6 +66,11 @@ Filesystem traversal with composable filters.
 - **Multi-pattern filters** — `EqualsAny`, `StartsWithAny`, `EndsWithAny`,
   `ContainsAny`.
 - **Logical filters** — `And`, `Or`, `Not`.
+- **Serialization** — `Filter.to_dict()` / `Filter.from_dict()` round-trip
+  via a `"kind"` discriminator; `Filter.parse()` accepts a `Filter` or a
+  `FilterDict`; `register_filter(kind)` extends the dispatcher with
+  custom subclasses. `FilterDict` family lives at
+  `kaparoo.filesystem.search.filters.types`.
 - **Deprecated** — `get_paths`, `get_files`, `get_dirs` (use `search_*`).
 
 ### `kaparoo.utils`

{kaparoo_python-0.2.0 → kaparoo_python-0.2.1}/README.md

@@ -45,6 +45,11 @@ Filesystem traversal with composable filters.
 - **Multi-pattern filters** — `EqualsAny`, `StartsWithAny`, `EndsWithAny`,
   `ContainsAny`.
 - **Logical filters** — `And`, `Or`, `Not`.
+- **Serialization** — `Filter.to_dict()` / `Filter.from_dict()` round-trip
+  via a `"kind"` discriminator; `Filter.parse()` accepts a `Filter` or a
+  `FilterDict`; `register_filter(kind)` extends the dispatcher with
+  custom subclasses. `FilterDict` family lives at
+  `kaparoo.filesystem.search.filters.types`.
 - **Deprecated** — `get_paths`, `get_files`, `get_dirs` (use `search_*`).
 
 ### `kaparoo.utils`

{kaparoo_python-0.2.0 → kaparoo_python-0.2.1}/kaparoo/data/sequence.py

@@ -1,39 +1,39 @@
-from __future__ import annotations
-
-__all__ = ("DataSequence",)
-
-from abc import abstractmethod
-from collections.abc import Sequence
-from typing import TYPE_CHECKING, overload
-
-if TYPE_CHECKING:
-    from kaparoo.filesystem.types import StrPath
-
-
-class DataSequence[T](Sequence[T]):
-    @abstractmethod
-    def __init__(self, path: StrPath) -> None:
-        raise NotImplementedError
-
-    @abstractmethod
-    def __len__(self) -> int:
-        raise NotImplementedError
-
-    @overload
-    def __getitem__(self, index: int, /) -> T: ...
-
-    @overload
-    def __getitem__(self, index: slice, /) -> Sequence[T]: ...
-
-    def __getitem__(self, index: int | slice, /) -> T | Sequence[T]:
-        if isinstance(index, slice):
-            start, stop, step = index.indices(len(self))
-            return self.by_indices(range(start, stop, step))
-        return self.by_index(index)
-
-    @abstractmethod
-    def by_index(self, index: int) -> T:
-        raise NotImplementedError
-
-    def by_indices(self, indices: Sequence[int]) -> Sequence[T]:
-        return [self.by_index(index) for index in indices]
+from __future__ import annotations
+
+__all__ = ("DataSequence",)
+
+from abc import abstractmethod
+from collections.abc import Sequence
+from typing import TYPE_CHECKING, overload
+
+if TYPE_CHECKING:
+    from kaparoo.filesystem.types import StrPath
+
+
+class DataSequence[T](Sequence[T]):
+    @abstractmethod
+    def __init__(self, path: StrPath) -> None:
+        raise NotImplementedError
+
+    @abstractmethod
+    def __len__(self) -> int:
+        raise NotImplementedError
+
+    @overload
+    def __getitem__(self, index: int, /) -> T: ...
+
+    @overload
+    def __getitem__(self, index: slice, /) -> Sequence[T]: ...
+
+    def __getitem__(self, index: int | slice, /) -> T | Sequence[T]:
+        if isinstance(index, slice):
+            start, stop, step = index.indices(len(self))
+            return self.by_indices(range(start, stop, step))
+        return self.by_index(index)
+
+    @abstractmethod
+    def by_index(self, index: int) -> T:
+        raise NotImplementedError
+
+    def by_indices(self, indices: Sequence[int]) -> Sequence[T]:
+        return [self.by_index(index) for index in indices]

{kaparoo_python-0.2.0 → kaparoo_python-0.2.1}/kaparoo/data/utils.py

@@ -1,46 +1,46 @@
-from __future__ import annotations
-
-__all__ = ("generate_batches",)
-
-from typing import TYPE_CHECKING
-
-from kaparoo.utils.optional import replace_if_none
-
-if TYPE_CHECKING:
-    from collections.abc import Iterator, Sequence
-
-
-def generate_batches[T](
-    sequence: Sequence[T],
-    size: int,
-    step: int = 1,
-    skip: int = 1,
-    start: int = 0,
-    stop: int | None = None,
-    *,
-    drop_last: bool = True,
-) -> Iterator[Sequence[T]]:
-    def die_if_not_positive(name: str, value: int) -> None:
-        if value <= 0:
-            msg = f"{name} must be positive (got {value})"
-            raise ValueError(msg)
-
-    die_if_not_positive("size", size)
-    die_if_not_positive("step", step)
-    die_if_not_positive("skip", skip)
-
-    stop = replace_if_none(stop, len_ := len(sequence))
-    if not (start < stop <= len_ and start >= 0):
-        msg = f"invalid range [{start}, {stop}) for sequence of length {len_}"
-        raise ValueError(msg)
-
-    head = start
-    tail = head + (size - 1) * skip + 1
-
-    while tail <= stop:
-        yield sequence[head:tail:skip]
-        head += step
-        tail += step
-
-    if not drop_last and head < stop:
-        yield sequence[head:tail:skip]
+from __future__ import annotations
+
+__all__ = ("generate_batches",)
+
+from typing import TYPE_CHECKING
+
+from kaparoo.utils.optional import replace_if_none
+
+if TYPE_CHECKING:
+    from collections.abc import Iterator, Sequence
+
+
+def generate_batches[T](
+    sequence: Sequence[T],
+    size: int,
+    step: int = 1,
+    skip: int = 1,
+    start: int = 0,
+    stop: int | None = None,
+    *,
+    drop_last: bool = True,
+) -> Iterator[Sequence[T]]:
+    def die_if_not_positive(name: str, value: int) -> None:
+        if value <= 0:
+            msg = f"{name} must be positive (got {value})"
+            raise ValueError(msg)
+
+    die_if_not_positive("size", size)
+    die_if_not_positive("step", step)
+    die_if_not_positive("skip", skip)
+
+    stop = replace_if_none(stop, len_ := len(sequence))
+    if not (start < stop <= len_ and start >= 0):
+        msg = f"invalid range [{start}, {stop}) for sequence of length {len_}"
+        raise ValueError(msg)
+
+    head = start
+    tail = head + (size - 1) * skip + 1
+
+    while tail <= stop:
+        yield sequence[head:tail:skip]
+        head += step
+        tail += step
+
+    if not drop_last and head < stop:
+        yield sequence[head:tail:skip]

{kaparoo_python-0.2.0 → kaparoo_python-0.2.1}/kaparoo/filesystem/__init__.py

@@ -1,73 +1,73 @@
-__all__ = (
-    "DirectoryNotFoundError",
-    "NotAFileError",
-    "dir_empty",
-    "dir_empty_unsafe",
-    "dir_exists",
-    "dirs_empty",
-    "dirs_empty_unsafe",
-    "dirs_exist",
-    "ensure_dir_exists",
-    "ensure_dirs_exist",
-    "ensure_file_exists",
-    "ensure_files_exist",
-    "ensure_path_exists",
-    "ensure_paths_exist",
-    "file_exists",
-    "files_exist",
-    "get_dirs",
-    "get_files",
-    "get_paths",
-    "make_dir",
-    "make_dirs",
-    "path_exists",
-    "paths_exist",
-    "search_dirs",
-    "search_files",
-    "search_paths",
-    "stringify_path",
-    "stringify_paths",
-    "wrap_path",
-    "wrap_paths",
-)
-
-from kaparoo.filesystem.directory import (
-    dir_empty,
-    dir_empty_unsafe,
-    dirs_empty,
-    dirs_empty_unsafe,
-    make_dir,
-    make_dirs,
-)
-from kaparoo.filesystem.exceptions import (
-    DirectoryNotFoundError,
-    NotAFileError,
-)
-from kaparoo.filesystem.existence import (
-    dir_exists,
-    dirs_exist,
-    ensure_dir_exists,
-    ensure_dirs_exist,
-    ensure_file_exists,
-    ensure_files_exist,
-    ensure_path_exists,
-    ensure_paths_exist,
-    file_exists,
-    files_exist,
-    path_exists,
-    paths_exist,
-)
-from kaparoo.filesystem.search import (
-    get_dirs,
-    get_files,
-    get_paths,
-    search_dirs,
-    search_files,
-    search_paths,
-)
-from kaparoo.filesystem.utils import (
-    stringify_path,
-    stringify_paths,
-    wrap_path,
-    wrap_paths,
-)
+__all__ = (
+    "DirectoryNotFoundError",
+    "NotAFileError",
+    "dir_empty",
+    "dir_empty_unsafe",
+    "dir_exists",
+    "dirs_empty",
+    "dirs_empty_unsafe",
+    "dirs_exist",
+    "ensure_dir_exists",
+    "ensure_dirs_exist",
+    "ensure_file_exists",
+    "ensure_files_exist",
+    "ensure_path_exists",
+    "ensure_paths_exist",
+    "file_exists",
+    "files_exist",
+    "get_dirs",
+    "get_files",
+    "get_paths",
+    "make_dir",
+    "make_dirs",
+    "path_exists",
+    "paths_exist",
+    "search_dirs",
+    "search_files",
+    "search_paths",
+    "stringify_path",
+    "stringify_paths",
+    "wrap_path",
+    "wrap_paths",
+)
+
+from kaparoo.filesystem.directory import (
+    dir_empty,
+    dir_empty_unsafe,
+    dirs_empty,
+    dirs_empty_unsafe,
+    make_dir,
+    make_dirs,
+)
+from kaparoo.filesystem.exceptions import (
+    DirectoryNotFoundError,
+    NotAFileError,
+)
+from kaparoo.filesystem.existence import (
+    dir_exists,
+    dirs_exist,
+    ensure_dir_exists,
+    ensure_dirs_exist,
+    ensure_file_exists,
+    ensure_files_exist,
+    ensure_path_exists,
+    ensure_paths_exist,
+    file_exists,
+    files_exist,
+    path_exists,
+    paths_exist,
+)
+from kaparoo.filesystem.search import (
+    get_dirs,
+    get_files,
+    get_paths,
+    search_dirs,
+    search_files,
+    search_paths,
+)
+from kaparoo.filesystem.utils import (
+    stringify_path,
+    stringify_paths,
+    wrap_path,
+    wrap_paths,
+)