Ruby: come scrivere una gemma?

Question

Mi piacerebbe scrivere un pacchetto per Ruby e renderlo disponibile come gemma.
Quali sono gli strumenti, i passaggi e le insidie?
Ci sono dei buoni tutorial, screencast, ecc., Che ti hanno aiutato ad imparare come farlo?

Answer 1

Rubygems.org's Guides è una delle migliori risorse per scrivere la tua gemma.

Se stai usando Bundler nella vostra applicazione, si potrebbe desiderare di guardare guida di Ryan Bigg per Developing a RubyGem using Bundler e il Railscast on creating gems with Bundler.

Se siete interessati a strumenti che consentono di scrivere gemme:

• Jeweler - strumento supponente per la creazione e la gestione di progetti rubygem. C'è anche un Gemcutter and Jeweler Railscast.
• Hoe - Dai ragazzi di seattlrb.
• gem-this aggiunge un sacco di utili compiti di rake.

qualche tutorial/guide:

• Creating Your First Gem
• Using bundler and rvm to build a rubygem - Utilizzando fardellatrice e rvm per creare una gemma
• Gem Packaging: Best Practices
• Ruby Gem Recipe - guida Introduzione alla creazione di un gioiello con bundler e gioielliere
• How to build a ruby gem and host it on gemcutter - tutorial con echoe e gemcutter
• The Truth About Gemspecs - va oltre gemspecs e suggerimenti per affrontare con loro
• Packaging with RubyGems - una guida rapida per il gioielliere
• gem that - James Adam - recensioni strumenti che aiutano a costruire le gemme (zappa, newgem, echoe, gemhub, gioielliere, gioiello questo)
• Using Gemcutter's Api from the Commandline
• New Gem with Bundler – Sample Rakefile - rakefile utile per la distribuzione e la pubblicazione di una gemma
• Let's Write a Gem
• How To Build A Ruby Gem With Bundler, Test-Driven Development, Travis CI And Coveralls, Oh My!

Answer 2

Non è necessario iniziare a scrivere un gioiello, basta scrivere del codice, scrivere alcuni test, usarlo come si desidera e, una volta che si è soddisfatti, utilizzare gem this per generare il Rakefile pertinente.

È utile attenersi agli approcci adottati da altre gemme (avere una directory lib, evitare di denominare i file in modi che potrebbero scontrarsi con altre gemme, scrivere alcuni test se è possibile, avere un readme), ma non è necessario.

Una volta che si desidera condividere qualcosa, inserirlo su github e inserirlo in gemcutter.

Non pensarci troppo, non usare zappa o altri strumenti di overkill, divertiti, non fare nulla che non farei.

Answer 3

Questo è il modo in genere creo e rilasciare gemme:

1. Registrati per https://github.com
2. Registrati per https://rubygems.org
3. $ gem install ore rubygems-tasks rdoc rspec
4. $ mine awesome_gem
5. cd awesome_gem/ e modificare il README.rdoc e il awesome_gem.gemspec , scrivere il codice lib/awesome_gem/ e aggiungere i test RSpec in specs/.
6. quando si è pronti per il rilascio, aggiornare il file ChangeLog.rdoc, eseguire rake spec e rake rerdoc, aprire html/index.html e ricontrollare eventuali errori di battitura.
7. rake release
8. (opzionale) inviare un collegamento e la spiegazione del nuovo gioiello impressionante per http://rubyflow.com

Rilassatevi e crogiolarsi nella gloria del vostro primo Gem. :)