[FEATURE]: Commande pour tester la doc API d'un PA par rapport à la norme #27

New issue

Open

opened 2026-01-29 13:41:32 +01:00 by ha · 4 comments

ha commented

2026-01-29 13:41:32 +01:00

Member

Description

Le but est d'avoir un test rapide pour voir si la doc swagger proposé par un PA respect la norme XP_Z12-013 :
https://git.pdplibre.org/Construction_PA/PA_Communautaire/src/branch/main/docs/norme/XP_Z12-013_SWAGGER_Annexes_A_et_B_V1.2

pdplibre test-url-doc http://localhost:8000/openapi.json

En sortie, avoir une ligne par test.

Exemple

No response

### Description Le but est d'avoir un test rapide pour voir si la doc swagger proposé par un PA respect la norme XP_Z12-013 : https://git.pdplibre.org/Construction_PA/PA_Communautaire/src/branch/main/docs/norme/XP_Z12-013_SWAGGER_Annexes_A_et_B_V1.2 ```bash pdplibre test-url-doc http://localhost:8000/openapi.json ``` En sortie, avoir une ligne par test. ### Exemple _No response_

👍 1

ha added the

enhancement

label

2026-01-29 13:41:32 +01:00

philippe.entzmann commented

2026-01-29 18:49:54 +01:00

Member

voir s'il n'existe pas déjà un outil pour comparer 2 API swagger

voir s'il n'existe pas déjà un outil pour *comparer* 2 API swagger

philippe.entzmann commented

2026-01-29 18:52:27 +01:00

Member

swagger-diff ?

[swagger-diff](https://github.com/civisanalytics/swagger-diff) ?

bruno.d2b commented

2026-02-02 15:08:04 +01:00

Member

J'ai fait du presque vibe coding avec l'environnement de dev lancé et le cli.

pac test swagger [--service flow|directory]

Fichiers

lib/swagger_validator.py : Module de validation
lib/init.py : Package init
command/test.py : Commande CLI modifiée

uv run pac test swagger http://localhost:8000/openapi.json
Validation swagger FLOW Service...
URL: http://localhost:8000/openapi.json

✅ Version OpenAPI: 3.1.0
✅ Info.title: FastAPI
✅ Info.version: 0.1.0
❌ Sécurité Bearer: MANQUANT - authentification Bearer requise (XP Z12-013 §5)
✅ Healthcheck: présent (/healthcheck)
✅ GET /v1/flows/{flowId}: présent
✅ GET /v1/healthcheck: présent
✅ POST /v1/flows: présent
❌ POST /v1/flows/search: MANQUANT

❌ 7/9 tests passés - NON CONFORME

J'ai fait du presque vibe coding avec l'environnement de dev lancé et le cli. pac test swagger <URL> [--service flow|directory] Fichiers - lib/swagger_validator.py : Module de validation - lib/__init__.py : Package init - command/test.py : Commande CLI modifiée uv run pac test swagger http://localhost:8000/openapi.json Validation swagger FLOW Service... URL: http://localhost:8000/openapi.json -------------------------------------------------- ✅ Version OpenAPI: 3.1.0 ✅ Info.title: FastAPI ✅ Info.version: 0.1.0 ❌ Sécurité Bearer: MANQUANT - authentification Bearer requise (XP Z12-013 §5) ✅ Healthcheck: présent (/healthcheck) ✅ GET /v1/flows/{flowId}: présent ✅ GET /v1/healthcheck: présent ✅ POST /v1/flows: présent ❌ POST /v1/flows/search: MANQUANT -------------------------------------------------- ❌ 7/9 tests passés - NON CONFORME