Я хотел бы написать пакет для Ruby и сделать его доступным как драгоценный камень.
Каковы инструменты, шаги и подводные камни?
Есть ли хорошие учебники, скринкасты и т.д., Которые помогли вам узнать, как это сделать?
Рубин: Как написать драгоценный камень?
Ответ 1
Rubygems.org Guides является одним из лучших ресурсов для написания собственного драгоценного камня.
Если вы используете Bundler в своем приложении, вы можете посмотреть руководство Райана Бигга на Разработка RubyGem с использованием Bundler и Railscast для создания драгоценных камней с помощью Bundler.
Если вам интересны инструменты, которые помогут вам написать драгоценные камни:
- Jeweler - Мнение инструмента для создания и управления проектами Rubygem. Там также Gemcutter и Jeweler Railscast.
- Hoe - От парней на seattlrb.
- gem-this добавляет кучу полезных задач рейка.
Некоторые руководства/руководства:
- Создание вашего первого драгоценного камня
- Использование bundler и rvm для создания rubygem - Использование bundler и rvm для создания драгоценного камня
- Gem Packaging: лучшие практики
- Ruby Gem Recipe - Введение в создание драгоценного камня с использованием связки и ювелира.
- Как создать рубиновый камень и разместить его на gemcutter - учебник с использованием echoe и gemcutter
- Правда о Gemspecs - идет о gemspecs и подсказках для борьбы с ними.
- Упаковка с RubyGems - руководство для быстрого запуска для Jeweler
- драгоценный камень, который - Джеймс Адам - рассматривает инструменты, которые помогают строить драгоценные камни (мотыга, newgem, echoe, gemhub, jeweler, gem this)
- Использование Gemcutter Api из командной строки
- Новый Gem с Bundler - Образец Rakefile - Полезный rakefile для развертывания и публикации драгоценного камня
- Let Write the Gem
- Как создать Ruby Gem с Bundler, Test-Driven Development, Travis CI и Coveralls, Oh My!
Ответ 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
Устройтесь поудобнее и погрейтесь в славе своего первого драгоценного камня.:)