Ruby: Как написать драгоценный камень?

Question

Я хотел бы написать пакет для Ruby и сделать его доступным как драгоценный камень.
Каковы инструменты, шаги и подводные камни?
Есть ли хорошие учебники, скринкасты и т. Д., Которые помогли вам научиться этому?

Answer 1

Rubygems.org's Guides является одним из лучших ресурсов для написания собственного драгоценного камня.

Если вы используете Bundler в своем приложении, вы можете посмотреть руководство Райана Бигга по адресу Developing a RubyGem using Bundler и Railscast on creating gems with Bundler.

Если вы заинтересованы в инструменты, чтобы помочь вам писать драгоценные камни:

• Jeweler - упрямый инструмент для создания и управления проектами Rubygem. Также есть Gemcutter and Jeweler Railscast.
• Hoe - От ребята на seattlrb.
• gem-this добавляет кучу полезных задач рейка.

Некоторые учебники/справочники:

• Creating Your First Gem
• Using bundler and rvm to build a rubygem - Использование Bundler и RVM создать драгоценный камень
• Gem Packaging: Best Practices
• Ruby Gem Recipe - Intro руководство по созданию жемчужину с помощью Bundler и ювелира
• How to build a ruby gem and host it on gemcutter - учебник с использованием эхо и gemcutter
• The Truth About Gemspecs - переходит gemspecs и советы по работе с ними
• Packaging with RubyGems - руководство QuickStart для ювелира
• gem that - James Adam - отзывы инструменты, которые помогают строить драгоценные камни (мотыга, newgem, ECHOE, gemhub, ювелир, камень это)
• Using Gemcutter's Api from the Commandline
• New Gem with Bundler – Sample Rakefile - Полезные rakefile для развертывания и публикаций жемчужины
• Let's Write a Gem
• How To Build A Ruby Gem With Bundler, Test-Driven Development, Travis CI And Coveralls, Oh My!

Answer 2

Вам не нужно начинать писать драгоценный камень, просто написать код, написать несколько тестов, использовать его, как вы хотите, и как только вы его доволите, используйте gem this для создания соответствующего Rakefile.

Это помогает, если вы придерживаетесь подходов, которые используют другие драгоценные камни (у вас есть каталог lib, избегайте именования файлов способами, которые могли бы столкнуться с другими драгоценными камнями, написать несколько тестов, если можно, иметь readme), но это необязательно.

Как только у вас есть что-то, что вы хотите разделить, наденьте его на github и нажмите на gemcutter.

Не задумывайтесь об этом, не используйте мотыгу или другие инструменты перехитрить, получайте удовольствие, не делайте ничего, что я бы не делал.

Answer 3

Это, как я обычно создаю и освободить драгоценные камни:

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.rdoc и awesome_gem.gemspec , напишите код в lib/awesome_gem/ и добавьте RSpec тесты в specs/.
6. , когда вы готовы к выпуску, обновите файл ChangeLog.rdoc, запустите rake spec и rake rerdoc, откройте html/index.html и выполните двойную проверку для любых опечаток.
7. rake release
8. (необязательно) отправить ссылку и объяснение вашего нового удивительного драгоценного камня, чтобы http://rubyflow.com

Sit назад и греться в славе первого Gem. :)