scim2-client 0.3.1__tar.gz → 0.3.3__tar.gz

{scim2_client-0.3.1 → scim2_client-0.3.3}/.readthedocs.yml

@@ -9,7 +9,7 @@ build:
   jobs:
     post_create_environment:
       - pip install uv
-      - uv export --group doc --no-hashes --output-file requirements.txt
+      - uv export --all-extras --group doc --no-hashes --output-file requirements.txt
     post_install:
       - pip install .
       - pip install --requirement requirements.txt

{scim2_client-0.3.1 → scim2_client-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scim2-client
-Version: 0.3.1
+Version: 0.3.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.3.1 → scim2_client-0.3.3}/doc/changelog.rst

@@ -1,6 +1,24 @@
 Changelog
 =========
 
+[0.3.3] - 2024-11-29
+--------------------
+
+Added
+^^^^^
+- :class:`~scim2_client.engines.werkzeug.TestSCIMClient` raise a
+  :class:`~scim2_client.UnexpectedContentFormat` exception when response is not JSON.
+
+[0.3.2] - 2024-11-29
+--------------------
+
+Added
+^^^^^
+- Implement :class:`~scim2_client.BaseSCIMClient` :paramref:`~scim2_client.BaseSCIMClient.check_request_payload`,
+  :paramref:`~scim2_client.BaseSCIMClient.check_response_payload` and
+  :paramref:`~scim2_client.BaseSCIMClient.raise_scim_errors` paramibutes,
+  to keep the same values for all the requests.
+
 [0.3.1] - 2024-11-29
 --------------------
 
@@ -22,12 +40,12 @@ Fixed
 Added
 ^^^^^
 - The `Unknown resource type` request error keeps a reference to the faulty payload.
-- New `werkzeug` request engine for application development purpose.
-- New `AsyncSCIMClient` request engine. :issue:`1`
+- New :class:`~scim2_client.engines.werkzeug.TestSCIMClient` request engine for application development purpose.
+- New :class:`~scim2_client.engines.httpx.AsyncSCIMClient` request engine. :issue:`1`
 
 Changed
 ^^^^^^^
-- Separate httpx network code and SCIM code in separate file as a basis for async support (and maybe other request engines).
+- Separate httpx network code and SCIM code in separate file as a basis for async support (and other request engines).
 
 [0.2.2] - 2024-11-12
 --------------------

{scim2_client-0.3.1 → scim2_client-0.3.3}/doc/conf.py

@@ -17,6 +17,7 @@ extensions = [
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
     "sphinx_issues",
+    "sphinx_paramlinks",
     "sphinxcontrib.autodoc_pydantic",
     "myst_parser",
 ]

{scim2_client-0.3.1 → scim2_client-0.3.3}/doc/tutorial.rst

@@ -17,15 +17,15 @@ In addition to your SCIM server root endpoint, you will probably want to provide
     from scim2_client.engines.httpx import SyncSCIMClient
 
     client = Client(base_url="https://auth.example/scim/v2", headers={"Authorization": "Bearer foobar"})
-    scim = SyncSCIMClient(client, resource_types=(User[EnterpriseUser], Group))
+    scim = SyncSCIMClient(client, resource_models=(User[EnterpriseUser], Group))
 
-You need to give to indicate to :class:`~scim2_client.SCIMClient` all the different :class:`~scim2_models.Resource` types that you will need to manipulate with the :code:`resource_types` parameter.
+You need to give to indicate to :class:`~scim2_client.BaseSCIMClient` all the different :class:`~scim2_models.Resource` types that you will need to manipulate with the :code:`resource_models` parameter.
 This is needed so scim2-client will be able to guess which resource type to instante when an arbitrary payload is met.
 
 .. todo::
 
     We plan to implement the automatic discovery of SCIM server resources,
-    so they can dynamically be used without explicitly passing them with the :code:`resource_types` parameter.
+    so they can dynamically be used without explicitly passing them with the :code:`resource_models` parameter.
 
 Performing actions
 ==================
@@ -33,11 +33,11 @@ Performing actions
 scim2-client allows your application to interact with a SCIM server as described in :rfc:`RFC7644 §3 <7644#section-3>`, so you can read and manage the resources.
 The following actions are available:
 
-- :meth:`~scim2_client.BaseSCIMClient.create`
-- :meth:`~scim2_client.BaseSCIMClient.query`
-- :meth:`~scim2_client.BaseSCIMClient.replace`
-- :meth:`~scim2_client.BaseSCIMClient.delete`
-- :meth:`~scim2_client.BaseSCIMClient.search`
+- :meth:`~scim2_client.BaseSyncSCIMClient.create`
+- :meth:`~scim2_client.BaseSyncSCIMClient.query`
+- :meth:`~scim2_client.BaseSyncSCIMClient.replace`
+- :meth:`~scim2_client.BaseSyncSCIMClient.delete`
+- :meth:`~scim2_client.BaseSyncSCIMClient.search`
 
 Have a look at the :doc:`reference` to see usage examples and the exhaustive set of parameters, but generally it looks like this:
 
@@ -64,16 +64,16 @@ By default, the data passed to the :class:`SCIM client <scim2_client.BaseSCIMCli
 However sometimes you want to accept invalid inputs and outputs.
 To achieve this, all the methods provide the following parameters, all are :data:`True` by default:
 
-- :code:`check_request_payload`:
+- :paramref:`~scim2_client.BaseSCIMClient.check_request_payload`:
   If :data:`True` (the default) a :class:`~pydantic.ValidationError` will be raised if the input does not respect the SCIM standard.
   If :data:`False`, input is expected to be a :data:`dict` that will be passed as-is in the request.
-- :code:`check_response_payload`:
+- :paramref:`~scim2_client.BaseSCIMClient.check_response_payload`:
   If :data:`True` (the default) a :class:`~pydantic.ValidationError` will be raised if the server response does not respect the SCIM standard.
   If :data:`False` the server response is returned as-is.
 - :code:`expected_status_codes`: The list of expected status codes in the response.
   If :data:`None` any status code is accepted.
   If an unexpected status code is returned, a :class:`~scim2_client.errors.UnexpectedStatusCode` exception is raised.
-- :code:`raise_scim_errors`: If :data:`True` (the default) and the server returned an :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject` exception will be raised.
+- :paramref:`~scim2_client.BaseSCIMClient.raise_scim_errors`: If :data:`True` (the default) and the server returned an :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject` exception will be raised.
   If :data:`False` the error object is returned.
 
 

{scim2_client-0.3.1 → scim2_client-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "scim2-client"
-version = "0.3.1"
+version = "0.3.3"
 description = "Pythonically build SCIM requests and parse SCIM responses"
 authors = [{name="Yaal Coop", email="contact@yaal.coop"}]
 license = {file = "LICENSE.md"}
@@ -64,6 +64,7 @@ doc = [
     "shibuya>=2024.5.15",
     "sphinx-issues >= 5.0.0",
     "sphinx>=7.3.7",
+    "sphinx-paramlinks>=0.6.0",
 ]
 
 [tool.coverage.run]

{scim2_client-0.3.1 → scim2_client-0.3.3}/scim2_client/client.py

@@ -48,6 +48,14 @@ class BaseSCIMClient:
 
     :param resource_models: A tuple of :class:`~scim2_models.Resource` types expected to be handled by the SCIM client.
         If a request payload describe a resource that is not in this list, an exception will be raised.
+    :param check_request_payload: If :data:`False`,
+        :code:`resource` is expected to be a dict that will be passed as-is in the request.
+        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 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.
 
     .. note::
 
@@ -134,10 +142,19 @@ class BaseSCIMClient:
     :rfc:`RFC7644 §3.12 <7644#section-3.12>`.
     """
 
-    def __init__(self, resource_models: Optional[tuple[type[Resource]]] = None):
+    def __init__(
+        self,
+        resource_models: Optional[tuple[type[Resource]]] = None,
+        check_request_payload: bool = True,
+        check_response_payload: bool = True,
+        raise_scim_errors: bool = True,
+    ):
         self.resource_models = tuple(
             set(resource_models or []) | {ResourceType, Schema, ServiceProviderConfig}
         )
+        self.check_request_payload = True
+        self.check_response_payload = True
+        self.raise_scim_errors = True
 
     def check_resource_model(
         self, resource_model: type[Resource], payload=None
@@ -169,10 +186,13 @@ class BaseSCIMClient:
         headers: dict,
         expected_status_codes: Optional[list[int]] = None,
         expected_types: Optional[list[type[Resource]]] = None,
-        check_response_payload: bool = True,
-        raise_scim_errors: bool = True,
+        check_response_payload: Optional[bool] = None,
+        raise_scim_errors: Optional[bool] = None,
         scim_ctx: Optional[Context] = None,
     ) -> Union[Error, None, dict, type[Resource]]:
+        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)
 
@@ -198,6 +218,9 @@ class BaseSCIMClient:
         else:
             response_payload = payload
 
+        if check_response_payload is None:
+            check_response_payload = self.check_response_payload
+
         if not check_response_payload:
             return response_payload
 
@@ -240,15 +263,17 @@ class BaseSCIMClient:
     def prepare_create_request(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
         expected_status_codes: Optional[list[int]] = None,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> RequestPayload:
         req = RequestPayload(
             expected_status_codes=expected_status_codes,
             request_kwargs=kwargs,
         )
+        if check_request_payload is None:
+            check_request_payload = self.check_request_payload
 
         if not check_request_payload:
             req.payload = resource
@@ -289,9 +314,9 @@ class BaseSCIMClient:
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
         expected_status_codes: Optional[list[int]] = None,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> RequestPayload:
         req = RequestPayload(
@@ -299,6 +324,9 @@ class BaseSCIMClient:
             request_kwargs=kwargs,
         )
 
+        if check_request_payload is None:
+            check_request_payload = self.check_request_payload
+
         if resource_model and check_request_payload:
             self.check_resource_model(resource_model)
 
@@ -341,9 +369,9 @@ class BaseSCIMClient:
     def prepare_search_request(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
         expected_status_codes: Optional[list[int]] = None,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> RequestPayload:
         req = RequestPayload(
@@ -351,6 +379,9 @@ class BaseSCIMClient:
             request_kwargs=kwargs,
         )
 
+        if check_request_payload is None:
+            check_request_payload = self.check_request_payload
+
         if not check_request_payload:
             req.payload = search_request
 
@@ -372,7 +403,7 @@ class BaseSCIMClient:
         resource_model: type,
         id: str,
         expected_status_codes: Optional[list[int]] = None,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> RequestPayload:
         req = RequestPayload(
@@ -388,9 +419,9 @@ class BaseSCIMClient:
     def prepare_replace_request(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
         expected_status_codes: Optional[list[int]] = None,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> RequestPayload:
         req = RequestPayload(
@@ -398,6 +429,9 @@ class BaseSCIMClient:
             request_kwargs=kwargs,
         )
 
+        if check_request_payload is None:
+            check_request_payload = self.check_request_payload
+
         if not check_request_payload:
             req.payload = resource
             req.url = kwargs.pop("url", None)
@@ -449,27 +483,23 @@ class BaseSyncSCIMClient(BaseSCIMClient):
     def create(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.CREATION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         """Perform a POST request to create, as defined in :rfc:`RFC7644 §3.3 <7644#section-3.3>`.
 
         :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 :data:`False`,
-            :code:`resource` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request
             library.
 
@@ -501,12 +531,12 @@ class BaseSyncSCIMClient(BaseSCIMClient):
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.QUERY_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         """Perform a GET request to read resources, as defined in :rfc:`RFC7644 §3.4.2 <7644#section-3.4.2>`.
@@ -517,15 +547,11 @@ class BaseSyncSCIMClient(BaseSCIMClient):
         :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 :data:`False`,
-            :code:`search_request` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request library.
 
         :return:
@@ -577,12 +603,12 @@ class BaseSyncSCIMClient(BaseSCIMClient):
     def search(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.SEARCH_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         """Perform a POST search request to read all available resources, as defined in :rfc:`RFC7644 §3.4.3 <7644#section-3.4.3>`.
@@ -590,15 +616,11 @@ class BaseSyncSCIMClient(BaseSCIMClient):
         :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 :data:`False`,
-            :code:`search_request` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -630,24 +652,21 @@ class BaseSyncSCIMClient(BaseSCIMClient):
         self,
         resource_model: type,
         id: str,
-        check_response_payload: bool = True,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.DELETION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Optional[Union[Error, dict]]:
         """Perform a DELETE request to create, as defined in :rfc:`RFC7644 §3.6 <7644#section-3.6>`.
 
         :param resource_model: The type of the resource to delete.
         :param id: The type id the resource to delete.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -670,27 +689,23 @@ class BaseSyncSCIMClient(BaseSCIMClient):
     def replace(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.REPLACEMENT_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         """Perform a PUT request to replace a resource, as defined in :rfc:`RFC7644 §3.5.1 <7644#section-3.5.1>`.
 
         :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 :data:`False`,
-            :code:`resource` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -725,27 +740,23 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
     async def create(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.CREATION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         """Perform a POST request to create, as defined in :rfc:`RFC7644 §3.3 <7644#section-3.3>`.
 
         :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 :data:`False`,
-            :code:`resource` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request
             library.
 
@@ -777,12 +788,12 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.QUERY_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         """Perform a GET request to read resources, as defined in :rfc:`RFC7644 §3.4.2 <7644#section-3.4.2>`.
@@ -793,15 +804,11 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
         :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 :data:`False`,
-            :code:`search_request` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying HTTP request library.
 
         :return:
@@ -853,12 +860,12 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
     async def search(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.SEARCH_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         """Perform a POST search request to read all available resources, as defined in :rfc:`RFC7644 §3.4.3 <7644#section-3.4.3>`.
@@ -866,15 +873,11 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
         :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 :data:`False`,
-            :code:`search_request` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -906,24 +909,21 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
         self,
         resource_model: type,
         id: str,
-        check_response_payload: bool = True,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.DELETION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Optional[Union[Error, dict]]:
         """Perform a DELETE request to create, as defined in :rfc:`RFC7644 §3.6 <7644#section-3.6>`.
 
         :param resource_model: The type of the resource to delete.
         :param id: The type id the resource to delete.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 
@@ -946,27 +946,23 @@ class BaseAsyncSCIMClient(BaseSCIMClient):
     async def replace(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSCIMClient.REPLACEMENT_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         """Perform a PUT request to replace a resource, as defined in :rfc:`RFC7644 §3.5.1 <7644#section-3.5.1>`.
 
         :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 :data:`False`,
-            :code:`resource` is expected to be a dict that will be passed as-is in the request.
-        :param check_response_payload: Whether to validate that the response payload is valid.
-            If set, the raw payload will be returned.
+        :param check_request_payload: If set, overwrites :paramref:`BaseSCIMClient.check_request_payload`.
+        :param check_response_payload: If set, overwrites :paramref:`BaseSCIMClient.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 :data:`True` and the server returned an
-            :class:`~scim2_models.Error` object, a :class:`~scim2_client.SCIMResponseErrorObject`
-            exception will be raised. If :data:`False` the error object is returned.
+        :param raise_scim_errors: If set, overwrites :paramref:`BaseSCIMClient.raise_scim_errors`.
         :param kwargs: Additional parameters passed to the underlying
             HTTP request library.
 

{scim2_client-0.3.1 → scim2_client-0.3.3}/scim2_client/engines/httpx.py

@@ -52,23 +52,29 @@ class SyncSCIMClient(BaseSyncSCIMClient):
     :param client: A :class:`httpx.Client` instance that will be used to send requests.
     :param resource_models: A tuple of :class:`~scim2_models.Resource` types expected to be handled by the SCIM client.
         If a request payload describe a resource that is not in this list, an exception will be raised.
+    :param check_request_payload: If :data:`False`,
+        :code:`resource` is expected to be a dict that will be passed as-is in the request.
+        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 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.
     """
 
-    def __init__(
-        self, client: Client, resource_models: Optional[tuple[type[Resource]]] = None
-    ):
-        super().__init__(resource_models=resource_models)
+    def __init__(self, client: Client, *args, **kwargs):
+        super().__init__(*args, **kwargs)
         self.client = client
 
     def create(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.CREATION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_create_request(
@@ -99,12 +105,12 @@ class SyncSCIMClient(BaseSyncSCIMClient):
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.QUERY_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ):
         req = self.prepare_query_request(
@@ -137,12 +143,12 @@ class SyncSCIMClient(BaseSyncSCIMClient):
     def search(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.SEARCH_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         req = self.prepare_search_request(
@@ -172,11 +178,11 @@ class SyncSCIMClient(BaseSyncSCIMClient):
         self,
         resource_model: type,
         id: str,
-        check_response_payload: bool = True,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.DELETION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Optional[Union[Error, dict]]:
         req = self.prepare_delete_request(
@@ -203,12 +209,12 @@ class SyncSCIMClient(BaseSyncSCIMClient):
     def replace(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.REPLACEMENT_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_replace_request(
@@ -241,23 +247,30 @@ class AsyncSCIMClient(BaseAsyncSCIMClient):
     :param client: A :class:`httpx.AsyncClient` instance that will be used to send requests.
     :param resource_models: A tuple of :class:`~scim2_models.Resource` types expected to be handled by the SCIM client.
         If a request payload describe a resource that is not in this list, an exception will be raised.
+    :param check_request_payload: If :data:`False`,
+        :code:`resource` is expected to be a dict that will be passed as-is in the request.
+        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 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.
+
     """
 
-    def __init__(
-        self, client: Client, resource_models: Optional[tuple[type[Resource]]] = None
-    ):
-        super().__init__(resource_models=resource_models)
+    def __init__(self, client: Client, *args, **kwargs):
+        super().__init__(*args, **kwargs)
         self.client = client
 
     async def create(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseAsyncSCIMClient.CREATION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_create_request(
@@ -290,12 +303,12 @@ class AsyncSCIMClient(BaseAsyncSCIMClient):
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseAsyncSCIMClient.QUERY_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ):
         req = self.prepare_query_request(
@@ -328,12 +341,12 @@ class AsyncSCIMClient(BaseAsyncSCIMClient):
     async def search(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseAsyncSCIMClient.SEARCH_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         req = self.prepare_search_request(
@@ -365,11 +378,11 @@ class AsyncSCIMClient(BaseAsyncSCIMClient):
         self,
         resource_model: type,
         id: str,
-        check_response_payload: bool = True,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseAsyncSCIMClient.DELETION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Optional[Union[Error, dict]]:
         req = self.prepare_delete_request(
@@ -396,12 +409,12 @@ class AsyncSCIMClient(BaseAsyncSCIMClient):
     async def replace(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseAsyncSCIMClient.REPLACEMENT_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_replace_request(

{scim2_client-0.3.1 → scim2_client-0.3.3}/scim2_client/engines/werkzeug.py

@@ -1,3 +1,4 @@
+import json
 from contextlib import contextmanager
 from typing import Optional
 from typing import Union
@@ -13,6 +14,7 @@ from werkzeug.test import Client
 
 from scim2_client.client import BaseSyncSCIMClient
 from scim2_client.errors import SCIMClientError
+from scim2_client.errors import UnexpectedContentFormat
 
 
 @contextmanager
@@ -20,6 +22,9 @@ def handle_response_error(response):
     try:
         yield
 
+    except json.decoder.JSONDecodeError as exc:
+        raise UnexpectedContentFormat(source=response) from exc
+
     except SCIMClientError as exc:
         exc.source = response
         raise exc
@@ -36,6 +41,14 @@ class TestSCIMClient(BaseSyncSCIMClient):
     :param scim_prefix: The scim root endpoint in the application.
     :param resource_models: A tuple of :class:`~scim2_models.Resource` types expected to be handled by the SCIM client.
         If a request payload describe a resource that is not in this list, an exception will be raised.
+    :param check_request_payload: If :data:`False`,
+        :code:`resource` is expected to be a dict that will be passed as-is in the request.
+        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 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.
 
     .. code-block:: python
 
@@ -50,13 +63,8 @@ class TestSCIMClient(BaseSyncSCIMClient):
         assert response_user.user_name == "foo"
     """
 
-    def __init__(
-        self,
-        app,
-        scim_prefix: str = "",
-        resource_models: Optional[tuple[type[Resource]]] = None,
-    ):
-        super().__init__(resource_models=resource_models)
+    def __init__(self, app, *args, scim_prefix: str = "", **kwargs):
+        super().__init__(*args, **kwargs)
         self.client = Client(app)
         self.scim_prefix = scim_prefix
 
@@ -71,12 +79,12 @@ class TestSCIMClient(BaseSyncSCIMClient):
     def create(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.CREATION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_create_request(
@@ -108,12 +116,12 @@ class TestSCIMClient(BaseSyncSCIMClient):
         resource_model: Optional[type[Resource]] = None,
         id: Optional[str] = None,
         search_request: Optional[Union[SearchRequest, dict]] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.QUERY_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ):
         req = self.prepare_query_request(
@@ -146,12 +154,12 @@ class TestSCIMClient(BaseSyncSCIMClient):
     def search(
         self,
         search_request: Optional[SearchRequest] = None,
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.SEARCH_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, ListResponse[AnyResource], Error, dict]:
         req = self.prepare_search_request(
@@ -182,11 +190,11 @@ class TestSCIMClient(BaseSyncSCIMClient):
         self,
         resource_model: type,
         id: str,
-        check_response_payload: bool = True,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.DELETION_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Optional[Union[Error, dict]]:
         req = self.prepare_delete_request(
@@ -212,12 +220,12 @@ class TestSCIMClient(BaseSyncSCIMClient):
     def replace(
         self,
         resource: Union[AnyResource, dict],
-        check_request_payload: bool = True,
-        check_response_payload: bool = True,
+        check_request_payload: Optional[bool] = None,
+        check_response_payload: Optional[bool] = None,
         expected_status_codes: Optional[
             list[int]
         ] = BaseSyncSCIMClient.REPLACEMENT_RESPONSE_STATUS_CODES,
-        raise_scim_errors: bool = True,
+        raise_scim_errors: Optional[bool] = None,
         **kwargs,
     ) -> Union[AnyResource, Error, dict]:
         req = self.prepare_replace_request(

{scim2_client-0.3.1 → scim2_client-0.3.3}/tests/engines/test_werkzeug.py

@@ -2,9 +2,12 @@ import pytest
 from scim2_models import ResourceType
 from scim2_models import SearchRequest
 from scim2_models import User
+from werkzeug.wrappers import Request
+from werkzeug.wrappers import Response
 
 from scim2_client.engines.werkzeug import TestSCIMClient
 from scim2_client.errors import SCIMResponseErrorObject
+from scim2_client.errors import UnexpectedContentFormat
 
 scim2_server = pytest.importorskip("scim2_server")
 from scim2_server.backend import InMemoryBackend  # noqa: E402
@@ -61,3 +64,15 @@ def test_werkzeug_engine(scim_client):
     scim_client.delete(User, response_user.id)
     with pytest.raises(SCIMResponseErrorObject):
         scim_client.query(User, response_user.id)
+
+
+def test_no_json():
+    """Test that pages that do not return JSON raise an UnexpectedContentFormat error."""
+
+    @Request.application
+    def application(request):
+        return Response("Hello, World!", content_type="application/scim+json")
+
+    client = TestSCIMClient(app=application, resource_models=(User,))
+    with pytest.raises(UnexpectedContentFormat):
+        client.query(url="/")

{scim2_client-0.3.1 → scim2_client-0.3.3}/uv.lock

@@ -984,7 +984,7 @@ wheels = [
 
 [[package]]
 name = "scim2-client"
-version = "0.3.0"
+version = "0.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "scim2-models" },
@@ -1017,6 +1017,7 @@ doc = [
     { name = "shibuya" },
     { name = "sphinx" },
     { name = "sphinx-issues" },
+    { name = "sphinx-paramlinks" },
 ]
 
 [package.metadata]
@@ -1045,6 +1046,7 @@ doc = [
     { name = "shibuya", specifier = ">=2024.5.15" },
     { name = "sphinx", specifier = ">=7.3.7" },
     { name = "sphinx-issues", specifier = ">=5.0.0" },
+    { name = "sphinx-paramlinks", specifier = ">=0.6.0" },
 ]
 
 [[package]]
@@ -1165,6 +1167,16 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1d/14/a1b38212db8d327f53f2f56f0ed81c8b80ee2c2160e8819069c0d329d0a9/sphinx_issues-5.0.0-py3-none-any.whl", hash = "sha256:d80704a01c8af3d76586771a67a9e48f2d1a6091a0377458c49908460a6a31ea", size = 8063 },
 ]
 
+[[package]]
+name = "sphinx-paramlinks"
+version = "0.6.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "docutils" },
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ae/21/62d3a58ff7bd02bbb9245a63d1f0d2e0455522a11a78951d16088569fca8/sphinx-paramlinks-0.6.0.tar.gz", hash = "sha256:746a0816860aa3fff5d8d746efcbec4deead421f152687411db1d613d29f915e", size = 12363 }
+
 [[package]]
 name = "sphinxcontrib-applehelp"
 version = "2.0.0"