Ruby: Comment écrire un bijou?

Je voudrais écrire un paquet pour Ruby et le rendre disponible en tant que bijou.
Quels sont les outils, les étapes et les pièges?
Existe-t-il de bons tutoriels, screencasts, etc., qui vous ont aidé à apprendre comment le faire?

Les guides de Rubygems.org sont l’une des meilleures ressources pour écrire votre propre bijou.

Si vous utilisez Bundler dans votre application, vous pouvez consulter le guide de Ryan Bigg sur le développement d’un RubyGem utilisant Bundler et le Railscast sur la création de gems avec Bundler .

Si vous êtes intéressé par des outils pour vous aider à écrire des gemmes:

  • Bijoutier – Outil avisé pour créer et gérer des projets Rubygem. Il y a aussi un Gemcutter et Jewellery Railscast .
  • Hoe – Des gars de seattlrb.
  • gem-ceci ajoute un tas de tâches de rake utiles.

Quelques tutoriels / guides:

  • Créer votre premier joyau
  • Utiliser bundler et rvm pour créer un rubygem – Utiliser bundler et rvm pour créer un joyau
  • Gem Packaging: Meilleures pratiques
  • Ruby Gem Recipe – Guide d’introduction pour créer un bijou en utilisant un bundler et un bijoutier
  • Comment construire un bijou rbuy et l’héberger sur gemcutter – tutoriel utilisant echoe et gemcutter
  • The Truth About Gemspecs – passe en revue les gemspecs et les astuces pour y faire face
  • Emballage avec RubyGems – un guide de démarrage rapide pour le bijoutier
  • gem that – James Adam – examine les outils qui aident à construire des gemmes (hoe, newgem, echo, gemhub, bijoutier, gem this)
  • Utiliser Api de Gemcutter depuis la ligne de commande
  • Nouveau Gem avec Bundler – Sample Rakefile – Un rakefile utile pour déployer et publier une gem
  • Écrivons un bijou
  • Comment construire un bijou de rbuy avec Bundler, développement piloté par les tests, CI et combinaisons de rechange, Oh My!

Voici comment je crée et publie généralement des gems:

  1. Inscrivez-vous pour https://github.com
  2. Inscrivez-vous pour https://rubygems.org
  3. $ gem install ore rubygems-tasks rdoc rspec
  4. $ mine awesome_gem
  5. cd awesome_gem/ et éditez le README.rdoc et awesome_gem.gemspec , écrivez le code dans lib/awesome_gem/ et ajoutez les tests RSpec dans les specs/ .
  6. Lorsque vous êtes prêt à lancer la mise à jour, mettez à jour le fichier ChangeLog.rdoc , exécutez rake spec et rake rerdoc , ouvrez html/index.html et vérifiez s’il y a des fautes de frappe.
  7. rake release
  8. (Facultatif) envoyez un lien et une explication de votre nouveau bijou génial à http://rubyflow.com

Asseyez-vous et profitez de la gloire de votre premier joyau. 🙂

Vous n’avez pas besoin de commencer à écrire une gemme, écrivez simplement du code, écrivez des tests, utilisez-le comme bon vous semble, et une fois que vous en serez satisfait, utilisez gem this pour générer le fichier Rakefile correspondant.

Cela aide si vous vous en tenez aux approches des autres gems (ayez un répertoire lib, évitez de nommer les fichiers d’une manière qui pourrait entrer en conflit avec d’autres gems, écrivez des tests si vous le pouvez, lisez-le), mais ce n’est pas nécessaire.

Une fois que vous avez quelque chose à partager, mettez-le sur github et poussez-le sur gemcutter .

Ne le pensez pas trop, n’utilisez pas d’outils de bricolage ou autres outils amusants, amusez-vous, ne faites rien de ce que je ne ferais pas.