Confronti versioni semantiche secondo le regole SemVer

Confronti due numeri di versione semantica senza affidarsi all’ordinamento lessicale, alla conversione in virgola mobile o a scorciatoie specifiche dei gestori di pacchetti. Questa capacità convalida entrambi gli input secondo Semantic Versioning 2.0.0 e applica le regole ufficiali di precedenza ai componenti major, minor, patch e pre-release. Indica se la prima versione ha precedenza inferiore, superiore o uguale alla seconda e ignora correttamente i metadata di build. Le versioni non valide o incomplete producono un chiaro errore di input, anziché un ordinamento fuorviante.

Confronti le versioni con le regole usate dalle release software

Il normale confronto tra stringhe restituisce risultati errati per molti numeri di versione. Per esempio, un ordinamento lessicale può collocare 2.10.0 prima di 2.9.0 perché confronta il carattere 1 con 9, mentre una conversione numerica elimina il significato distinto delle posizioni major, minor e patch. Questo comparatore analizza separatamente ogni posizione obbligatoria e procede da sinistra a destra.

Rifiuta inoltre forme permissive, come un componente patch mancante, una v iniziale o un identificatore numerico principale con zero iniziale. Una convalida rigorosa è preziosa negli script di distribuzione, nei registri dei pacchetti, nei servizi di aggiornamento e nei controlli CI, perché impedisce a dati non validi di passare silenziosamente come release legittime. Invii la prima e la seconda versione esattamente come pubblicate.

Il risultato include una precedenza con segno: meno uno indica che la prima è inferiore, zero indica equivalenza e uno indica che la prima è superiore. Un campo descrittivo rende la stessa risposta pratica per interfacce e condizioni di workflow.

Comprenda l’ordine delle pre-release e i metadata di build

Gli identificatori di pre-release sono il punto in cui i comparatori semplicistici falliscono più spesso. Una release con un suffisso preliminare ha precedenza inferiore rispetto alla stessa versione major, minor e patch priva del suffisso: 1.0.0-rc.1 è quindi inferiore a 1.0.0. Se entrambe sono pre-release, gli identificatori vengono confrontati in sequenza.

Quelli numerici si confrontano per grandezza, quelli non numerici secondo l’ordine lessicale ASCII e un identificatore numerico ha sempre precedenza inferiore a uno non numerico. Se tutti gli identificatori condivisi coincidono, la versione che ne contiene di più ha precedenza superiore. Queste regole riproducono la progressione standard da alpha a beta e alle release candidate senza attribuire significati speciali a parole specifiche.

I metadata dopo il segno più vengono convalidati ma esclusi dalla precedenza. Pertanto, 1.0.0+linux e 1.0.0+windows sono equivalenti nonostante le stringhe diverse.

Usi il confronto rigoroso in modo sicuro nell’automazione

Un risultato deterministico può diventare un punto decisionale piccolo e affidabile all’interno di sistemi più ampi. Una pipeline di rilascio può richiedere che la versione proposta sia superiore a quella distribuita. Un programma di aggiornamento può stabilire se un manifesto scaricato rappresenta un upgrade, un downgrade o una build equivalente.

Una suite di test può coprire la sequenza canonica delle pre-release e respingere le etichette non valide prima della pubblicazione degli artefatti. L’implementazione non effettua richieste di rete, non legge l’orologio e non usa valori casuali: gli stessi input producono sempre lo stesso output. Gli identificatori numerici vengono confrontati come stringhe di cifre, invece di essere convertiti in numeri JavaScript, mantenendo l’ordine corretto anche oltre l’intervallo degli interi sicuri.

La lunghezza degli input è limitata per mantenere l’elaborazione circoscritta.