rapidstr2int 1.0.0__tar.gz

rapidstr2int-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+# Ensure the binary test corpus ships in the source distribution (sdist).
+recursive-include tests *

rapidstr2int-1.0.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,14 @@
+# 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/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rapidstr2int"
+version = "1.0.0"
+description = "Fast dependency-free string to 32-bit integer hashing (FNV-1a)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.7"
+keywords = ["hash", "fnv", "fnv1a", "string", "integer", "uint32"]
+
+[tool.setuptools]
+py-modules = ["rapidstr2int"]

rapidstr2int-1.0.0/rapidstr2int.egg-info/PKG-INFO

@@ -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/rapidstr2int.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+MANIFEST.in
+README.md
+pyproject.toml
+rapidstr2int.py
+rapidstr2int.egg-info/PKG-INFO
+rapidstr2int.egg-info/SOURCES.txt
+rapidstr2int.egg-info/dependency_links.txt
+rapidstr2int.egg-info/top_level.txt
+tests/test_rapidstr2int.py

rapidstr2int-1.0.0/rapidstr2int.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rapidstr2int-1.0.0/rapidstr2int.egg-info/top_level.txt

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

rapidstr2int-1.0.0/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}"

rapidstr2int-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rapidstr2int-1.0.0/tests/test_rapidstr2int.py

@@ -0,0 +1,19 @@
+import glob
+import os
+
+from rapidstr2int import str_to_int, str_to_hex
+
+
+def test_known_vectors():
+    assert str_to_int("") == 0x811C9DC5
+    assert str_to_hex("hello") == "4f9f2cab"
+    assert str_to_hex("a") == "e40c292c"
+
+
+def test_corpus():
+    here = os.path.dirname(__file__)
+    for f in glob.glob(os.path.join(here, "*.bin")):
+        with open(f, "rb") as fh:
+            data = fh.read()
+        h = str_to_int(data.decode("latin1"))
+        assert 0 <= h <= 0xFFFFFFFF