Files
Forge-Engine/db/global_vars/create_global_variable.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

42 lines
1.8 KiB
Python

from ..connection import connect
from .coerce_structured_value import coerce_structured_value
from .ensure_global_vars_schema import PLAYER_SHARED, ensure_global_vars_schema
def create_global_variable(
slug: str, name: str, var_type: str = "texte", default_value: str = "", per_player: bool = True
) -> int | None:
"""Crée la ligne "modèle" d'une variable globale (toujours
player_id=PLAYER_SHARED, quel que soit per_player — voir
ensure_global_vars_schema.py) si son nom n'existe pas déjà ; si elle
existe déjà, ne touche à rien et renvoie simplement son id existant,
pour que "créer" depuis le sélecteur de condition de visibilité (voir
screen_edit.html) reste sans risque même en cas de double clic/
soumission.
per_player (réglé une fois, à la création, coché par défaut) :
True = chaque joueur aura sa propre valeur (une ligne créée
paresseusement à sa première écriture, voir
update_global_variable_value.py) ; False = valeur unique partagée par
tous les joueurs (ex. un compteur de visiteurs global)."""
name = (name or "").strip()
if not name:
return None
default_value = coerce_structured_value(var_type, default_value)
ensure_global_vars_schema(slug)
conn = connect(slug)
existing = conn.execute(
"SELECT id FROM _global_variables WHERE name = ? AND player_id = ?", (name, PLAYER_SHARED)
).fetchone()
if existing:
conn.close()
return int(existing["id"])
conn.execute(
"INSERT INTO _global_variables (name, type, value, player_id, per_player) VALUES (?, ?, ?, ?, ?)",
(name, var_type, default_value, PLAYER_SHARED, 1 if per_player else 0),
)
new_id = int(conn.execute("SELECT last_insert_rowid() AS id").fetchone()["id"])
conn.commit()
conn.close()
return new_id