dhi 1.1.1__cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

dhi/validator.py

@@ -0,0 +1,212 @@
+"""
+Core validation classes for dhi
+"""
+
+import ctypes
+import os
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+# Try to import native extension first (fastest)
+try:
+    from . import _dhi_native
+    HAS_NATIVE_EXT = True
+except ImportError:
+    HAS_NATIVE_EXT = False
+    _dhi_native = None
+
+
+class ValidationError(Exception):
+    """Single validation error"""
+    def __init__(self, field: str, message: str):
+        self.field = field
+        self.message = message
+        super().__init__(f"{field}: {message}")
+
+
+class ValidationErrors(Exception):
+    """Multiple validation errors"""
+    def __init__(self, errors: List[ValidationError]):
+        self.errors = errors
+        messages = "\n".join(str(e) for e in errors)
+        super().__init__(f"Validation failed:\n{messages}")
+
+
+class BoundedInt:
+    """Integer with min/max bounds validation"""
+    
+    def __init__(self, min_val: int, max_val: int):
+        self.min_val = min_val
+        self.max_val = max_val
+    
+    def validate(self, value: int) -> int:
+        """Validate integer is within bounds"""
+        if not isinstance(value, int):
+            raise ValidationError("value", f"Expected int, got {type(value).__name__}")
+        
+        # Use native extension (fastest) or ctypes (fast) or pure Python (fallback)
+        if HAS_NATIVE_EXT:
+            if not _dhi_native.validate_int(value, self.min_val, self.max_val):
+                if value < self.min_val:
+                    raise ValidationError("value", f"Value {value} must be >= {self.min_val}")
+                else:
+                    raise ValidationError("value", f"Value {value} must be <= {self.max_val}")
+        elif _zig.available:
+            if not _zig.validate_int(value, self.min_val, self.max_val):
+                if value < self.min_val:
+                    raise ValidationError("value", f"Value {value} must be >= {self.min_val}")
+                else:
+                    raise ValidationError("value", f"Value {value} must be <= {self.max_val}")
+        else:
+            # Fallback to pure Python
+            if value < self.min_val:
+                raise ValidationError("value", f"Value {value} must be >= {self.min_val}")
+            
+            if value > self.max_val:
+                raise ValidationError("value", f"Value {value} must be <= {self.max_val}")
+        
+        return value
+    
+    def __call__(self, value: int) -> int:
+        """Allow using as a callable validator"""
+        return self.validate(value)
+
+
+class BoundedString:
+    """String with length bounds validation"""
+    
+    def __init__(self, min_len: int, max_len: int):
+        self.min_len = min_len
+        self.max_len = max_len
+    
+    def validate(self, value: str) -> str:
+        """Validate string length is within bounds"""
+        if not isinstance(value, str):
+            raise ValidationError("value", f"Expected str, got {type(value).__name__}")
+        
+        # Use native extension (fastest) or ctypes (fast) or pure Python (fallback)
+        if HAS_NATIVE_EXT:
+            if not _dhi_native.validate_string_length(value, self.min_len, self.max_len):
+                if len(value) < self.min_len:
+                    raise ValidationError("value", f"String length {len(value)} must be >= {self.min_len}")
+                else:
+                    raise ValidationError("value", f"String length {len(value)} must be <= {self.max_len}")
+        elif _zig.available:
+            if not _zig.validate_string_length(value, self.min_len, self.max_len):
+                if len(value) < self.min_len:
+                    raise ValidationError("value", f"String length {len(value)} must be >= {self.min_len}")
+                else:
+                    raise ValidationError("value", f"String length {len(value)} must be <= {self.max_len}")
+        else:
+            # Fallback to pure Python
+            if len(value) < self.min_len:
+                raise ValidationError("value", f"String length {len(value)} must be >= {self.min_len}")
+            
+            if len(value) > self.max_len:
+                raise ValidationError("value", f"String length {len(value)} must be <= {self.max_len}")
+        
+        return value
+    
+    def __call__(self, value: str) -> str:
+        """Allow using as a callable validator"""
+        return self.validate(value)
+
+
+class Email:
+    """Email format validation"""
+    
+    @staticmethod
+    def validate(value: str) -> str:
+        """Validate email format (simple check)"""
+        if not isinstance(value, str):
+            raise ValidationError("value", f"Expected str, got {type(value).__name__}")
+        
+        # Use native extension (fastest) or ctypes (fast) or pure Python (fallback)
+        if HAS_NATIVE_EXT:
+            if not _dhi_native.validate_email(value):
+                raise ValidationError("value", "Invalid email format (expected: local@domain)")
+        elif _zig.available:
+            if not _zig.validate_email(value):
+                raise ValidationError("value", "Invalid email format (expected: local@domain)")
+        else:
+            # Fallback to pure Python
+            if "@" not in value or "." not in value.split("@")[-1]:
+                raise ValidationError("value", "Invalid email format (expected: local@domain)")
+        
+        return value
+    
+    @staticmethod
+    def __call__(value: str) -> str:
+        """Allow using as a callable validator"""
+        return Email.validate(value)
+
+
+# TODO: Load Zig shared library for native performance
+# This is a pure Python implementation for now
+# Future: Use ctypes to call into libsatya.so for 100x+ speedup
+
+class _ZigValidator:
+    """Native Zig validator"""
+    
+    def __init__(self):
+        self._lib = None
+        self._try_load_native()
+    
+    def _try_load_native(self):
+        """Try to load native Zig library"""
+        lib_path = Path(__file__).parent.parent.parent / "zig-out" / "lib"
+        
+        # Try different library names
+        for name in ["libsatya.dylib", "libsatya.so", "satya.dll"]:
+            full_path = lib_path / name
+            if full_path.exists():
+                try:
+                    self._lib = ctypes.CDLL(str(full_path))
+                    
+                    # Define function signatures
+                    self._lib.satya_validate_int.argtypes = [ctypes.c_int64, ctypes.c_int64, ctypes.c_int64]
+                    self._lib.satya_validate_int.restype = ctypes.c_int32
+                    
+                    self._lib.satya_validate_string_length.argtypes = [ctypes.c_char_p, ctypes.c_size_t, ctypes.c_size_t]
+                    self._lib.satya_validate_string_length.restype = ctypes.c_int32
+                    
+                    self._lib.satya_validate_email.argtypes = [ctypes.c_char_p]
+                    self._lib.satya_validate_email.restype = ctypes.c_int32
+                    
+                    self._lib.satya_version.argtypes = []
+                    self._lib.satya_version.restype = ctypes.c_char_p
+                    
+                    version = self._lib.satya_version().decode('utf-8')
+                    print(f"✅ Loaded native Zig library v{version}: {name}")
+                    return
+                except Exception as e:
+                    print(f"⚠️  Failed to load {name}: {e}")
+        
+        print("ℹ️  Using pure Python implementation (slower)")
+    
+    @property
+    def available(self) -> bool:
+        """Check if native library is available"""
+        return self._lib is not None
+    
+    def validate_int(self, value: int, min_val: int, max_val: int) -> bool:
+        """Validate integer using native Zig"""
+        if not self.available:
+            return min_val <= value <= max_val
+        return bool(self._lib.satya_validate_int(value, min_val, max_val))
+    
+    def validate_string_length(self, value: str, min_len: int, max_len: int) -> bool:
+        """Validate string length using native Zig"""
+        if not self.available:
+            return min_len <= len(value) <= max_len
+        return bool(self._lib.satya_validate_string_length(value.encode('utf-8'), min_len, max_len))
+    
+    def validate_email(self, value: str) -> bool:
+        """Validate email using native Zig"""
+        if not self.available:
+            return "@" in value and "." in value.split("@")[-1]
+        return bool(self._lib.satya_validate_email(value.encode('utf-8')))
+
+
+# Global instance
+_zig = _ZigValidator()

dhi-1.1.1.dist-info/METADATA

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: dhi
+Version: 1.1.1
+Summary: Ultra-fast data validation for Python - 28M validations/sec, 3x faster than Rust alternatives
+Author-email: Rach Pradhan <rach@rachpradhan.com>
+License: MIT
+Project-URL: Homepage, https://github.com/justrach/satya-zig
+Project-URL: Documentation, https://github.com/justrach/satya-zig#readme
+Project-URL: Repository, https://github.com/justrach/satya-zig
+Project-URL: Issues, https://github.com/justrach/satya-zig/issues
+Keywords: validation,data-validation,pydantic,zig,performance,fast,validator,email,url,uuid,schema
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Other
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-benchmark>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# dhi - Ultra-Fast Data Validation for Python
+
+**The fastest data validation library for Python.** Powered by Zig for maximum performance.
+
+## 🚀 Performance
+
+**28 million validations/sec** - 3x faster than satya (Rust), 3x faster than msgspec (C)
+
+```python
+# Validate 10,000 users in 0.36ms
+from dhi import _dhi_native
+
+users = [{"name": "Alice", "email": "alice@example.com", "age": 25}, ...]
+
+field_specs = {
+    'name': ('string', 2, 100),
+    'email': ('email',),
+    'age': ('int_positive',),
+}
+
+results, valid_count = _dhi_native.validate_batch_direct(users, field_specs)
+# 28M users/sec! 🔥
+```
+
+## ✨ Features
+
+- **�� Fastest**: 3x faster than satya (Rust) and msgspec (C)
+- **🎯 24+ Validators**: Email, URL, UUID, IPv4, dates, numbers, strings
+- **🔋 Zero Python Overhead**: C extension extracts directly from dicts
+- **🌍 General Purpose**: Works with any dict structure
+- **💪 Production Ready**: Thoroughly tested and benchmarked
+
+## 📦 Installation
+
+```bash
+pip install dhi
+```
+
+## 🎯 Quick Start
+
+```python
+from dhi import _dhi_native
+
+users = [
+    {"name": "Alice", "email": "alice@example.com", "age": 25},
+    {"name": "Bob", "email": "bob@example.com", "age": 30},
+]
+
+field_specs = {
+    'name': ('string', 2, 100),
+    'email': ('email',),
+    'age': ('int_positive',),
+}
+
+results, valid_count = _dhi_native.validate_batch_direct(users, field_specs)
+print(f"Valid: {valid_count}/{len(users)}")
+```
+
+## �� Available Validators
+
+### String: `email`, `url`, `uuid`, `ipv4`, `base64`, `iso_date`, `iso_datetime`, `string`
+### Number: `int`, `int_gt`, `int_gte`, `int_lt`, `int_lte`, `int_positive`, `int_non_negative`, `int_multiple_of`
+
+## 🏆 Benchmarks
+
+```
+dhi:     28M users/sec  🥇
+satya:    9M users/sec  (3.0x slower)
+msgspec:  9M users/sec  (3.1x slower)
+```
+
+## 📝 License
+
+MIT License - see LICENSE file
+
+## 🔗 Links
+
+- GitHub: https://github.com/justrach/satya-zig
+- PyPI: https://pypi.org/project/dhi/

dhi-1.1.1.dist-info/RECORD

@@ -0,0 +1,21 @@
+dhi/batch.py,sha256=fBCCF4Eo3oU4ppXrZaCm4rwFDDa6iM1F3htzhKj02xY,7216
+dhi/functional_validators.py,sha256=2-VTl8nX-DNpDUvOjzfevbJj5AAmc1MhdfAcTncmy8o,2966
+dhi/_dhi_native.cpython-313-aarch64-linux-gnu.so,sha256=iBt4y3FddvhOufom13RYU_AEM7NiOxhuTeyusHKlHzs,198049
+dhi/special_types.py,sha256=jInp2NijeTxj7ZVjtU00ZZUmV4DPeWAN8rlm4dbdaXk,12525
+dhi/fields.py,sha256=vn1lKortQgxBe0KnLOhjFBmKUbDNxi7lvNv0kjVLYtc,6067
+dhi/networks.py,sha256=CmspeR3GuBHzoWH2q2FqFuqrMKGK3DtO_V-TO826B3g,10123
+dhi/types.py,sha256=zvDFdy9k9kUsL-5yQ3YJpX-QoZWcW7sv1GQUVcCtZxg,9885
+dhi/validator.py,sha256=suqs8mF1lZ2-KzjF8gIHNt5X4kAbrupTMd1Lxpyx06Y,8453
+dhi/libsatya.so,sha256=oi2Y9AFxPR2bJYAm0jb7oPeM_ac9ZSdwjKst3FU0bOc,89848
+dhi/secret.py,sha256=hCWQ9gLLNxDxwEOtxMVOZ0TDkmtGDRfz6bNu3N_c3EE,2896
+dhi/datetime_types.py,sha256=C0Gq9gW6gvv2U6dYTcqCNkkDHqNzqPbaqfQG2xL3GKQ,3786
+dhi/model.py,sha256=-oP338Q5udfuar5n24ro5J9cDQDNw94VwcsKLkbKcVA,25532
+dhi/_native.c,sha256=zWEXy3O0dMaPBTLBkh1k9efez5-CN9hTmYGrBWpL-W4,14316
+dhi/__init__.py,sha256=aU-_6BemI32y5Bs0HFFv-_2vCcn8zzJ2BQwa9anvyl8,4752
+dhi/constraints.py,sha256=pzzFbfoQzSx-y-RAvM5PfINHoQOGg6V545LajxZpDKA,10683
+dhi.libs/libsatya-a22d98f4.so,sha256=SexQ3zPPR65XiDZxajyF99pKqkWSMJNv_Tq4McPcCmg,133105
+dhi-1.1.1.dist-info/WHEEL,sha256=wXgLOoUZn6w376EcY-MIDI9QZ4oT7tzW-k6jucYkm10,154
+dhi-1.1.1.dist-info/top_level.txt,sha256=iq71wPTnUMM4ZJ61Eg64c1msSlpnWAiWz66ZpD6ohLs,4
+dhi-1.1.1.dist-info/METADATA,sha256=DtQQdaNTsr0XgbWBb2-ua-4sTRh2CGKYeLnUzeb1UkE,3605
+dhi-1.1.1.dist-info/RECORD,,
+dhi-1.1.1.dist-info/licenses/LICENSE,sha256=5NTWM6gyO_xYeJfEx0dbtR4g0g2axgUpCykd_BfCb8s,1069

dhi-1.1.1.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: false
+Tag: cp313-cp313-manylinux_2_17_aarch64
+Tag: cp313-cp313-manylinux2014_aarch64
+

dhi-1.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rach Pradhan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dhi-1.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+dhi