Перейти к содержанию
100% локально

Калькулятор семантических версий

Вычислите следующую семантическую версию из текущей версии и типа изменения.

Входные данные
Выходные данные

Калькулятор семантических версий

Вставьте версию вроде 1.4.2, выберите тип изменения — основная, дополнительная, патч, предосновная или предрелиз — и этот инструмент вычислит точную следующую семантическую версию, придерживаясь правил SemVer 2.0.0 для предрелизов и метаданных сборки. Он создан для мейнтейнеров, выпускающих релиз, скриптов CI, которым нужен следующий тег, и для тех, кто хочет проверить изменение версии перед тем, как оно попадет в package.json или git-тег.

Предосновные и предрелизные изменения используют опцию идентификатора предрелиза — alpha, beta или rc — для открытия или продолжения цепи предрелизов, поэтому 2.0.0 становится 2.0.0-beta.0, а второе предрелизное изменение с тем же идентификатором переводит его в beta.1. Добавьте метаданные сборки, такие как хэш коммита, и они будут добавлены после знака плюс. Включите опцию «Рекомендовать изменение из списка коммитов» и поместите вашу текущую версию на первую строку, затем один коммит Conventional Commits на строку: feat: рекомендует дополнительное изменение, fix: или perf: рекомендуют патч, а «!» после типа или footer BREAKING CHANGE: рекомендует основное изменение. Введите диапазон с каретой (^1.2.0) или диапазон с тильдой (~1.2.0), чтобы увидеть, остается ли вычисленная версия внутри него.

Калькулятор принимает необязательный начальный v (v1.4.2), правильно читает существующие идентификаторы предрелиза и метаданных сборки и обрабатывает переводы строк Windows и Unix одинаково. Версия, которая не является действительной SemVer, или диапазон, который не является действительным выражением с каретой или тильдой, сообщается простым языком, а не как молчаливый неправильный ответ.

Все вычисления выполняются в вашем браузере. Номер версии или сообщение коммита никогда не загружаются, поэтому это безопасно использовать с невыпущенным проектом. Скопируйте результат, загрузите его как файл .txt или отправьте обратно во входные данные, чтобы связать еще одно изменение версии.

FAQ

Как рекомендация из списка коммитов определяет тип изменения?
Она читает каждую строку после версии как сообщение Conventional Commits. Любой символ «!» после типа или footer BREAKING CHANGE: рекомендует основное изменение; в противном случае строка feat: рекомендует дополнительное изменение, а строка fix: или perf: рекомендуют патч. Если в числе обнаруживаются узнаваемые коммиты, инструмент использует выбранный вами тип изменения.
Что происходит с существующим предрелизом при основном, дополнительном или патч-изменении?
Если изменение поля уже находится на его следующем значении в предрелизе (например 2.0.0-rc.1 при основном изменении), то предрелиз просто удаляется вместо двойного увеличения, что соответствует тому, как это обрабатывают такие инструменты, как npm version.
Что означают проверки диапазона с каретой и тильдой?
Диапазон с каретой, например ^1.2.0, позволяет любое изменение, которое не затрагивает самую левую ненулевую цифру; диапазон с тильдой, например ~1.2.0, позволяет только патч-уровневые изменения. Инструмент сообщает, находится ли ваша вычисленная версия внутри введенного вами диапазона.
Он принимает версии с начальным «v», например v1.4.2?
Да. Начальный v распознается и удаляется перед анализом, что соответствует общему именованию git-тегов, и не переносится в вычисленный результат.
Мой номер версии или список коммитов загружаются куда-нибудь?
Нет. Вычисление версии выполняется полностью в вашем браузере — ничто из того, что вы вставляете, никогда не покидает ваше устройство.