Analizador SemVer

Una versión no son solo tres números: los identificadores opcionales de prerelease unidos por guiones y los metadatos de build con prefijo más cambian cómo se etiqueta y se compara un lanzamiento. Este analizador de versión SemVer acepta una sola cadena, la valida de forma estricta contra la especificación oficial SemVer 2.0.0 y devuelve los componentes numéricos major, minor y patch junto con cualquier identificador de prerelease y de build.

Qué permite realmente SemVer 2.0.0

El versionado semántico 2.0.0 define una versión como MAJOR.MINOR.PATCH, tres enteros no negativos unidos por puntos, con identificadores opcionales de prerelease unidos por un guion y metadatos opcionales de build con prefijo más. Cada uno de major, minor y patch es un identificador numérico: o bien un cero suelto, o bien una cifra del uno al nueve seguida de más dígitos, de modo que 1.0.0 es válido y 01.0.0 no lo es.

Una versión de prerelease es el núcleo seguido de un guion y uno o más identificadores separados por puntos, como alpha, rc.1 o 0.3.4. Un identificador de prerelease es o bien un identificador numérico con la misma regla de no ceros a la izquierda, o bien un identificador alfanumérico que contiene al menos una letra o un guion y, por lo demás, solo letras ASCII, dígitos y guiones.

Los metadatos de build siguen a un signo más y usan el mismo alfabeto de identificadores, salvo que los identificadores de build formados solo por dígitos pueden conservar ceros a la izquierda, así que 1.0.0+001 es legal. Los identificadores vacíos, los puntos consecutivos, un guion o un más finales, un v inicial, las versiones de dos partes como 1.2 y las letras no ASCII son ilegales.

Este analizador implementa esa gramática como un escáner de izquierda a derecha, no como una expresión regular permisiva, de modo que un fallo nombra la regla rota en lugar de devolver un objeto a medias. El orden de comparación queda fuera de alcance: la capacidad analiza y valida, no clasifica dos versiones entre sí.

Dónde un analizador SemVer aporta valor real

Los registros de paquetes, los bots de publicación y los generadores de changelog necesitan un solo sitio que responda si una etiqueta es una versión SemVer legal y cuáles son sus cinco partes. Un trabajo de integración continua que se niega a publicar cuando la etiqueta git es v1.2.3 en lugar de 1.2.3, o cuando alguien escribió solo 1.2, evita un lanzamiento roto antes de que llegue a un registro.

Los escáneres de dependencias que leen lockfiles quieren campos estructurados major, minor, patch y prerelease sin arrastrar un motor semver propio de un lenguaje a un worker de borde. Quien enseña versionado quiere una landing dedicada que explique los ceros a la izquierda y los metadatos de build, no enterrar el tema bajo un divisor de cadenas genérico. La validación fallida no consume saldo.

Mantenga las cadenas bajo el límite de longitud documentado, fije los campos estructurados en las pruebas y obtendrá componentes reproducibles para herramientas de publicación, complementos de aprendizaje y workers de borde sin montar una biblioteca semver propia de un lenguaje.