kvgit 0.3.2__tar.gz → 0.3.4__tar.gz

{kvgit-0.3.2 → kvgit-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kvgit
-Version: 0.3.2
+Version: 0.3.4
 Summary: Versioned key-value store with git-like commit, branch, and merge semantics.
 Author: ashenfad
 License: MIT
@@ -42,7 +42,7 @@ Requires-Dist: pandas>=2.0; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: diskcache; extra == "dev"
-Requires-Dist: ruff; extra == "dev"
+Requires-Dist: ruff<0.17,>=0.16; extra == "dev"
 Requires-Dist: numpy>=1.24; extra == "dev"
 Requires-Dist: pandas>=2.0; extra == "dev"
 Dynamic: license-file

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/codecs/numpy.py

@@ -33,7 +33,7 @@ storing each unique buffer once instead of N times.)
 
 from __future__ import annotations
 
-from typing import Any, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     import numpy as np
@@ -66,7 +66,7 @@ def _descr_to_dtype(descr):
     return npf.descr_to_dtype(descr)
 
 
-def _root_and_offset(arr: "np.ndarray") -> tuple["np.ndarray", int]:
+def _root_and_offset(arr: np.ndarray) -> tuple[np.ndarray, int]:
     """Walk ``.base`` to the root buffer; return (root, byte_offset).
 
     Returns ``(arr, 0)`` if the .base chain leads somewhere we can't

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/codecs/pickler.py

@@ -16,7 +16,8 @@ from __future__ import annotations
 
 import io
 import pickle
-from typing import Any, Iterable
+from collections.abc import Iterable
+from typing import Any
 
 from .base import ChunkReader, ChunkSink, Codec
 

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/content_types.py

@@ -1,6 +1,7 @@
 """Merge functions for typed values."""
 
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 MergeFn = Callable[[Any | None, Any, Any], Any]
 """Merge function: (old_value | None, our_value, their_value) -> merged_value.

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/encoding.py

@@ -28,5 +28,6 @@ def safe_loads(raw: bytes):
     """
     try:
         return json.loads(raw)
-    except Exception:
+    except Exception:  # noqa: BLE001 — the point of the function: any
+        # decode failure (garbage, partial write, version skew) is a miss.
         return None

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/kv/indexeddb.py

@@ -47,8 +47,8 @@ the handler is set, causing a deadlock.
 
 from collections.abc import Iterable, Mapping
 
-from pyodide.ffi import create_proxy, run_sync, to_js  # type: ignore[import-not-found]
 from js import Promise, indexedDB, undefined  # type: ignore[import-not-found]
+from pyodide.ffi import create_proxy, run_sync, to_js  # type: ignore[import-not-found]
 
 from .base import KVStore
 
@@ -155,8 +155,9 @@ def _to_bytes(js_value) -> bytes | None:
         return None
     try:
         return js_value.to_py().tobytes()
-    except Exception:
-        # Corrupted or unexpected JS value — treat as missing
+    except Exception:  # noqa: BLE001 — a JS->Python conversion can fail
+        # with anything the FFI decides to raise; there is no narrower
+        # type to name. Corrupted or unexpected JS value — treat as missing.
         return None
 
 

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/namespaced.py

@@ -2,8 +2,8 @@
 
 from __future__ import annotations
 
-from collections.abc import Iterator, MutableMapping
-from typing import Any, Iterable
+from collections.abc import Iterable, Iterator, MutableMapping
+from typing import Any
 
 
 class Namespaced(MutableMapping[str, Any]):

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/staged.py

@@ -2,8 +2,8 @@
 
 import inspect
 import pickle
-from collections.abc import Iterable, Iterator, MutableMapping
-from typing import Any, Callable
+from collections.abc import Callable, Iterable, Iterator, MutableMapping
+from typing import Any
 
 from .codecs._hash import hash_bytes
 from .content_types import MergeFn

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/store.py

@@ -1,13 +1,19 @@
 """Store factory function."""
 
 import pickle
-from collections.abc import Iterable
-from typing import Any, Callable, Literal
+from collections.abc import Callable, Iterable
+from typing import Any, Literal
 
 from .kv.base import KVStore
 from .kv.memory import Memory
 from .staged import Staged
-from .versioned.kv import BRANCH_HEAD, BRANCH_HEAD_PREV, VersionedKV, clean_orphans
+from .versioned.kv import (
+    BRANCH_HEAD,
+    BRANCH_HEAD_PREV,
+    CorruptHeadRecoverer,
+    VersionedKV,
+    clean_orphans,
+)
 
 
 def _make_backend(
@@ -46,6 +52,7 @@ def store(
     encoder: Callable[..., bytes] = pickle.dumps,
     decoder: Callable[..., Any] = pickle.loads,
     codecs: str | None = None,
+    recover_from_corrupt_head: CorruptHeadRecoverer | None = None,
 ) -> Staged:
     """Create a Staged store with sensible defaults.
 
@@ -62,6 +69,13 @@ def store(
             ``"scientific"`` — numpy/pandas chunked codecs (requires
             numpy; install with ``pip install kvgit[scientific]``).
             Mutually exclusive with explicit ``encoder`` / ``decoder``.
+        recover_from_corrupt_head: Optional last-resort recovery for a
+            branch whose HEAD is unresolvable *and* whose prev-HEAD
+            backup is gone. Off by default: with both gone the store
+            does not know what the branch pointed at, so the honest
+            answer is to fail rather than guess. Pass
+            ``kvgit.versioned.kv.recover_by_commit_scan`` to opt into
+            the scan, having read what it can return.
 
     Returns:
         A ``Staged`` store instance.
@@ -85,7 +99,15 @@ def store(
 
     backend = _make_backend(kind, path=path, db_name=db_name)
 
-    return Staged(VersionedKV(backend, branch=branch), encoder=encoder, decoder=decoder)
+    return Staged(
+        VersionedKV(
+            backend,
+            branch=branch,
+            recover_from_corrupt_head=recover_from_corrupt_head,
+        ),
+        encoder=encoder,
+        decoder=decoder,
+    )
 
 
 def delete_branches(
@@ -123,6 +145,11 @@ def delete_branches(
     not swept out from under it; an admin who knows the store is quiet
     can pass ``0`` to reclaim young commits immediately.
 
+    That sweep does not reclaim chunks — the content-addressed bytes a
+    chunked codec writes — because a chunk key is not the deleted
+    branch's to give away. On a store using chunked codecs, follow up
+    with ``deep_clean`` on a quiescent store to get that space back.
+
     Args:
         names: Branch names to delete — one name or an iterable of
             them. Missing names are no-ops. (A bare string is treated

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/versioned/base.py

@@ -1,7 +1,7 @@
 """Shared commit/merge orchestration for versioned stores."""
 
 from abc import ABC, abstractmethod
-from typing import Iterable
+from collections.abc import Iterable
 
 from ..errors import ConcurrencyError, MergeConflict
 from .helpers import diff_keysets, walk_history

{kvgit-0.3.2 → kvgit-0.3.4}/kvgit/versioned/helpers.py

@@ -1,7 +1,7 @@
 """Shared diff and history helpers."""
 
 from collections import deque
-from typing import Callable, Iterable
+from collections.abc import Callable, Iterable
 
 from .protocol import DiffResult