# -*- coding: utf-8 -*- """Contrôle de structure des mots : le filet de sécurité du savoir. `verifier_entree(d)` contrôle une entrée de catalogue (la forme historique complet=True) et renvoie la liste de ses erreurs (vide si tout va bien). `verifier_base()` contrôle tous les mots en base. Les commandes `importer_mots`, `ajouter_mot` et `verifier_mots` s'appuient dessus : aucune écriture sans contrôle préalable. """ import re TAMPONS = {"JUNIOR", "ADOS", "SÉNIOR"} REGISTRES = {"soutenu", "commun", "populaire"} PISTES = {"sens", "origines", "registre", "emplois", "voisins"} SLUG_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$") # champs requis par type de mini-jeu (ce que le moteur lit dans chaque étape) ETAPES = { "choose": ("prompt", "items"), "choose1": ("prompt", "items"), "chain": ("slots", "decoys"), "registre": ("prompt", "reponse", "pourquoi"), "judge": ("prompt", "items"), "sort": ("prompt", "la", "lb", "items"), } def _err(cond, message, erreurs, ou): if cond: erreurs.append(f"{ou} : {message}" if ou else message) def verifier_entree(d, ou=""): """Contrôle une entrée de catalogue ; renvoie une liste d'erreurs.""" e = [] _err(not isinstance(d, dict), "entrée illisible (objet attendu)", e, ou) if not isinstance(d, dict): return e slug = d.get("id") or "" _err(not SLUG_RE.match(slug), f"identifiant suspect « {slug} »", e, ou) for champ in ("title", "kind", "teaser", "mapNote"): _err(not str(d.get(champ) or "").strip(), f"« {champ} » est vide", e, ou) _err(d.get("stamp") not in TAMPONS, f"tampon inconnu « {d.get('stamp')} » (attendus : JUNIOR, ADOS, SÉNIOR)", e, ou) carte = d.get("card") or {} for champ in ("def", "date", "registre", "anecdote"): _err(not str(carte.get(champ) or "").strip(), f"card.{champ} est vide", e, ou) etym = carte.get("etym") _err(not isinstance(etym, list) or not etym or not all(isinstance(x, str) and x.strip() for x in etym), "card.etym doit être une liste non vide de textes", e, ou) vois = carte.get("vois") _err(not isinstance(vois, list) or not all(isinstance(x, str) and x.strip() for x in vois), "card.vois doit être une liste de textes", e, ou) pistes = d.get("pistes") or {} _err(set(pistes.keys()) != PISTES, f"les pistes doivent être exactement {sorted(PISTES)} (trouvées : {sorted(pistes.keys())})", e, ou) for nom, piste in pistes.items(): sous = f"{ou}/pistes.{nom}" if ou else f"pistes.{nom}" _err(not str(piste.get("one") or "").strip(), "l'introduction (one) est vide", e, sous) _err(not str(piste.get("reward") or "").strip(), "la récompense (reward) est vide", e, sous) steps = piste.get("steps") _err(not isinstance(steps, list) or not steps, "aucune étape (steps)", e, sous) if isinstance(steps, list): for i, s in enumerate(steps): _verifier_etape(s, e, f"{sous}.steps[{i}]") resolve = d.get("resolve") or {} perles = resolve.get("beads") or {} ok = perles.get("ok") _err(not isinstance(ok, list) or not ok or not all(isinstance(x, str) and x.strip() for x in ok), "resolve.beads.ok doit être une liste non vide de textes", e, ou) intrus = perles.get("decoys") _err(not isinstance(intrus, list) or not intrus or not all(isinstance(x, dict) and str(x.get("t") or "").strip() and str(x.get("why") or "").strip() for x in intrus), "resolve.beads.decoys doit être une liste non vide de {t, why}", e, ou) return e def _verifier_etape(s, e, ou): if not isinstance(s, dict): _err(True, "étape illisible (objet attendu)", e, ou) return t = s.get("type") if t == "slider": _err(True, "le type « slider » a été retiré : étape « registre » attendue", e, ou) return if t not in ETAPES: _err(True, f"type d'étape inconnu « {t} » (attendus : {sorted(ETAPES)})", e, ou) return for champ in ETAPES[t]: _err(s.get(champ) in (None, ""), f"champ « {champ} » manquant", e, ou) if t in ("choose", "choose1", "judge", "sort"): items = s.get("items") # un judge peut n'apporter qu'une seule phrase à juger ; # les autres mini-jeux ont besoin de vrais choix minimum = 1 if t == "judge" else 2 _err(not isinstance(items, list) or len(items) < minimum, f"au moins {minimum} proposition(s) sont attendue(s)", e, ou) if isinstance(items, list): n_ok = 0 for j, it in enumerate(items): sous = f"{ou}.items[{j}]" if t == "judge": _err(not str(it.get("s") or "").strip(), "phrase (s) vide", e, sous) else: _err(not str(it.get("t") or "").strip(), "texte (t) vide", e, sous) _err(not str(it.get("why") or "").strip(), "explication (why) vide", e, sous) n_ok += 1 if it.get("ok") else 0 if t == "choose": _err(n_ok < 1, "aucune bonne réponse", e, ou) if t == "choose1": _err(n_ok != 1, "exactement une bonne réponse attendue", e, ou) if t == "chain": for cle in ("slots", "decoys"): bloc = s.get(cle) _err(not isinstance(bloc, list) or not all(isinstance(x, dict) and str(x.get("t") or "").strip() and str(x.get("why") or "").strip() for x in bloc), f"{cle} doit être une liste de {{t, why}} remplis", e, ou) _err(not s.get("slots"), "il faut au moins un maillon juste", e, ou) if t == "registre": _err(s.get("reponse") not in REGISTRES, f"réponse « {s.get('reponse')} » hors du ternaire (soutenu, commun, populaire)", e, ou)