git » alan.git » master » tree

[master] / meta_schema.py 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
"""Lightweight schema checks for ALAN JSON structures."""
from __future__ import annotations

from typing import Any, Dict, List


def _is_bool(x: Any) -> bool:
    return isinstance(x, bool)


def _is_str(x: Any) -> bool:
    return isinstance(x, str)


def _is_list_of_str(x: Any) -> bool:
    return isinstance(x, list) and all(isinstance(i, str) for i in x)


def _check_np(feat: Dict[str, Any]) -> bool:
    required = {"noun_id", "feminine", "plural", "adjectives", "role", "use_irregular"}
    if not isinstance(feat, dict) or not required.issubset(feat.keys()):
        return False
    return (
        _is_str(feat["noun_id"])
        and _is_bool(feat["feminine"])
        and _is_bool(feat["plural"])
        and isinstance(feat["adjectives"], list)
        and _is_str(feat["role"])
        and _is_bool(feat["use_irregular"])
    )


def _check_features(f: Dict[str, Any]) -> bool:
    required = {"subject", "obj1", "verb_id", "tense", "use_irregular_verb"}
    if not isinstance(f, dict) or not required.issubset(f.keys()):
        return False
    if not _check_np(f["subject"]) or not _check_np(f["obj1"]):
        return False
    if f.get("obj2") is not None and not _check_np(f["obj2"]):
        return False
    return _is_str(f["verb_id"]) and _is_str(f["tense"]) and _is_bool(f["use_irregular_verb"])


def validate_schema(data: Dict[str, Any]) -> bool:
    """Shallow structural validation for generated JSON."""
    meta = data.get("meta", {})
    if not (_is_str(meta.get("version", "")) and _is_str(meta.get("description", ""))):
        return False
    if not isinstance(meta.get("rules", []), list):
        return False
    dictionary = meta.get("dictionary", {})
    for part in ("nouns", "verbs", "adjectives"):
        if not isinstance(dictionary.get(part, {}), dict):
            return False
        if not all(_is_str(k) and _is_str(v) for k, v in dictionary.get(part, {}).items()):
            return False

    sections: List[Dict[str, Any]] = data.get("sections", [])
    if not isinstance(sections, list) or not sections:
        return False
    for sec in sections:
        if not _is_str(sec.get("id", "")):
            return False
        if not isinstance(sec.get("questions", []), list):
            return False
        for q in sec.get("questions", []):
            if not all(_is_str(q.get(k, "")) for k in ("id", "item_type", "section_id", "stem")):
                return False
            if not isinstance(q.get("options", []), list) or len(q["options"]) != 4:
                return False
            for opt in q["options"]:
                if not (_is_str(opt.get("label", "")) and _is_str(opt.get("text", ""))):
                    return False
                if not _is_bool(opt.get("is_correct", False)):
                    return False
                if not _is_str(opt.get("explanation", "")):
                    return False
                if not _check_features(opt.get("features", {})):
                    return False
    return True