Usa el Calculadora de Versiones Semver gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
¿Qué es el versionado semántico?
El versionado semántico, normalmente abreviado como semver, es un acuerdo sencillo sobre qué significan los números de versión. Una versión tiene tres números: mayor.menor.parche. Subes el número mayor cuando haces un cambio que rompe la compatibilidad, el número menor cuando añades una función que mantiene la compatibilidad y el número parche cuando corriges un error sin cambiar el comportamiento. La versión 2.3.4 significa, por tanto, la segunda versión mayor, el tercer conjunto de funciones compatibles y la cuarta corrección sobre esa base.
Este acuerdo solo funciona si todos lo siguen, y en la práctica la mayorÃa de las librerÃas populares lo hacen. Por eso los gestores de paquetes pueden instalar actualizaciones con seguridad: una herramienta que acepta versiones desde la 2.0.0 hasta la 3.0.0, sin incluirla, confÃa en que nada de la lÃnea 2.x romperá su código. Cuando un mantenedor rompe esa confianza y publica un cambio incompatible como versión menor, los usuarios lo notan rápido, porque las construcciones fallan por motivos que parecen misteriosos. Semver es un contrato social respaldado por herramientas, y la calculadora de arriba te ayuda a aplicar sus reglas con exactitud.
Por qué comparar versiones es más difÃcil de lo que parece
Comparar versiones como texto plano da respuestas equivocadas. Como texto, la 1.10.0 va antes que la 1.4.0, porque el carácter 1 se ordena antes que el 4. Como versiones, la 1.10.0 es más reciente, porque el número menor 10 es mayor que 4. Cualquier código que ordene versiones alfabéticamente acabará instalando la versión equivocada o saltándose una actualización. La calculadora compara cada parte numérica por separado, asà que la 1.10.0 vence correctamente a la 1.4.2, y la 2.0.0 vence a la 1.99.99.
Las versiones pre-lanzamiento añaden otra regla que sorprende a muchos. Una versión como 1.0.0-beta.1 es más antigua que la 1.0.0, no más reciente. La etiqueta pre-lanzamiento significa que la versión aún no está terminada, asà que se ordena antes que la versión final correspondiente. Los metadatos de construcción tras un signo más, como 1.0.0+build.5, se ignoran al comparar, porque describen cómo se construyó la versión, no qué versión es. La calculadora sigue ambas reglas y acepta una v inicial opcional, asà que v1.2.3 funciona igual que 1.2.3.
Cómo usar la calculadora
Para comparar dos versiones, escrÃbelas en las dos casillas y pulsa Comparar. La herramienta te dice si la primera es más antigua, igual o más reciente que la segunda, y señala la entrada no válida con palabras claras en lugar de adivinar en silencio. Para subir una versión, escrÃbela y elige mayor, menor, parche o pre-lanzamiento. Una subida mayor de 2.3.4 da 3.0.0, una menor da 2.4.0 y una parche da 2.3.5. Una subida pre-lanzamiento convierte 2.3.4 en 2.3.4-beta.1, o avanza una etiqueta pre-lanzamiento existente.
Para ordenar una lista, pega una versión por lÃnea y pulsa Ordenar. La herramienta revisa primero cada lÃnea y nombra cualquier lÃnea no válida en lugar de eliminarla en silencio, lo que importa cuando la lista viene de un registro de cambios o de un feed de versiones. Ordenar es útil antes de una revisión de lanzamiento, cuando quieres ver el orden real en que salieron las versiones, o cuando estás limpiando etiquetas en un repositorio y necesitas ver los huecos.
Elegir la próxima versión
La parte más difÃcil de semver no es la aritmética, sino el juicio. Hazte una pregunta: ¿este cambio romperÃa a alguien que usa la versión actual de forma correcta? Si la respuesta es sÃ, es mayor. Si solo añade algo nuevo, es menor. Si solo corrige algo roto, es parche. Cambiar el nombre de una función, quitar un parámetro o cambiar un tipo de retorno es mayor. Añadir un parámetro opcional es menor. Corregir un fallo es parche. Cuando dudes entre menor y mayor, elige mayor. Los usuarios perdonan una subida mayor que resulta ser segura; no perdonan una subida menor que rompe su construcción.
Para las versiones 0.x las reglas son más flexibles por acuerdo: cualquier cosa puede cambiar en cualquier momento, porque el proyecto está diciendo que aún no es estable. Cuando llegas a la 1.0.0, le estás diciendo al mundo que la API pública es estable, asà que trata ese hito con seriedad. Guarda un registro de cambios que liste en lenguaje claro qué cambió en cada versión, y deja que el número de versión lo resuma. Un buen versionado es una forma de comunicación, y esta calculadora se encarga de las cuentas para que puedas concentrarte en el mensaje.
Herramientas relacionadas
- Semantic Version Calculator (English version)
- Calculadora de Permisos Chmod
- Buscar Códigos de Estado HTTP