halib 0.2.23__tar.gz → 0.2.27__tar.gz

{halib-0.2.23 → halib-0.2.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: halib
-Version: 0.2.23
+Version: 0.2.27
 Summary: Small library for common tasks
 Author: Hoang Van Ha
 Author-email: hoangvanhauit@gmail.com
@@ -56,7 +56,7 @@ Dynamic: summary
 
 ## v0.2.x (Experiment & Core Updates)
 
-### **v0.2.23**
+### **v0.2.27**
 - ✨ **New Feature:** Added `utils.dict.DictUtils` for advanced dictionary manipulations (merging, filtering, transforming).
 
 - ✨ **New Feature:** Added `common.common.pprint_stack_trace` to print stack traces with optional custom messages and force stop capability.

{halib-0.2.23 → halib-0.2.27}/README.md

@@ -2,7 +2,7 @@
 
 ## v0.2.x (Experiment & Core Updates)
 
-### **v0.2.23**
+### **v0.2.27**
 - ✨ **New Feature:** Added `utils.dict.DictUtils` for advanced dictionary manipulations (merging, filtering, transforming).
 
 - ✨ **New Feature:** Added `common.common.pprint_stack_trace` to print stack traces with optional custom messages and force stop capability.

{halib-0.2.23 → halib-0.2.27}/halib/utils/dict.py

@@ -1,5 +1,9 @@
+from pygments.token import Other
 from typing import Dict, Any, Callable, Optional
 from rich.pretty import pprint
+import json
+import hashlib
+
 
 class DictUtils:
     """
@@ -112,8 +116,26 @@ class DictUtils:
                 target = {}
         target[parts[-1]] = value
 
+    @staticmethod
+    def get_unique_hash(input_dict, length=12):
+        """
+        Returns a unique hash string for a dictionary.
 
-if __name__ == "__main__":
+        :param input_dict: The dictionary params
+        :param length: The desired length of the hash string (default 12)
+        """
+        assert length >= 12, "Hash length must be at least 12 to ensure uniqueness."
+        # 1. Sort keys to ensure {a:1, b:2} == {b:2, a:1}
+        config_str = json.dumps(input_dict, sort_keys=True)
+
+        # 2. Generate full SHA-256 hash (64 chars long)
+        full_hash = hashlib.sha256(config_str.encode("utf-8")).hexdigest()
+
+        # 3. Truncate to desired length
+        return full_hash[:length]
+
+
+def test_update():
     # --- Setup ---
     base_config = {
         "model": {
@@ -154,3 +176,28 @@ if __name__ == "__main__":
     # --- Deep Update (The Solution) ---
     pprint("Deep Update Result:")
     pprint(DictUtils.deep_update(b2, n2))
+
+
+def test_hash():
+    # --- Usage ---
+    cfg1 = {"learning_rate": 0.01, "batch_size": 32, "optimizer": "adam"}
+    cfg1_shuffle = {
+        "batch_size": 32,
+        "optimizer": "adam",
+        "learning_rate": 0.01,
+    }
+    cfg2 = {"learning_rate": 0.02, "batch_size": 32, "optimizer": "adam"}
+    hash1 = DictUtils.get_unique_hash(cfg1)
+    hash2 = DictUtils.get_unique_hash(cfg1_shuffle)
+    hash3 = DictUtils.get_unique_hash(cfg2)
+    pprint(f"Config 1 Hash: {hash1}")
+    pprint(f"Config 1_shuffle Hash: {hash2}")
+    pprint(f"Config 2 Hash: {hash3}")
+
+    assert hash1 == hash2, "Hashes should match for identical dicts."
+    assert hash1 != hash3, "Hashes should differ for different dicts."
+
+
+if __name__ == "__main__":
+    test_update()
+    test_hash()

{halib-0.2.23 → halib-0.2.27}/halib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: halib
-Version: 0.2.23
+Version: 0.2.27
 Summary: Small library for common tasks
 Author: Hoang Van Ha
 Author-email: hoangvanhauit@gmail.com
@@ -56,7 +56,7 @@ Dynamic: summary
 
 ## v0.2.x (Experiment & Core Updates)
 
-### **v0.2.23**
+### **v0.2.27**
 - ✨ **New Feature:** Added `utils.dict.DictUtils` for advanced dictionary manipulations (merging, filtering, transforming).
 
 - ✨ **New Feature:** Added `common.common.pprint_stack_trace` to print stack traces with optional custom messages and force stop capability.

{halib-0.2.23 → halib-0.2.27}/setup.py

@@ -8,7 +8,7 @@ with open("requirements.txt", "r", encoding="utf-8") as f:
 
 setuptools.setup(
     name="halib",
-    version="0.2.23",
+    version="0.2.27",
     author="Hoang Van Ha",
     author_email="hoangvanhauit@gmail.com",
     description="Small library for common tasks",