feat: SCIMException optional scim_ctx param.

Author: azmeuk

doc/changelog.rst

@@ -1,6 +1,14 @@
 Changelog
 =========
 
+[Unreleased]
+------------
+
+Added
+^^^^^
+
+- :class:`~scim2_models.SCIMException` now accepts an optional ``scim_ctx`` parameter to indicate the SCIM context in which the exception occurred.
+
 [0.6.3] - 2026-01-29
 --------------------
 

scim2_models/exceptions.py

@@ -10,6 +10,8 @@
 
 from pydantic_core import PydanticCustomError
 
+from .context import Context
+
 if TYPE_CHECKING:
     from .messages.error import Error
 
@@ -18,15 +20,25 @@ class SCIMException(Exception):
     """Base exception for SCIM protocol errors.
 
     Each subclass corresponds to a scimType defined in :rfc:`RFC 7644 Table 9 <7644#section-3.12>`.
+
+    :param detail: The error detail message.
+    :param scim_ctx: The SCIM context in which the exception occurred.
     """
 
     status: int = 400
     scim_type: str = ""
     _default_detail: str = "A SCIM error occurred"
 
-    def __init__(self, *, detail: str | None = None, **context: Any):
+    def __init__(
+        self,
+        *,
+        detail: str | None = None,
+        scim_ctx: Context | None = None,
+        **context: Any,
+    ):
         self.context = context
         self._detail = detail
+        self.scim_ctx = scim_ctx
         super().__init__(detail or self._default_detail)
 
     @property
@@ -53,10 +65,13 @@ def as_pydantic_error(self) -> PydanticCustomError:
         )
 
     @classmethod
-    def from_error(cls, error: "Error") -> "SCIMException":
+    def from_error(
+        cls, error: "Error", scim_ctx: Context | None = None
+    ) -> "SCIMException":
         """Create an exception from a SCIM Error object.
 
         :param error: The SCIM Error object to convert.
+        :param scim_ctx: The SCIM context in which the exception occurred.
         :return: The appropriate SCIMException subclass instance.
         """
         from .messages.error import Error
@@ -65,7 +80,7 @@ def from_error(cls, error: "Error") -> "SCIMException":
             raise TypeError(f"Expected Error, got {type(error).__name__}")
 
         exception_class = _SCIM_TYPE_TO_EXCEPTION.get(error.scim_type or "", cls)
-        return exception_class(detail=error.detail)
+        return exception_class(detail=error.detail, scim_ctx=scim_ctx)
 
 
 class InvalidFilterException(SCIMException):

tests/test_exceptions.py

@@ -6,6 +6,7 @@
 from pydantic import ValidationError
 from pydantic import field_validator
 
+from scim2_models import Context
 from scim2_models import Error
 from scim2_models import InvalidFilterException
 from scim2_models import InvalidPathException
@@ -429,3 +430,44 @@ def test_from_error_type_error():
     """from_error() raises TypeError for non-Error input."""
     with pytest.raises(TypeError, match="Expected Error"):
         SCIMException.from_error("not an error")
+
+
+def test_scim_ctx_default_none():
+    """SCIMException has scim_ctx=None by default."""
+    exc = SCIMException()
+    assert exc.scim_ctx is None
+
+
+def test_scim_ctx_set_directly():
+    """SCIMException can have scim_ctx set directly."""
+    exc = SCIMException(detail="Test error", scim_ctx=Context.RESOURCE_CREATION_REQUEST)
+    assert exc.scim_ctx == Context.RESOURCE_CREATION_REQUEST
+    assert exc.detail == "Test error"
+
+
+def test_scim_ctx_on_subclass():
+    """Exception subclasses can have scim_ctx set."""
+    exc = InvalidValueException(
+        detail="Invalid input",
+        attribute="userName",
+        scim_ctx=Context.RESOURCE_CREATION_REQUEST,
+    )
+    assert exc.scim_ctx == Context.RESOURCE_CREATION_REQUEST
+    assert exc.attribute == "userName"
+
+
+def test_from_error_with_scim_ctx():
+    """from_error() passes scim_ctx to the created exception."""
+    error = Error(status=400, scim_type="invalidValue", detail="Missing required")
+    exc = SCIMException.from_error(error, scim_ctx=Context.RESOURCE_CREATION_RESPONSE)
+    assert isinstance(exc, InvalidValueException)
+    assert exc.scim_ctx == Context.RESOURCE_CREATION_RESPONSE
+    assert exc.detail == "Missing required"
+
+
+def test_from_error_without_scim_ctx():
+    """from_error() creates exception with scim_ctx=None when not provided."""
+    error = Error(status=400, scim_type="invalidFilter", detail="Bad filter")
+    exc = SCIMException.from_error(error)
+    assert isinstance(exc, InvalidFilterException)
+    assert exc.scim_ctx is None