Forge-Engine/tests/game/test_personnage_role.py

"""Rôle d'un personnage posé sur une scène 2D (joueur/ennemie/pnj, voir
game_engine/rendering/personnage_role.py) : seul un personnage "joueur" est
déplacé/animé automatiquement au clavier et suivi par la caméra (voir
static/game/js/play/personnage-controller.js, testé côté client dans
static/game/js/play/__tests__/personnage-controller.test.js)."""

import re
from collections.abc import Callable
from typing import Any

from flask.testing import FlaskClient

import game_engine
from tests.conftest import not_none


def _create_jeu2d_game(
    client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str], name: str = "pytest_role"
) -> Any:
    resp = client.post("/games/new", data={"name": name}, follow_redirects=False)
    slug = tmp_game_slug_cleanup(resp.headers["Location"].rstrip("/").split("/")[-1])
    screen_id = game_engine.create_screen(slug, "Scène 1", kind="jeu_2d")
    return slug, screen_id


def _add_personnage(client: FlaskClient, slug: str, screen_id: int) -> Any:
    resp = client.post(
        f"/game/{slug}/screens/{screen_id}/scene-objects/add", data={"kind": "personnage"}, follow_redirects=False
    )
    assert resp.status_code == 302, resp.data
    return int(not_none(re.search(r"selected=(\d+)", resp.headers["Location"])).group(1))


def test_freshly_placed_personnage_defaults_to_the_pnj_role(
    client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str]
) -> None:
    """Demande explicite : un personnage fraîchement posé n'est JAMAIS le
    joueur par défaut, même le tout premier de la scène — voir
    game_engine/scenes/add_scene_object.py, qui enregistre "pnj" explicitement.
    Passer un personnage en "Joueur" est désormais toujours un choix
    explicite (menu "🏷️ Rôle" du panneau de propriétés)."""
    slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
    obj_id = _add_personnage(client, slug, screen_id)
    obj = not_none(game_engine.get_scene_object(slug, obj_id))
    assert game_engine.resolve_personnage_role(obj) == "pnj"


def test_second_personnage_also_defaults_to_the_pnj_role(
    client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str]
) -> None:
    """Non-régression : un deuxième personnage ne doit pas non plus
    retomber sur "joueur" — sinon il se faisait exclure à tort de "🧩
    Collision" (voir scene_edit_view.py, qui exclut TOUJOURS le joueur)."""
    slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
    _add_personnage(client, slug, screen_id)
    second_id = _add_personnage(client, slug, screen_id)
    obj = not_none(game_engine.get_scene_object(slug, second_id))
    assert game_engine.resolve_personnage_role(obj) == "pnj"


def test_role_route_persists_a_valid_role(client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str]) -> None:
    slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
    obj_id = _add_personnage(client, slug, screen_id)

    resp = client.post(
        f"/game/{slug}/scene-objects/{obj_id}/role", data='{"role": "pnj"}', content_type="application/json"
    )
    assert resp.status_code == 200
    assert resp.get_json() == {"ok": True, "role": "pnj"}
    obj = not_none(game_engine.get_scene_object(slug, obj_id))
    assert game_engine.resolve_personnage_role(obj) == "pnj"


def test_role_route_rejects_an_unknown_role(client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str]) -> None:
    slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
    obj_id = _add_personnage(client, slug, screen_id)

    resp = client.post(
        f"/game/{slug}/scene-objects/{obj_id}/role", data='{"role": "boss-final"}', content_type="application/json"
    )
    assert resp.get_json()["role"] == "joueur"  # retombe sur le défaut plutôt que d'enregistrer n'importe quoi


def test_role_route_404s_for_missing_object(client: FlaskClient, game: str) -> None:
    resp = client.post(
        f"/game/{game}/scene-objects/999999/role", data='{"role": "ennemie"}', content_type="application/json"
    )
    assert resp.status_code == 404


def test_full_game_payload_exposes_the_resolved_role_for_personnage_objects(
    client: FlaskClient, tmp_game_slug_cleanup: Callable[[str], str]
) -> None:
    slug, screen_id = _create_jeu2d_game(client, tmp_game_slug_cleanup)
    obj_id = _add_personnage(client, slug, screen_id)
    client.post(
        f"/game/{slug}/scene-objects/{obj_id}/role", data='{"role": "ennemie"}', content_type="application/json"
    )

    payload = game_engine.full_game_payload(slug)
    scene_screen = next(s for s in payload["screens"] if s["id"] == screen_id)
    obj_payload = next(o for o in scene_screen["elements"] if o["id"] == obj_id)
    assert obj_payload["personnage_role"] == "ennemie"