scim2-client 0.4.1__py3-none-any.whl → 0.4.3__py3-none-any.whl

scim2_client/client.py

@@ -60,6 +60,8 @@ class SCIMClient:
         This value can be overwritten in methods.
     :param check_response_payload: Whether to validate that the response payloads are valid.
         If set, the raw payload will be returned. This value can be overwritten in methods.
+    :param check_response_content_type: Whether to validate that the response content types are valid.
+    :param check_response_status_codes: Whether to validate that the response status codes are valid.
     :param raise_scim_errors: If :data:`True` and the server returned an
         :class:`~scim2_models.Error` object during a request, a :class:`~scim2_client.SCIMResponseErrorObject`
         exception will be raised. If :data:`False` the error object is returned. This value can be overwritten in methods.
@@ -156,6 +158,8 @@ class SCIMClient:
         service_provider_config: Optional[ServiceProviderConfig] = None,
         check_request_payload: bool = True,
         check_response_payload: bool = True,
+        check_response_content_type: bool = True,
+        check_response_status_codes: bool = True,
         raise_scim_errors: bool = True,
     ):
         self.resource_models = tuple(resource_models or [])
@@ -163,6 +167,8 @@ class SCIMClient:
         self.service_provider_config = service_provider_config
         self.check_request_payload = check_request_payload
         self.check_response_payload = check_response_payload
+        self.check_response_content_type = check_response_content_type
+        self.check_response_status_codes = check_response_status_codes
         self.raise_scim_errors = raise_scim_errors
 
     def get_resource_model(self, name: str) -> Optional[type[Resource]]:
@@ -220,6 +226,31 @@ class SCIMClient:
             if model not in CONFIG_RESOURCES
         ]
 
+    def _check_status_codes(
+        self, status_code: int, expected_status_codes: Optional[list[int]]
+    ):
+        if (
+            self.check_response_status_codes
+            and expected_status_codes
+            and status_code not in expected_status_codes
+        ):
+            raise UnexpectedStatusCode(status_code)
+
+    def _check_content_types(self, headers: dict):
+        # Interoperability considerations:  The "application/scim+json" media
+        # type is intended to identify JSON structure data that conforms to
+        # the SCIM protocol and schema specifications.  Older versions of
+        # SCIM are known to informally use "application/json".
+        # https://datatracker.ietf.org/doc/html/rfc7644.html#section-8.1
+
+        actual_content_type = headers.get("content-type", "").split(";").pop(0)
+        expected_response_content_types = ("application/scim+json", "application/json")
+        if (
+            self.check_response_content_type
+            and actual_content_type not in expected_response_content_types
+        ):
+            raise UnexpectedContentType(content_type=actual_content_type)
+
     def check_response(
         self,
         payload: Optional[dict],
@@ -234,19 +265,8 @@ class SCIMClient:
         if raise_scim_errors is None:
             raise_scim_errors = self.raise_scim_errors
 
-        if expected_status_codes and status_code not in expected_status_codes:
-            raise UnexpectedStatusCode(status_code)
-
-        # Interoperability considerations:  The "application/scim+json" media
-        # type is intended to identify JSON structure data that conforms to
-        # the SCIM protocol and schema specifications.  Older versions of
-        # SCIM are known to informally use "application/json".
-        # https://datatracker.ietf.org/doc/html/rfc7644.html#section-8.1
-
-        actual_content_type = headers.get("content-type", "").split(";").pop(0)
-        expected_response_content_types = ("application/scim+json", "application/json")
-        if actual_content_type not in expected_response_content_types:
-            raise UnexpectedContentType(content_type=actual_content_type)
+        self._check_status_codes(status_code, expected_status_codes)
+        self._check_content_types(headers)
 
         # In addition to returning an HTTP response code, implementers MUST return
         # the errors in the body of the response in a JSON format
@@ -560,11 +580,11 @@ class BaseSyncSCIMClient(SCIMClient):
 
         :param resource: The resource to create
             If is a :data:`dict`, the resource type will be guessed from the schema.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`~scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`~scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`~scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request
             library.
 
@@ -612,11 +632,11 @@ class BaseSyncSCIMClient(SCIMClient):
         :param resource_model: A :class:`~scim2_models.Resource` subtype or :data:`None`
         :param id: The SCIM id of an object to get, or :data:`None`
         :param search_request: An object detailing the search query parameters.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request library.
 
         :return:
@@ -681,11 +701,11 @@ class BaseSyncSCIMClient(SCIMClient):
         :param resource_models: Resource type or union of types expected
             to be read from the response.
         :param search_request: An object detailing the search query parameters.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -728,10 +748,10 @@ class BaseSyncSCIMClient(SCIMClient):
 
         :param resource_model: The type of the resource to delete.
         :param id: The type id the resource to delete.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -766,11 +786,11 @@ class BaseSyncSCIMClient(SCIMClient):
 
         :param resource: The new resource to replace.
             If is a :data:`dict`, the resource type will be guessed from the schema.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -798,14 +818,25 @@ class BaseSyncSCIMClient(SCIMClient):
         """
         raise NotImplementedError()
 
-    def discover(self):
-        """Dynamically discover the server models :class:`~scim2_models.Schema` and :class:`~scim2_models.ResourceType`."""
-        resource_types_response = self.query(ResourceType)
-        schemas_response = self.query(Schema)
-        self.service_provider_config = self.query(ServiceProviderConfig)
-        self.resource_types = resource_types_response.resources
-        schemas = schemas_response.resources
-        self.resource_models = self.build_resource_models(self.resource_types, schemas)
+    def discover(self, schemas=True, resource_types=True, service_provider_config=True):
+        """Dynamically discover the server configuration objects.
+
+        :param schemas: Whether to discover the :class:`~scim2_models.Schema` endpoint.
+        :param resource_types: Whether to discover the :class:`~scim2_models.ResourceType` endpoint.
+        :param service_provider_config: Whether to discover the :class:`~scim2_models.ServiceProviderConfig` endpoint.
+        """
+        if resource_types:
+            resource_types_response = self.query(ResourceType)
+            self.resource_types = resource_types_response.resources
+
+        if schemas:
+            schemas_response = self.query(Schema)
+            self.resource_models = self.build_resource_models(
+                self.resource_types, schemas_response.resources
+            )
+
+        if service_provider_config:
+            self.service_provider_config = self.query(ServiceProviderConfig)
 
 
 class BaseAsyncSCIMClient(SCIMClient):
@@ -826,11 +857,11 @@ class BaseAsyncSCIMClient(SCIMClient):
 
         :param resource: The resource to create
             If is a :data:`dict`, the resource type will be guessed from the schema.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request
             library.
 
@@ -878,11 +909,11 @@ class BaseAsyncSCIMClient(SCIMClient):
         :param resource_model: A :class:`~scim2_models.Resource` subtype or :data:`None`
         :param id: The SCIM id of an object to get, or :data:`None`
         :param search_request: An object detailing the search query parameters.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request library.
 
         :return:
@@ -947,11 +978,11 @@ class BaseAsyncSCIMClient(SCIMClient):
         :param resource_models: Resource type or union of types expected
             to be read from the response.
         :param search_request: An object detailing the search query parameters.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -994,10 +1025,10 @@ class BaseAsyncSCIMClient(SCIMClient):
 
         :param resource_model: The type of the resource to delete.
         :param id: The type id the resource to delete.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -1032,11 +1063,11 @@ class BaseAsyncSCIMClient(SCIMClient):
 
         :param resource: The new resource to replace.
             If is a :data:`dict`, the resource type will be guessed from the schema.
-        :param check_request_payload: If set, overwrites :paramref:`SCIMClient.check_request_payload`.
-        :param check_response_payload: If set, overwrites :paramref:`SCIMClient.check_response_payload`.
+        :param check_request_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`scim2_client.SCIMClient.check_response_payload`.
         :param expected_status_codes: The list of expected status codes form the response.
             If :data:`None` any status code is accepted.
-        :param raise_scim_errors: If set, overwrites :paramref:`SCIMClient.raise_scim_errors`.
+        :param raise_scim_errors: If set, overwrites :paramref:`scim2_client.SCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -1064,14 +1095,33 @@ class BaseAsyncSCIMClient(SCIMClient):
         """
         raise NotImplementedError()
 
-    async def discover(self):
-        """Dynamically discover the server models :class:`~scim2_models.Schema` and :class:`~scim2_models.ResourceType`."""
-        resources_task = asyncio.create_task(self.query(ResourceType))
-        schemas_task = asyncio.create_task(self.query(Schema))
-        spc_task = asyncio.create_task(self.query(ServiceProviderConfig))
-        resource_types_response = await resources_task
-        schemas_response = await schemas_task
-        self.service_provider_config = await spc_task
-        self.resource_types = resource_types_response.resources
-        schemas = schemas_response.resources
-        self.resource_models = self.build_resource_models(self.resource_types, schemas)
+    async def discover(
+        self, schemas=True, resource_types=True, service_provider_config=True
+    ):
+        """Dynamically discover the server configuration objects.
+
+        :param schemas: Whether to discover the :class:`~scim2_models.Schema` endpoint.
+        :param resource_types: Whether to discover the :class:`~scim2_models.ResourceType` endpoint.
+        :param service_provider_config: Whether to discover the :class:`~scim2_models.ServiceProviderConfig` endpoint.
+        """
+        if schemas:
+            schemas_task = asyncio.create_task(self.query(Schema))
+
+        if resource_types:
+            resources_types_task = asyncio.create_task(self.query(ResourceType))
+
+        if service_provider_config:
+            spc_task = asyncio.create_task(self.query(ServiceProviderConfig))
+
+        if resource_types:
+            resource_types_response = await resources_types_task
+            self.resource_types = resource_types_response.resources
+
+        if schemas:
+            schemas_response = await schemas_task
+            self.resource_models = self.build_resource_models(
+                self.resource_types, schemas_response.resources
+            )
+
+        if service_provider_config:
+            self.service_provider_config = await spc_task

{scim2_client-0.4.1.dist-info → scim2_client-0.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scim2-client
-Version: 0.4.1
+Version: 0.4.3
 Summary: Pythonically build SCIM requests and parse SCIM responses
 Project-URL: documentation, https://scim2-client.readthedocs.io
 Project-URL: repository, https://github.com/python-scim/scim2-client

{scim2_client-0.4.1.dist-info → scim2_client-0.4.3.dist-info}/RECORD

@@ -1,11 +1,11 @@
 scim2_client/__init__.py,sha256=l0pyBLiTpFA68ao98PqQLT_Xx0mw8BHumwrIHYCWa_M,845
-scim2_client/client.py,sha256=8M_3truHEpFFlmnVy3fk7Hl67duS6iQlBMuKRoep5Ew,44048
+scim2_client/client.py,sha256=ySG8sLOqOxzsW1CF2uR1UO_uuUef8sgUhfiWFviu-Wo,46293
 scim2_client/errors.py,sha256=FVmRXsaZLn1VZhJ3dSDs4IqycuU92AEun9JWWMseVO8,4397
 scim2_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 scim2_client/engines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 scim2_client/engines/httpx.py,sha256=L39ZZHjqe43uIQpgh_r_maqM2gkf3_Rk6d8MeNe57gk,17781
 scim2_client/engines/werkzeug.py,sha256=mVpK0GjmD4fu0jI0W2zqrn7GjBFZ0AjNk2gBO5415Gk,10230
-scim2_client-0.4.1.dist-info/METADATA,sha256=k3S_PnzmSlWiNE2TMZgpt4gZf1Nv5Pv-7xGVSAFqHpQ,16961
-scim2_client-0.4.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-scim2_client-0.4.1.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-scim2_client-0.4.1.dist-info/RECORD,,
+scim2_client-0.4.3.dist-info/METADATA,sha256=YHWHLDbgqOKPjlVU6Ab-WEFrCZOrXnVrzixgZ4_6kzw,16961
+scim2_client-0.4.3.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+scim2_client-0.4.3.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+scim2_client-0.4.3.dist-info/RECORD,,