Add swagger-drogon generator

This commit is contained in:
gabdevele
2026-06-03 01:52:43 +02:00 Unverified
parent 1043768da7
commit 21883a4a8f
19 changed files with 1672 additions and 203 deletions
+4 -3
View File
@@ -8,13 +8,14 @@
- Added report media uploads at `POST /api/v1/reports/{id}/media`.
- Supported JPEG, PNG, WebP, MP4, WebM and QuickTime uploads.
- Report attachments now use the `/media` upload path.
- Added generated OpenAPI JSON from Drogon controller route macros and adjacent
metadata blocks.
- Added generated OpenAPI JSON through `scripts/swagger-drogon/`, combining
Drogon route macros, adjacent metadata blocks, C++ inference and the Visione
schema registry.
- Exposed `/api/v1/openapi.json` and `/api/v1/docs`.
- Added a small Streamlit API lab for visual endpoint testing.
## To do next
- Add richer OpenAPI schema metadata for request and response bodies.
- Expand OpenAPI schema coverage as endpoints evolve.
- Consider extracting `scripts/generate_openapi.py` into an open-source standalone
project once the conventions stabilize.
- Add minimal media upload integration tests after endpoint contracts settle.