Que fait Planificateur de Mise à Jour de Dépendances ?
Produire un plan. Ne rien mettre à jour tant que l'utilisateur n'a pas approuvé le plan.
Procédure
- Détecter l'écosystème à partir du manifeste :
package.json,requirements.txtoupyproject.toml,go.mod,Cargo.toml,Gemfile,pom.xml. Si plusieurs existent, demander lequel planifier, ou les planifier séparément. - Lire les versions actuelles depuis le manifeste et le fichier de verrouillage (
package-lock.json,poetry.lock,go.sum,Cargo.lock,Gemfile.lock). - Trouver les versions disponibles avec l'outil propre à l'écosystème et signaler le résultat que vous avez réellement obtenu :
- npm :
npm outdated - Python :
pip list --outdatedouuv pip list --outdated - Go :
go list -u -m all - Rust :
cargo outdated - Ruby :
bundle outdatedSi l'outil n'est pas disponible, le dire et travailler à partir du manifeste, en marquant les versions comme non vérifiées.
- npm :
- Classer chaque paquet obsolète :
- Correctif / mineur — généralement sûr.
- Majeur — lire le journal des modifications ou les notes de version pour les changements cassants avant de le planifier.
- Sécurité — tout ce qui est signalé par
npm audit,pip-audit,govulncheck,cargo audit, oubundle audit. Ceux-ci passent en premier.
- Ordonner le travail en lots :
- Lot 0 : correctifs de sécurité, même s'ils sont majeurs.
- Lot 1 : correctifs et mises à jour mineures, groupés par domaine.
- Lot 2 : majeurs sans dépendance croisée, un commit par lot.
- Lot 3 : majeurs qui doivent bouger ensemble (par exemple un framework et ses plugins).
- Pour chaque lot, indiquer : les paquets, les versions source et cible, les changements cassants applicables, le code ou la configuration qui doit changer, et comment vérifier.
Modèle de sortie
## Plan de mise à jour
Écosystème : <npm / pip / go / cargo / ...>
Manifeste : <chemin>
### Lot 0 — Sécurité
| Paquet | De | Vers | Pourquoi | Cassant ? |
| --- | --- | --- | --- | --- |
### Lot 1 — Correctifs et mineurs
...
### Lot 2 — Majeurs, indépendants
...
### Lot 3 — Majeurs, doivent bouger ensemble
...
### Vérification
Après chaque lot : <la commande exacte qui prouve qu'aucune régression n'a eu lieu>
### Retour arrière
Par lot : <comment revenir en arrière, par exemple git revert du commit du lot>
### Reporté
<Paquets laissés intentionnellement de côté, et pourquoi>
Règles
- Ne jamais éditer le manifeste pendant la planification. Générer le plan, puis s'arrêter.
- Lire le journal des modifications réel pour une mise à jour majeure lorsqu'il est disponible ; ne pas supposer qu'une version est cassante parce que le numéro majeur a changé.
- Toujours nommer la commande de vérification. « Exécuter les tests » n'est pas une commande ;
npm testen est une. - Préciser la raison du report lorsque vous laissez un paquet de côté — par exemple, une version majeure dont les notes de version n'ont pas pu être lues.
- Ne pas exécuter de commandes d'installation, de mise à jour ou d'audit qui modifient l'arborescence.
npm outdated,npm auditet leurs équivalents sont en lecture seule et acceptables.
Fichier d'accompagnement
references/upgrade-strategy.md explique le groupement en lots, les cas particuliers de semver et comment gérer un paquet qui doit être retenu.