refactor: the fixture is a dataclass instead of a tuple

Author: azmeuk

README.md

@@ -16,9 +16,7 @@ pytest-scim2-server creates a ``scim2_server`` fixture that runs an instance of
 import requests
 
 def test_scim_foobar(scim2_server):
-    host, port = scim2_server
-
-    res = request.get(f"http://{host}:{port}")
+    res = request.get(f"http://localhost:{scim2_server.port}")
     ...
 ```
 
@@ -32,8 +30,7 @@ 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}")
+    http_client = Client(base_url=f"http://localhost:{scim2_server.port}")
     scim_client = SyncSCIMClient(http_client)
     scim_client.discover()
     return scim_client

pytest_scim2_server/__init__.py

@@ -1,5 +1,6 @@
 import threading
 import wsgiref.simple_server
+from dataclasses import dataclass
 
 import portpicker
 import pytest
@@ -9,6 +10,17 @@
 from scim2_server.utils import load_default_schemas
 
 
+@dataclass
+class Server:
+    """A proxy object that is returned by the pytest fixture."""
+
+    port: int
+    """The port on which the local http server listens."""
+
+    app: SCIMProvider
+    """The scim2-server WSGI application."""
+
+
 @pytest.fixture(scope="session")
 def scim2_server():
     """SCIM2 server running in a thread."""
@@ -27,8 +39,11 @@ def scim2_server():
 
     server_thread = threading.Thread(target=httpd.serve_forever)
     server_thread.start()
+
+    server = Server(port=port, app=provider)
+
     try:
-        yield host, port
+        yield server
     finally:
         httpd.shutdown()
         server_thread.join()

tests/test_scim2_server.py

@@ -5,8 +5,7 @@
 
 @pytest.fixture(scope="session")
 def scim_client(scim2_server):
-    host, port = scim2_server
-    http_client = Client(base_url=f"http://{host}:{port}")
+    http_client = Client(base_url=f"http://localhost:{scim2_server.port}")
     scim_client = SyncSCIMClient(http_client)
     scim_client.discover()
     return scim_client