feat: add the pystapi-validator (#8)

Ran with:
```
uv run stapi-validator
```
Will need a local instance of stapi fastapi to run for the tests to
pass.

---------

Co-authored-by: dylan bartels <dylan.bartels@live-eo.com>
Co-authored-by: Pete Gadomski <pete.gadomski@gmail.com>

Author: 3 people

pyproject.toml

@@ -5,8 +5,9 @@ description = "Monorepo for Satellite Tasking API (STAPI) Specification Python p
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
+    "pystapi-validator",
     "stapi-pydantic",
-    "stapi-fastapi",
+    "stapi-fastapi"
 ]
 
 [dependency-groups]
@@ -30,9 +31,10 @@ docs = [
 default-groups = ["dev", "docs"]
 
 [tool.uv.workspace]
-members = ["stapi-pydantic", "stapi-fastapi"]
+members = ["pystapi-validator", "stapi-pydantic", "stapi-fastapi"]
 
 [tool.uv.sources]
+pystapi-validator.workspace = true
 stapi-pydantic.workspace = true
 stapi-fastapi.workspace = true
 
@@ -58,6 +60,7 @@ max-complexity = 8  # default 10
 [tool.mypy]
 strict = true
 files = [
+    "pystapi-validator/src/pystapi_validator/**/*.py",
     "stapi-pydantic/src/stapi_pydantic/**/*.py",
     "stapi-fastapi/src/stapi_fastapi/**/*.py"
 ]

pystapi-validator/README.md

@@ -0,0 +1,27 @@
+# pystapi-validator
+
+This project provides API validation for STAPI FastAPI implementations using Schemathesis against the latest STAPI OpenAPI
+specification.
+
+## Configuration
+
+- The STAPI OpenAPI specification is fetched from:
+  [STAPI OpenAPI Spec](https://raw.githubusercontent.com/stapi-spec/stapi-spec/refs/heads/main/openapi.yaml)
+- The base URL for the API being tested is set to `http://localhost:8000`. Update the `BASE_URL` in `tests/validate_api.py`
+  if your API is hosted elsewhere.
+
+## Setup
+
+1. Install dependencies:
+
+```bash
+uv sync
+```
+
+1. Run tests and generate report:
+
+```bash
+uv run pytest tests/validate_api.py --html=report.html --self-contained-html
+```
+
+1. Open `report.html` in your browser to view the detailed test report.

pystapi-validator/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "pystapi-validator"
+version = "0.1.0"
+description = "API validation for STAPI FastAPI using Schemathesis and OpenAPI YAML with reporting"
+authors = [
+    { name = "Brian Terry", email = "brian.b.terry@ama-inc.com" }
+]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "schemathesis>=3.37.0",
+    "pytest>=8.3.3",
+    "requests>=2.32.3",
+    "pyyaml>=6.0.2",
+    "pytest-html>=4.1.1",
+    "pytest-metadata>=3.1.1",
+]
+
+[project.scripts]
+pystapi-validator = "pystapi_validator:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

pystapi-validator/src/pystapi_validator/__init__.py

@@ -0,0 +1,11 @@
+import sys
+
+import pytest
+
+
+def main() -> None:
+    sys.exit(pytest.main(["pystapi-validator/tests/validate_api.py"]))
+
+
+if __name__ == "__main__":
+    main()

pystapi-validator/tests/__init__.py

@@ -0,0 +1,61 @@
+import json
+
+import pytest
+import schemathesis
+from schemathesis.checks import (
+    content_type_conformance,
+    negative_data_rejection,
+    not_a_server_error,
+    response_headers_conformance,
+    response_schema_conformance,
+    status_code_conformance,
+)
+
+schemathesis.experimental.OPEN_API_3_1.enable()
+
+SCHEMA_URL = "https://raw.githubusercontent.com/stapi-spec/stapi-spec/refs/heads/main/openapi.yaml"
+schema = schemathesis.from_uri(SCHEMA_URL)
+
+BASE_URL = "http://localhost:8000"
+
+
+@schema.parametrize()
+def test_api(case):
+    response = case.call_and_validate(base_url=BASE_URL)
+    case.validate_response(response)
+
+    not_a_server_error(response, case)
+    status_code_conformance(response, case)
+    content_type_conformance(response, case)
+    response_schema_conformance(response, case)
+    response_headers_conformance(response, case)
+    negative_data_rejection(response, case)
+
+
+def test_openapi_specification():
+    assert schema.validate()
+
+
+@pytest.hookimpl(tryfirst=True, hookwrapper=True)
+def pytest_runtest_makereport(item, call):
+    outcome = yield
+    rep = outcome.get_result()
+    if rep.when == "call":
+        item.session.results = getattr(item.session, "results", {})
+        item.session.results[item.nodeid] = rep
+
+
+def pytest_sessionfinish(session, exitstatus):
+    if hasattr(session, "results"):
+        with open("test_results.json", "w") as f:
+            json.dump(
+                {
+                    nodeid: {
+                        "outcome": rep.outcome,
+                        "longrepr": str(rep.longrepr) if rep.longrepr else None,
+                    }
+                    for nodeid, rep in session.results.items()
+                },
+                f,
+                indent=2,
+            )