Files
Forge-Engine/screens/rendering/personnage_data.py
T
williamandClaude Sonnet 5 449c36fd5d
Build and deploy / test-python (push) Failing after 12s
Build and deploy / test-js (push) Successful in 6s
Build and deploy / build-and-push (push) Skipped
Build and deploy / deploy (push) Skipped
Bibliothèque de sprites animaux CraftPix (1/3) : catalogue, galerie, accès admin
Premier commit d'une fonctionnalité découpée en plusieurs lots (voir le
plan "Bibliothèque de sprites animaux CraftPix") : intègre 14 familles
d'animaux (15 variantes de couleur chacune) comme personnages Forge
sélectionnables, à côté des 6 Kenney existants — réservé au rôle admin,
licence CraftPix oblige (interdiction contractuelle de rendre ces sprites
utilisables par un compte "user" via l'application).

- screens/labels/animal_sprite_library.py (nouveau) : charge un manifest
  JSON généré une fois (voir scripts/generate_animal_sprite_manifest.py,
  commit suivant) et construit ADMIN_SPRITE_LIBRARY, dans le même format
  que l'existant PUBLIC_SPRITE_LIBRARY (screens/labels/sprite_library.py,
  ex-SPRITE_LIBRARY, renommé pour distinguer les deux). screens.SPRITE_LIBRARY
  reste le catalogue FUSIONNÉ (utilisé par resolve_personnage_animations
  pour la résolution runtime, sans filtrage par rôle — voir le constat
  d'exploration : le payload de jeu et /jouer/<slug> ne vérifient déjà
  aucun rôle nulle part).
- screens/labels/sprite_gallery.py (nouveau) : sprite_gallery_families()
  groupe la galerie par famille — un animal n'apparaît qu'une fois (sa
  variante "de base"), ses 15 couleurs se choisissent depuis le panneau
  de propriétés (render_variant_gallery, templates/screen_edit.html),
  répondant à la suggestion de l'utilisateur plutôt que d'encombrer la
  galerie d'ajout de 210 tuiles quasi identiques.
- routes/screens/screen_edit.py, routes/scenes/scene_edit_view.py :
  la galerie passée au template est filtrée par rôle
  (PUBLIC_SPRITE_LIBRARY pour un compte "user", SPRITE_LIBRARY complet
  pour un admin) — même idiome que core/auth_guard.py.
- core/sprite_gate.py (nouveau) + 4 routes d'écriture (element_add,
  element_set_personnage_data, scene_object_add, scene_object_personnage_data) :
  ferme la brèche d'un POST direct qui contournerait la galerie filtrée
  (403 si un compte non-admin tente d'assigner un personnage animal).
- tests/conftest.py : nouvelles fixtures user_client/user_game (compte
  "user" non-admin avec un projet assigné) pour tester le filtrage par
  rôle de bout en bout.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-31 21:49:05 +02:00

48 lines
2.1 KiB
Python

import json
from ..labels.sprite_library import PUBLIC_SPRITE_LIBRARY
from ..labels.animal_sprite_library import ADMIN_SPRITE_LIBRARY
# Résolution RUNTIME (jeu jouable) : le catalogue COMPLET, quel que soit le
# rôle du créateur — voir le plan "Bibliothèque de sprites animaux
# CraftPix" (aucun filtrage par rôle au runtime, seulement à la galerie de
# l'éditeur/l'écriture, voir routes/screens/screen_edit.py et
# routes/elements/element_add.py).
_SPRITE_LIBRARY = {**PUBLIC_SPRITE_LIBRARY, **ADMIN_SPRITE_LIBRARY}
_DEFAULT_PERSONNAGE_DATA = {"source": "forge", "forge_character": "male-adventurer"}
def resolve_personnage_data(el):
"""Décode attributes._personnage_data (voir set_personnage_data.py) en
dict Python, jamais None — un attribut absent/corrompu retombe sur le
défaut posé à la création (default_style_for_widget.py)."""
raw = (el.get("attributes") or {}).get("_personnage_data")
if not raw:
return dict(_DEFAULT_PERSONNAGE_DATA)
try:
data = json.loads(raw)
except (TypeError, ValueError):
return dict(_DEFAULT_PERSONNAGE_DATA)
return data if isinstance(data, dict) else dict(_DEFAULT_PERSONNAGE_DATA)
def resolve_personnage_animations(el):
"""{nom_animation: [urls...]} pour cet élément personnage, quelle que
soit sa source — Forge (SPRITE_LIBRARY) ou sprites propres au créateur
(ses propres frames importées, voir personnage-panel.js)."""
data = resolve_personnage_data(el)
if data.get("source") == "custom":
return data.get("animations") or {}
character = _SPRITE_LIBRARY.get(data.get("forge_character"))
return character["animations"] if character else {}
def resolve_personnage_idle_frame(el):
"""Première image de l'animation "idle" (ou, à défaut, de la première
animation disponible) — utilisée pour le rendu serveur ET l'aperçu
animé de l'éditeur, jamais vide tant qu'au moins une frame existe."""
animations = resolve_personnage_animations(el)
frames = animations.get("idle") or (next(iter(animations.values())) if animations else None)
return frames[0] if frames else ""