Analizzatore SemVer

Una versione non è soltanto tre numeri: gli identificatori opzionali di prerelease uniti da trattini e i metadati di build con prefisso più cambiano come si etichetta e si confronta un rilascio. Questo analizzatore di versione SemVer accetta una sola stringa, la valida in modo rigoroso rispetto alla specifica ufficiale SemVer 2.0.0 e restituisce i componenti numerici major, minor e patch insieme a eventuali identificatori di prerelease e di build.

Ciò che SemVer 2.0.0 consente davvero

Il versionamento semantico 2.0.0 definisce una versione come MAJOR.MINOR.PATCH, tre interi non negativi uniti da punti, con identificatori opzionali di prerelease dopo un trattino e metadati opzionali di build dopo un più. Ciascuno di major, minor e patch è un identificatore numerico: oppure uno zero isolato, oppure una cifra da uno a nove seguita da altre cifre, così 1.0.0 è valido e 01.0.0 non lo è.

Una versione di prerelease è il nucleo seguito da un trattino e da uno o più identificatori separati da punti, come alpha, rc.1 o 0.3.4. Un identificatore di prerelease è oppure un identificatore numerico con la stessa regola di nessun zero iniziale, oppure un identificatore alfanumerico che contiene almeno una lettera o un trattino e, per il resto, soltanto lettere ASCII, cifre e trattini.

I metadati di build seguono un segno più e usano lo stesso alfabeto di identificatori, salvo che gli identificatori di build solo numerici possono conservare zeri iniziali, quindi 1.0.0+001 è lecito. Identificatori vuoti, punti consecutivi, un trattino o un più finale, una v iniziale, versioni a due parti come 1.2 e lettere non ASCII sono illeciti. Questo analizzatore implementa quella grammatica come uno scanner da sinistra a destra, non come un'espressione regolare permissiva, così un fallimento nomina la regola infranta invece di restituire un oggetto a metà.

L'ordine di confronto è fuori ambito: la capacità analizza e valida, non classifica due versioni l'una rispetto all'altra.

Dove un analizzatore SemVer ripaga davvero

I registri di pacchetti, i robot di pubblicazione e i generatori di changelog hanno bisogno di un solo posto che dica se un'etichetta è una versione SemVer lecita e quali sono le sue cinque parti. Un lavoro di integrazione continua che rifiuta di pubblicare quando l'etichetta git è v1.2.3 invece di 1.2.3, o quando qualcuno ha digitato solo 1.2, evita un rilascio rotto prima che arrivi a un registro.

Gli scanner di dipendenze che leggono lockfile vogliono campi strutturati major, minor, patch e prerelease senza trascinare un runtime semver specifico di un linguaggio in un worker di bordo. Chi insegna il versionamento vuole una pagina dedicata che spieghi gli zeri iniziali e i metadati di build, invece di seppellire l'argomento sotto uno spezzatore di stringhe generico. Una convalida fallita non consuma il saldo.

Tenga le stringhe sotto il limite di lunghezza documentato, fissi i campi strutturati nelle prove e otterrà componenti riproducibili per strumenti di rilascio, plugin di apprendimento e worker di bordo, senza erigere una libreria semver propria di un linguaggio.