Ruby: ¿Cómo escribir una gema?

Question

Me gustaría escribir un paquete para Ruby y ponerlo a disposición como una joya.
¿Cuáles son las herramientas, los pasos y las dificultades?
¿Hay buenos tutoriales, screencasts, etc. que te hayan ayudado a aprender cómo hacerlo?

Answer 1

Rubygems.org's Guides es uno de los mejores recursos para escribir su propia joya.

Si está usando Bundler en su aplicación, es posible que desee consultar la guía de Ryan Bigg al Developing a RubyGem using Bundler y la Railscast on creating gems with Bundler.

Si usted está interesado en herramientas para ayudarle a escribir gemas:

• Jeweler - herramienta pertinaz para la creación y gestión de proyectos rubygem. También hay un Gemcutter and Jeweler Railscast.
• Hoe - De los chicos de seattlrb.
• gem-this agrega un montón de útiles tareas de rake.

Algunos tutoriales/guías:

• Creating Your First Gem
• Using bundler and rvm to build a rubygem - Uso bundler y RVM para crear una joya
• Gem Packaging: Best Practices
• Ruby Gem Recipe - guía Introducción a la creación de una joya utilizando bundler y joyero
• How to build a ruby gem and host it on gemcutter - tutorial usando echoe y gemcutter
• The Truth About Gemspecs - Balón por encima gemspecs y sugerencias para tratar con ellos
• Packaging with RubyGems - una guía de inicio rápido para el joyero
• gem that - James Adam - opiniones herramientas que ayudan a construir gemas (azada, newgem, echoe, gemhub, joyería, joya es este)
• Using Gemcutter's Api from the Commandline
• New Gem with Bundler – Sample Rakefile - Rakefile Útil para el despliegue y la publicación de una joya
• Let's Write a Gem
• How To Build A Ruby Gem With Bundler, Test-Driven Development, Travis CI And Coveralls, Oh My!

Answer 2

No necesita comenzar a escribir una gema, solo escriba un código, escriba algunas pruebas, utilícelo como quiera, y una vez que esté satisfecho con él, use gem this para generar el Rakefile correspondiente.

Te ayuda si te apegas a los enfoques que toman otras gemas (tener un directorio lib, evitar nombrar archivos de forma que pueda chocar con otras gemas, escribir algunas pruebas si puedes, tener un léame), pero no es necesario.

Una vez que tenga algo que quiera compartir, colóquelo en github y presiónelo en gemcutter.

No lo pienses más, no uses azada u otras herramientas de sobrecarga, diviértete, no hagas nada que yo no haría.

Answer 3

Esta es la forma en general creo y desprender piedras preciosas:

1. Inscríbase para https://github.com
2. Inscríbase para https://rubygems.org
3. $ gem install ore rubygems-tasks rdoc rspec
4. $ mine awesome_gem
5. cd awesome_gem/ y editar README.rdoc y awesome_gem.gemspec , escriba el código en lib/awesome_gem/ y agregue las pruebas de RSpec en specs/.
6. cuando esté listo para lanzar, actualice el archivo ChangeLog.rdoc, ejecute rake spec y rake rerdoc, abra html/index.html y verifique si hay algún error tipográfico.
7. rake release
8. (Opcional) envíe un enlace y una explicación de su nueva joya impresionante para http://rubyflow.com

Sentarse y disfrutar de la gloria de su primera gema. :)