Ruby Specification.metadata用法及代碼示例

metadata [讀寫]

元數據包含此 gem 的額外數據，這些數據可能對其他消費者有用，並且可由 gem 作者設置。

元數據項具有以下限製：

• 元數據必須是 Hash 對象

• 所有鍵和值都必須是字符串

• 鍵最大為 128 字節，值最大為 1024 字節

• 所有字符串必須是 UTF-8，不允許使用二進製數據

您可以使用元數據來指定指向 gem 主頁、代碼庫、文檔、wiki、郵件列表、問題跟蹤器和變更日誌的鏈接。

s.metadata = {
  "bug_tracker_uri"   => "https://example.com/user/bestgemever/issues",
  "changelog_uri"     => "https://example.com/user/bestgemever/CHANGELOG.md",
  "documentation_uri" => "https://www.example.info/gems/bestgemever/0.0.1",
  "homepage_uri"      => "https://bestgemever.example.io",
  "mailing_list_uri"  => "https://groups.example.com/bestgemever",
  "source_code_uri"   => "https://example.com/user/bestgemever",
  "wiki_uri"          => "https://example.com/user/bestgemever/wiki"
  "funding_uri"       => "https://example.com/donate"
}

這些鏈接將在 rubygems.org 上的 gem 頁麵上使用，並且必須通過以下正則表達式的驗證。

%r{\Ahttps?:\/\/([^\s:@]+:[^\s:@]*@)?[A-Za-z\d\-]+(\.[A-Za-z\d\-]+)+\.?(:\d{1,5})?([\/?]\S*)?\z}