Files
Forge-Engine/scripts/generate_background_manifest.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

83 lines
3.6 KiB
Python

"""Script à usage unique (PAS exécuté au runtime du moteur) : copie les
images de fond CraftPix depuis assets/background/<pack>/ (pack source, non
versionné dans static/) vers static/backgrounds/<pack_slug>/<image>.png, et
écrit static/backgrounds/manifest.json (dimensions RÉELLES en pixels de
chaque image, lues dans l'en-tête PNG — nécessaires pour proposer une
taille par défaut cohérente à la pose de l'objet de scène "fond", voir
screens/scenes/add_scene_object.py). Réutilisé une fois par moi via
`python scripts/generate_background_manifest.py`, jamais importé par le
moteur.
Accès réservé au rôle admin (voir screens/labels/background_library.py,
routes/scenes/scene_edit_view.py) : licence CraftPix, ne redistribue pas
ces images à des comptes "user" — même règle que la bibliothèque de
sprites animaux (screens/labels/animal_sprite_library.py)."""
import json
import os
import shutil
import struct
from typing import Any
_BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
_SRC_ROOT = os.path.join(_BASE_DIR, "assets", "background")
_DST_ROOT = os.path.join(_BASE_DIR, "static", "backgrounds")
# Nom de dossier source -> (slug interne court, libellé FR). Seule
# l'image COMBINÉE de premier niveau (game_background_N.png) est reprise
# pour l'instant — les calques séparés (layers/) permettraient un effet de
# parallaxe, hors scope de ce premier jet.
_PACKS = {
"craftpix-net-208967-flying-island-battle-backgrounds": ("flying_island", "Île volante"),
}
def _png_dimensions(path: str) -> tuple[int, int]:
"""Largeur/hauteur RÉELLES lues dans l'en-tête PNG (chunk IHDR, 8
octets de signature + 4 octets de taille + 4 octets de type "IHDR"
avant les 2 x 4 octets de dimensions, big-endian) — évite une
dépendance à Pillow (absente de ce projet) pour un besoin aussi
ponctuel."""
with open(path, "rb") as f:
header = f.read(24)
if len(header) < 24 or header[:8] != b"\x89PNG\r\n\x1a\n" or header[12:16] != b"IHDR":
raise ValueError(f"pas un PNG valide : {path}")
width, height = struct.unpack(">II", header[16:24])
return width, height
def main() -> None:
manifest: dict[str, Any] = {}
for pack_folder, (pack_slug, pack_label) in sorted(_PACKS.items()):
pack_dir = os.path.join(_SRC_ROOT, pack_folder, "PNG")
if not os.path.isdir(pack_dir):
print(f"SKIP (introuvable) : {pack_folder}")
continue
images: dict[str, Any] = {}
for name in sorted(os.listdir(pack_dir)):
src_dir = os.path.join(pack_dir, name)
src_file = os.path.join(src_dir, f"{name}.png")
if not os.path.isfile(src_file):
continue
dst_dir = os.path.join(_DST_ROOT, pack_slug)
os.makedirs(dst_dir, exist_ok=True)
dst_file = os.path.join(dst_dir, f"{name}.png")
shutil.copy2(src_file, dst_file)
width, height = _png_dimensions(dst_file)
images[name] = {"width": width, "height": height}
if images:
manifest[pack_slug] = {"label": pack_label, "images": images}
print(f"{pack_slug} ({pack_label}) : {len(images)} images copiées")
else:
print(f"SKIP (aucune image) : {pack_folder}")
os.makedirs(_DST_ROOT, exist_ok=True)
manifest_path = os.path.join(_DST_ROOT, "manifest.json")
with open(manifest_path, "w", encoding="utf-8") as f:
json.dump(manifest, f, ensure_ascii=False, indent=2, sort_keys=True)
print(f"\nManifest écrit : {manifest_path}")
if __name__ == "__main__":
main()