scim2-models 0.6.2__py3-none-any.whl → 0.6.3__py3-none-any.whl

scim2_models/path.py

@@ -9,6 +9,8 @@ from typing import NamedTuple
 from typing import TypeVar
 
 from pydantic import GetCoreSchemaHandler
+from pydantic import GetJsonSchemaHandler
+from pydantic.json_schema import JsonSchemaValue
 from pydantic_core import core_schema
 
 from .base import BaseModel
@@ -129,6 +131,14 @@ class Path(UserString, Generic[ResourceT]):
             serialization=core_schema.plain_serializer_function_ser_schema(str),
         )
 
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls,
+        _core_schema: core_schema.CoreSchema,
+        _handler: GetJsonSchemaHandler,
+    ) -> JsonSchemaValue:
+        return {"type": "string"}
+
     def __init__(self, path: "str | Path[Any]"):
         if isinstance(path, Path):
             path = str(path)

scim2_models/reference.py

@@ -7,6 +7,8 @@ from typing import get_args
 from typing import get_origin
 
 from pydantic import GetCoreSchemaHandler
+from pydantic import GetJsonSchemaHandler
+from pydantic.json_schema import JsonSchemaValue
 from pydantic_core import Url
 from pydantic_core import ValidationError
 from pydantic_core import core_schema
@@ -112,6 +114,14 @@ class Reference(str, Generic[ReferenceTypes]):
             serialization=core_schema.plain_serializer_function_ser_schema(str),
         )
 
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls,
+        _core_schema: core_schema.CoreSchema,
+        _handler: GetJsonSchemaHandler,
+    ) -> JsonSchemaValue:
+        return {"type": "string", "format": "uri"}
+
     @classmethod
     def get_scim_reference_types(cls) -> list[str]:
         """Return referenceTypes for SCIM schema generation."""

scim2_models/resources/enterprise_user.py

@@ -3,6 +3,7 @@ from typing import Annotated
 
 from pydantic import Field
 
+from ..annotations import CaseExact
 from ..annotations import Mutability
 from ..annotations import Required
 from ..attributes import ComplexAttribute
@@ -15,7 +16,7 @@ if TYPE_CHECKING:
 
 
 class Manager(ComplexAttribute):
-    value: Annotated[str | None, Required.true] = None
+    value: Annotated[str | None, Required.true, CaseExact.true] = None
     """The id of the SCIM resource representing the User's manager."""
 
     ref: Annotated[  # type: ignore[type-arg]

scim2_models/resources/group.py

@@ -7,6 +7,7 @@ from typing import Union
 from pydantic import Field
 
 from ..annotations import Mutability
+from ..annotations import Required
 from ..attributes import ComplexAttribute
 from ..path import URN
 from ..reference import Reference
@@ -38,7 +39,7 @@ class GroupMember(ComplexAttribute):
 class Group(Resource[Any]):
     __schema__ = URN("urn:ietf:params:scim:schemas:core:2.0:Group")
 
-    display_name: str | None = None
+    display_name: Annotated[str | None, Required.true] = None
     """A human-readable name for the Group."""
 
     members: list[GroupMember] | None = None

scim2_models/resources/resource.py

@@ -532,19 +532,21 @@ def _model_attribute_to_scim_attribute(
         else None
     )
 
-    return Attribute(
-        name=field_info.serialization_alias or attribute_name,
-        type=Attribute.Type(attribute_type),
-        multi_valued=model.get_field_multiplicity(attribute_name),
-        description=field_info.description,
-        canonical_values=field_info.examples,
-        required=model.get_field_annotation(attribute_name, Required),
-        case_exact=model.get_field_annotation(attribute_name, CaseExact),
-        mutability=model.get_field_annotation(attribute_name, Mutability),
-        returned=model.get_field_annotation(attribute_name, Returned),
-        uniqueness=model.get_field_annotation(attribute_name, Uniqueness),
-        sub_attributes=sub_attributes,
-        reference_types=root_type.get_scim_reference_types()  # type: ignore[attr-defined]
-        if attribute_type == Attribute.Type.reference
-        else None,
-    )
+    kwargs: dict[str, Any] = {
+        "name": field_info.serialization_alias or attribute_name,
+        "type": Attribute.Type(attribute_type),
+        "multi_valued": model.get_field_multiplicity(attribute_name),
+        "description": field_info.description,
+        "canonical_values": field_info.examples,
+        "required": model.get_field_annotation(attribute_name, Required),
+        "case_exact": model.get_field_annotation(attribute_name, CaseExact),
+        "mutability": model.get_field_annotation(attribute_name, Mutability),
+        "returned": model.get_field_annotation(attribute_name, Returned),
+        "sub_attributes": sub_attributes,
+    }
+    if attribute_type != Attribute.Type.complex:
+        kwargs["uniqueness"] = model.get_field_annotation(attribute_name, Uniqueness)
+    if attribute_type == Attribute.Type.reference:
+        kwargs["reference_types"] = root_type.get_scim_reference_types()  # type: ignore[attr-defined]
+
+    return Attribute(**kwargs)

scim2_models/resources/resource_type.py

@@ -8,6 +8,7 @@ from ..annotations import CaseExact
 from ..annotations import Mutability
 from ..annotations import Required
 from ..annotations import Returned
+from ..annotations import Uniqueness
 from ..attributes import ComplexAttribute
 from ..path import URN
 from ..reference import URI
@@ -38,7 +39,13 @@ class SchemaExtension(ComplexAttribute):
 class ResourceType(Resource[Any]):
     __schema__ = URN("urn:ietf:params:scim:schemas:core:2.0:ResourceType")
 
-    name: Annotated[str | None, Mutability.read_only, Required.true] = None
+    name: Annotated[
+        str | None,
+        Mutability.read_only,
+        Required.true,
+        CaseExact.true,
+        Uniqueness.server,
+    ] = None
     """The resource type name.
 
     When applicable, service providers MUST specify the name, e.g.,
@@ -57,9 +64,9 @@ class ResourceType(Resource[Any]):
     This is often the same value as the "name" attribute.
     """
 
-    endpoint: Annotated[Reference[URI] | None, Mutability.read_only, Required.true] = (
-        None
-    )
+    endpoint: Annotated[
+        Reference[URI] | None, Mutability.read_only, Required.true, Uniqueness.server
+    ] = None
     """The resource type's HTTP-addressable endpoint relative to the Base URL,
     e.g., '/Users'."""
 

scim2_models/resources/user.py

@@ -2,7 +2,6 @@ from enum import Enum
 from typing import TYPE_CHECKING
 from typing import Annotated
 from typing import ClassVar
-from typing import Union
 
 from pydantic import Base64Bytes
 from pydantic import EmailStr
@@ -202,8 +201,8 @@ class GroupMembership(ComplexAttribute):
     value: Annotated[str | None, Mutability.read_only] = None
     """The identifier of the User's group."""
 
-    ref: Annotated[  # type: ignore[type-arg]
-        Reference[Union["User", "Group"]] | None,
+    ref: Annotated[
+        Reference["Group"] | None,
         Mutability.read_only,
     ] = Field(None, serialization_alias="$ref")
     """The reference URI of a target resource, if the attribute is a

{scim2_models-0.6.2.dist-info → scim2_models-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scim2-models
-Version: 0.6.2
+Version: 0.6.3
 Summary: SCIM2 models serialization and validation with pydantic
 Keywords: scim,scim2,provisioning,pydantic,rfc7643,rfc7644
 Author: Yaal Coop
@@ -240,6 +240,17 @@ Provisioning is the action of managing a set of resources across different servi
 SCIM is often used between Identity Providers and applications in completion of standards like OAuth2 and OpenID Connect.
 It allows users and groups creations, modifications and deletions to be synchronized between applications.
 
+## Features
+
+- **SCIM Resources**: Native Python classes for `User`, `Group`, `EnterpriseUser`, `ServiceProviderConfig`, `ResourceType` and `Schema`
+- **Pydantic Integration**: Full Pydantic v2 support with validation, serialization and IDE autocompletion
+- **RFC Compliance**: Implements [RFC7643](https://datatracker.ietf.org/doc/html/rfc7643) (schema) and [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644) (protocol) specifications
+- **Attribute Metadata**: Support for `Mutability`, `Returned`, `Uniqueness` and `Required` field annotations
+- **Context-Aware Validation**: Automatic field inclusion/exclusion based on HTTP context (creation, query, replacement, etc.)
+- **Schema Extensions**: Dynamic schema extensions and custom resource types, dynamic conversion between schemas and Python models.
+- **SCIM Messages**: `ListResponse`, `SearchRequest`, `PatchOp`, and `Error` messages
+- **Error Handling**: SCIM-compliant exceptions with automatic conversion to `Error` responses
+
 ## Installation
 
 ```shell

{scim2_models-0.6.2.dist-info → scim2_models-0.6.3.dist-info}/RECORD

@@ -12,19 +12,19 @@ scim2_models/messages/list_response.py,sha256=ahAqdElGSNxt8LlOUeSsNbOykZdCLM4aJy
 scim2_models/messages/message.py,sha256=7svNN_xi8BSyWmRoMdYFTjQGuV1F9HUpQYHb6TQtf8A,4081
 scim2_models/messages/patch_op.py,sha256=QwAkeHvzzUXFmS8Ut_ns99yhiSQehpuHAodI_eSc_hA,16236
 scim2_models/messages/search_request.py,sha256=OXw4-oehLC5NyD7yVFEq0QgPsxAaQwXE7hZMKiNkvzY,3017
-scim2_models/path.py,sha256=4u-Lqtq8lqSmJUi6thFDwhpzc-uzyVFulsTklIyIFL8,27053
+scim2_models/path.py,sha256=LwAhBtLQg4dKveRgvsj1R20ptT8mK9x9UfEczBWQuKE,27359
 scim2_models/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scim2_models/reference.py,sha256=-E6VD-lFPEIXpSpwu0G_3MKLbWKgZhwk8ER3-JhCHig,5636
+scim2_models/reference.py,sha256=Nx9r19EZ8ET7x1KvmHzyhJ4UH8n1GUsJAerezmZ52PI,5959
 scim2_models/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-scim2_models/resources/enterprise_user.py,sha256=Wk8CzQrCXUE-roQYINpj4YhOlj2s_TD3Y3SnEXK6jKY,1798
-scim2_models/resources/group.py,sha256=nmmPlbP7gQluNJEtFIFYtjDYJ2AR4Uml5LuxMcY_NIk,1379
-scim2_models/resources/resource.py,sha256=0Y8xloQk6tWQ9L7gW__qlUkU55mpYAsxfpeuFuSX2Vk,20550
-scim2_models/resources/resource_type.py,sha256=IDzUcv9_XiAHOpaaG9j24sa-nNKY6i0wPDTTrxNqJgQ,3297
+scim2_models/resources/enterprise_user.py,sha256=4y6AyoIzGdXYeTpoBb5gJmLmXBK8xac6-GBZ-5fbytM,1850
+scim2_models/resources/group.py,sha256=_BA0Qxr7QBjH_1nNrRVi6kbYjBAd86x2cvsVgP3iMHM,1440
+scim2_models/resources/resource.py,sha256=IDJsrXzzPC5OA93hNeoPknDbLfIbISozBEf1XQfvjyU,20671
+scim2_models/resources/resource_type.py,sha256=yO18uO04eaWJ0yFdvtzI0cfjpr0545aFM3gAYBIw2MI,3433
 scim2_models/resources/schema.py,sha256=wDh8G1oxCgyQcmChz30bVNPjyksYcgxD66k0mB1VIdI,10239
 scim2_models/resources/service_provider_config.py,sha256=cmfPtLPOuwNrZl9hGpbrMsQhoOwIytlf2Q_LAJegAcQ,5303
-scim2_models/resources/user.py,sha256=Z-h8x9dAnxBqDeZJbKi-u-HCv6aQdS8e4VzHLVm63ZA,11398
+scim2_models/resources/user.py,sha256=uIUlEV4h1LsqWHLXvHVZWdx5H5n4X4kKknNzR15V72c,11332
 scim2_models/scim_object.py,sha256=suYhQ0iFQs1aKTlSerWZsi_sAVhFX_9N24U_DmZxCbw,5321
 scim2_models/utils.py,sha256=Lb7mlP3I_IfAlqi_8_m4G-_1Rn7oKRqbNdpoDLjXXr0,1978
-scim2_models-0.6.2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-scim2_models-0.6.2.dist-info/METADATA,sha256=q6LTJlB0nesIAO3-DP7Exy2cw4IbODc8MxGRTydt7Qw,16486
-scim2_models-0.6.2.dist-info/RECORD,,
+scim2_models-0.6.3.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+scim2_models-0.6.3.dist-info/METADATA,sha256=DwqVdSFbzm9gp0MkXayievlAEArR_YTjHGWQ-7m2Ylw,17479
+scim2_models-0.6.3.dist-info/RECORD,,