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

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

Ответ 1

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

Если вы используете Bundler в своем приложении, вы можете посмотреть руководство Райана Бигга на Разработка RubyGem с использованием Bundler и Railscast для создания драгоценных камней с помощью Bundler.

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

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

Некоторые руководства/руководства:

Ответ 2

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

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

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

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

Ответ 3

Вот как я обычно создаю и выпускаю Gems:

  • Подпишитесь на https://github.com
  • Подпишитесь на https://rubygems.org
  • $ gem install ore rubygems-tasks rdoc rspec
  • $ mine awesome_gem
  • cd awesome_gem/ и отредактируйте README.rdoc и awesome_gem.gemspec, напишите код в lib/awesome_gem/ и добавьте тесты RSpec в specs/.
  • когда вы готовы к выпуску, обновите файл ChangeLog.rdoc, запустите rake spec и rake rerdoc, откройте html/index.html и дважды проверьте наличие каких-либо опечаток.
  • rake release
  • (необязательно) отправьте ссылку и объяснение вашего нового удивительного драгоценного камня на http://rubyflow.com

Устройтесь поудобнее и погрейтесь в славе своего первого драгоценного камня.:)