schemez 0.2.4__py3-none-any.whl → 0.3.0__py3-none-any.whl

schemez/__init__.py

@@ -1,5 +1,20 @@
-__version__ = "0.2.4"
+"""Schemez: main package.
 
+Pydantic shim for config stuff.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import version
+
+__version__ = version("schemez")
+__title__ = "Schemez"
+
+__author__ = "Philipp Temminghoff"
+__author_email__ = "philipptemminghoff@googlemail.com"
+__copyright__ = "Copyright (c) 2025 Philipp Temminghoff"
+__license__ = "MIT"
+__url__ = "https://github.com/phil65/schemez"
 
 from schemez.schema import Schema
 from schemez.code import PythonCode, JSONCode, TOMLCode, YAMLCode
@@ -11,6 +26,8 @@ from schemez.schemadef.schemadef import (
 )
 from schemez.pydantic_types import ModelIdentifier, ModelTemperature, MimeType
 
+__version__ = version("schemez")
+
 __all__ = [
     "ImportedSchemaDef",
     "InlineSchemaDef",

schemez/pydantic_types.py

@@ -2,9 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Any
+from typing import TYPE_CHECKING, Annotated, Any
 
-from pydantic import BaseModel, Field
+from pydantic import Field
+
+
+if TYPE_CHECKING:
+    from pydantic import BaseModel
 
 
 ModelIdentifier = Annotated[

schemez/schemadef/schemadef.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from enum import Enum
 from typing import Annotated, Any, Literal
 
-from pydantic import BaseModel, Field, create_model
+from pydantic import BaseModel, Field, create_model, field_validator
 
 from schemez import Schema, helpers
 
@@ -18,6 +18,7 @@ class SchemaField(Schema):
     - Optional description
     - Validation constraints
     - Enum values (when type is 'enum')
+    - Field dependencies and relationships
 
     Used by InlineSchemaDef to structure response fields.
     """
@@ -31,7 +32,6 @@ class SchemaField(Schema):
     values: list[Any] | None = None
     """Values for enum type fields"""
 
-    # Common validation constraints
     default: Any | None = None
     """Default value for the field"""
 
@@ -41,10 +41,10 @@ class SchemaField(Schema):
     pattern: str | None = None
     """Regex pattern for string validation"""
 
-    min_length: int | None = None
+    min_length: Annotated[int | None, Field(ge=0)] = None
     """Minimum length for collections"""
 
-    max_length: int | None = None
+    max_length: Annotated[int | None, Field(ge=0)] = None
     """Maximum length for collections"""
 
     gt: float | None = None
@@ -59,7 +59,7 @@ class SchemaField(Schema):
     le: float | None = None
     """Less than or equal (inclusive) validation for numbers"""
 
-    multiple_of: float | None = None
+    multiple_of: Annotated[float | None, Field(gt=0)] = None
     """Number must be a multiple of this value"""
 
     literal_value: Any | None = None
@@ -77,10 +77,55 @@ class SchemaField(Schema):
     field_config: dict[str, Any] | None = None
     """Configuration for Pydantic model fields"""
 
+    # Dependencies between fields
+    dependent_required: dict[str, list[str]] = Field(default_factory=dict)
+    """Field dependencies - when this field exists, dependent fields are required"""
+
+    dependent_schema: dict[str, dict[str, Any]] = Field(default_factory=dict)
+    """Schema dependencies - when this field exists, dependent fields must match schema"""
+
     # Extensibility for future or custom constraints
     constraints: dict[str, Any] = Field(default_factory=dict)
     """Additional constraints not covered by explicit fields"""
 
+    def add_required_dependency(
+        self, field_name: str, required_fields: list[str]
+    ) -> None:
+        """Add a dependency requiring other fields when this field exists.
+
+        Args:
+            field_name: The field that triggers the dependency
+            required_fields: Fields that become required when field_name exists
+        """
+        if field_name not in self.dependent_required:
+            self.dependent_required[field_name] = []
+        self.dependent_required[field_name].extend([
+            field
+            for field in required_fields
+            if field not in self.dependent_required[field_name]
+        ])
+
+    def add_schema_dependency(self, field_name: str, schema: dict[str, Any]) -> None:
+        """Add a schema dependency when this field exists.
+
+        Args:
+            field_name: The field that triggers the dependency
+            schema: JSON Schema to apply when field_name exists
+        """
+        self.dependent_schema[field_name] = schema
+
+    @field_validator("max_length")
+    @classmethod
+    def validate_max_min_length(cls, v: int | None, info) -> int | None:
+        if (
+            v is not None
+            and info.data.get("min_length") is not None
+            and v < info.data.get("min_length")
+        ):
+            msg = "max_length must be ≥ min_length"
+            raise ValueError(msg)
+        return v
+
 
 class BaseSchemaDef(Schema):
     """Base class for response definitions."""
@@ -98,14 +143,21 @@ class InlineSchemaDef(BaseSchemaDef):
     - Field definitions with types and descriptions
     - Optional validation constraints
     - Custom field descriptions
+    - Field dependencies and relationships
 
     Example:
-        schemas:
-          BasicResult:
-            type: inline
-            fields:
-              success: {type: bool, description: "Operation success"}
-              message: {type: str, description: "Result details"}
+        type: inline
+        fields:
+            success: {type: bool, description: "Operation success"}
+            message: {type: str, description: "Result details"}
+            payment_method: {type: str, description: "Payment method used"}
+            card_number: {
+                type: str,
+                description: "Credit card number",
+                dependent_required: {
+                "payment_method": ["card_expiry", "card_cvc"]
+                }
+            }
     """
 
     type: Literal["inline"] = Field("inline", init=False)
@@ -114,12 +166,49 @@ class InlineSchemaDef(BaseSchemaDef):
     fields: dict[str, SchemaField]
     """A dictionary containing all fields."""
 
+    def add_field_dependency(
+        self, field_name: str, dependent_on: str, required_fields: list[str]
+    ) -> None:
+        """Add a dependency between fields.
+
+        Args:
+            field_name: The field where to add the dependency
+            dependent_on: The field that triggers the dependency
+            required_fields: Fields that become required when the dependency is triggered
+        """
+        if field_name not in self.fields:
+            msg = f"Field '{field_name}' not found in schema"
+            raise ValueError(msg)
+
+        field = self.fields[field_name]
+        field.add_required_dependency(dependent_on, required_fields)
+
+    def add_schema_dependency(
+        self, field_name: str, dependent_on: str, schema: dict[str, Any]
+    ) -> None:
+        """Add a schema dependency between fields.
+
+        Args:
+            field_name: The field where to add the dependency
+            dependent_on: The field that triggers the dependency
+            schema: JSON Schema to apply when dependent_on exists
+        """
+        if field_name not in self.fields:
+            msg = f"Field '{field_name}' not found in schema"
+            raise ValueError(msg)
+
+        field = self.fields[field_name]
+        field.add_schema_dependency(dependent_on, schema)
+
     def get_schema(self) -> type[BaseModel]:  # type: ignore
         """Create Pydantic model from inline definition."""
         fields = {}
+        model_dependencies: dict[str, dict[str, Any]] = {}
+
+        # First pass: collect all field information
         for name, field in self.fields.items():
             # Initialize constraint dictionary
-            field_constraints = {}
+            field_constraints: dict[str, Any] = {}
 
             # Handle enum type
             if field.type == "enum":
@@ -203,20 +292,82 @@ class InlineSchemaDef(BaseSchemaDef):
             if field.json_schema_extra:
                 field_constraints["json_schema_extra"] = field.json_schema_extra
 
+            # Handle field dependencies
+            if field.dependent_required or field.dependent_schema:
+                if field.json_schema_extra is None:
+                    field_constraints["json_schema_extra"] = {}
+
+                json_extra = field_constraints.get("json_schema_extra", {})
+
+                if field.dependent_required:
+                    if "dependentRequired" not in json_extra:
+                        json_extra["dependentRequired"] = {}
+                    json_extra["dependentRequired"].update(field.dependent_required)
+
+                if field.dependent_schema:
+                    if "dependentSchemas" not in json_extra:
+                        json_extra["dependentSchemas"] = {}
+                    json_extra["dependentSchemas"].update(field.dependent_schema)
+
+                field_constraints["json_schema_extra"] = json_extra
+
             # Add any additional constraints
             field_constraints.update(field.constraints)
 
             field_info = Field(description=field.description, **field_constraints)
             fields[name] = (python_type, field_info)
 
+            # Collect model-level dependencies for JSON Schema
+            if field.dependent_required or field.dependent_schema:
+                if not model_dependencies:
+                    model_dependencies = {"json_schema_extra": {}}
+
+                if field.dependent_required:
+                    if "dependentRequired" not in model_dependencies["json_schema_extra"]:
+                        model_dependencies["json_schema_extra"]["dependentRequired"] = {}
+                    model_dependencies["json_schema_extra"]["dependentRequired"].update(
+                        field.dependent_required
+                    )
+
+                if field.dependent_schema:
+                    if "dependentSchemas" not in model_dependencies["json_schema_extra"]:
+                        model_dependencies["json_schema_extra"]["dependentSchemas"] = {}
+                    model_dependencies["json_schema_extra"]["dependentSchemas"].update(
+                        field.dependent_schema
+                    )
+
+        # Create the model class with field definitions
         cls_name = self.description or "ResponseType"
-        return create_model(
+        model = create_model(
             cls_name,
             **fields,
             __base__=BaseModel,
             __doc__=self.description,
         )  # type: ignore[call-overload]
 
+        # Add model-level JSON Schema extras for dependencies
+        if model_dependencies:
+            if not hasattr(model, "model_config") or not model.model_config:
+                model.model_config = {}
+
+            if "json_schema_extra" not in model.model_config:
+                model.model_config["json_schema_extra"] = {}
+
+            schema_extra = model.model_config["json_schema_extra"]
+
+            if "dependentRequired" in model_dependencies["json_schema_extra"]:
+                schema_extra["dependentRequired"] = model_dependencies[
+                    "json_schema_extra"
+                ]["dependentRequired"]
+
+            if "dependentSchemas" in model_dependencies["json_schema_extra"]:
+                schema_extra["dependentSchemas"] = model_dependencies[
+                    "json_schema_extra"
+                ]["dependentSchemas"]
+
+        # Return the created model
+        return model
+
 
 class ImportedSchemaDef(BaseSchemaDef):
     """Response definition that imports an existing Pydantic model.

{schemez-0.2.4.dist-info → schemez-0.3.0.dist-info}/METADATA

@@ -1,36 +1,32 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: schemez
-Version: 0.2.4
+Version: 0.3.0
 Summary: Pydantic shim for config stuff
-Project-URL: Documentation, https://phil65.github.io/schemez/
-Project-URL: Source, https://github.com/phil65/schemez
-Project-URL: Issues, https://github.com/phil65/schemez/issues
-Project-URL: Discussions, https://github.com/phil65/schemez/discussions
-Project-URL: Code coverage, https://app.codecov.io/gh/phil65/schemez
+Keywords: 
+Author: Philipp Temminghoff
 Author-email: Philipp Temminghoff <philipptemminghoff@googlemail.com>
 License: MIT License
-        
-        Copyright (c) 2024, Philipp Temminghoff
-        
-        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.
-        
-License-File: LICENSE
+         
+         Copyright (c) 2024, Philipp Temminghoff
+         
+         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.
+         
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pydantic
 Classifier: Framework :: Pydantic :: 2
@@ -45,23 +41,26 @@ Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.12
 Requires-Dist: griffe>=1.7.3
 Requires-Dist: pydantic
 Requires-Dist: universal-pathlib>=0.2.6
+Requires-Dist: llmling-agent ; extra == 'ai'
+Requires-Dist: anyenv>=0.4.14 ; extra == 'ai'
+Requires-Dist: yamling ; extra == 'yaml'
+Requires-Python: >=3.12
+Project-URL: Code coverage, https://app.codecov.io/gh/phil65/schemez
+Project-URL: Discussions, https://github.com/phil65/schemez/discussions
+Project-URL: Documentation, https://phil65.github.io/schemez/
+Project-URL: Issues, https://github.com/phil65/schemez/issues
+Project-URL: Source, https://github.com/phil65/schemez
 Provides-Extra: ai
-Requires-Dist: anyenv>=0.4.14; extra == 'ai'
-Requires-Dist: llmling-agent; extra == 'ai'
 Provides-Extra: yaml
-Requires-Dist: yamling; extra == 'yaml'
 Description-Content-Type: text/markdown
 
 # Schemez
 
 [![PyPI License](https://img.shields.io/pypi/l/schemez.svg)](https://pypi.org/project/schemez/)
 [![Package status](https://img.shields.io/pypi/status/schemez.svg)](https://pypi.org/project/schemez/)
-[![Daily downloads](https://img.shields.io/pypi/dd/schemez.svg)](https://pypi.org/project/schemez/)
-[![Weekly downloads](https://img.shields.io/pypi/dw/schemez.svg)](https://pypi.org/project/schemez/)
 [![Monthly downloads](https://img.shields.io/pypi/dm/schemez.svg)](https://pypi.org/project/schemez/)
 [![Distribution format](https://img.shields.io/pypi/format/schemez.svg)](https://pypi.org/project/schemez/)
 [![Wheel availability](https://img.shields.io/pypi/wheel/schemez.svg)](https://pypi.org/project/schemez/)
@@ -79,12 +78,8 @@ Description-Content-Type: text/markdown
 [![Github last commit](https://img.shields.io/github/last-commit/phil65/schemez)](https://github.com/phil65/schemez/commits)
 [![Github release date](https://img.shields.io/github/release-date/phil65/schemez)](https://github.com/phil65/schemez/releases)
 [![Github language count](https://img.shields.io/github/languages/count/phil65/schemez)](https://github.com/phil65/schemez)
-[![Github commits this week](https://img.shields.io/github/commit-activity/w/phil65/schemez)](https://github.com/phil65/schemez)
 [![Github commits this month](https://img.shields.io/github/commit-activity/m/phil65/schemez)](https://github.com/phil65/schemez)
-[![Github commits this year](https://img.shields.io/github/commit-activity/y/phil65/schemez)](https://github.com/phil65/schemez)
 [![Package status](https://codecov.io/gh/phil65/schemez/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/schemez/)
-[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![PyUp](https://pyup.io/repos/github/phil65/schemez/shield.svg)](https://pyup.io/repos/github/phil65/schemez/)
 
 [Read the documentation!](https://phil65.github.io/schemez/)
-

schemez-0.3.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+schemez/__init__.py,sha256=iDo1ZpV07BUOmRmISV6QDA8s3viJR5V1NnrBsdw6eVM,985
+schemez/code.py,sha256=usZLov9i5KpK1W2VJxngUzeetgrINtodiooG_AxN-y4,2072
+schemez/convert.py,sha256=b6Sz11lq0HvpXfMREOqnnw8rcVg2XzTKhjjPNc4YIoE,4403
+schemez/docstrings.py,sha256=kmd660wcomXzKac0SSNYxPRNbVCUovrpmE9jwnVRS6c,4115
+schemez/helpers.py,sha256=Ee3wvFbt65ljhWDFdb6ACVUJK4KLjJFVzl4Le75pOBQ,5159
+schemez/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+schemez/pydantic_types.py,sha256=8vgSl8i2z9n0fB-8AJj-D3TBByEWE5IxItBxQ0XwXFI,1640
+schemez/schema.py,sha256=VeNSFec6aCR9GgqXLBE3t4TZeUoS9BDmIoofe9nbqVI,8804
+schemez/schemadef/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+schemez/schemadef/schemadef.py,sha256=m4m6f24xEgJgkp7jhp-6TpfLcwkVLL3WmKF9zDRhwAM,15091
+schemez-0.3.0.dist-info/WHEEL,sha256=n2u5OFBbdZvCiUKAmfnY1Po2j3FB_NWfuUlt5WiAjrk,79
+schemez-0.3.0.dist-info/METADATA,sha256=IQqDc_jIBQ8BepGQ3uRT_1FKNg21x-tLKzqbXUE5b90,5359
+schemez-0.3.0.dist-info/RECORD,,

schemez-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.23
+Root-Is-Purelib: true
+Tag: py3-none-any

schemez-0.2.4.dist-info/RECORD

@@ -1,14 +0,0 @@
-schemez/__init__.py,sha256=q23JyNo20vslOAU0BXRZkfYba4iLGMSMQ7zs7t-4oFA,565
-schemez/code.py,sha256=usZLov9i5KpK1W2VJxngUzeetgrINtodiooG_AxN-y4,2072
-schemez/convert.py,sha256=b6Sz11lq0HvpXfMREOqnnw8rcVg2XzTKhjjPNc4YIoE,4403
-schemez/docstrings.py,sha256=kmd660wcomXzKac0SSNYxPRNbVCUovrpmE9jwnVRS6c,4115
-schemez/helpers.py,sha256=Ee3wvFbt65ljhWDFdb6ACVUJK4KLjJFVzl4Le75pOBQ,5159
-schemez/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-schemez/pydantic_types.py,sha256=iiaHqVkWVd1TZry933aDYJnyzMD0HJIABfROR9txxhA,1581
-schemez/schema.py,sha256=VeNSFec6aCR9GgqXLBE3t4TZeUoS9BDmIoofe9nbqVI,8804
-schemez/schemadef/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-schemez/schemadef/schemadef.py,sha256=LTl6aRS-xovwUv-HWQ7UMZk_k4Jg9MjzVTpZswUplIE,8674
-schemez-0.2.4.dist-info/METADATA,sha256=1SjSzieIJhza0YqDjjrOaTRBtDmUWjs9JR5wq1AzMnc,5891
-schemez-0.2.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-schemez-0.2.4.dist-info/licenses/LICENSE,sha256=AteGCH9r177TxxrOFEiOARrastASsf7yW6MQxlAHdwA,1078
-schemez-0.2.4.dist-info/RECORD,,

schemez-0.2.4.dist-info/WHEEL

@@ -1,4 +0,0 @@
-Wheel-Version: 1.0
-Generator: hatchling 1.27.0
-Root-Is-Purelib: true
-Tag: py3-none-any

schemez-0.2.4.dist-info/licenses/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) 2024, Philipp Temminghoff
-
-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.
-