You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hamilton.apache.org by gi...@apache.org on 2026/06/16 12:57:55 UTC
(hamilton) branch asf-site updated: Deploy documentation from 8147b47597be97882333874a1264f42ccaa7b2ef
This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hamilton.git
The following commit(s) were added to refs/heads/asf-site by this push:
new e62cb4f0 Deploy documentation from 8147b47597be97882333874a1264f42ccaa7b2ef
e62cb4f0 is described below
commit e62cb4f0736982aacfc1365fdb2c9a5a795bcace
Author: GitHub Actions <ac...@github.com>
AuthorDate: Tue Jun 16 12:57:49 2026 +0000
Deploy documentation from 8147b47597be97882333874a1264f42ccaa7b2ef
---
.../hamilton/caching/fingerprinting/index.html | 102 ++++++++++++---------
.../hamilton/function_modifiers/delayed/index.html | 8 +-
content/_static/Hamilton.pdf | Bin 11118535 -> 11120026 bytes
content/code-comparisons/langchain/index.html | 11 +++
.../reference/caching/data-versioning/index.html | 31 +++++--
content/searchindex.js | 2 +-
6 files changed, 95 insertions(+), 59 deletions(-)
diff --git a/content/_modules/hamilton/caching/fingerprinting/index.html b/content/_modules/hamilton/caching/fingerprinting/index.html
index c688e379..b6748879 100644
--- a/content/_modules/hamilton/caching/fingerprinting/index.html
+++ b/content/_modules/hamilton/caching/fingerprinting/index.html
@@ -595,6 +595,15 @@ s=d.getElementsByTagName('script')[0];
<span class="k">return</span> <span class="n">base64</span><span class="o">.</span><span class="n">urlsafe_b64encode</span><span class="p">(</span><span class="n">digest</span><span class="p">)</span><span class="o">.</span><span class="n">decode</span><span class="p">()</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">_hash_bytes</span><span class="p">(</span><span class="n">data</span><span class="p">:</span> <span class="nb">bytes</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span>
+<span class="w"> </span><span class="sd">"""Hash raw bytes and compact-encode the digest.</span>
+
+<span class="sd"> All hashing in this module routes through this single helper so the</span>
+<span class="sd"> underlying hashing algorithm can be changed in exactly one place.</span>
+<span class="sd"> """</span>
+ <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hashlib</span><span class="o">.</span><span class="n">md5</span><span class="p">(</span><span class="n">data</span><span class="p">)</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span>
+
+
<div class="viewcode-block" id="hash_value">
<a class="viewcode-back" href="../../../../reference/caching/data-versioning/#hamilton.caching.fingerprinting.hash_value">[docs]</a>
<span class="nd">@functools</span><span class="o">.</span><span class="n">singledispatch</span>
@@ -668,12 +677,15 @@ s=d.getElementsByTagName('script')[0];
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="nb">bool</span><span class="p">)</span>
<span class="k">def</span><span class="w"> </span><span class="nf">hash_primitive</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span>
-<span class="w"> </span><span class="sd">"""Convert the primitive to a string and hash it</span>
+<span class="w"> </span><span class="sd">"""Convert the primitive to a string and hash it.</span>
+
+<span class="sd"> The hash is prefixed with the type name so that values sharing the same</span>
+<span class="sd"> string form but differing in type (e.g. ``1`` vs ``"1"`` vs ``1.0``) do</span>
+<span class="sd"> not collide.</span>
<span class="sd"> Primitive type returns a hash and doesn't have to handle depth.</span>
<span class="sd"> """</span>
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">md5</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">:</span><span class="si">{</span><span class="n">obj</span><span class="si">}</span><span class="s2">"</span><span [...]
@@ -681,12 +693,14 @@ s=d.getElementsByTagName('script')[0];
<a class="viewcode-back" href="../../../../reference/caching/data-versioning/#hamilton.caching.fingerprinting.hash_bytes">[docs]</a>
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="nb">bytes</span><span class="p">)</span>
<span class="k">def</span><span class="w"> </span><span class="nf">hash_bytes</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span>
-<span class="w"> </span><span class="sd">"""Convert the primitive to a string and hash it</span>
+<span class="w"> </span><span class="sd">"""Hash a bytes object.</span>
+
+<span class="sd"> The hash is prefixed with a ``bytes`` type tag so that ``b"1"`` and the</span>
+<span class="sd"> string ``"1"`` (handled by :func:`hash_primitive`) do not collide.</span>
<span class="sd"> Primitive type returns a hash and doesn't have to handle depth.</span>
<span class="sd"> """</span>
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">md5</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="sa">b</span><span class="s2">"bytes:"</span> <span class="o">+</span> <span class="n">obj</span><span class="p">)</span></div>
@@ -698,11 +712,8 @@ s=d.getElementsByTagName('script')[0];
<span class="sd"> Orders matters for the hash since orders matters in a sequence.</span>
<span class="sd"> """</span>
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha224</span><span class="p">()</span>
- <span class="k">for</span> <span class="n">elem</span> <span class="ow">in</span> <span class="n">obj</span><span class="p">:</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">hash_value</span><span class="p">(</span><span class="n">elem</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
-
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="n">buffer</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">hash_value</span><span class="p">(</span><span class="n">elem</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span cla [...]
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span></div>
@@ -725,12 +736,10 @@ s=d.getElementsByTagName('script')[0];
<span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">obj</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
<span class="n">hashed_mapping</span><span class="p">[</span><span class="n">hash_value</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)]</span> <span class="o">=</span> <span class="n">hash_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">depth</ [...]
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha224</span><span class="p">()</span>
- <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">hashed_mapping</span><span class="o">.</span><span class="n">items</span><span class="p">()):</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">key</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">value</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
-
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="n">buffer</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+ <span class="n">key</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="o">+</span> <span class="n">value</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">hashed_mapping</span><span class="o">.</spa [...]
+ <span class="p">)</span>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span></div>
@@ -759,12 +768,11 @@ s=d.getElementsByTagName('script')[0];
<span class="c1"># use the same depth because we're simply dispatching to another implementation</span>
<span class="k">return</span> <span class="n">hash_unordered_mapping</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span><span class="p">)</span>
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha224</span><span class="p">()</span>
- <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">obj</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">hash_value</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">hash_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
-
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="n">buffer</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+ <span class="n">hash_value</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="o">+</span> <span class="n">hash_value</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span c [...]
+ <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">obj</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
+ <span class="p">)</span>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span></div>
@@ -778,14 +786,9 @@ s=d.getElementsByTagName('script')[0];
<span class="sd"> For the same objects in the set, the hashes will be the</span>
<span class="sd"> same.</span>
<span class="sd"> """</span>
- <span class="n">hashes</span> <span class="o">=</span> <span class="p">[</span><span class="n">hash_value</span><span class="p">(</span><span class="n">elem</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="k">for</span> <span class="n">elem</span> <span class="ow">in</span> <span class="n">obj</span><span class="p">]</span>
- <span class="n">sorted_hashes</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">hashes</span><span class="p">)</span>
-
- <span class="n">hash_object</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">sha224</span><span class="p">()</span>
- <span class="k">for</span> <span class="nb">hash</span> <span class="ow">in</span> <span class="n">sorted_hashes</span><span class="p">:</span>
- <span class="n">hash_object</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="nb">hash</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
-
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">hash_object</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="n">sorted_hashes</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">hash_value</span><span class="p">(</span><span class="n">elem</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="k">for</span> <span class="n">elem</span> <span class="ow">in</span> <span class="n">obj</span [...]
+ <span class="n">buffer</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">""</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">hash</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="k">for</span> <span class="nb">hash</span> <span class="ow">in</span> <span class="n">sorted_hashes</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">buffer</span><span class="p">)</span></div>
@@ -794,17 +797,25 @@ s=d.getElementsByTagName('script')[0];
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">h_databackends</span><span class="o">.</span><span class="n">AbstractPandasDataFrame</span><span class="p">)</span>
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">h_databackends</span><span class="o">.</span><span class="n">AbstractPandasColumn</span><span class="p">)</span>
<span class="k">def</span><span class="w"> </span><span class="nf">hash_pandas_obj</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class="o">- [...]
-<span class="w"> </span><span class="sd">"""Convert a pandas dataframe, series, or index to</span>
-<span class="sd"> a dictionary of {index: row_hash} then hash it.</span>
+<span class="w"> </span><span class="sd">"""Hash a pandas DataFrame, Series, or Index via vectorized row hashing.</span>
+
+<span class="sd"> ``pandas.util.hash_pandas_object`` computes a uint64 hash per row in a</span>
+<span class="sd"> single vectorized pass; we hash that buffer in one shot rather than</span>
+<span class="sd"> iterating over rows in Python. Column names and dtypes (the schema) are</span>
+<span class="sd"> folded in so that frames carrying identical cell values under different</span>
+<span class="sd"> schemas do not collide.</span>
-<span class="sd"> Given the hashing for mappings, the physical ordering or rows doesn't matter.</span>
-<span class="sd"> For example, if the index is a date, the hash will represent the {date: row_hash},</span>
-<span class="sd"> and won't preserve how dates were ordered in the DataFrame.</span>
+<span class="sd"> The hash is order-sensitive: reordering rows changes the per-row hash</span>
+<span class="sd"> buffer and therefore the fingerprint.</span>
<span class="sd"> """</span>
<span class="kn">from</span><span class="w"> </span><span class="nn">pandas.util</span><span class="w"> </span><span class="kn">import</span> <span class="n">hash_pandas_object</span>
- <span class="n">hash_per_row</span> <span class="o">=</span> <span class="n">hash_pandas_object</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span>
- <span class="k">return</span> <span class="n">hash_mapping</span><span class="p">(</span><span class="n">hash_per_row</span><span class="o">.</span><span class="n">to_dict</span><span class="p">(),</span> <span class="n">ignore_order</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span></div>
+ <span class="n">row_hashes</span> <span class="o">=</span> <span class="n">hash_pandas_object</span><span class="p">(</span><span class="n">obj</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">tobytes</span><span class="p">()</span>
+ <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="s2">"columns"</span><span class="p">):</span>
+ <span class="n">schema</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="nb">list</span><span class="p">(</span><span class="n">obj</span><span class="o">.</span><span class="n">columns</span><span class="p">)</span><span class="si">}</span><span class="s2">:</span><span class="si">{</span><span class="p">[</span><span class="nb">str</span><span class="p">(</span><span class="n">dtype</span><span class="p" [...]
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">schema</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="nb">getattr</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span><span class="w"> </span><span class="s1">'name'</span><span class="p">,</span><span class="w"> </span><span class="kc">None</span><span class="p">)</span><span class="si">}</span><span class="s2">:</span><span class="si">{</span><span c [...]
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">schema</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="o">+</span> <span class="n">row_hashes</span><span class="p">)</span></div>
@@ -812,15 +823,18 @@ s=d.getElementsByTagName('script')[0];
<a class="viewcode-back" href="../../../../reference/caching/data-versioning/#hamilton.caching.fingerprinting.hash_polars_dataframe">[docs]</a>
<span class="nd">@hash_value</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">h_databackends</span><span class="o">.</span><span class="n">AbstractPolarsDataFrame</span><span class="p">)</span>
<span class="k">def</span><span class="w"> </span><span class="nf">hash_polars_dataframe</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span> <span class [...]
-<span class="w"> </span><span class="sd">"""Convert a polars dataframe to a hash that includes column names</span>
-<span class="sd"> and dtypes (schema) alongside row hashes. This prevents collisions</span>
-<span class="sd"> between DataFrames with identical cell values but different schemas.</span>
+<span class="w"> </span><span class="sd">"""Hash a polars DataFrame via vectorized row hashing.</span>
+
+<span class="sd"> ``DataFrame.hash_rows`` computes a per-row hash in a single vectorized</span>
+<span class="sd"> pass; we hash that buffer (``to_numpy().tobytes()``) in one shot rather</span>
+<span class="sd"> than iterating element-by-element in Python. Column names and dtypes</span>
+<span class="sd"> (the schema) are folded in so frames carrying identical cell values under</span>
+<span class="sd"> different schemas do not collide.</span>
<span class="sd"> """</span>
<span class="n">schema_str</span> <span class="o">=</span> <span class="s2">","</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">:</span><span class="si">{</span><span class="n">dtype</span><span class="si">}</span><span class="s2">"</span> <span class="k">for</span> <span class="n">name</sp [...]
<span class="n">schema_hash</span> <span class="o">=</span> <span class="n">hash_bytes</span><span class="p">(</span><span class="n">schema_str</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
- <span class="n">row_hash</span> <span class="o">=</span> <span class="n">hash_sequence</span><span class="p">(</span><span class="n">obj</span><span class="o">.</span><span class="n">hash_rows</span><span class="p">()</span><span class="o">.</span><span class="n">to_list</span><span class="p">(),</span> <span class="n">depth</span><span class="o">=</span><span class="n">depth</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span>
- <span class="n">combined</span> <span class="o">=</span> <span class="n">hashlib</span><span class="o">.</span><span class="n">md5</span><span class="p">(</span><span class="n">schema_hash</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="o">+</span> <span class="n">row_hash</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span>
- <span class="k">return</span> <span class="n">_compact_hash</span><span class="p">(</span><span class="n">combined</span><span class="o">.</span><span class="n">digest</span><span class="p">())</span></div>
+ <span class="n">row_hash</span> <span class="o">=</span> <span class="n">hash_bytes</span><span class="p">(</span><span class="n">obj</span><span class="o">.</span><span class="n">hash_rows</span><span class="p">()</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()</span><span class="o">.</span><span class="n">tobytes</span><span class="p">())</span>
+ <span class="k">return</span> <span class="n">_hash_bytes</span><span class="p">(</span><span class="n">schema_hash</span><span class="o">.</span><span class="n">encode</span><span class="p">()</span> <span class="o">+</span> <span class="n">row_hash</span><span class="o">.</span><span class="n">encode</span><span class="p">())</span></div>
diff --git a/content/_modules/hamilton/function_modifiers/delayed/index.html b/content/_modules/hamilton/function_modifiers/delayed/index.html
index dc3e3b62..5942bab8 100644
--- a/content/_modules/hamilton/function_modifiers/delayed/index.html
+++ b/content/_modules/hamilton/function_modifiers/delayed/index.html
@@ -669,13 +669,13 @@ s=d.getElementsByTagName('script')[0];
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_optional_config</span>
<span class="k">def</span><span class="w"> </span><span class="nf">resolve</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">config</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">fn</span><span class="p">:</span> <span class="n">Callable</span><span class="p">)</span> <span class="o [...]
- <span class="k">if</span> <span class="ow">not</span> <span class="n">config</span><span class="p">[</span><span class="n">settings</span><span class="o">.</span><span class="n">ENABLE_POWER_USER_MODE</span><span class="p">]:</span>
+ <span class="k">if</span> <span class="ow">not</span> <span class="n">config</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">settings</span><span class="o">.</span><span class="n">ENABLE_POWER_USER_MODE</span><span class="p">,</span> <span class="kc">False</span><span class="p">):</span>
<span class="k">raise</span> <span class="n">InvalidDecoratorException</span><span class="p">(</span>
- <span class="s2">"Dynamic functions are only allowed in power user mode!"</span>
+ <span class="s2">"Dynamic functions are only allowed in power user mode. "</span>
<span class="s2">"Why? This is occasionally needed to enable highly flexible "</span>
<span class="s2">"dataflows, but it can compromise readability if you're not "</span>
- <span class="s2">"careful! To enable power user mode, pass in the configuration "</span>
- <span class="sa">f</span><span class="s2">"parameter </span><span class="si">{</span><span class="n">settings</span><span class="o">.</span><span class="n">ENABLE_POWER_USER_MODE</span><span class="si">}</span><span class="s2">=True to your driver."</span>
+ <span class="s2">"careful! To enable power user mode, build your driver with "</span>
+ <span class="sa">f</span><span class="s2">".with_config(</span><span class="se">{{</span><span class="si">{</span><span class="n">settings</span><span class="o">.</span><span class="n">ENABLE_POWER_USER_MODE</span><span class="si">!r}</span><span class="s2">: True</span><span class="se">}}</span><span class="s2">)."</span>
<span class="p">)</span>
<span class="n">missing_configs</span> <span class="o">=</span> <span class="p">[]</span>
<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">required_config</span><span class="p">():</span>
diff --git a/content/_static/Hamilton.pdf b/content/_static/Hamilton.pdf
index ec8eb8ef..b40928f0 100644
Binary files a/content/_static/Hamilton.pdf and b/content/_static/Hamilton.pdf differ
diff --git a/content/code-comparisons/langchain/index.html b/content/code-comparisons/langchain/index.html
index 2aeeb091..6c2b237b 100644
--- a/content/code-comparisons/langchain/index.html
+++ b/content/code-comparisons/langchain/index.html
@@ -1585,6 +1585,17 @@ opinion it’s better to be explicit about it.</p>
</div>
</td>
<td><div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="k">def</span><span class="w"> </span><span class="nf">invoke_chain_with_fallback</span><span class="p">(</span><span class="n">topic</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span>
+<span class="w"> </span><span class="sd">"""Invoke a chain with a fallback to Anthropic chain.</span>
+
+<span class="sd"> Attempts to invoke a chain using `invoke_chain` and falls back to</span>
+<span class="sd"> `invoke_anthropic_chain` if any exception is raised.</span>
+
+<span class="sd"> Args:</span>
+<span class="sd"> topic: The topic to pass to the chain invocation.</span>
+
+<span class="sd"> Returns:</span>
+<span class="sd"> The result from the successful chain invocation.</span>
+<span class="sd"> """</span>
<span class="k">try</span><span class="p">:</span>
<span class="k">return</span> <span class="n">invoke_chain</span><span class="p">(</span><span class="n">topic</span><span class="p">)</span> <span class="c1"># noqa: F821</span>
<span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
diff --git a/content/reference/caching/data-versioning/index.html b/content/reference/caching/data-versioning/index.html
index 8ee77f67..1812d417 100644
--- a/content/reference/caching/data-versioning/index.html
+++ b/content/reference/caching/data-versioning/index.html
@@ -541,7 +541,9 @@ implementation should pass the <cite>depth</cite> parameter to prevent <cite>Rec
<dl class="py function">
<dt class="sig sig-object py" id="hamilton.caching.fingerprinting.hash_bytes">
<span class="sig-prename descclassname"><span class="pre">hamilton.caching.fingerprinting.</span></span><span class="sig-name descname"><span class="pre">hash_bytes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">obj</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span> [...]
-<dd><p>Convert the primitive to a string and hash it</p>
+<dd><p>Hash a bytes object.</p>
+<p>The hash is prefixed with a <code class="docutils literal notranslate"><span class="pre">bytes</span></code> type tag so that <code class="docutils literal notranslate"><span class="pre">b"1"</span></code> and the
+string <code class="docutils literal notranslate"><span class="pre">"1"</span></code> (handled by <a class="reference internal" href="#hamilton.caching.fingerprinting.hash_primitive" title="hamilton.caching.fingerprinting.hash_primitive"><code class="xref py py-func docutils literal notranslate"><span class="pre">hash_primitive()</span></code></a>) do not collide.</p>
<p>Primitive type returns a hash and doesn’t have to handle depth.</p>
</dd></dl>
@@ -581,11 +583,14 @@ identical bit patterns) would produce identical hashes.</p>
<dl class="py function">
<dt class="sig sig-object py" id="hamilton.caching.fingerprinting.hash_pandas_obj">
<span class="sig-prename descclassname"><span class="pre">hamilton.caching.fingerprinting.</span></span><span class="sig-name descname"><span class="pre">hash_pandas_obj</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">obj</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">depth</span [...]
-<dd><p>Convert a pandas dataframe, series, or index to
-a dictionary of {index: row_hash} then hash it.</p>
-<p>Given the hashing for mappings, the physical ordering or rows doesn’t matter.
-For example, if the index is a date, the hash will represent the {date: row_hash},
-and won’t preserve how dates were ordered in the DataFrame.</p>
+<dd><p>Hash a pandas DataFrame, Series, or Index via vectorized row hashing.</p>
+<p><code class="docutils literal notranslate"><span class="pre">pandas.util.hash_pandas_object</span></code> computes a uint64 hash per row in a
+single vectorized pass; we hash that buffer in one shot rather than
+iterating over rows in Python. Column names and dtypes (the schema) are
+folded in so that frames carrying identical cell values under different
+schemas do not collide.</p>
+<p>The hash is order-sensitive: reordering rows changes the per-row hash
+buffer and therefore the fingerprint.</p>
</dd></dl>
<dl class="py function">
@@ -597,15 +602,21 @@ and won’t preserve how dates were ordered in the DataFrame.</p>
<dl class="py function">
<dt class="sig sig-object py" id="hamilton.caching.fingerprinting.hash_polars_dataframe">
<span class="sig-prename descclassname"><span class="pre">hamilton.caching.fingerprinting.</span></span><span class="sig-name descname"><span class="pre">hash_polars_dataframe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">obj</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">depth [...]
-<dd><p>Convert a polars dataframe to a hash that includes column names
-and dtypes (schema) alongside row hashes. This prevents collisions
-between DataFrames with identical cell values but different schemas.</p>
+<dd><p>Hash a polars DataFrame via vectorized row hashing.</p>
+<p><code class="docutils literal notranslate"><span class="pre">DataFrame.hash_rows</span></code> computes a per-row hash in a single vectorized
+pass; we hash that buffer (<code class="docutils literal notranslate"><span class="pre">to_numpy().tobytes()</span></code>) in one shot rather
+than iterating element-by-element in Python. Column names and dtypes
+(the schema) are folded in so frames carrying identical cell values under
+different schemas do not collide.</p>
</dd></dl>
<dl class="py function">
<dt class="sig sig-object py" id="hamilton.caching.fingerprinting.hash_primitive">
<span class="sig-prename descclassname"><span class="pre">hamilton.caching.fingerprinting.</span></span><span class="sig-name descname"><span class="pre">hash_primitive</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">obj</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></s [...]
-<dd><p>Convert the primitive to a string and hash it</p>
+<dd><p>Convert the primitive to a string and hash it.</p>
+<p>The hash is prefixed with the type name so that values sharing the same
+string form but differing in type (e.g. <code class="docutils literal notranslate"><span class="pre">1</span></code> vs <code class="docutils literal notranslate"><span class="pre">"1"</span></code> vs <code class="docutils literal notranslate"><span class="pre">1.0</span></code>) do
+not collide.</p>
<p>Primitive type returns a hash and doesn’t have to handle depth.</p>
</dd></dl>
diff --git a/content/searchindex.js b/content/searchindex.js
index ca051207..a544beb7 100644
--- a/content/searchindex.js
+++ b/content/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{".with_cache() to specify caching behavior":[[43,"with-cache-to-specify-caching-behavior"]],"1 - Dynamically create modules within your notebook":[[58,"dynamically-create-modules-within-your-notebook"]],"1. Define steps":[[5,"define-steps"]],"1. Hard to read UI and data flows.":[[66,"hard-to-read-ui-and-data-flows"]],"1. Importing the extension":[[45,"importing-the-extension"]],"1. Programmatically":[[45,"programmatically"]],"1. Reuse a function module acros [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{".with_cache() to specify caching behavior":[[43,"with-cache-to-specify-caching-behavior"]],"1 - Dynamically create modules within your notebook":[[58,"dynamically-create-modules-within-your-notebook"]],"1. Define steps":[[5,"define-steps"]],"1. Hard to read UI and data flows.":[[66,"hard-to-read-ui-and-data-flows"]],"1. Importing the extension":[[45,"importing-the-extension"]],"1. Programmatically":[[45,"programmatically"]],"1. Reuse a function module acros [...]
\ No newline at end of file