Elixir Version用法及代碼示例

根據需求解析和匹配版本的函數。

版本是特定格式的字符串或通過 Version.parse/1 解析後生成的 Version 。

盡管 Elixir 項目不需要遵循 SemVer，但它們必須遵循 SemVer 2.0 schema 中列出的格式。

版本

簡而言之，一個版本由三個數字表示：

MAJOR.MINOR.PATCH

通過可選地在補丁版本之後附加一個連字符和一係列 period-separated 標識符來支持預發布。標識符僅由 ASCII 字母數字字符和連字符 ([0-9A-Za-z-]) 組成：

"1.0.0-alpha.3"

可以通過在補丁或預發布版本之後附加一個加號和一係列 dot-separated 標識符來添加構建信息。標識符僅由 ASCII 字母數字字符和連字符 ([0-9A-Za-z-]) 組成：

"1.0.0-alpha.3+20130417140000.amd64"

結構

版本由 Version 結構表示，字段根據 SemVer 2.0 命名：:major、:minor、:patch、:pre和:build。您可以讀取這些字段，但不應直接通過結構語法創建新的 Version 。而是使用此模塊中的函數。

要求

需求允許您指定您願意使用的給定依賴項的哪些版本。要求支持常見的比較運算符，例如 > 、 >= 、 < 、 <= 和 == ，它們可以按預期工作，另外還支持特殊運算符 ~> 在下麵進一步詳細說明。

# Only version 2.0.0
"== 2.0.0"

# Anything later than 2.0.0
"> 2.0.0"

對於複雜條件，要求還支持 and 和 or：

# 2.0.0 and later until 2.1.0
">= 2.0.0 and < 2.1.0"

由於上麵的例子是這樣一個常見的需求，它可以表示為：

"~> 2.0.0"

~> 將永遠不會包含其上限的預發布版本，無論是否使用了 :allow_pre 選項，或者操作數是否為預發布版本。它也可用於僅在主要版本部分設置上限。請參閱下表了解~> 要求及其相應的翻譯。

~> 之後的要求操作數允許省略補丁版本，允許我們表達 ~> 2.1 或 ~> 2.1-dev ，這是使用常見比較運算符時不允許的。

當 :allow_pre 選項在 Version.match?/3 中設置 false 時，除非操作數是預發布版本，否則要求將不匹配預發布版本。默認情況下始終允許預發布，但請注意在十六進製中 :allow_pre 設置為 false 。有關示例，請參見下表。