DSPy: The framework for programming—not prompting—language models
Python
docs(hasher): add Google-style docstrings to public APIs (#9293)
immersir37a2c5feb0cc
diff --git a/dspy/utils/hasher.py b/dspy/utils/hasher.pyindex f842600b2..bfde976e4 100644--- a/dspy/utils/hasher.py+++ b/dspy/utils/hasher.py@@ -19,10 +19,19 @@ class Hasher:dispatch: dict = {}def __init__(self):+ """Initialize an empty xxhash64 hasher state."""self.m = xxhash.xxh64()@classmethoddef hash_bytes(cls, value: bytes | list[bytes]) -> str:+ """Return a hex digest for one or more byte chunks.++ Args:+ value: A single bytes object or a list of bytes to hash in order.++ Returns:+ The xxhash64 hexadecimal digest.+ """value = [value] if isinstance(value, bytes) else valuem = xxhash.xxh64()for x in value:@@ -31,13 +40,27 @@ class Hasher:@classmethoddef hash(cls, value: Any) -> str:+ """Serialize and hash a Python object.++ Args:+ value: Any pickle-serializable Python object.++ Returns:+ The xxhash64 hexadecimal digest of the serialized object.+ """return cls.hash_bytes(dumps(value))def update(self, value: Any) -> None:+ """Update the running digest with a typed object payload.++ Args:+ value: Any pickle-serializable Python object to incorporate.+ """header_for_update = f"=={type(value)}=="value_for_update = self.hash(value)self.m.update(header_for_update.encode("utf8"))self.m.update(value_for_update.encode("utf-8"))def hexdigest(self) -> str:+ """Return the hexadecimal digest of the current hasher state."""return self.m.hexdigest()