feat(series-studio): initial implementation of unified series studio engine (PDF & DOCX)
This commit is contained in:
commit
03d9922066
20 files changed
+7082
No files matched your search
@@ -0,0 +1,79 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
validator.py
|
||||
Validateur JSON pour series-studio avec erreurs précises et localisées
|
||||
(chemin du champ, cause de l'erreur, correction attendue).
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import jsonschema
|
||||
|
||||
SCHEMA_PATH = os.path.join(os.path.dirname(__file__), "schema.json")
|
||||
|
||||
def load_schema():
|
||||
with open(SCHEMA_PATH, "r", encoding="utf-8") as f:
|
||||
return json.load(f)
|
||||
|
||||
_SCHEMA = load_schema()
|
||||
_VALIDATOR = jsonschema.Draft7Validator(_SCHEMA)
|
||||
|
||||
def format_error(err: jsonschema.ValidationError):
|
||||
"""Formate une erreur jsonschema en dictionnaire clair et localisé."""
|
||||
path = ".".join(str(p) for p in err.path)
|
||||
if not path:
|
||||
if err.validator == "required":
|
||||
# Le message indique quelle propriété manque
|
||||
prop = err.message.split("'")[1] if "'" in err.message else "champ_requis"
|
||||
path = prop
|
||||
else:
|
||||
path = "source"
|
||||
|
||||
cause = err.message
|
||||
fix = f"Vérifier le champ '{path}' : respecter la structure spécifiée dans schema.json."
|
||||
|
||||
if err.validator == "type":
|
||||
fix = f"Le champ '{path}' doit être de type '{err.validator_value}' au lieu de '{type(err.instance).__name__}'."
|
||||
elif err.validator == "required":
|
||||
fix = f"Ajouter le champ manquant requis : '{path}'."
|
||||
elif err.validator == "enum":
|
||||
fix = f"La valeur pour '{path}' doit être parmi {err.validator_value}."
|
||||
elif err.validator == "minimum":
|
||||
fix = f"La valeur de '{path}' doit être supérieure ou égale à {err.validator_value}."
|
||||
|
||||
return {
|
||||
"path": path,
|
||||
"field": path,
|
||||
"cause": cause,
|
||||
"fix": fix
|
||||
}
|
||||
|
||||
def validate_source(source):
|
||||
"""Valide une source JSON complète et renvoie un dictionnaire de résultat."""
|
||||
if not isinstance(source, dict):
|
||||
return {
|
||||
"valid": False,
|
||||
"errors": [
|
||||
{
|
||||
"path": "source",
|
||||
"field": "source",
|
||||
"cause": "Le document racine doit être un objet JSON (dict)",
|
||||
"fix": "Fournir un objet JSON avec schema_version, cartouche, exercices, etc."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
errors = []
|
||||
for err in _VALIDATOR.iter_errors(source):
|
||||
errors.append(format_error(err))
|
||||
|
||||
if errors:
|
||||
return {
|
||||
"valid": False,
|
||||
"errors": errors
|
||||
}
|
||||
return {
|
||||
"valid": True,
|
||||
"errors": []
|
||||
}
|
||||
Reference in new issue
Block a user