"""Réglages "❓ Boîte à quiz" propres au quiz AUTONOME/plein écran (demande explicite : "étendre les fonctionnalités de la boîte à quiz pour les RH qui veulent juste faire un quiz") — voir screens/rendering/ quiz_box_config.py, screens/rendering/quiz_box_templates.py. DISTINCT de "🎨 Style" (dialogue_box_style.py, partagé avec dialogue_box/score_widget, voir test_dialogue_box.py) : ce fichier ne teste que plein écran/ minuteur/modèle.""" from collections.abc import Callable from typing import Any from flask.testing import FlaskClient import db import screens from tests.conftest import not_none def _create_jeu2d_game(tmp_game_slug_cleanup: Callable[[str], str], name: str = "pytest_quiz_config") -> Any: slug = tmp_game_slug_cleanup(db.create_game(name)) screen_id = screens.create_screen(slug, "Scène 1", kind="jeu_2d") return slug, screen_id # ---------- Sanitizer/résolution ---------- def test_default_quiz_box_config_has_no_fullscreen_no_timer_and_the_defaut_template( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """ "Aucun" minuteur/plein écran désactivé par défaut — demande explicite : jamais imposé, seulement au choix du créateur.""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") obj = not_none(screens.get_scene_object(slug, obj_id)) config = screens.resolve_quiz_box_config(obj) assert config == screens.DEFAULT_QUIZ_BOX_CONFIG assert config["fullscreen"] is False assert config["timer_mode"] == "aucun" assert config["dialog_template"] == "defaut" assert config["page_template"] == "classique" def test_sanitize_quiz_box_config_clamps_timer_seconds(tmp_game_slug_cleanup: Callable[[str], str]) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") config = not_none(screens.set_scene_object_quiz_config(slug, obj_id, {"timer_seconds": 999999})) assert config["timer_seconds"] == 600 config = not_none(screens.set_scene_object_quiz_config(slug, obj_id, {"timer_seconds": 0})) assert config["timer_seconds"] == 3 def test_sanitize_quiz_box_config_rejects_unknown_timer_mode_and_templates( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") config = not_none( screens.set_scene_object_quiz_config( slug, obj_id, { "timer_mode": "toutes-les-secondes", "dialog_template": "arc-en-ciel", "page_template": "aquarelle", }, ) ) assert config["timer_mode"] == "aucun" assert config["dialog_template"] == "defaut" assert config["page_template"] == "classique" def test_sanitize_quiz_box_config_keeps_dialog_and_page_template_independent( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Demande explicite : les deux réglages sont conservés INDÉPENDAMMENT — un modèle "boîte" invalide ne doit jamais affecter le modèle "page" valide, et réciproquement ("verre" n'existe plus depuis la suppression des modèles "boîte" non-base, sert ici justement à vérifier qu'une valeur invalide retombe sur "defaut" SANS toucher au page_template valide à côté).""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") config = not_none( screens.set_scene_object_quiz_config(slug, obj_id, {"dialog_template": "verre", "page_template": "manga"}) ) assert config["dialog_template"] == "defaut" assert config["page_template"] == "manga" def test_sanitize_quiz_box_config_ignores_a_non_dict_input(tmp_game_slug_cleanup: Callable[[str], str]) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") config = screens.set_scene_object_quiz_config(slug, obj_id, "pas-un-dict") assert config == screens.DEFAULT_QUIZ_BOX_CONFIG def test_set_scene_object_quiz_config_persists_and_sanitizes(tmp_game_slug_cleanup: Callable[[str], str]) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config( slug, obj_id, { "fullscreen": True, "timer_mode": "question", "timer_seconds": 15, "dialog_template": "defaut", "page_template": "manga", }, ) obj = not_none(screens.get_scene_object(slug, obj_id)) config = screens.resolve_quiz_box_config(obj) assert config == { "fullscreen": True, "timer_mode": "question", "timer_seconds": 15, "dialog_template": "defaut", "page_template": "manga", } def test_set_scene_object_quiz_config_returns_none_for_unknown_object( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: slug, _ = _create_jeu2d_game(tmp_game_slug_cleanup) assert screens.set_scene_object_quiz_config(slug, 999999, {}) is None # ---------- Route ---------- def test_quiz_config_route_persists_config_and_returns_rendered_html( client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str] ) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") resp = client.post( f"/game/{slug}/scene-objects/{obj_id}/quiz-config", data=( '{"config": {"fullscreen": false, "timer_mode": "quiz", "timer_seconds": 30, "dialog_template": "defaut"}}' ), content_type="application/json", ) assert resp.status_code == 200 body = resp.get_json() assert body["config"]["fullscreen"] is False assert body["config"]["dialog_template"] == "defaut" assert 'class="quizBoxWidget"' in body["rendered_html"] obj = not_none(screens.get_scene_object(slug, obj_id)) assert screens.resolve_quiz_box_config(obj)["dialog_template"] == "defaut" def test_quiz_config_route_page_template_only_applies_when_fullscreen( client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str] ) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") resp = client.post( f"/game/{slug}/scene-objects/{obj_id}/quiz-config", data='{"config": {"fullscreen": true, "page_template": "manga"}}', content_type="application/json", ) assert resp.status_code == 200 body = resp.get_json() assert body["config"]["page_template"] == "manga" assert "quizBoxWidget--manga" in body["rendered_html"] def test_quiz_config_route_404s_for_missing_object(client: FlaskClient, game: str) -> None: resp = client.post( f"/game/{game}/scene-objects/999999/quiz-config", data='{"config": {}}', content_type="application/json" ) assert resp.status_code == 404 # ---------- Rendu — "contrat" de points d'ancrage (voir §3 du plan) : # chaque modèle doit exposer les mêmes data-quiz-role, quelle que soit sa # présentation, pour que le moteur JS partagé fonctionne quel que soit le # modèle choisi ---------- def test_render_quiz_box_defaut_is_unchanged_for_a_non_reconfigured_object( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Non-régression explicite : un quiz existant (jamais reconfiguré) doit rester visuellement identique à avant cette extension.""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert "quizBoxWidget--" not in html assert 'data-quiz-role="header"' in html assert 'data-quiz-role="question"' in html assert 'data-quiz-role="choices"' in html assert "Quête : Titre de la quête" in html assert html.count("quizBoxChoiceBtn") == 2 assert "quizBoxFooter" not in html def test_render_quiz_box_header_and_topbar_share_the_same_header_row( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Demande explicite : "le score doit être à l'intérieur de la boîte à quiz, pas à l'extérieur" — le score (topbar) et le titre (header) doivent être frères DANS le même bandeau ("quizBoxHeaderRow"), jamais deux bandes empilées de couleurs différentes.""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) for template in screens.QUIZ_BOX_DIALOG_TEMPLATES: obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config(slug, obj_id, {"dialog_template": template}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) row_start = html.index("quizBoxHeaderRow") row_end = html.index("quizBoxBody") # le bandeau se termine avant le corps assert row_start < html.index('data-quiz-role="header"', row_start) < row_end, template assert row_start < html.index('data-quiz-role="topbar"', row_start) < row_end, template def test_render_quiz_box_every_dialog_template_exposes_the_required_data_quiz_role_anchors( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Contrat commun (voir §3 du plan) — vérifié ici pour les modèles "boîte de dialogue" (fullscreen=False, voir le test jumeau pour les modèles "page de quiz").""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") for template in screens.QUIZ_BOX_DIALOG_TEMPLATES: screens.set_scene_object_quiz_config(slug, obj_id, {"dialog_template": template}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) for role in ("header", "question", "choices", "topbar", "score", "timer"): assert f'data-quiz-role="{role}"' in html, f"modèle {template!r} : ancrage {role!r} manquant" assert f'data-quiz-template="{template}"' in html assert 'class="quizBoxWidget' in html def test_render_quiz_box_every_page_template_exposes_the_required_data_quiz_role_anchors( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Même contrat, pour les modèles "page de quiz" (fullscreen=True) — "topbar" n'est PAS exigé ici (voir le contrat assoupli dans screens/rendering/quiz_box_templates.py : un modèle "page" n'a pas besoin de regrouper score/minuteur à masquer, il n'existe QUE plein écran).""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config(slug, obj_id, {"fullscreen": True}) for template in screens.QUIZ_BOX_PAGE_TEMPLATES: screens.set_scene_object_quiz_config(slug, obj_id, {"fullscreen": True, "page_template": template}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) for role in ("header", "question", "choices", "score", "timer"): assert f'data-quiz-role="{role}"' in html, f"modèle {template!r} : ancrage {role!r} manquant" assert f'data-quiz-template="{template}"' in html assert 'class="quizBoxWidget' in html def test_render_quiz_box_reflects_fullscreen_and_timer_data_attributes( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config( slug, obj_id, {"fullscreen": True, "timer_mode": "question", "timer_seconds": 42} ) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert 'data-fullscreen="1"' in html assert 'data-timer-mode="question"' in html assert 'data-timer-seconds="42"' in html def test_render_quiz_box_manga_shows_aucun_under_temps_when_no_timer_is_configured( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Demande explicite : "garde le temps mais si il n'y a pas de chrono marque en dessous de temps aucun" — la plaque "Temps" reste TOUJOURS visible (jamais masquée), avec "Aucun" en son absence.""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config( slug, obj_id, {"fullscreen": True, "timer_mode": "aucun", "page_template": "manga"} ) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert 'Aucun' in html def test_render_quiz_box_manga_leaves_the_timer_value_empty_when_a_timer_is_configured( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Un vrai minuteur est rempli par le moteur JS (compte à rebours), pas par le rendu serveur — jamais "Aucun" affiché en même temps qu'un minuteur réellement configuré.""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config( slug, obj_id, {"fullscreen": True, "timer_mode": "question", "timer_seconds": 20, "page_template": "manga"} ) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert '' in html def test_render_quiz_box_manga_has_a_progress_stepper_placeholder(tmp_game_slug_cleanup: Callable[[str], str]) -> None: """Demande explicite : "il n'y a pas le steper" — le HTML doit exposer un conteneur `data-manga-role="progress"` que le JS (forgeQuizMangaOnShow, static/js/play/quiz-box-templates.js) remplit au jeu (nombre de questions inconnu à la création de l'objet).""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config(slug, obj_id, {"fullscreen": True, "page_template": "manga"}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert '
' in html def test_render_quiz_box_manga_has_an_always_empty_result_zone_placeholder( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """Demande explicite : "il faut aussi adapter le modele manga pour avoir sa page de résultat" — voir forgeQuizMangaOnQuizComplete, static/js/play/quiz-box-templates.js, qui remplit/affiche ce conteneur EN JEU seulement (toujours vide côté rendu serveur).""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config(slug, obj_id, {"fullscreen": True, "page_template": "manga"}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert '' in html def test_render_quiz_box_manga_dialogue_applies_its_modifier_class_and_frame( tmp_game_slug_cleanup: Callable[[str], str], ) -> None: """ "Manga" (boîte de dialogue) — demande explicite : "il faut créer un modele de boite themé mangas qui va avec le mode de page mangas", validé via une maquette interactive. Reste une petite carte flottante (fullscreen=False), structure PARTAGÉE avec les autres modèles "boîte" (contrat déjà vérifié génériquement, voir test_render_quiz_box_every_dialog_template_exposes_the_required_data_quiz_role_anchors).""" slug, screen_id = _create_jeu2d_game(tmp_game_slug_cleanup) obj_id = screens.add_scene_object(slug, screen_id, kind="quiz_box") screens.set_scene_object_quiz_config(slug, obj_id, {"dialog_template": "manga_dialogue"}) obj = not_none(screens.get_scene_object(slug, obj_id)) html = screens.render_scene_object(obj) assert 'class="quizBoxWidget quizBoxWidget--mangaDialogue"' in html assert '