Files
Forge-Engine/screens/labels/background_library.py
T
williamandClaude Sonnet 5 c57420c8c9 Phase 3 : hardening qualite de code - typage strict, securite, dead code, a11y
Config strictement stricte partout (ruff, mypy --strict, bandit, vulture,
import-linter, eslint, stylelint), aucune regle desactivee "pour ne pas
casser le build" - l'existant a ete corrige pour la satisfaire plutot que
l'inverse. Hooks pre-commit locaux (language: system) bloquants.

- Typage mypy --strict propage a tout le moteur (db, screens, auth, core,
  ai, routes, puis publish/scripts/tests/app.py/build_css.py).
- Securite : fuite de handle fichier Windows corrigee dans l'export SCORM
  (routes/publish/export_scorm.py), CSRF/RNG non-crypto/xAPI documentes
  (# nosec, # NOSONAR justifies), nouveau db.json_for_script() (echappe
  "</script>" dans le JSON embarque en <script>, 25 sites).
- Architecture : imports circulaires/F811 nettoyes, contrats
  import-linter respectes, code mort retire (vulture).
- Accessibilite : 69 champs de formulaire sans label correctement
  associe corriges (for/id ou aria-label) sur 11 templates.
- ESLint/Stylelint : lot mecanique JS/CSS, regles ajustees puis
  appliquees (aucune desactivee sans verification individuelle).
- Tests : isolation du compte admin partage (nettoyage ponctuel +
  fixture de teardown automatique en filet de securite), suite complete
  verte (591 tests Python, 241 tests JS).
- SonarQube Community Build self-heberge (Docker + PostgreSQL) : rapport
  complet analyse point par point, faux positifs documentes.
- .gitattributes ajoute (LF force) : core.autocrlf=true sur cette machine
  faisait echouer ESLint (linebreak-style) via un bug connu de git
  (checkout "en place" qui ignore l'eol force sur un fichier deja
  present sur disque - contourne en supprimant puis recreant chaque
  fichier suivi).

djLint (H021, styles inline) volontairement saute pour ce commit -
backlog assume, deja documente, traite dans un lot separe.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-15 16:06:15 +02:00

56 lines
2.2 KiB
Python

import json
import os
from typing import Any
# Bibliothèque d'images de fond CraftPix — RÉSERVÉE au rôle admin (voir
# core/sprite_gate.py, routes/scenes/scene_object_add.py), même règle que
# la bibliothèque de sprites animaux (screens/labels/animal_sprite_library.py) :
# licence CraftPix, interdiction de rendre ces images utilisables par un
# compte "user". Générée une fois par
# scripts/generate_background_manifest.py depuis assets/background/<pack>/
# (pack source, non versionné) vers static/backgrounds/<pack_slug>/
# <image>.png, avec un manifest JSON portant les dimensions RÉELLES
# (largeur/hauteur) de chaque image — utilisées comme taille par défaut de
# l'objet de scène "fond" posé (voir screens/scenes/add_scene_object.py),
# modifiable ensuite comme n'importe quel objet (panneau "Position & taille").
_MANIFEST_PATH = os.path.join(
os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
"static",
"backgrounds",
"manifest.json",
)
def _load_manifest() -> dict[str, Any]:
try:
with open(_MANIFEST_PATH, encoding="utf-8") as f:
return dict(json.load(f))
except FileNotFoundError:
# Poste de dev sans les images de fond copiées (script pas encore
# lancé), ou paquet exporté pour un jeu qui n'utilise aucun fond
# CraftPix (voir publish/build_scorm_package.py, à étendre pour
# copier sélectivement static/backgrounds/ le jour où un export
# utilise ce widget) : aucun fond disponible, pas une erreur.
return {}
def _build_library() -> dict[str, dict[str, Any]]:
manifest = _load_manifest()
library: dict[str, dict[str, Any]] = {}
for pack_slug, pack in manifest.items():
pack_label = pack["label"]
for image_name, dims in pack["images"].items():
slug = f"{pack_slug}-{image_name}"
library[slug] = {
"label": f"{pack_label} — {image_name.replace('_', ' ')}",
"url": f"/static/backgrounds/{pack_slug}/{image_name}.png",
"width": dims["width"],
"height": dims["height"],
"pack": pack_slug,
"pack_label": pack_label,
}
return library
BACKGROUND_LIBRARY = _build_library()