rapidstr2int 1.0.0__py3-none-any.whl

rapidstr2int-1.0.0.dist-info/METADATA

@@ -0,0 +1,23 @@
+Metadata-Version: 2.4
+Name: rapidstr2int
+Version: 1.0.0
+Summary: Fast dependency-free string to 32-bit integer hashing (FNV-1a)
+License: MIT
+Keywords: hash,fnv,fnv1a,string,integer,uint32
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# rapidstr2int (Python)
+
+Fast, dependency-free **string → 32-bit unsigned integer** hashing (FNV-1a over
+UTF-8 bytes). Deterministic and stable across platforms.
+
+```python
+from rapidstr2int import str_to_int, str_to_hex
+str_to_int("hello")  # 1335831723
+str_to_hex("hello")  # "4f9f2cab"
+```
+
+Useful for hash tables, shard/bucket keys, bloom filters and cache keys.
+
+Binary fixtures under `tests/` are exercised by the test suite as an input corpus.

rapidstr2int-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+rapidstr2int.py,sha256=SZIVezyCo8Zu8D-CTIGKDLamh3J-tUgN_nVC0iv-q5E,746
+rapidstr2int-1.0.0.dist-info/METADATA,sha256=QliJvyu2ulEld8vxVs8WTiRF_CYTezs5ydERJ778J98,705
+rapidstr2int-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+rapidstr2int-1.0.0.dist-info/top_level.txt,sha256=zAjywA53iAOXW3c1VXtMwCf_UpKkRWf0ev07bLMybFM,13
+rapidstr2int-1.0.0.dist-info/RECORD,,

rapidstr2int-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

rapidstr2int-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+rapidstr2int

rapidstr2int.py

@@ -0,0 +1,26 @@
+"""rapidstr2int — fast, dependency-free string -> 32-bit unsigned integer hashing.
+
+Implements FNV-1a (Fowler-Noll-Vo) over the UTF-8 bytes of the input. Deterministic
+and stable across platforms; useful for hash tables, shard keys, bloom filters and
+cache bucketing.
+"""
+
+_FNV_OFFSET = 0x811C9DC5
+_FNV_PRIME = 0x01000193
+_MASK = 0xFFFFFFFF
+
+__all__ = ["str_to_int", "str_to_hex"]
+
+
+def str_to_int(s: str) -> int:
+    """Hash a string to a 32-bit unsigned integer (FNV-1a over UTF-8 bytes)."""
+    h = _FNV_OFFSET
+    for b in s.encode("utf-8"):
+        h ^= b
+        h = (h * _FNV_PRIME) & _MASK
+    return h
+
+
+def str_to_hex(s: str) -> str:
+    """Same hash as a fixed-width 8-char lowercase hex string."""
+    return f"{str_to_int(s):08x}"