@ferrflow/doc 7.28.0 → 7.28.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/benchmarks.json +698 -698
- package/docs-en/reference/errors.md +581 -74
- package/docs-fr/reference/errors.md +654 -20
- package/package.json +1 -1
|
@@ -121,13 +121,49 @@ Plusieurs fichiers de config trouvés dans le répertoire.
|
|
|
121
121
|
|
|
122
122
|
`ferrflow init` lancé alors qu'un fichier de config existe déjà.
|
|
123
123
|
|
|
124
|
-
###
|
|
124
|
+
### E1018 : Chemin hors du dépôt
|
|
125
|
+
|
|
126
|
+
<span id="e1018"></span>
|
|
127
|
+
|
|
128
|
+
Un chemin de `versionedFiles` est absolu, ou sort de la racine du dépôt avec `..`. FerrFlow ne lit et n'écrit les fichiers de version qu'à l'intérieur du dépôt : écrivez le chemin relativement à la racine.
|
|
129
|
+
|
|
130
|
+
### E1019 : Le pattern d'include ne trouve aucun fichier
|
|
131
|
+
|
|
132
|
+
<span id="e1019"></span>
|
|
133
|
+
|
|
134
|
+
Une entrée de `include` ne correspond à aucun fichier. Les patterns sont résolus depuis le répertoire du fichier de config racine. Corrigez le chemin ou supprimez le pattern.
|
|
135
|
+
|
|
136
|
+
### E1020 : Fichier inclus invalide
|
|
137
|
+
|
|
138
|
+
<span id="e1020"></span>
|
|
139
|
+
|
|
140
|
+
Un fichier chargé via `include` ne décrit pas un package valide. Soit il déclare `workspace`, `include` ou `package`, qui n'ont leur place que dans la config racine, soit son contenu ne se désérialise pas en package. Un fichier inclus décrit un seul package, avec les mêmes clés qu'une entrée `package`.
|
|
141
|
+
|
|
142
|
+
### E1021 : Package inclus hors du dépôt
|
|
143
|
+
|
|
144
|
+
<span id="e1021"></span>
|
|
145
|
+
|
|
146
|
+
Le `path` d'un package inclus pointe hors de la racine du dépôt. Dans un fichier inclus, `path` est relatif au répertoire de ce fichier, et vaut ce répertoire quand il est vide.
|
|
147
|
+
|
|
148
|
+
### E1022 : Nom de package en double
|
|
149
|
+
|
|
150
|
+
<span id="e1022"></span>
|
|
151
|
+
|
|
152
|
+
Deux packages portent le même `name`, qu'ils viennent de la config racine ou d'un `include`. L'erreur indique les deux chemins. Renommez l'un des deux.
|
|
153
|
+
|
|
154
|
+
### E1023 : Package sans chemin
|
|
155
|
+
|
|
156
|
+
<span id="e1023"></span>
|
|
157
|
+
|
|
158
|
+
Un package de la config racine n'a pas de `path`. Renseignez-le relativement à la racine du dépôt, ou déplacez le package dans son propre fichier listé sous `include`, où `path` vaut par défaut le répertoire de ce fichier.
|
|
159
|
+
|
|
160
|
+
### E1024 : Fichier versionné introuvable
|
|
125
161
|
|
|
126
162
|
<span id="e1024"></span>
|
|
127
163
|
|
|
128
|
-
Un package que cette
|
|
164
|
+
Un package que cette exécution allait publier déclare une entrée `versionedFiles` dont le fichier n'est pas sur le disque. L'exécution s'arrête au moment du plan plutôt qu'au moment de l'écriture, où le même problème apparaîtrait sous la forme d'une simple erreur de lecture.
|
|
129
165
|
|
|
130
|
-
La cause habituelle est un chemin
|
|
166
|
+
La cause habituelle est un chemin écrit relativement au package plutôt qu'à la racine du dépôt. `package.path` n'est pas un préfixe que FerrFlow ajoute pour vous :
|
|
131
167
|
|
|
132
168
|
```toml
|
|
133
169
|
[[package]]
|
|
@@ -135,11 +171,11 @@ name = "api"
|
|
|
135
171
|
path = "packages/api"
|
|
136
172
|
|
|
137
173
|
[[package.versioned_files]]
|
|
138
|
-
path = "Cargo.toml" # faux,
|
|
174
|
+
path = "Cargo.toml" # faux, cherché à la racine du dépôt
|
|
139
175
|
# path = "packages/api/Cargo.toml" # correct
|
|
140
176
|
```
|
|
141
177
|
|
|
142
|
-
L'erreur indique le chemin qu'elle suppose correct. `ferrflow validate` signale le
|
|
178
|
+
L'erreur indique le chemin qu'elle suppose correct. `ferrflow validate` signale le même problème pour tous les packages configurés, y compris ceux que cette exécution n'aurait pas touchés.
|
|
143
179
|
|
|
144
180
|
## Erreurs de validation
|
|
145
181
|
|
|
@@ -265,6 +301,39 @@ Le commit de release n'a pas pu être vérifié sur la branche distante.
|
|
|
265
301
|
|
|
266
302
|
La branche distante n'a pas été trouvée après le push.
|
|
267
303
|
|
|
304
|
+
### E2011 : Release déjà en cours
|
|
305
|
+
|
|
306
|
+
<span id="e2011"></span>
|
|
307
|
+
|
|
308
|
+
Un autre `ferrflow release` détient le verrou de release `.git/ferrflow.lock`, ou le fichier de verrou n'a pas pu être créé. Un verrou laissé par un processus mort sur la même machine est repris automatiquement, et celui d'une autre machine au bout de six heures. Le message affiche le contenu du verrou pour savoir qui le détient.
|
|
309
|
+
|
|
310
|
+
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Si aucune autre release ne tourne, supprimez le fichier de verrou ou relancez avec <code>--force-unlock</code>.</p>
|
|
311
|
+
</div></aside>
|
|
312
|
+
|
|
313
|
+
### E2012 : Force-push de la branche de release échoué
|
|
314
|
+
|
|
315
|
+
<span id="e2012"></span>
|
|
316
|
+
|
|
317
|
+
FerrFlow n'a pas pu force-push la branche de la PR ou MR de release. Le message reprend la sortie de git. Vérifiez que le token peut pousser sur cette branche et qu'aucune règle de protection n'y interdit le force-push.
|
|
318
|
+
|
|
319
|
+
### E2013 : Inspection de la branche de release impossible
|
|
320
|
+
|
|
321
|
+
<span id="e2013"></span>
|
|
322
|
+
|
|
323
|
+
Avant de réutiliser la branche de release, FerrFlow lance `git ls-remote`, `git fetch` et `git log` dessus pour vérifier qu'elle ne contient que ses propres commits. L'une de ces commandes a échoué. La release continue : FerrFlow affiche un avertissement et fait comme si la branche ne contenait que ses commits.
|
|
324
|
+
|
|
325
|
+
### E2014 : Suppression du tag distant échouée
|
|
326
|
+
|
|
327
|
+
<span id="e2014"></span>
|
|
328
|
+
|
|
329
|
+
`ferrflow rollback` n'a pas pu supprimer avec `git push --delete` un tag poussé par l'exécution échouée. Un tag absent du remote, ou qui pointe désormais vers un autre commit, est ignoré. Vérifiez que le token peut supprimer des tags, puis relancez le rollback.
|
|
330
|
+
|
|
331
|
+
### E2015 : Revert échoué
|
|
332
|
+
|
|
333
|
+
<span id="e2015"></span>
|
|
334
|
+
|
|
335
|
+
`ferrflow rollback` n'a pas pu faire `git revert` sur le commit de release, par exemple parce qu'il entre en conflit avec des changements plus récents. Terminez le revert à la main. FerrFlow ne pousse jamais le revert : poussez la branche vous-même après vérification.
|
|
336
|
+
|
|
268
337
|
### E2016 : Clone de shadow-release échoué
|
|
269
338
|
|
|
270
339
|
<span id="e2016"></span>
|
|
@@ -282,11 +351,95 @@ L'API GitHub Releases a retourné une erreur.
|
|
|
282
351
|
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez que <code>GITHUB_TOKEN</code> a la permission <code>contents: write</code>.</p>
|
|
283
352
|
</div></aside>
|
|
284
353
|
|
|
285
|
-
### E3002
|
|
354
|
+
### E3002 : Liste des releases échouée
|
|
286
355
|
|
|
287
356
|
<span id="e3002"></span>
|
|
288
357
|
|
|
289
|
-
|
|
358
|
+
Impossible de récupérer les releases existantes depuis l'API GitHub.
|
|
359
|
+
|
|
360
|
+
### E3003 : Réponse des releases illisible
|
|
361
|
+
|
|
362
|
+
<span id="e3003"></span>
|
|
363
|
+
|
|
364
|
+
L'API GitHub a renvoyé une réponse dans un format inattendu.
|
|
365
|
+
|
|
366
|
+
### E3004 : Publication de release échouée
|
|
367
|
+
|
|
368
|
+
<span id="e3004"></span>
|
|
369
|
+
|
|
370
|
+
Impossible de publier (sortir du brouillon) une release GitHub.
|
|
371
|
+
|
|
372
|
+
### E3005 : Création de pull request échouée
|
|
373
|
+
|
|
374
|
+
<span id="e3005"></span>
|
|
375
|
+
|
|
376
|
+
L'API GitHub a retourné une erreur à la création de la PR.
|
|
377
|
+
|
|
378
|
+
### E3006 : Réponse de PR illisible
|
|
379
|
+
|
|
380
|
+
<span id="e3006"></span>
|
|
381
|
+
|
|
382
|
+
L'API GitHub a renvoyé une PR dans un format inattendu.
|
|
383
|
+
|
|
384
|
+
### E3007 : Champ manquant dans la réponse de PR
|
|
385
|
+
|
|
386
|
+
<span id="e3007"></span>
|
|
387
|
+
|
|
388
|
+
La réponse de l'API GitHub pour la PR ne contient pas le champ `number` ou `node_id`.
|
|
389
|
+
|
|
390
|
+
### E3008 : Activation de l'auto-merge échouée
|
|
391
|
+
|
|
392
|
+
<span id="e3008"></span>
|
|
393
|
+
|
|
394
|
+
Impossible d'activer l'auto-merge sur la PR de release via l'API GraphQL.
|
|
395
|
+
|
|
396
|
+
### E3009 : Réponse GraphQL illisible
|
|
397
|
+
|
|
398
|
+
<span id="e3009"></span>
|
|
399
|
+
|
|
400
|
+
L'API GraphQL de GitHub a renvoyé une réponse inattendue.
|
|
401
|
+
|
|
402
|
+
### E3010 : Auto-merge échoué
|
|
403
|
+
|
|
404
|
+
<span id="e3010"></span>
|
|
405
|
+
|
|
406
|
+
La mutation GraphQL qui active l'auto-merge a renvoyé une erreur.
|
|
407
|
+
|
|
408
|
+
### E3011 : Recherche de la PR de release échouée
|
|
409
|
+
|
|
410
|
+
<span id="e3011"></span>
|
|
411
|
+
|
|
412
|
+
La liste des pull requests ouvertes n'a pas pu être récupérée pendant que FerrFlow cherchait une PR de release existante à mettre à jour. Vérifiez le token et l'accès à l'API GitHub.
|
|
413
|
+
|
|
414
|
+
### E3012 : Mise à jour de la PR de release échouée
|
|
415
|
+
|
|
416
|
+
<span id="e3012"></span>
|
|
417
|
+
|
|
418
|
+
FerrFlow a trouvé la PR de release ouverte, mais GitHub a refusé la mise à jour de son titre et de sa description. Vérifiez que le token a `pull-requests: write`.
|
|
419
|
+
|
|
420
|
+
### E3013 : Requête GraphQL échouée
|
|
421
|
+
|
|
422
|
+
<span id="e3013"></span>
|
|
423
|
+
|
|
424
|
+
Une requête vers l'API GraphQL de GitHub a échoué avant d'obtenir une réponse exploitable, sur le réseau ou avec un statut HTTP d'erreur. FerrFlow appelle cette API pour créer le commit de release avec `createCommitOnBranch` quand `FERRFLOW_BOT` est défini.
|
|
425
|
+
|
|
426
|
+
### E3014 : Erreur GraphQL
|
|
427
|
+
|
|
428
|
+
<span id="e3014"></span>
|
|
429
|
+
|
|
430
|
+
L'API GraphQL de GitHub a répondu par une erreur, ou `createCommitOnBranch` n'a renvoyé aucun identifiant de commit. Le message reprend le texte de l'erreur GitHub.
|
|
431
|
+
|
|
432
|
+
### E3015 : Déplacement de la branche de release échoué
|
|
433
|
+
|
|
434
|
+
<span id="e3015"></span>
|
|
435
|
+
|
|
436
|
+
Quand `FERRFLOW_BOT` est défini, FerrFlow fait pointer la branche de release sur la tête de la branche cible via l'API refs de GitHub avant d'y créer le commit. GitHub a refusé la mise à jour, ou la création de la ref quand la branche n'existait pas encore. Vérifiez que le token a `contents: write`.
|
|
437
|
+
|
|
438
|
+
### E3016 : Suppression de release échouée
|
|
439
|
+
|
|
440
|
+
<span id="e3016"></span>
|
|
441
|
+
|
|
442
|
+
`ferrflow rollback` n'a pas pu supprimer une release GitHub créée par l'exécution échouée. Supprimez-la à la main et relancez le rollback.
|
|
290
443
|
|
|
291
444
|
## API GitLab
|
|
292
445
|
|
|
@@ -299,27 +452,465 @@ L'API GitLab Releases a retourné une erreur.
|
|
|
299
452
|
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez que le token CI a les accès API nécessaires.</p>
|
|
300
453
|
</div></aside>
|
|
301
454
|
|
|
302
|
-
### E3102
|
|
455
|
+
### E3102 : Création de merge request échouée
|
|
303
456
|
|
|
304
457
|
<span id="e3102"></span>
|
|
305
458
|
|
|
306
|
-
|
|
459
|
+
L'API GitLab a retourné une erreur à la création de la MR.
|
|
460
|
+
|
|
461
|
+
### E3103 : Réponse de MR illisible
|
|
462
|
+
|
|
463
|
+
<span id="e3103"></span>
|
|
464
|
+
|
|
465
|
+
L'API GitLab a renvoyé une MR dans un format inattendu.
|
|
466
|
+
|
|
467
|
+
### E3104 : Champ iid manquant
|
|
468
|
+
|
|
469
|
+
<span id="e3104"></span>
|
|
470
|
+
|
|
471
|
+
La réponse de l'API GitLab pour la MR ne contient pas le champ `iid`.
|
|
472
|
+
|
|
473
|
+
### E3105 : Merge de la MR échoué
|
|
474
|
+
|
|
475
|
+
<span id="e3105"></span>
|
|
476
|
+
|
|
477
|
+
Impossible de merger la MR de release via l'API GitLab.
|
|
478
|
+
|
|
479
|
+
### E3106 : Recherche de la MR de release échouée
|
|
480
|
+
|
|
481
|
+
<span id="e3106"></span>
|
|
482
|
+
|
|
483
|
+
La liste des merge requests ouvertes n'a pas pu être récupérée pendant que FerrFlow cherchait une MR de release existante à mettre à jour. Vérifiez le token et l'accès à l'API GitLab.
|
|
484
|
+
|
|
485
|
+
### E3107 : Mise à jour de la MR de release échouée
|
|
486
|
+
|
|
487
|
+
<span id="e3107"></span>
|
|
488
|
+
|
|
489
|
+
FerrFlow a trouvé la MR de release ouverte, mais GitLab a refusé la mise à jour de son titre et de sa description. Vérifiez les droits du token sur le projet.
|
|
490
|
+
|
|
491
|
+
## API Gitea
|
|
492
|
+
|
|
493
|
+
### E3201 : Création de release échouée
|
|
494
|
+
|
|
495
|
+
<span id="e3201"></span>
|
|
496
|
+
|
|
497
|
+
L'API Gitea Releases a retourné une erreur à la création d'une release. Vérifiez que le token peut écrire dans le dépôt.
|
|
498
|
+
|
|
499
|
+
### E3202 : Liste des releases échouée
|
|
500
|
+
|
|
501
|
+
<span id="e3202"></span>
|
|
502
|
+
|
|
503
|
+
Impossible de lister les releases depuis l'API Gitea pour chercher un brouillon de release existant pour le tag.
|
|
504
|
+
|
|
505
|
+
### E3203 : Publication de release échouée
|
|
506
|
+
|
|
507
|
+
<span id="e3203"></span>
|
|
508
|
+
|
|
509
|
+
Impossible de publier (sortir du brouillon) une release Gitea.
|
|
510
|
+
|
|
511
|
+
## API Bitbucket
|
|
512
|
+
|
|
513
|
+
### E3301 : Résolution du tag de release échouée
|
|
514
|
+
|
|
515
|
+
<span id="e3301"></span>
|
|
516
|
+
|
|
517
|
+
Bitbucket n'a pas de releases. Sur Bitbucket Cloud, FerrFlow interroge plutôt l'API sur le nouveau tag pour en obtenir le lien, et cette requête a échoué. Vérifiez que le token peut lire le dépôt et que le tag a bien été poussé.
|
|
307
518
|
|
|
308
519
|
## Fichiers de version
|
|
309
520
|
|
|
310
|
-
Les erreurs E4xxx concernent la lecture, l'écriture et le parsing des fichiers de version
|
|
521
|
+
Les erreurs E4xxx concernent la lecture, l'écriture et le parsing des fichiers de version. Chaque format a sa propre plage de codes. Les codes UTF-8 invalide viennent de `ferrflow validate`, qui lit les fichiers versionnés comme des octets bruts ; les autres commandes signalent un fichier qui n'est pas en UTF-8 avec l'erreur de lecture du format.
|
|
522
|
+
|
|
523
|
+
### E4101 : Lecture du fichier TOML impossible
|
|
524
|
+
|
|
525
|
+
<span id="e4101"></span>
|
|
526
|
+
|
|
527
|
+
FerrFlow n'a pas pu lire le fichier de version TOML (`Cargo.toml`, `pyproject.toml`) sur le disque.
|
|
528
|
+
|
|
529
|
+
### E4102 : Syntaxe TOML invalide
|
|
530
|
+
|
|
531
|
+
<span id="e4102"></span>
|
|
532
|
+
|
|
533
|
+
Le fichier de version TOML ne se parse pas. Le message indique où se trouve l'erreur.
|
|
534
|
+
|
|
535
|
+
### E4103 : Aucune version dans le fichier TOML
|
|
536
|
+
|
|
537
|
+
<span id="e4103"></span>
|
|
538
|
+
|
|
539
|
+
Aucun des champs `package.version`, `workspace.package.version`, `project.version` ou `tool.poetry.version` n'est renseigné. Un `Cargo.toml` qui déclare `version.workspace = true` tombe aussi ici quand le même fichier n'a pas de `[workspace.package].version` : faites pointer le fichier versionné vers le `Cargo.toml` racine du workspace.
|
|
540
|
+
|
|
541
|
+
### E4104 : Écriture du fichier TOML impossible
|
|
542
|
+
|
|
543
|
+
<span id="e4104"></span>
|
|
544
|
+
|
|
545
|
+
L'écriture de la nouvelle version dans le fichier de version TOML (`Cargo.toml`, `pyproject.toml`) a échoué.
|
|
546
|
+
|
|
547
|
+
### E4105 : UTF-8 invalide dans le fichier TOML
|
|
548
|
+
|
|
549
|
+
<span id="e4105"></span>
|
|
550
|
+
|
|
551
|
+
Le contenu du fichier de version TOML (`Cargo.toml`, `pyproject.toml`) n'est pas de l'UTF-8 valide.
|
|
552
|
+
|
|
553
|
+
### E4201 : Lecture du fichier JSON impossible
|
|
554
|
+
|
|
555
|
+
<span id="e4201"></span>
|
|
556
|
+
|
|
557
|
+
FerrFlow n'a pas pu lire le fichier de version JSON (`package.json`, `composer.json`) sur le disque. Le même code couvre le checkpoint de release `.git/ferrflow.checkpoint.json`.
|
|
558
|
+
|
|
559
|
+
### E4202 : Syntaxe JSON invalide
|
|
560
|
+
|
|
561
|
+
<span id="e4202"></span>
|
|
562
|
+
|
|
563
|
+
Le fichier de version JSON ne se parse pas. FerrFlow lève aussi ce code quand le checkpoint de release `.git/ferrflow.checkpoint.json` est corrompu ou a été écrit par une autre version de FerrFlow : supprimez ce fichier pour repartir de zéro.
|
|
564
|
+
|
|
565
|
+
### E4203 : Aucune version dans le fichier JSON
|
|
566
|
+
|
|
567
|
+
<span id="e4203"></span>
|
|
568
|
+
|
|
569
|
+
Le fichier JSON n'a pas de champ `version` au premier niveau.
|
|
570
|
+
|
|
571
|
+
### E4204 : Écriture du fichier JSON impossible
|
|
572
|
+
|
|
573
|
+
<span id="e4204"></span>
|
|
574
|
+
|
|
575
|
+
L'écriture de la nouvelle version dans le fichier de version JSON (`package.json`, `composer.json`) a échoué. FerrFlow le lève aussi quand il ne peut pas enregistrer ou supprimer le checkpoint de release, ou réécrire le manifeste d'un package dépendant (`package.json` ou `Cargo.toml`) pour suivre une dépendance bumpée.
|
|
576
|
+
|
|
577
|
+
### E4205 : UTF-8 invalide dans le fichier JSON
|
|
578
|
+
|
|
579
|
+
<span id="e4205"></span>
|
|
580
|
+
|
|
581
|
+
Le contenu du fichier de version JSON (`package.json`, `composer.json`) n'est pas de l'UTF-8 valide.
|
|
582
|
+
|
|
583
|
+
### E4301 : Lecture de Chart.yaml (helm) impossible
|
|
584
|
+
|
|
585
|
+
<span id="e4301"></span>
|
|
586
|
+
|
|
587
|
+
FerrFlow n'a pas pu lire le `Chart.yaml` déclaré avec `format = "helm"` sur le disque.
|
|
588
|
+
|
|
589
|
+
### E4302 : Aucune version dans Chart.yaml (helm)
|
|
590
|
+
|
|
591
|
+
<span id="e4302"></span>
|
|
592
|
+
|
|
593
|
+
Le `Chart.yaml` déclaré avec `format = "helm"` n'a pas de champ `version:` au premier niveau.
|
|
594
|
+
|
|
595
|
+
### E4303 : Écriture de Chart.yaml (helm) impossible
|
|
596
|
+
|
|
597
|
+
<span id="e4303"></span>
|
|
598
|
+
|
|
599
|
+
L'écriture de la nouvelle version dans le `Chart.yaml` déclaré avec `format = "helm"` a échoué.
|
|
600
|
+
|
|
601
|
+
### E4304 : UTF-8 invalide dans Chart.yaml (helm)
|
|
602
|
+
|
|
603
|
+
<span id="e4304"></span>
|
|
604
|
+
|
|
605
|
+
Le contenu du `Chart.yaml` déclaré avec `format = "helm"` n'est pas de l'UTF-8 valide.
|
|
606
|
+
|
|
607
|
+
### E4401 : Lecture du fichier XML impossible
|
|
608
|
+
|
|
609
|
+
<span id="e4401"></span>
|
|
610
|
+
|
|
611
|
+
FerrFlow n'a pas pu lire le fichier de version XML (`pom.xml`) sur le disque.
|
|
612
|
+
|
|
613
|
+
### E4402 : Aucune version dans le fichier XML
|
|
614
|
+
|
|
615
|
+
<span id="e4402"></span>
|
|
616
|
+
|
|
617
|
+
Le fichier XML n'a pas de balise `<version>`.
|
|
618
|
+
|
|
619
|
+
### E4403 : Écriture du fichier XML impossible
|
|
620
|
+
|
|
621
|
+
<span id="e4403"></span>
|
|
622
|
+
|
|
623
|
+
L'écriture de la nouvelle version dans le fichier de version XML (`pom.xml`) a échoué.
|
|
624
|
+
|
|
625
|
+
### E4404 : UTF-8 invalide dans le fichier XML
|
|
626
|
+
|
|
627
|
+
<span id="e4404"></span>
|
|
628
|
+
|
|
629
|
+
Le contenu du fichier de version XML (`pom.xml`) n'est pas de l'UTF-8 valide.
|
|
630
|
+
|
|
631
|
+
### E4410 : Lecture du fichier .csproj impossible
|
|
311
632
|
|
|
312
|
-
|
|
313
|
-
| -------------- | --------------------------------- |
|
|
314
|
-
| E4101 to E4105 | TOML (Cargo.toml, pyproject.toml) |
|
|
315
|
-
| E4201 to E4205 | JSON (package.json) |
|
|
316
|
-
| E4301 to E4304 | Helm / YAML (Chart.yaml) |
|
|
317
|
-
| E4401 to E4413 | XML / CSProj |
|
|
318
|
-
| E4501 to E4504 | Gradle |
|
|
319
|
-
| E4601 to E4603 | Go mod |
|
|
320
|
-
| E4701 to E4704 | Texte (VERSION, VERSION.txt) |
|
|
633
|
+
<span id="e4410"></span>
|
|
321
634
|
|
|
322
|
-
|
|
635
|
+
FerrFlow n'a pas pu lire le fichier `.csproj` sur le disque.
|
|
636
|
+
|
|
637
|
+
### E4411 : Aucune version dans le fichier .csproj
|
|
638
|
+
|
|
639
|
+
<span id="e4411"></span>
|
|
640
|
+
|
|
641
|
+
Le fichier `.csproj` n'a pas d'élément `<Version>`.
|
|
642
|
+
|
|
643
|
+
### E4412 : Écriture du fichier .csproj impossible
|
|
644
|
+
|
|
645
|
+
<span id="e4412"></span>
|
|
646
|
+
|
|
647
|
+
L'écriture de la nouvelle version dans le fichier `.csproj` a échoué.
|
|
648
|
+
|
|
649
|
+
### E4413 : UTF-8 invalide dans le fichier .csproj
|
|
650
|
+
|
|
651
|
+
<span id="e4413"></span>
|
|
652
|
+
|
|
653
|
+
Le contenu du fichier `.csproj` n'est pas de l'UTF-8 valide.
|
|
654
|
+
|
|
655
|
+
### E4501 : Lecture du fichier Gradle impossible
|
|
656
|
+
|
|
657
|
+
<span id="e4501"></span>
|
|
658
|
+
|
|
659
|
+
FerrFlow n'a pas pu lire le fichier de build Gradle (`build.gradle`, `build.gradle.kts`) sur le disque.
|
|
660
|
+
|
|
661
|
+
### E4502 : Aucune version dans le fichier Gradle
|
|
662
|
+
|
|
663
|
+
<span id="e4502"></span>
|
|
664
|
+
|
|
665
|
+
Le fichier de build Gradle n'a pas d'affectation `version = "…"`.
|
|
666
|
+
|
|
667
|
+
### E4503 : Écriture du fichier Gradle impossible
|
|
668
|
+
|
|
669
|
+
<span id="e4503"></span>
|
|
670
|
+
|
|
671
|
+
L'écriture de la nouvelle version dans le fichier de build Gradle (`build.gradle`, `build.gradle.kts`) a échoué.
|
|
672
|
+
|
|
673
|
+
### E4504 : UTF-8 invalide dans le fichier Gradle
|
|
674
|
+
|
|
675
|
+
<span id="e4504"></span>
|
|
676
|
+
|
|
677
|
+
Le contenu du fichier de build Gradle (`build.gradle`, `build.gradle.kts`) n'est pas de l'UTF-8 valide.
|
|
678
|
+
|
|
679
|
+
### E4601 : Impossible de lancer git describe
|
|
680
|
+
|
|
681
|
+
<span id="e4601"></span>
|
|
682
|
+
|
|
683
|
+
Un fichier versionné `gomod` tire sa version des tags git via `git describe`, et la commande n'a pas pu être lancée. Vérifiez que git est dans le `PATH`.
|
|
684
|
+
|
|
685
|
+
### E4602 : Aucun tag de version
|
|
686
|
+
|
|
687
|
+
<span id="e4602"></span>
|
|
688
|
+
|
|
689
|
+
`git describe` n'a trouvé aucun tag correspondant à `*@v*` ou `v*` pour le package.
|
|
690
|
+
|
|
691
|
+
Depuis FerrFlow v3, le flux de release intercepte ce cas et repart de la version de départ de la stratégie (`0.0.0`, `0`, …) : la première release d'un dépôt neuf réussit sans tag créé à la main. Le code existe toujours pour les programmes qui utilisent `GoModVersionFile` directement, mais `ferrflow release` ne devrait plus l'afficher.
|
|
692
|
+
|
|
693
|
+
### E4603 : Version illisible depuis go.mod
|
|
694
|
+
|
|
695
|
+
<span id="e4603"></span>
|
|
696
|
+
|
|
697
|
+
La version d'un module Go vient des tags git : FerrFlow ne peut pas la lire dans le contenu de `go.mod`. `ferrflow validate` ignore les entrées `gomod` avec un avertissement.
|
|
698
|
+
|
|
699
|
+
### E4701 : Lecture du fichier texte impossible
|
|
700
|
+
|
|
701
|
+
<span id="e4701"></span>
|
|
702
|
+
|
|
703
|
+
FerrFlow n'a pas pu lire le fichier de version texte (`VERSION`, `VERSION.txt`) sur le disque.
|
|
704
|
+
|
|
705
|
+
### E4702 : Aucune version dans le fichier texte
|
|
706
|
+
|
|
707
|
+
<span id="e4702"></span>
|
|
708
|
+
|
|
709
|
+
Le fichier texte est vide. Avec un `selector`, ce code couvre aussi une regex qui ne compile pas, qui n'a pas exactement un groupe de capture, qui ne trouve rien ou qui ne capture que des espaces.
|
|
710
|
+
|
|
711
|
+
### E4703 : Écriture du fichier texte impossible
|
|
712
|
+
|
|
713
|
+
<span id="e4703"></span>
|
|
714
|
+
|
|
715
|
+
L'écriture de la nouvelle version dans le fichier de version texte (`VERSION`, `VERSION.txt`) a échoué.
|
|
716
|
+
|
|
717
|
+
### E4704 : UTF-8 invalide dans le fichier texte
|
|
718
|
+
|
|
719
|
+
<span id="e4704"></span>
|
|
720
|
+
|
|
721
|
+
Le contenu du fichier de version texte (`VERSION`, `VERSION.txt`) n'est pas de l'UTF-8 valide.
|
|
722
|
+
|
|
723
|
+
### E4801 : Lecture de pubspec.yaml impossible
|
|
724
|
+
|
|
725
|
+
<span id="e4801"></span>
|
|
726
|
+
|
|
727
|
+
FerrFlow n'a pas pu lire `pubspec.yaml` sur le disque.
|
|
728
|
+
|
|
729
|
+
### E4802 : Aucune version dans pubspec.yaml
|
|
730
|
+
|
|
731
|
+
<span id="e4802"></span>
|
|
732
|
+
|
|
733
|
+
`pubspec.yaml` n'a pas de clé `version:` au premier niveau.
|
|
734
|
+
|
|
735
|
+
### E4803 : Écriture de pubspec.yaml impossible
|
|
736
|
+
|
|
737
|
+
<span id="e4803"></span>
|
|
738
|
+
|
|
739
|
+
L'écriture de la nouvelle version dans `pubspec.yaml` a échoué.
|
|
740
|
+
|
|
741
|
+
### E4804 : UTF-8 invalide dans pubspec.yaml
|
|
742
|
+
|
|
743
|
+
<span id="e4804"></span>
|
|
744
|
+
|
|
745
|
+
Le contenu de `pubspec.yaml` n'est pas de l'UTF-8 valide.
|
|
746
|
+
|
|
747
|
+
### E4811 : Lecture de mix.exs impossible
|
|
748
|
+
|
|
749
|
+
<span id="e4811"></span>
|
|
750
|
+
|
|
751
|
+
FerrFlow n'a pas pu lire `mix.exs` sur le disque.
|
|
752
|
+
|
|
753
|
+
### E4812 : Aucune version dans mix.exs
|
|
754
|
+
|
|
755
|
+
<span id="e4812"></span>
|
|
756
|
+
|
|
757
|
+
`mix.exs` ne contient pas de littéral `version: "…"`.
|
|
758
|
+
|
|
759
|
+
### E4813 : Écriture de mix.exs impossible
|
|
760
|
+
|
|
761
|
+
<span id="e4813"></span>
|
|
762
|
+
|
|
763
|
+
L'écriture de la nouvelle version dans `mix.exs` a échoué.
|
|
764
|
+
|
|
765
|
+
### E4814 : UTF-8 invalide dans mix.exs
|
|
766
|
+
|
|
767
|
+
<span id="e4814"></span>
|
|
768
|
+
|
|
769
|
+
Le contenu de `mix.exs` n'est pas de l'UTF-8 valide.
|
|
770
|
+
|
|
771
|
+
### E4821 : Lecture de Chart.yaml (chartyaml) impossible
|
|
772
|
+
|
|
773
|
+
<span id="e4821"></span>
|
|
774
|
+
|
|
775
|
+
FerrFlow n'a pas pu lire le `Chart.yaml` déclaré avec `format = "chartyaml"` sur le disque.
|
|
776
|
+
|
|
777
|
+
### E4822 : Aucune version dans Chart.yaml (chartyaml)
|
|
778
|
+
|
|
779
|
+
<span id="e4822"></span>
|
|
780
|
+
|
|
781
|
+
Le `Chart.yaml` déclaré avec `format = "chartyaml"` n'a pas de clé `version:` au premier niveau.
|
|
782
|
+
|
|
783
|
+
### E4823 : Écriture de Chart.yaml (chartyaml) impossible
|
|
784
|
+
|
|
785
|
+
<span id="e4823"></span>
|
|
786
|
+
|
|
787
|
+
L'écriture de la nouvelle version dans le `Chart.yaml` déclaré avec `format = "chartyaml"` a échoué.
|
|
788
|
+
|
|
789
|
+
### E4824 : UTF-8 invalide dans Chart.yaml (chartyaml)
|
|
790
|
+
|
|
791
|
+
<span id="e4824"></span>
|
|
792
|
+
|
|
793
|
+
Le contenu du `Chart.yaml` déclaré avec `format = "chartyaml"` n'est pas de l'UTF-8 valide.
|
|
794
|
+
|
|
795
|
+
### E4831 : Lecture du fichier .gemspec impossible
|
|
796
|
+
|
|
797
|
+
<span id="e4831"></span>
|
|
798
|
+
|
|
799
|
+
FerrFlow n'a pas pu lire le fichier `.gemspec` sur le disque.
|
|
800
|
+
|
|
801
|
+
### E4832 : Aucune version dans le fichier .gemspec
|
|
802
|
+
|
|
803
|
+
<span id="e4832"></span>
|
|
804
|
+
|
|
805
|
+
Le fichier `.gemspec` n'a pas d'affectation `<ident>.version = "…"`.
|
|
806
|
+
|
|
807
|
+
### E4833 : Écriture du fichier .gemspec impossible
|
|
808
|
+
|
|
809
|
+
<span id="e4833"></span>
|
|
810
|
+
|
|
811
|
+
L'écriture de la nouvelle version dans le fichier `.gemspec` a échoué.
|
|
812
|
+
|
|
813
|
+
### E4834 : UTF-8 invalide dans le fichier .gemspec
|
|
814
|
+
|
|
815
|
+
<span id="e4834"></span>
|
|
816
|
+
|
|
817
|
+
Le contenu du fichier `.gemspec` n'est pas de l'UTF-8 valide.
|
|
818
|
+
|
|
819
|
+
### E4841 : Lecture de Package.swift impossible
|
|
820
|
+
|
|
821
|
+
<span id="e4841"></span>
|
|
822
|
+
|
|
823
|
+
FerrFlow n'a pas pu lire `Package.swift` sur le disque.
|
|
824
|
+
|
|
825
|
+
### E4842 : Aucune version dans Package.swift
|
|
826
|
+
|
|
827
|
+
<span id="e4842"></span>
|
|
828
|
+
|
|
829
|
+
`Package.swift` n'a pas de déclaration `let <name>Version = "…"` au premier niveau.
|
|
830
|
+
|
|
831
|
+
### E4843 : Écriture de Package.swift impossible
|
|
832
|
+
|
|
833
|
+
<span id="e4843"></span>
|
|
834
|
+
|
|
835
|
+
L'écriture de la nouvelle version dans `Package.swift` a échoué.
|
|
836
|
+
|
|
837
|
+
### E4844 : UTF-8 invalide dans Package.swift
|
|
838
|
+
|
|
839
|
+
<span id="e4844"></span>
|
|
840
|
+
|
|
841
|
+
Le contenu de `Package.swift` n'est pas de l'UTF-8 valide.
|
|
842
|
+
|
|
843
|
+
### E4851 : Lecture du fichier .cabal impossible
|
|
844
|
+
|
|
845
|
+
<span id="e4851"></span>
|
|
846
|
+
|
|
847
|
+
FerrFlow n'a pas pu lire le fichier `.cabal` sur le disque.
|
|
848
|
+
|
|
849
|
+
### E4852 : Aucune version dans le fichier .cabal
|
|
850
|
+
|
|
851
|
+
<span id="e4852"></span>
|
|
852
|
+
|
|
853
|
+
Le fichier `.cabal` n'a pas de champ `version:` au premier niveau.
|
|
854
|
+
|
|
855
|
+
### E4853 : Écriture du fichier .cabal impossible
|
|
856
|
+
|
|
857
|
+
<span id="e4853"></span>
|
|
858
|
+
|
|
859
|
+
L'écriture de la nouvelle version dans le fichier `.cabal` a échoué.
|
|
860
|
+
|
|
861
|
+
### E4854 : UTF-8 invalide dans le fichier .cabal
|
|
862
|
+
|
|
863
|
+
<span id="e4854"></span>
|
|
864
|
+
|
|
865
|
+
Le contenu du fichier `.cabal` n'est pas de l'UTF-8 valide.
|
|
866
|
+
|
|
867
|
+
### E4861 : Lecture de CMakeLists.txt impossible
|
|
868
|
+
|
|
869
|
+
<span id="e4861"></span>
|
|
870
|
+
|
|
871
|
+
FerrFlow n'a pas pu lire `CMakeLists.txt` sur le disque.
|
|
872
|
+
|
|
873
|
+
### E4862 : Aucune version dans CMakeLists.txt
|
|
874
|
+
|
|
875
|
+
<span id="e4862"></span>
|
|
876
|
+
|
|
877
|
+
`CMakeLists.txt` n'a pas de déclaration `project(… VERSION …)`.
|
|
878
|
+
|
|
879
|
+
### E4863 : Écriture de CMakeLists.txt impossible
|
|
880
|
+
|
|
881
|
+
<span id="e4863"></span>
|
|
882
|
+
|
|
883
|
+
L'écriture de la nouvelle version dans `CMakeLists.txt` a échoué.
|
|
884
|
+
|
|
885
|
+
### E4864 : UTF-8 invalide dans CMakeLists.txt
|
|
886
|
+
|
|
887
|
+
<span id="e4864"></span>
|
|
888
|
+
|
|
889
|
+
Le contenu de `CMakeLists.txt` n'est pas de l'UTF-8 valide.
|
|
890
|
+
|
|
891
|
+
### E4871 : Lecture de galaxy.yml impossible
|
|
892
|
+
|
|
893
|
+
<span id="e4871"></span>
|
|
894
|
+
|
|
895
|
+
FerrFlow n'a pas pu lire `galaxy.yml` sur le disque.
|
|
896
|
+
|
|
897
|
+
### E4872 : Aucune version dans galaxy.yml
|
|
898
|
+
|
|
899
|
+
<span id="e4872"></span>
|
|
900
|
+
|
|
901
|
+
`galaxy.yml` n'a pas de clé `version:` au premier niveau.
|
|
902
|
+
|
|
903
|
+
### E4873 : Écriture de galaxy.yml impossible
|
|
904
|
+
|
|
905
|
+
<span id="e4873"></span>
|
|
906
|
+
|
|
907
|
+
L'écriture de la nouvelle version dans `galaxy.yml` a échoué.
|
|
908
|
+
|
|
909
|
+
### E4874 : UTF-8 invalide dans galaxy.yml
|
|
910
|
+
|
|
911
|
+
<span id="e4874"></span>
|
|
912
|
+
|
|
913
|
+
Le contenu de `galaxy.yml` n'est pas de l'UTF-8 valide.
|
|
323
914
|
|
|
324
915
|
## Pré-release
|
|
325
916
|
|
|
@@ -360,6 +951,23 @@ Un hook a échoué avec `on_failure: "abort"`.
|
|
|
360
951
|
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez la commande du hook, ou mettez <code>on_failure: "continue"</code>.</p>
|
|
361
952
|
</div></aside>
|
|
362
953
|
|
|
954
|
+
## Publishers
|
|
955
|
+
|
|
956
|
+
### E6101 : Publisher mal configuré
|
|
957
|
+
|
|
958
|
+
<span id="e6101"></span>
|
|
959
|
+
|
|
960
|
+
Un publisher n'a pas pu démarrer parce que sa configuration est incomplète : un `registry` absent de `workspace.registries`, une variable `tokenEnv` non définie, un contexte de build, un chart ou un fichier d'asset introuvable, ou un `trustedPublishing` utilisé hors de GitHub Actions. Le message nomme le publisher et l'élément manquant. Rien n'a été publié.
|
|
961
|
+
|
|
962
|
+
### E6102 : Publication échouée
|
|
963
|
+
|
|
964
|
+
<span id="e6102"></span>
|
|
965
|
+
|
|
966
|
+
L'étape de publication a tourné et a échoué : `cargo publish`, `npm publish`, `twine upload`, `docker buildx`, `helm push`, `gh release upload` ou un webhook a renvoyé une erreur. Le message reprend l'erreur de l'outil, avec les lignes qui en expliquent la cause. Pour cargo, FerrFlow réessaie quelques fois quand l'erreur ressemble à un retard d'index du registre juste après la publication d'une dépendance, et signale E6102 une fois les essais épuisés.
|
|
967
|
+
|
|
968
|
+
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Lancez la même commande à la main depuis le dossier du package, par exemple <code>cargo publish --dry-run</code>, pour voir la sortie complète.</p>
|
|
969
|
+
</div></aside>
|
|
970
|
+
|
|
363
971
|
## Query
|
|
364
972
|
|
|
365
973
|
### E7001 : Aucun package configuré
|
|
@@ -380,6 +988,24 @@ Le nom de package spécifié n'existe pas dans la config.
|
|
|
380
988
|
<aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Lancez <code>ferrflow version</code> pour lister les packages.</p>
|
|
381
989
|
</div></aside>
|
|
382
990
|
|
|
991
|
+
### E7003 : Plage de diff invalide
|
|
992
|
+
|
|
993
|
+
<span id="e7003"></span>
|
|
994
|
+
|
|
995
|
+
`ferrflow diff` attend une plage de la forme `<from>..<to>`, avec deux bornes non vides, par exemple `v1.4.0..v1.6.0`.
|
|
996
|
+
|
|
997
|
+
### E7004 : Nom de package requis
|
|
998
|
+
|
|
999
|
+
<span id="e7004"></span>
|
|
1000
|
+
|
|
1001
|
+
Le dépôt est un monorepo : `ferrflow diff` doit savoir quel package comparer, avec `ferrflow diff <package> <from>..<to>`.
|
|
1002
|
+
|
|
1003
|
+
### E7005 : Borne de plage introuvable
|
|
1004
|
+
|
|
1005
|
+
<span id="e7005"></span>
|
|
1006
|
+
|
|
1007
|
+
Une borne de la plage de `ferrflow diff` ne correspond à aucun tag. FerrFlow essaie la valeur telle quelle, puis comme une version passée dans le modèle de tag du package, avec et sans `v` initial. Le message liste les noms essayés. Passez un nom de tag ou une version existants.
|
|
1008
|
+
|
|
383
1009
|
## Monorepo
|
|
384
1010
|
|
|
385
1011
|
### E8001 : Package introuvable dans la config
|
|
@@ -402,3 +1028,11 @@ Un tag flottant serait déplacé vers une version plus ancienne.
|
|
|
402
1028
|
<span id="e8003"></span>
|
|
403
1029
|
|
|
404
1030
|
Deux packages ou plus dépendent l'un de l'autre via `dependsOn`, directement ou transitivement : il n'existe aucun ordre de release possible. Le message nomme la boucle, par exemple `cycle detected: api → web → api`. Supprimez l'une des arêtes `dependsOn` pour la casser. La vérification s'exécute avant toute écriture de version, donc une configuration cyclique ne laisse jamais de release partielle.
|
|
1031
|
+
|
|
1032
|
+
## Rollback
|
|
1033
|
+
|
|
1034
|
+
### E10000 : Rollback bloqué
|
|
1035
|
+
|
|
1036
|
+
<span id="e10000"></span>
|
|
1037
|
+
|
|
1038
|
+
Chaque package de l'exécution échouée a publié sur un registre qui ne permet pas de dépublier : `ferrflow rollback` n'a rien qu'il puisse annuler. Le plan affiché indique chaque package bloqué et la raison.
|