Verifica di versioni e intervalli SemVer

Questo strumento risponde applicando la precedenza deterministica di SemVer. Comprende comparatori, intersezioni separate da spazi, intervalli con trattino, caratteri jolly, versioni parziali e alternative con doppia barra. Gli identificatori di prerelease e build ricevono il corretto significato semantico, quindi il risultato è adatto agli strumenti per le dipendenze e non è una semplice approssimazione numerica.

Inserisca una versione e l’intervallo da verificare

Fornisca una versione semantica completa, per esempio <code>2.4.1</code>, e un’espressione di intervallo. In un insieme di comparatori separati da spazi devono riuscire tutte le condizioni: <code>&gt;=2.0.0 &lt;3.0.0</code> accetta quindi le versioni stabili della seconda versione principale. Separi gli insiemi con <code>||</code> quando può bastare uno dei rami. Anche una versione esatta è un intervallo valido. Lo strumento restituisce la versione normalizzata, l’intervallo senza spazi esterni, un valore booleano e l’alternativa corrispondente numerata da uno; zero indica che nessuna alternativa coincide. Questo risultato esplicito è facile da usare in un controllo di distribuzione, un rapporto sulle dipendenze, un editor di manifesti o un test senza interpretare testo descrittivo. Gli input sono stringhe: convertire l’intera versione in virgola mobile farebbe sembrare 1.10 minore di 1.9 ed eliminerebbe i prerelease. Una <code>v</code> iniziale è accettata nelle versioni complete e rimossa dalla normalizzazione; componenti non validi, alternative vuote e identificatori errati producono un errore di input tipizzato anziché un falso risultato inaffidabile.

Usi con precisione comparatori, trattini e caratteri jolly

Sono disponibili <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code> e <code>=</code>. Più comparatori nella stessa alternativa formano un’intersezione. Un’espressione come <code>1.2.3 - 2.4.0</code> include entrambi gli estremi completi; un estremo superiore parziale viene esteso alla fine della propria famiglia: <code>1.2 - 2.4</code> parte da 1.2.0 e si ferma prima di 2.5.0. I caratteri jolly possono essere <code>x</code>, <code>X</code> o <code>*</code>. Pertanto <code>3.x</code> copre le versioni stabili da 3.0.0 fino a prima di 4.0.0, mentre <code>3.2</code> equivale a <code>3.2.x</code>. I jolly devono seguire i componenti noti; <code>1.x.4</code> viene rifiutato perché non descrive un intervallo coerente. Questa capacità rifiuta intenzionalmente le abbreviazioni con accento circonflesso e tilde. Esprima quei limiti con comparatori espliciti, affinché la regola resti visibile e inequivocabile nei log, nelle politiche generate, nei controlli automatici e nelle revisioni umane.

Comprenda precedenza, prerelease e metadati di build

Le versioni semantiche si confrontano componente per componente, non alfabeticamente. Decidono prima i numeri principale, secondario e patch. Un prerelease precede la relativa versione stabile; i suoi identificatori separati da punti vengono confrontati da sinistra a destra: quelli numerici si confrontano numericamente, precedono quelli non numerici e un prefisso uguale più corto viene prima. I metadati dopo <code>+</code> sono conservati nell’output normalizzato ma non cambiano mai la precedenza, come richiede SemVer. I gestori di dipendenze evitano inoltre di selezionare accidentalmente prerelease. Lo strumento segue tale comportamento: un prerelease può soddisfare un insieme soltanto quando quell’insieme contiene un comparatore prerelease con gli stessi numeri principale, secondario e patch. Per esempio, <code>2.0.0-beta.2</code> può soddisfare <code>&gt;=2.0.0-beta.1 &lt;2.0.0</code>, ma non rientra in un jolly ampio solo perché coincide il nucleo numerico. Ogni valutazione è locale e deterministica. Non vengono interrogati registri, scaricati pacchetti o ipotizzati rilasci correnti; le stesse stringhe restituiscono sempre la stessa decisione.