Skip to content

feat(compiler): @pure vérifie aussi l'absence d'effets de bord#45

Open
NyalephTheCat wants to merge 2 commits into
leek-wars:masterfrom
NyalephTheCat:feature/pure-annotation-purity-check
Open

feat(compiler): @pure vérifie aussi l'absence d'effets de bord#45
NyalephTheCat wants to merge 2 commits into
leek-wars:masterfrom
NyalephTheCat:feature/pure-annotation-purity-check

Conversation

@NyalephTheCat

@NyalephTheCat NyalephTheCat commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

L'annotation @pure ne signalait jusqu'ici que le rejet du résultat (comme @NODISCARD). Elle vérifie désormais que la fonction est réellement pure.

Une fonction @pure est signalée (WARNING ANNOTATION_NOT_PURE) quand son corps :

  • écrit / incrémente une variable externe à la fonction (globale, champ, champ statique, this, ou variable capturée d'une portée englobante) ;
  • appelle une fonction système à effet de bord (debug*, mutateurs Array/Map/Set : push, pop, sort, mapPut, setRemove…) ;
  • appelle une fonction utilisateur qui n'est pas elle-même pure.

La pureté des appels est vérifiée de façon transitive après l'analyse complète (le graphe d'appels n'est connu qu'à ce moment, à cause des références avant déclaration) : appeler une fonction non annotée mais réellement pure est donc autorisé, et la récursion / récursion mutuelle est gérée via les cycles.

La détection se greffe sur la passe analyze() existante (pas de visiteur AST dédié) ; les effets directs sont signalés en ligne, les appels inter-fonctions sont résolus dans resolvePurity().

Côté générateur (consommateur de ce drapeau de pureté) : les fonctions de combat à effet de bord sont déclarées setImpure() dans NyalephTheCat/leek-wars-generator@0a80ace — branche feature/fight-function-purity.

L'annotation @pure ne signalait jusqu'ici que le rejet du résultat (comme
@NODISCARD). Elle vérifie désormais que la fonction est réellement pure.

Une fonction @pure est signalée (WARNING ANNOTATION_NOT_PURE) quand son corps :
- écrit / incrémente une variable externe à la fonction (globale, champ,
  champ statique, this, ou variable capturée d'une portée englobante) ;
- appelle une fonction système à effet de bord (debug*, mutateurs
  Array/Map/Set : push, pop, sort, mapPut, setRemove…) ;
- appelle une fonction utilisateur qui n'est pas elle-même pure.

La pureté des appels est vérifiée de façon transitive après l'analyse complète
(le graphe d'appels n'est connu qu'à ce moment, à cause des références avant
déclaration) : appeler une fonction non annotée mais réellement pure est donc
autorisé, et la récursion / récursion mutuelle est gérée via les cycles.

La détection se greffe sur la passe analyze() existante (pas de visiteur AST
dédié) ; les effets directs sont signalés en ligne, les appels inter-fonctions
sont résolus dans resolvePurity().

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@NyalephTheCat NyalephTheCat marked this pull request as draft June 16, 2026 16:24
Le check @pure ne connaissait que les fonctions à effet de bord de la
bibliothèque standard (liste IMPURE_SYSTEM_FUNCTIONS). Les fonctions
fournies par un hôte (ex. le générateur Leek Wars) étaient toutes
considérées pures, donc appelables depuis une fonction @pure sans
avertissement, même lorsqu'elles agissent sur l'état.

LeekFunctions porte désormais un drapeau de pureté (pur par défaut,
setImpure() pour s'en exclure) : un hôte peut déclarer la pureté de
chacune de ses fonctions directement sur l'objet. isImpureSystemFunction()
consulte ce drapeau en plus de la liste standard, et LeekFunctionCall lui
passe la fonction plutôt que son seul nom.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@NyalephTheCat NyalephTheCat marked this pull request as ready for review June 16, 2026 17:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant