feat: add app factory with health endpoint and test infrastructure

src/fastapi_oidc_op/app.py

@@ -0,0 +1,23 @@
+from fastapi import FastAPI
+
+from fastapi_oidc_op.config import Settings
+
+
+def create_app(settings: Settings | None = None) -> FastAPI:
+    if settings is None:
+        settings = Settings()  # type: ignore[call-arg]
+
+    app = FastAPI(
+        title="FastAPI OIDC OP",
+        version="0.1.0",
+        docs_url="/docs" if settings.debug else None,
+        redoc_url=None,
+    )
+
+    app.state.settings = settings
+
+    @app.get("/health")
+    async def health() -> dict[str, str]:
+        return {"status": "ok"}
+
+    return app

tests/conftest.py

@@ -0,0 +1,20 @@
+from collections.abc import AsyncIterator
+
+import pytest
+from httpx import ASGITransport, AsyncClient
+
+from fastapi_oidc_op.app import create_app
+from fastapi_oidc_op.config import Settings
+
+
+@pytest.fixture
+def settings() -> Settings:
+    return Settings(issuer="http://localhost:8000")
+
+
+@pytest.fixture
+async def client(settings: Settings) -> AsyncIterator[AsyncClient]:
+    app = create_app(settings)
+    transport = ASGITransport(app=app)
+    async with AsyncClient(transport=transport, base_url=settings.issuer) as ac:
+        yield ac

tests/test_app.py

@@ -0,0 +1,15 @@
+from httpx import AsyncClient
+
+
+async def test_health_endpoint(client: AsyncClient) -> None:
+    response = await client.get("/health")
+    assert response.status_code == 200
+    data = response.json()
+    assert data["status"] == "ok"
+
+
+async def test_app_has_title(client: AsyncClient) -> None:
+    response = await client.get("/openapi.json")
+    assert response.status_code == 200
+    data = response.json()
+    assert data["info"]["title"] == "FastAPI OIDC OP"