pydantic-json-patch 0.6.2__tar.gz → 0.6.3__tar.gz

{pydantic_json_patch-0.6.2 → pydantic_json_patch-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydantic_json_patch
-Version: 0.6.2
+Version: 0.6.3
 Summary: Pydantic models for implementing JSON Patch.
 Author: Jonathan Sharpe
 Author-email: Jonathan Sharpe <mail@jonrshar.pe>
@@ -176,7 +176,10 @@ def _(
     ...
 ```
 
-**Note**: explicitly specifying the [discriminator][pydantic-discriminator] gives better results on _failed_ validation for unions of operations.
+**Notes**:
+
+- Explicitly specifying the [discriminator][pydantic-discriminator] gives better results on _failed_ validation for unions of operations; and
+- Parameterised versions of the operations will also appear in the JSON Schema as e.g. `AddOp_int_` (with the title _"JsonPatchAddOperation\[int\]"_).
 
 ## Development
 

{pydantic_json_patch-0.6.2 → pydantic_json_patch-0.6.3}/README.md

@@ -144,7 +144,10 @@ def _(
     ...
 ```
 
-**Note**: explicitly specifying the [discriminator][pydantic-discriminator] gives better results on _failed_ validation for unions of operations.
+**Notes**:
+
+- Explicitly specifying the [discriminator][pydantic-discriminator] gives better results on _failed_ validation for unions of operations; and
+- Parameterised versions of the operations will also appear in the JSON Schema as e.g. `AddOp_int_` (with the title _"JsonPatchAddOperation\[int\]"_).
 
 ## Development
 

{pydantic_json_patch-0.6.2 → pydantic_json_patch-0.6.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pydantic_json_patch"
-version = "0.6.2"
+version = "0.6.3"
 description = "Pydantic models for implementing JSON Patch."
 readme = "README.md"
 authors = [
@@ -49,6 +49,7 @@ dev = [
     "fastapi-cli>=0.0.20",
     "httpx>=0.28.1",
     "isort>=7.0.0",
+    "joythief>=0.8.1",
     "pre-commit>=4.5.1",
     "pytest>=9.0.2",
     "ruff>=0.15.0",

{pydantic_json_patch-0.6.2 → pydantic_json_patch-0.6.3}/src/pydantic_json_patch/models.py

@@ -24,9 +24,9 @@ T = tx.TypeVar("T", default=tp.Any)
 
 
 def _generate_title(model: type[tp.Any]) -> str:
-    """Strip any type metadata and expand the shortened name."""
-    name, *_ = model.__name__.partition("[")
-    return f"JsonPatch{name}eration"
+    """Prefix with 'JsonPatch' and expand 'Op' contraction."""
+    name, *rest = model.__name__.partition("[")
+    return "".join(("JsonPatch", name, "eration", *rest))
 
 
 class _BaseOp(BaseModel):
@@ -108,6 +108,15 @@ class _FromOp(_BaseOp):
 
 
 class _ValueOp(_BaseOp, tp.Generic[T]):
+    @classmethod
+    def __class_getitem__(
+        cls, typevar_values: type[tp.Any] | tuple[type[tp.Any], ...]
+    ) -> type[BaseModel]:
+        """Propagate docstring to generic alias."""
+        alias = super().__class_getitem__(typevar_values)
+        alias.__doc__ = cls.__doc__
+        return alias
+
     @classmethod
     def create(cls, *, path: str | Sequence[str], value: T) -> tx.Self:  # ty: ignore[invalid-method-override] -- deliberately narrows **kwargs to named params
         """Return an instance of the appropriate operation."""
@@ -123,9 +132,9 @@ class _ValueOp(_BaseOp, tp.Generic[T]):
 
 
 class AddOp(_ValueOp[T], tp.Generic[T]):
-    """Represents the `add`_ operation.
+    """Represents the [add] operation.
 
-    .. _add: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.1
+    [add]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.1
 
     """
 
@@ -133,9 +142,9 @@ class AddOp(_ValueOp[T], tp.Generic[T]):
 
 
 class CopyOp(_FromOp):
-    """Represents the `copy`_ operation.
+    """Represents the [copy] operation.
 
-    .. _copy: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.5
+    [copy]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.5
 
     """
 
@@ -143,9 +152,9 @@ class CopyOp(_FromOp):
 
 
 class MoveOp(_FromOp):
-    """Represents the `move`_ operation.
+    """Represents the [move] operation.
 
-    .. _move: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.4
+    [move]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.4
 
     """
 
@@ -153,9 +162,9 @@ class MoveOp(_FromOp):
 
 
 class RemoveOp(_BaseOp):
-    """Represents the `remove`_ operation.
+    """Represents the [remove] operation.
 
-    .. _remove: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.2
+    [remove]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.2
 
     """
 
@@ -168,9 +177,9 @@ class RemoveOp(_BaseOp):
 
 
 class ReplaceOp(_ValueOp[T], tp.Generic[T]):
-    """Represents the `replace`_ operation.
+    """Represents the [replace] operation.
 
-    .. _replace: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.3
+    [replace]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.3
 
     """
 
@@ -178,9 +187,9 @@ class ReplaceOp(_ValueOp[T], tp.Generic[T]):
 
 
 class TestOp(_ValueOp[T], tp.Generic[T]):
-    """Represents the `test`_ operation.
+    """Represents the [test] operation.
 
-    .. _test: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.6
+    [test]: https://datatracker.ietf.org/doc/html/rfc6902/#section-4.6
 
     """
 
@@ -198,9 +207,9 @@ Operation: tp.TypeAlias = tp.Annotated[
 
 
 class JsonPatch(RootModel[Sequence[Operation]], Sequence[Operation]):
-    """Represents a full JSON Patch `document`_.
+    """Represents a full JSON Patch [document].
 
-    .. _document: https://datatracker.ietf.org/doc/html/rfc6902/#section-3
+    [document]: https://datatracker.ietf.org/doc/html/rfc6902/#section-3
 
     """