checkpointer 2.14.10__tar.gz → 2.14.11__tar.gz

{checkpointer-2.14.10 → checkpointer-2.14.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: checkpointer
-Version: 2.14.10
+Version: 2.14.11
 Summary: checkpointer adds code-aware caching to Python functions, maintaining correctness and speeding up execution as your code changes.
 Project-URL: Repository, https://github.com/Reddan/checkpointer.git
 Author: Hampus Hallman
@@ -177,6 +177,24 @@ def process(
 
 In this example, the hash for `numbers` ignores order, `data_file` is hashed based on its contents rather than path, and changes to `log` don't affect caching.
 
+## 🔑 Custom Instance Hashing with `__objecthash__`
+
+Any class can implement `__objecthash__` to control how its instances are hashed by `checkpointer`. When an instance is encountered during hashing, `checkpointer` calls `__objecthash__()` and hashes the returned value instead of inspecting the object's internals.
+
+```python
+class Model:
+    def __init__(self, id: str, weights: list[float]):
+        self.id = id
+        self.weights = weights
+
+    def __objecthash__(self):
+        return self.id  # Hash instances by their id only
+```
+
+The return value of `__objecthash__` can be any Python value — a string, int, tuple, dict, or anything else `checkpointer` knows how to hash. This makes it easy to define a precise, stable identity for your objects without relying on pickle or attribute inspection.
+
+Once defined, `__objecthash__` applies everywhere the class is used — as a function argument, captured variable, or nested value — with no need for `HashBy` annotations at each call site.
+
 ## 🎯 Capturing Global Variables
 
 `checkpointer` can include **captured global variables** in call hashes - these are globals your function reads during execution that may affect results.

{checkpointer-2.14.10 → checkpointer-2.14.11}/README.md

@@ -160,6 +160,24 @@ def process(
 
 In this example, the hash for `numbers` ignores order, `data_file` is hashed based on its contents rather than path, and changes to `log` don't affect caching.
 
+## 🔑 Custom Instance Hashing with `__objecthash__`
+
+Any class can implement `__objecthash__` to control how its instances are hashed by `checkpointer`. When an instance is encountered during hashing, `checkpointer` calls `__objecthash__()` and hashes the returned value instead of inspecting the object's internals.
+
+```python
+class Model:
+    def __init__(self, id: str, weights: list[float]):
+        self.id = id
+        self.weights = weights
+
+    def __objecthash__(self):
+        return self.id  # Hash instances by their id only
+```
+
+The return value of `__objecthash__` can be any Python value — a string, int, tuple, dict, or anything else `checkpointer` knows how to hash. This makes it easy to define a precise, stable identity for your objects without relying on pickle or attribute inspection.
+
+Once defined, `__objecthash__` applies everywhere the class is used — as a function argument, captured variable, or nested value — with no need for `HashBy` annotations at each call site.
+
 ## 🎯 Capturing Global Variables
 
 `checkpointer` can include **captured global variables** in call hashes - these are globals your function reads during execution that may affect results.

{checkpointer-2.14.10 → checkpointer-2.14.11}/checkpointer/checkpoint.py

@@ -5,6 +5,7 @@ from datetime import datetime, timedelta
 from functools import cached_property, update_wrapper
 from inspect import Parameter, iscoroutine, signature, unwrap
 from pathlib import Path
+from types import MethodType
 from typing import (
   Callable, Concatenate, Coroutine, Generic, Iterable,
   Literal, Self, Type, TypedDict, Unpack, overload,
@@ -151,7 +152,7 @@ class CachedFunction(Generic[Fn]):
   @property
   def fn(self) -> Fn:
     if self.bound:
-      return self.ident.fn.__get__(self.bound[0], self.bound[0].__class__)  # type: ignore
+      return MethodType(self.ident.fn, self.bound[0])  # type: ignore
     return self.ident.fn  # type: ignore
 
   @cached_property

{checkpointer-2.14.10 → checkpointer-2.14.11}/checkpointer/storages/memory_storage.py

@@ -47,6 +47,8 @@ class MemoryStorage(Storage):
           for call_hash, (date, _) in list(calldict.items()):
             if self.expired_dt(date):
               del calldict[call_hash]
+          if not calldict:
+            del item_map[key]
 
   def clear(self):
     fn_path = self.fn_dir().parent

{checkpointer-2.14.10 → checkpointer-2.14.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "checkpointer"
-version = "2.14.10"
+version = "2.14.11"
 requires-python = ">=3.11"
 dependencies = []
 authors = [

{checkpointer-2.14.10 → checkpointer-2.14.11}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "checkpointer"
-version = "2.14.10"
+version = "2.14.11"
 source = { editable = "." }
 
 [package.dev-dependencies]