structtype 0.8.1__tar.gz → 0.9.0__tar.gz

{structtype-0.8.1 → structtype-0.9.0}/AGENTS.md

@@ -40,7 +40,9 @@ All commands go through `make`.
 ## Key API
 
 - `structtype.Struct` — base class with config options (frozen, tag, rename, etc.)
-- `structtype.Field` — field constraints (gt, ge, lt, le, min_length, etc.)
+- `structtype.Field` — field metadata (alias, title, description, examples, deprecated, json_schema_extra)
+- `structtype.Constraint` — base constraint (callable `fn`); subclasses: `NumericConstraint`, `StrConstraint`, `BytesConstraint`, `CollectionConstraint`, `TimezoneConstraint`
+- `structtype.Serializer` — custom-type load/dump codecs
 - `structtype.Raw` — lazy JSON passthrough
 - `structtype.fields(type_or_instance)` — get FieldInfo tuple for a struct type/instance
 - `structtype._inspect.type_info()` / `multi_type_info()` — type introspection
@@ -49,7 +51,7 @@ All commands go through `make`.
 
 - `obj.struct_dump_json(*, decimal_format=None, uuid_format=None, sort_keys=False)` — serialize to JSON bytes
 - `obj.struct_dump(*, sort_keys=False, str_keys=False, builtin_types=None)` — convert to built-in Python types (uses `alias` for keys)
-- `obj.struct_validate_self()` — validate field values against types + constraints
+- `obj.struct_check_types()` — validate field values against types + constraints (pure type-check, no conversion)
 - `cls.struct_validate_json(buf, *, strict=True)` — deserialize from JSON
 - `cls.struct_validate(obj, *, strict=True, from_attributes=False)` — convert built-in types to struct
 

{structtype-0.8.1/src/structtype.egg-info → structtype-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: structtype
-Version: 0.8.1
+Version: 0.9.0
 Summary: Fast Struct type with validation and JSON serialization for Python.
 Maintainer-email: Wolfgang Langner <tds333@mailbox.org>
 License-Expression: BSD-3-Clause

{structtype-0.8.1 → structtype-0.9.0}/src/structtype/__init__.py

@@ -4,22 +4,22 @@ from ._core import (  # type: ignore
     ALL_BUILTIN_TYPES,
     NODEFAULT,
     UNSET,
-    BytesValidator,
-    CollectionValidator,
+    BytesConstraint,
+    CollectionConstraint,
+    Constraint,
     DecodeError,
     EncodeError,
     Factory,
     Field,
-    NumericValidator,
+    NumericConstraint,
     Raw,
     Serializer,
+    StrConstraint,
     Struct,
     StructMeta,
-    StrValidator,
-    TimezoneValidator,
+    TimezoneConstraint,
     UnsetType,
     ValidationError,
-    Validator,
 )
 from ._inspect import FieldInfo, fields
 from ._json_schema import json_schema, json_schema_components, json_schema_dump
@@ -29,25 +29,25 @@ __all__ = [
     "ALL_BUILTIN_TYPES",
     "NODEFAULT",
     "UNSET",
-    "BytesValidator",
-    "CollectionValidator",
+    "BytesConstraint",
+    "CollectionConstraint",
+    "Constraint",
     "DecodeError",
     "EncodeError",
     "Factory",
     "Field",
     "FieldInfo",
-    "NumericValidator",
+    "NumericConstraint",
     "Raw",
     "Serializer",
-    "StrValidator",
+    "StrConstraint",
     "Struct",
     "StructAdapter",
     "StructConfig",
     "StructMeta",
-    "TimezoneValidator",
+    "TimezoneConstraint",
     "UnsetType",
     "ValidationError",
-    "Validator",
     "__version__",
     "fields",
     "json_schema",

{structtype-0.8.1 → structtype-0.9.0}/src/structtype/__init__.pyi

@@ -37,7 +37,7 @@ class StructConfig(TypedDict, total=False):
     repr_omit_defaults: bool
     omit_defaults: bool
     forbid_unknown_fields: bool
-    validate_on_init: bool
+    check_types_on_init: bool
     weakref: bool
     dict: bool
     cache_hash: bool
@@ -94,7 +94,7 @@ class Struct(metaclass=StructMeta):
         str_keys: bool = False,
         builtin_types: Iterable[type] | None = None,
     ) -> dict[str, Any] | list[Any]: ...
-    def struct_validate_self(self) -> None: ...
+    def struct_check_types(self) -> None: ...
     @classmethod
     def struct_validate_json(
         cls,
@@ -160,12 +160,12 @@ class Serializer:
     load: Final[Callable[[Any], Any] | None]
     dump: Final[Callable[[Any], Any] | None]
 
-class Validator:
+class Constraint:
     def __init__(self, fn: Callable[[Any], Any] | None = None) -> None: ...
     def __call__(self, value: Any) -> None: ...
 
 @final
-class NumericValidator(Validator):
+class NumericConstraint(Constraint):
     def __init__(
         self,
         *,
@@ -182,7 +182,7 @@ class NumericValidator(Validator):
     multiple_of: Final[int | float | None]
 
 @final
-class StrValidator(Validator):
+class StrConstraint(Constraint):
     def __init__(
         self,
         *,
@@ -195,7 +195,7 @@ class StrValidator(Validator):
     max_length: Final[int | None]
 
 @final
-class BytesValidator(Validator):
+class BytesConstraint(Constraint):
     def __init__(
         self,
         *,
@@ -206,7 +206,7 @@ class BytesValidator(Validator):
     max_length: Final[int | None]
 
 @final
-class CollectionValidator(Validator):
+class CollectionConstraint(Constraint):
     def __init__(
         self,
         *,
@@ -217,7 +217,7 @@ class CollectionValidator(Validator):
     max_length: Final[int | None]
 
 @final
-class TimezoneValidator(Validator):
+class TimezoneConstraint(Constraint):
     def __init__(self, *, tz: bool) -> None: ...
     tz: Final[bool]
 

{structtype-0.8.1 → structtype-0.9.0}/src/structtype/_config.py

@@ -17,7 +17,7 @@ class StructConfig(TypedDict, total=False):
     array_like: bool
     omit_defaults: bool
     forbid_unknown_fields: bool
-    validate_on_init: bool
+    check_types_on_init: bool
     weakref: bool
     dict: bool
     cache_hash: bool