Ruby:如何编写宝石?[关闭]


160

我想为Ruby编写一个程序包,并将其作为gem提供。
有哪些工具,步骤和陷阱?
有没有很好的教程,截屏等,可以帮助您学习如何做?

Answers:


216

Rubygems.org的指南是编写您自己的gem的最佳资源之一。

如果您在应用程序中使用Bundler,则可能需要查看Ryan Bigg的使用BundlerRailscast 使用Bundler 创建宝石的使用RubyGem开发指南。

如果您对帮助您编写宝石的工具感兴趣:

一些教程/指南:


3
gem build由RubyGems本身提供。Gemcutter的所有宝石(不久之后,RubyGems都可以使用)允许您使用API​​推送RubyGem。 gemcutter.org/pages/gem_docs gemcutter.org/pages/api_docs
qrush 2010年

谢谢,我已经编辑了回复。
Jack Chu

6

这通常是我创建和发布Gems的方式:

  1. 注册https://github.com
  2. 注册https://rubygems.org
  3. $ gem install ore rubygems-tasks rdoc rspec
  4. $ mine awesome_gem
  5. cd awesome_gem/并编辑README.rdocawesome_gem.gemspec,在中编写代码lib/awesome_gem/并在中添加RSpec测试specs/
  6. 准备发布时,请更新ChangeLog.rdoc文件,运行rake specrake rerdoc,然后打开html/index.html并仔细检查是否有错字。
  7. rake release
  8. (可选)将您的新宝石的链接和说明提交至http://rubyflow.com

坐下来,享受第一颗宝石的荣耀。:)


6

您无需开始编写gem,只需编写一些代码,编写一些测试,然后按需要使用它,一旦对它感到满意,就可以使用gem生成相关的Rakefile。

如果您坚持使用其他gem所采用的方法(有一个lib目录,避免以可能与其他gem冲突的方式命名文件,如果可以的话,编写一些测试,并拥有一个自述文件)会很有帮助,但这不是必需的。

一旦您有想要共享的东西,将其放在github上并将其推送到gemcutter

不要过度思考,不要使用头或其他过大的工具,要有乐趣,不要做我不会做的事。

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.