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}