Ruby: Jak napisać klejnot?

Question

Chciałbym napisać pakiet dla Rubiego i udostępnić go jako klejnot.
Jakie są narzędzia, kroki i pułapki?
Czy są jakieś dobre samouczki, screencasty itp., Które pomogły ci nauczyć się, jak to zrobić?

Answer 1

Rubygems.org's Guides to jeden z najlepszych zasobów do pisania własnych klejnotów.

Jeśli używasz w swojej aplikacji Bundler, możesz zajrzeć do przewodnika Ryana Bigga: Developing a RubyGem using Bundler i Railscast on creating gems with Bundler.

Jeśli jesteś zainteresowany narzędzi, które pomogą Ci napisać perełki:

• Jeweler - uparty narzędzie do tworzenia i zarządzania projektami Rubygem. Jest też Gemcutter and Jeweler Railscast.
• Hoe - Od chłopaków z seattlrb.
• gem-this dodaje kilka przydatnych zadań rake.

Niektóre tutoriale/przewodnicy:

• Creating Your First Gem
• Using bundler and rvm to build a rubygem - Korzystanie Bundler i RVM stworzyć prawdziwy klejnot
• Gem Packaging: Best Practices
• Ruby Gem Recipe - Intro Podręcznik do tworzenia gem za pomocą Bundler i jubilera
• How to build a ruby gem and host it on gemcutter - samouczek za pomocą echa i gemcuttera
• The Truth About Gemspecs - podchodzi gemspecs i wskazówek dla radzenia sobie z nimi
• Packaging with RubyGems - krótki przewodnik po za Jubiler
• gem that - James Adam - Opinie narzędzia, które pomagają budować perełki (Motyka, newgem, echoe, gemhub, jubiler, klejnot tego)
• Using Gemcutter's Api from the Commandline
• New Gem with Bundler – Sample Rakefile - Przydatne Rakefile do wdrażania i publikowania gem
• Let's Write a Gem
• How To Build A Ruby Gem With Bundler, Test-Driven Development, Travis CI And Coveralls, Oh My!

Answer 2

Nie musisz zaczynać pisać klejnotów, po prostu napisz jakiś kod, napisz kilka testów, użyj go, jak chcesz, a gdy będziesz z niego zadowolony, użyj gem this, aby wygenerować odpowiedni plik Rakefile.

Pomaga, jeśli trzymasz się podejścia, które podejmują inne klejnoty (masz katalog lib, unikaj nazw plików w sposób, który może kolidować z innymi klejnotami, napisz kilka testów, jeśli możesz, masz plik readme), ale nie jest to konieczne.

Gdy masz coś, czym chcesz się podzielić, umieść go na github i wciśnij do numeru gemcutter.

Nie przejmuj się tym, nie używaj motyki ani innych narzędzi do przesady, baw się dobrze, nie rób niczego, czego bym nie zrobił.

Answer 3

To jest jak zwykle tworzyć i uwalniać Gems:

1. Zaprenumeruj https://github.com
2. Zaprenumeruj https://rubygems.org
3. $ gem install ore rubygems-tasks rdoc rspec
4. $ mine awesome_gem
5. cd awesome_gem/ i edytować README.rdoc i awesome_gem.gemspec , napisz kod w lib/awesome_gem/ i dodaj testy RSpec w specs/.
6. , gdy jesteś gotowy do wydania, zaktualizuj plik ChangeLog.rdoc, uruchom rake spec i rake rerdoc, otwórz html/index.html i dwukrotnie sprawdź, czy nie ma żadnych literówek.
7. rake release
8. (opcjonalnie) przesłać link i wyjaśnienia nowej niesamowitej gem do http://rubyflow.com

usiąść i wygrzać się w chwale swojej pierwszej Gem. :)