Numéros de version brûlés sur PyPI¶

Ce document recense les numéros de version qui ne peuvent plus jamais être
publiés sur PyPI pour le paquet forge-mvc. Il sert de garde-fou : avant
tout bump de version et tout tag de release, vérifier que la version cible
n'est pas dans la liste ci-dessous.

Pourquoi un numéro peut être « brûlé »¶

PyPI applique une règle stricte et irréversible : un numéro de version (et un
nom de fichier) qui a déjà été utilisé ne peut jamais être réutilisé, même
après suppression de la release. Une tentative de réupload échoue avec une
erreur du type « This filename has already been used ».

Yanker (remiser) une version ne libère pas le numéro non plus : la version
reste occupée par son ancien contenu. Que le numéro soit yanked ou supprimé,
il est indisponible pour un nouveau contenu.

Liste des numéros interdits¶

Version	Statut	Origine	Action requise
`1.0.1`	supprimée de PyPI (2026-06-09)	prototype Forge 1.x d'avant le renumérotage vers la trajectoire publique 1.0	ne jamais bumper ni taguer
`1.1.0`	supprimée de PyPI (2026-06-09)	prototype Forge 1.x d'avant le renumérotage vers la trajectoire publique 1.0	ne jamais bumper ni taguer

Ces deux versions avaient été publiées le 2026-05-01, puis remisées (yanked),
puis supprimées définitivement le 2026-06-09 pour réparer la commande
forge update (voir section suivante).

Conséquence pratique sur le versionnage¶

La trajectoire actuelle est 1.0.0bN (bêta publique), puis un jour 1.0.0
stable. Après le 1.0.0 stable, les premiers correctifs et élargissements
ne pourront pas s'appeler 1.0.1 ni 1.1.0. Il faudra sauter ces numéros,
par exemple :

au lieu de 1.0.1 : passer à 1.0.2 ;
au lieu de 1.1.0 : passer à 1.1.1 (ou un autre incrément mineur libre).

Contexte : pourquoi ces versions ont été supprimées¶

Tant que 1.0.1 et 1.1.0 (versions finales) existaient sur l'index,
même remisées, elles cassaient forge update. La commande lance
pip install --upgrade forge-mvc sans --pre. Or :

pip constate qu'il existe des versions finales sur l'index, donc il exclut
toutes les pré-releases, dont la dernière bêta ;
puis il écarte 1.0.1 et 1.1.0 parce qu'elles sont yanked ;
il ne reste alors rien de plus récent que la version installée, et
l'utilisateur reste bloqué sur son ancienne bêta.

Leur suppression complète rétablit le repli automatique de pip sur les
pré-releases : il n'y a plus aucune version finale sur l'index, donc
forge update sans --pre récupère de nouveau la dernière bêta.

Vérification de l'état de l'index¶

Pour contrôler à tout moment qu'aucun numéro brûlé n'est réapparu sur PyPI :

curl -s -H "Cache-Control: no-cache" "https://pypi.org/pypi/forge-mvc/json" \
  | python3 -c "import sys,json; r=list(json.load(sys.stdin)['releases']); print('1.0.1 present ?', '1.0.1' in r); print('1.1.0 present ?', '1.1.0' in r)"

Les deux réponses doivent être False.