SemVer-Bereich prüfen und Paketversionen testen

Dieser Prüfer beantwortet sie mit der deterministischen Rangfolge von SemVer. Er versteht Vergleichsoperatoren, durch Leerzeichen verbundene Schnittmengen, Bindestrichbereiche, Platzhalter, Teilversionen und Alternativen mit doppeltem senkrechtem Strich. Vorabversions- und Build-Kennungen erhalten ihre korrekte semantische Bedeutung. Das Ergebnis eignet sich daher für Abhängigkeitswerkzeuge und ist keine grobe Zahlenannäherung.

Geben Sie eine Version und den zu prüfenden Bereich ein

Geben Sie eine vollständige semantische Version wie <code>2.4.1</code> und einen Bereichsausdruck an. In einer durch Leerzeichen getrennten Vergleichsgruppe müssen alle Bedingungen erfüllt sein; <code>&gt;=2.0.0 &lt;3.0.0</code> akzeptiert somit stabile Veröffentlichungen der Hauptversion zwei. Trennen Sie Gruppen mit <code>||</code>, wenn eine beliebige Alternative genügen darf. Auch eine exakte Version ist ein gültiger Bereich. Die Ausgabe enthält die normalisierte Version, den außen bereinigten Bereich, einen Wahrheitswert und die ab eins gezählte passende Alternative; null bedeutet, dass keine Alternative passt. Diese eindeutige Form lässt sich ohne Textauswertung in Bereitstellungssperren, Abhängigkeitsberichte, Manifesteditoren oder Tests einbauen. Eingaben bleiben Zeichenketten, weil eine Umwandlung ganzer Versionen in Gleitkommazahlen 1.10 fälschlich kleiner als 1.9 erscheinen ließe und Vorabinformationen verlöre. Ein führendes <code>v</code> wird bei vollständigen Versionen angenommen und bei der Normalisierung entfernt. Fehlerhafte Bestandteile, leere Alternativen und ungültige Kennungen führen zu einem typisierten Eingabefehler statt zu einem unzuverlässigen Falschwert.

Verwenden Sie Operatoren, Bindestriche und Platzhalter genau

Unterstützt werden <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code> und <code>=</code>. Mehrere Vergleiche in einer Alternative bilden eine Schnittmenge. Ein Ausdruck wie <code>1.2.3 - 2.4.0</code> schließt beide vollständigen Grenzen ein. Eine unvollständige Obergrenze wird bis zum Ende ihrer Komponentenfamilie erweitert: <code>1.2 - 2.4</code> beginnt bei 1.2.0 und endet vor 2.5.0. Platzhalter können als <code>x</code>, <code>X</code> oder <code>*</code> geschrieben werden. Daher umfasst <code>3.x</code> stabile Versionen von 3.0.0 bis vor 4.0.0; der Teilbereich <code>3.2</code> entspricht <code>3.2.x</code>. Platzhalter müssen auf bekannte Komponenten folgen. <code>1.x.4</code> wird abgelehnt, weil es kein zusammenhängendes Intervall beschreibt. Kurzformen mit Zirkumflex oder Tilde werden absichtlich nicht unterstützt. Schreiben Sie solche Grenzen mit ausdrücklichen Vergleichsoperatoren, damit die geprüfte Regel in Protokollen, erzeugten Richtlinien, automatischen Kontrollen und menschlichen Prüfungen sichtbar und eindeutig bleibt.

Verstehen Sie Rangfolge, Vorabversionen und Build-Metadaten

Semantische Versionen werden Bestandteil für Bestandteil und nicht alphabetisch verglichen. Zuerst entscheiden Haupt-, Neben- und Patchnummer. Eine Vorabversion steht vor der zugehörigen stabilen Veröffentlichung. Ihre durch Punkte getrennten Kennungen werden von links nach rechts verglichen: Zahlen numerisch, numerische Kennungen vor nichtnumerischen und ein kürzeres gleiches Präfix zuerst. Metadaten nach <code>+</code> bleiben in der normalisierten Ausgabe erhalten, ändern gemäß SemVer jedoch niemals die Rangfolge. Abhängigkeitsmanager schützen außerdem vor der unbeabsichtigten Auswahl von Vorabversionen. Dieser Prüfer folgt diesem Verhalten: Eine Vorabversion kann eine Gruppe nur erfüllen, wenn dieselbe Gruppe einen Vorabvergleich mit identischer Haupt-, Neben- und Patchnummer enthält. Beispielsweise kann <code>2.0.0-beta.2</code> den Bereich <code>&gt;=2.0.0-beta.1 &lt;2.0.0</code> erfüllen, gelangt aber nicht allein wegen des passenden Zahlenkerns in einen allgemeinen Platzhalterbereich. Jede Auswertung erfolgt lokal und deterministisch. Es werden weder Register abgefragt noch Pakete geladen oder aktuelle Veröffentlichungen geraten. Dieselben Zeichenketten liefern stets dieselbe Entscheidung.