Calculadora de versão semântica

Calcule a próxima versão semântica a partir de uma versão atual e um tipo de incremento escolhido, seguindo as regras SemVer.

Entrada

Tipo de incrementoIdentificador de pré-lançamentoMetadados de compilaçãoRecomendar incremento a partir da lista de commitsVerificar contra intervalo

Saída

Calculadora de versão semântica

Cole uma versão como 1.4.2 e escolha um tipo de incremento — major, minor, patch, premajor ou pré-lançamento — e esta ferramenta calcula a versão semântica exata seguinte, seguindo as regras SemVer 2.0.0 para pré-lançamentos e metadados de compilação. Foi desenvolvida para responsáveis que preparam uma versão, scripts de CI que precisam da próxima tag e qualquer pessoa que queira verificar um incremento de versão antes de chegar ao package.json ou a uma tag git.

Os incrementos premajor e pré-lançamento usam a opção de identificador de pré-lançamento — alpha, beta ou rc — para abrir ou continuar uma série de pré-lançamento, portanto 2.0.0 torna-se 2.0.0-beta.0, e um segundo incremento de pré-lançamento no mesmo identificador o move para beta.1. Adicione metadados de compilação como um hash de commit e será anexado após um sinal de adição. Ative "Recomendar incremento a partir da lista de commits" e coloque sua versão atual na primeira linha, seguida por uma mensagem Conventional Commits por linha: feat: recomenda um incremento minor, fix: ou perf: recomenda um patch, e um "!" após o tipo ou um rodapé BREAKING CHANGE: recomenda um incremento major. Digite um intervalo com acento (^1.2.0) ou um intervalo com til (~1.2.0) para ver se a versão calculada ainda se enquadra nele.

A calculadora aceita um v inicial opcional (v1.4.2), lê corretamente os identificadores de pré-lançamento e compilação existentes e trata as quebras de linha do Windows e Unix da mesma forma. Uma versão que não é válida SemVer ou um intervalo que não é uma expressão com acento ou til válida é relatado em linguagem clara, não como uma resposta silenciosamente errada.

Tudo é executado em seu navegador. Nenhum número de versão ou mensagem de commit é carregado, portanto é seguro usar em um projeto não lançado. Copie o resultado, baixe-o como um arquivo .txt ou envie-o de volta para a entrada para encadear outro incremento no topo.

FAQ

Como a recomendação de lista de commits decide o tipo de incremento?

Ela lê cada linha após a versão como uma mensagem Conventional Commits. Qualquer "!" após o tipo ou um rodapé BREAKING CHANGE: recomenda um incremento major; caso contrário, uma linha feat: recomenda minor e uma linha fix: ou perf: recomenda patch. Sem commits reconhecíveis, volta para o tipo de incremento escolhido manualmente.

O que acontece com uma pré-lançamento existente quando eu faço incremento major, minor ou patch?

Incrementar um campo que já está em seu próximo valor em uma pré-lançamento (por exemplo 2.0.0-rc.1 com um incremento major) apenas remove a pré-lançamento em vez de incrementar duas vezes, correspondendo à forma como ferramentas como npm version lidam com isso.

O que significam as verificações de intervalo com acento e com til?

Um intervalo com acento como ^1.2.0 permite qualquer mudança que não toque no dígito não-zero mais à esquerda; um intervalo com til como ~1.2.0 permite apenas mudanças no nível de patch. A ferramenta relata se sua versão calculada se enquadra no intervalo que você inseriu.

Aceita versões com um "v" inicial, como v1.4.2?

Sim. O v inicial é reconhecido e eliminado antes da análise, correspondendo à nomenclatura comum de tags git, e não é mantido no resultado calculado.

Meu número de versão ou lista de commits é carregado em algum lugar?

Não. O cálculo de incremento é executado inteiramente em seu navegador — nada que você cole sai do seu dispositivo.

Calculadora de versão semântica

Ferramentas relacionadas

Calculadora de versão semântica

FAQ