Outils de développement
Une version par ligne : normalisation, tri ou vérification de conditions séparées par des virgules.
Saisissez des données ou chargez un exemple.
Les données sont traitées dans ce navigateur et ne sont pas envoyées à un serveur.
Les virgules signifient ET. Une contrainte vide n’impose aucune borne. Opérateurs : ~= == != <= >= < > === ; .* uniquement avec les préfixes == ou !=.
1 000 lignes non vides au maximum ; 256 unités UTF-16 par ligne, 2 048 par contrainte, 100 000 au total. La saisie reste inchangée.
Vérification des candidats…
Ce test de version PEP 440 aide à comprendre pourquoi une publication apparemment plus récente ne satisfait pas une dépendance. Une écriture valide, un rang supérieur et une correspondance avec les conditions ne signifient pas la même chose.
Pour comparer les versions Python, 1.0 et 1.0.0 ont le même rang. Pourtant, leur forme normalisée conserve le nombre de composantes. Les segments epoch, dev, post et local exigent des règles que le tri alphabétique ne fournit pas.
Le test de version PEP 440 affiche v01.1 à côté de sa forme normalisée 1.1. Dépliez une ligne pour voir ses segments sans remplacer la liste source. Une différence de casse ou de séparateur reste ainsi identifiable.
La politique automatique commence par les candidats satisfaisant toutes les conditions. Si une version non préliminaire convient, elle est prioritaire. Sinon, les préversions admissibles peuvent être retenues. Ajouter une version stable peut donc modifier le résultat des autres lignes.
Normaliser vérifie les écritures sans filtrage. Trier utilise le rang Python et conserve l’ordre initial des valeurs égales. Vérifier les conditions garde l’ordre de saisie et distingue une contrainte non satisfaite d’une exclusion liée aux préversions.
Retirez une version stable qui satisfait les conditions pour observer le recours aux préversions. Inclure ne change pas les bornes : 1.0rc1 reste inférieur à 1.0 et ne satisfait donc pas >=1.0.
Le calcul automatique attend 350 ms. Désactivez-le pour utiliser le bouton ou Ctrl/Cmd+Entrée. Toute modification bloque immédiatement les anciens exports. Exemple et Effacer demandent un aperçu ; Annuler la modification restaure la saisie et le rapport précédents.
Les préfixes v, zéros initiaux, alias alpha ou preview et séparateurs locaux sont normalisés. Le nombre de composantes de publication est conservé : 1.0.0 reste affiché ainsi, même si son rang est identique à celui de 1.0.
L’epoch précède les nombres de publication, puis les règles ordonnent développement, alpha, bêta, rc, finale et post-publication. Les segments locaux numériques sont comparés comme des entiers. Les très grandes valeurs ne sont pas arrondies.
Les opérateurs ~=, ==, !=, <=, >=, <, > et === sont reconnus. Une virgule signifie ET. Les égalités et exclusions acceptent des préfixes comme 1.4.*. Le numéro de ligne physique est conservé même lorsque des lignes vides sont ignorées.
Une version incorrecte reste signalée dans sa ligne ; une contrainte incorrecte empêche tout le calcul. Le tri place les lignes invalides à la fin. L’affichage progresse par 50 lignes, tandis que le JSON contient toujours toutes les lignes traitées et leurs erreurs.
Il combine une borne inférieure et un préfixe de publication. ~=1.4 accepte les versions à partir de 1.4 dans la série 1.*, tandis que ~=1.4.0 reste dans 1.4.*. ~=1, avec une seule composante, est invalide. La sélection des préversions est traitée séparément.
Le filtrage automatique peut retenir les préversions lorsqu’aucune autre version admissible n’existe. Ajouter une finale ou une post-publication convenable modifie ce choix collectif. Inclure montre toutes les candidates respectant les bornes ; Exclure interdit aussi le recours automatique.
À partie publique identique, la version locale vient après : 1.0 < 1.0+abc. Les segments locaux numériques suivent les segments textuels. Les valeurs normalisées égales gardent leur ordre initial. Contrairement aux métadonnées de construction SemVer, local affecte donc le classement.
Oui avec == ou !=, par exemple ==1.0+linux.1. Elle est refusée avec >= ou ~=. Une contrainte publique ==1.0 peut accepter 1.0+linux.1, car elle n’impose pas une construction locale particulière.
packaging.version.Version fournit l’ordre conforme à PEP. L’implémentation du navigateur est confrontée à packaging 26.0. Une comparaison de chaînes peut inverser 1.10 et 1.9, et un autre format ne reconnaît pas nécessairement epoch ou post.
Non. ==1.0.* est un préfixe de publication valide, mais ==1.0rc1.* et ==1.0.post1.* sont invalides. Utilisez une égalité exacte ou des bornes ordinaires pour ces suffixes. Le joker ne dispense pas de la politique de préversion.
Un résultat inattendu ?
Revenez au test de version PEP 440 avec votre liste complète et sa contrainte. Examinez les lignes invalides et l’explication des préversions avant de conserver le rapport actuel et ses valeurs d’origine.