tests: basic unit tests

Author: azmeuk

README.md

@@ -1,2 +1,49 @@
 # pytest-scim2-server
+
 SCIM2 server fixture pour Pytest
+
+## Installation
+
+```
+pip install pytest-scim2-server
+```
+
+## Usage
+
+pytest-scim2-server creates a ``scim2_server`` fixture that runs an instance of [scim2-server](https://github.com/python-scim/scim2-server) on a random port, in a dedicated thread.
+
+```python
+import requests
+
+def test_scim_foobar(scim2_server):
+    host, port = scim2_server
+
+    res = request.get(f"http://{host}:{port}")
+    ...
+```
+
+Note that you can use [scim2-client](https://scim2-client.readthedocs.io) to interact with the SCIM server.
+
+```python
+import pytest
+from httpx import Client
+from scim2_client.engines.httpx import SyncSCIMClient
+
+
+@pytest.fixture(scope="session")
+def scim_client(scim2_server):
+    host, port = scim2_server
+    http_client = Client(base_url=f"http://{host}:{port}")
+    scim_client = SyncSCIMClient(http_client)
+    scim_client.discover()
+    return scim_client
+
+
+def test_scim2_server(scim_client):
+    User = scim_client.get_resource_model("User")
+    user = User(user_name="[email protected]")
+    response = scim_client.create(user)
+
+    users = scim_client.query(User)
+    assert users.resources[0].id == response.id
+```

pyproject.toml

@@ -17,6 +17,8 @@ dependencies = [
 [dependency-groups]
 dev = [
     "pre-commit-uv>=4.1.4",
+    "pytest-cov>=6.0.0",
+    "scim2-client[httpx]>=0.5.1",
     "tox-uv>=1.16.0",
 ]
 

pytest_scim2_server/__init__.py

@@ -12,7 +12,6 @@
 @pytest.fixture(scope="session")
 def scim2_server():
     """SCIM2 server running in a thread."""
-
     backend = InMemoryBackend()
     provider = SCIMProvider(backend)
 

tests/__init__.py

@@ -0,0 +1,21 @@
+import pytest
+from httpx import Client
+from scim2_client.engines.httpx import SyncSCIMClient
+
+
+@pytest.fixture(scope="session")
+def scim_client(scim2_server):
+    host, port = scim2_server
+    http_client = Client(base_url=f"http://{host}:{port}")
+    scim_client = SyncSCIMClient(http_client)
+    scim_client.discover()
+    return scim_client
+
+
+def test_scim2_server(scim_client):
+    User = scim_client.get_resource_model("User")
+    user = User(user_name="[email protected]")
+    response = scim_client.create(user)
+
+    users = scim_client.query(User)
+    assert users.resources[0].id == response.id