SemVer

Хочешь карту со своим ником? Оформить ❤️

Семантическое управление версиями для Lua.
Видишь http://semver.org / для получения подробной информации о семантическом управлении версиями.

v»1.2.3″ == v(1,2,3)
v»1.2.3″
v»1.2.3-альфа»
v»1.2.3″ == v»1.2.3+сборка.1″

Документация

локальный v = пользователь LibStub’

— два способа его создания: с отдельными параметрами или с одной строкой
v1 = v(1,0,0)
v2 = v(«2.5.1»)

— При использовании одной строки скобку можно пропустить:
v2 = v»2.5.1″ — допустимо в Lua

— основные, второстепенные и патч-атрибуты
v2.майор — 2
v2.минор — 5
v2.патч — 1

— предварительные выпуски:
a = v(1,0,0,»альфа»)
a.предварительный выпуск — «альфа»
b = v(«1.0.0-бета»)
б.предварительный выпуск — «бета»

— строит
c = v(1,0,0,ноль,»сборка-1″)
c.сборка — «сборка-1»

d = v(«0.9.5+номер расширения 22»)
d.сборка — «№ расширений.22»

— сравнение и сортировка
v»1.2.3″ == v(1,2,3) — верно
v»1.2.3″
v»1.2.3-альфа»
v»1.2.3″1″ — false, сборки игнорируются при сравнении версий в SemVer
— (см. раздел «Примечания» для получения дополнительной информации о сравнении версий)

— оператор совместимости: ^
— a ^ b возвращает значение true, если a и b совместимы
— предназначен для использования для сравнения версий между пользователями
v»2.0.1″ ^ v»2.5.1″ — верно — для версий 2.0.1 и 2.5.1 безопасно обмениваться данными
v»2.5.1″ ^ v»2.0.1″ — верно — для версий 2.0.1 и 2.5.1 безопасно обмениваться данными
v»1.0.0″ ^ v»2.0.0″ — false — 2.0.0 не должен быть обратно совместимым
v»0.0.1″ ^ v»0.5.1″ — ложь — версии предварительного выпуска должны быть идентичными, чтобы считаться совместимыми

— получение более новых версий
v(1,2,3):NextPatch() — v1.2.4
v(1,2,3):NextMinor() — v1.3.0 . Обратите внимание, что исправление сбрасывается до 0
v(1,2,3):NextMajor() — v2.0.0 . Минор и патч сбрасываются на 0

Установка

Устанавливайте так же, как и с любым другим дополнением.

Для разработчиков:
Вы можете включить SemVer в качестве библиотеки в любой аддон, который вы хотите (например, в библиотеки / папку). Убедитесь, что файл toc содержит SemVer.xml или SemVer.lua. LibStub — это обязательная библиотека, поэтому обязательно включите ее (если она еще не включена).

Запишите это в любой файл lua, где вы хотите его использовать:

локальный v = LibStub»Семвер»

Использование v позволяет использовать хороший строковый синтаксис: v"1.2.3-альфа".

Вместо этого вы можете использовать SemVer:

локальный семвер = LibStub»Семвер»

Примечания по сравнению версий

Сравнение версий производится в соответствии со спецификациями Semver 2.0.0:

Основные, второстепенные и исправленные версии всегда сравниваются численно.

Приоритет перед выпуском ДОЛЖЕН определяться путем сравнения каждого идентификатора, разделенного точками, следующим образом:

• Идентификаторы, состоящие только из цифр, сравниваются численно
• Идентификаторы с буквами или тире сравниваются лексически в порядке сортировки ASCII.
• Числовые идентификаторы всегда имеют более низкий приоритет, чем нечисловые идентификаторы

Сборки игнорируются при расчете приоритета: версии 1.2.3 и 1.2.3+build5 считаются равными.

Полная документация и инструкции по установке

Похожие аддоны

EventHorizon Omen Threat Meter Glamour Troll The Bones (Roll The Bones Tracker)