pyuncommonkit 0.1.0__tar.gz → 0.1.2__tar.gz

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyuncommonkit
-Version: 0.1.0
+Version: 0.1.2
 Summary: Named shared-memory segments for numpy arrays: publish once, attach from any process.
 Keywords: numpy,npy,mmap,shared-memory,cache
 Author: Sean D. True

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyuncommonkit"
-version = "0.1.0"
+version = "0.1.2"
 description = "Named shared-memory segments for numpy arrays: publish once, attach from any process."
 readme = "README.md"
 license = "MIT"

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "pyuncommonkit"
-version = "0.1.0"
+version = "0.1.2"
 description = "Named shared-memory segments for numpy arrays: publish once, attach from any process."
 readme = "README.md"
 authors = [
@@ -16,7 +16,8 @@ dependencies = [
 ]
 keywords = ["numpy", "npy", "mmap", "shared-memory", "cache"]
 # No License :: classifier: PEP 639's `license` expression replaces it. Linux and macOS only:
-# Windows is supported in the contract (§12) but has no Python default root or CI yet.
+# Windows has a default root since 0.1.1 and passes the suite on a Windows 11 machine, but has no
+# CI yet, so no Windows classifier.
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/src/commonkit/keys.py

@@ -42,10 +42,11 @@ from __future__ import annotations
 import re
 from collections.abc import Iterable
 
-#: Segments are addressed by md5, lowercase. Every pattern here is used with
+#: Segments are addressed by a lowercase hex digest: 32 digits (md5) or 64 (BLAKE3,
+#: contract §3.4); the length tells them apart, so one key still names one content. Every pattern here is used with
 #: ``fullmatch``, never ``match`` with ``$``: ``$`` also matches before a final
 #: newline, which let ``"...\n"`` through as a digest or token (contract §3.1).
-_DIGEST_RE = re.compile(r"[0-9a-f]{32}")
+_DIGEST_RE = re.compile(r"[0-9a-f]{32}|[0-9a-f]{64}")
 
 #: Every other component is a bare lowercase token. Restrictive on purpose:
 #: these become PATH components, and a key is the only thing standing between
@@ -110,7 +111,7 @@ class KeyScheme:
 
         self._key_re = re.compile(
             rf"{re.escape(self.domain)}:{re.escape(self.version)}:"
-            r"(?P<form>[a-z0-9]+):(?P<digest>[0-9a-f]{32}):"
+            r"(?P<form>[a-z0-9]+):(?P<digest>[0-9a-f]{32}|[0-9a-f]{64}):"
             r"(?P<variant>[a-z0-9]+)")
 
     # ------------------------------------------------------------- building
@@ -140,7 +141,7 @@ class KeyScheme:
         """The store key for one array. Raises on anything it cannot address."""
         digest = str(digest).translate(_ASCII_LOWER)
         if not _DIGEST_RE.fullmatch(digest):
-            raise ValueError(f"not an md5 digest: {digest!r}")
+            raise ValueError(f"not a 32- or 64-digit hex digest: {digest!r}")
         form = self.default_form if form is None else str(form)
         if form not in self.forms:
             raise ValueError(

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/src/commonkit/shared.py

@@ -44,15 +44,21 @@ from .store import SharedArrayStore
 
 ENV_PREFIX = "COMMONKIT_STORE_"
 _DARWIN = sys.platform == "darwin"
+_WINDOWS = sys.platform == "win32"
 
 #: Per-platform defaults. macOS: the user cache directory on the internal SSD -- it has no
 #: /dev/shm, the SSD beat a RAM disk on first attach (0.69 ms against 0.76 ms), and a
 #: ``ram://`` disk commits its whole size up front as dirty memory. Linux: /dev/shm, which
-#: is RAM, so the budget is its only real bound.
+#: is RAM, so the budget is its only real bound. Windows: no /dev/shm either (it would
+#: resolve to ``\dev\shm`` on the current drive), so the per-user local cache, on disk like
+#: macOS and with its budget (contract 10.1; from seantrue/commonkit d8198ae).
 DEFAULTS = {
     "ROOT": (os.path.expanduser("~/Library/Caches/commonkit/store") if _DARWIN
+             else os.path.join(os.environ.get("LOCALAPPDATA")
+                               or os.path.expanduser("~/AppData/Local"), "commonkit", "store")
+             if _WINDOWS
              else "/dev/shm/commonkit"),
-    "MAX_GB": 2.0 if _DARWIN else 8.0,
+    "MAX_GB": 2.0 if _DARWIN or _WINDOWS else 8.0,
     "MIN_FREE_GB": 8.0,
     "TTL_S": 900.0,
     "REAP_S": 30.0,

{pyuncommonkit-0.1.0 → pyuncommonkit-0.1.2}/src/commonkit/store.py

@@ -97,7 +97,7 @@ _NPY_MAGIC = b"\x93NUMPY"
 #: The reaper's candidates (contract §9.4): ``{form}/{xx}/{digest}.{variant}.npy`` with
 #: the shard equal to the digest's first two characters. Matched per path component.
 _SHARD_RE = re.compile(r"[0-9a-f]{2}")
-_SEGMENT_NAME_RE = re.compile(r"([0-9a-f]{2})[0-9a-f]{30}\.[a-z0-9]+\.npy")
+_SEGMENT_NAME_RE = re.compile(r"([0-9a-f]{2})(?:[0-9a-f]{30}|[0-9a-f]{62})\.[a-z0-9]+\.npy")
 
 #: An orphaned temporary file is swept once it is this old (contract §9.5). A writer
 #: holds its ``.tmp`` for one ``np.save`` -- milliseconds -- so an hour old means the
@@ -356,7 +356,9 @@ class SharedArrayStore:
         ``keys.relpath`` is strict about the key shape, so a malformed key raises
         here rather than producing a path the reaper might later unlink.
         """
-        return os.path.join(self.root, _keys.relpath(key))
+        # The relative path is `/`-separated (contract 3.6); joined with this platform's
+        # separator, so a Windows path isn't `...\store\plumarr/91/...`.
+        return os.path.join(self.root, *_keys.relpath(key).split("/"))
 
     # ---------------------------------------------------------------- reading
 
@@ -812,8 +814,8 @@ def _measure_free(root: str) -> int:
     """Free bytes on ``root``'s volume, 0 on any failure (contract §9.9)."""
     # Any failure is 0 free, not an exception: catching only OSError let AttributeError
     # out on a platform without os.statvfs. Windows has none, so it asks shutil, whose
-    # POSIX branch is this same f_bavail * f_frsize; how Windows measures is not yet
-    # contract (§12).
+    # POSIX branch is this same f_bavail * f_frsize and whose Windows one is
+    # GetDiskFreeSpaceExW's free-to-caller figure (§9.9).
     try:
         if hasattr(os, "statvfs"):
             st = os.statvfs(root)