Ruby : Comment écrire un bijou ?

Question

Je voudrais écrire un paquet pour Ruby et l’utiliser comme un joyau.
Quels sont les outils, les étapes et les pièges ?
Y a-t-il des bons tutoriaux, screencasts, etc., ce qui vous a aidé à apprendre comment le faire ?

Answer 1

Rubygems.org's Guides est l'une des meilleures ressources pour la rédaction de votre propre bijou.

Si vous êtes à l'aide de Bundler dans votre application, vous pouvez regarder Ryan Bigg guide pour l'Élaboration d'un RubyGem à l'aide de Bundler et la Railscast sur la création de gemmes avec Bundler.

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

• Bijoutier - Opiniâtre outil de création et de gestion Rubygem projets. Il y a aussi un Gemcutter et Bijoutier Railscast.
• Hoe - De la part des gars à seattlrb.
• gem-ce ajoute un tas de tâches rake.

Certains tutos/guides:

• La Création De Votre Premier Bijou
• À l'aide de bundler et de rvm pour construire un rubygem - à l'Aide de bundler et de rvm pour créer un bijou
• Joyau De L'Emballage: Les Meilleures Pratiques
• Ruby Gem Recette - Intro guide pour la création d'un bijou à l'aide de bundler et bijoutier
• Comment construire un ruby gem et de l'héberger sur gemcutter - tutoriel en utilisant résonnent et gemcutter
• La Vérité Sur Gemspecs - va sur gemspecs et des conseils pour traiter avec eux
• Emballage avec RubyGems - un guide de démarrage pour Bijoutier
• gem - James Adam - examens des outils qui les aident à construire des gemmes (houe, newgem, résonnent, gemhub, bijoutier, gem)
• À l'aide de Gemcutter de l'Api en ligne de commande
• Nouveau Joyau avec Bundler – Échantillon Rakefile - Utile rakefile pour le déploiement et la publication d'un bijou
• Nous allons Écrire un Bijou
• Comment Construire Un Rubis Gemme Avec Bundler, Test-Driven Development, Travis CI Et des Combinaisons, Oh Mon dieu!

Answer 2

J’ai écrit un guide sur l’écriture d’un bijou utilisant Bundler qui peuvent vous être utiles.

Answer 3

Vous n'avez pas besoin de commencer à écrire un bijou, il suffit d'écrire un peu de code, écrire quelques tests, utilisez-le comme vous voulez, et une fois que vous êtes heureux avec elle, d'utiliser ce joyau de générer pertinentes Rakefile.

Il aide si vous vous en tenez aux approches d'autres pierres précieuses (avoir un répertoire lib, éviter de nommer les fichiers d'une manière qui risque de conflit avec d'autres pierres précieuses, écrire quelques tests si vous le pouvez, avoir un readme), mais il n'est pas nécessaire.

Une fois que vous avez quelque chose que vous souhaitez partager, de le mettre sur github et de le pousser à gemcutter.

Ne plus penser, ne pas utiliser la houe ou à d'autres overkill outils, de s'amuser, n'est pas pour rien que je ne ferais pas.

Answer 4

C'est de cette façon j'ai l'habitude de créer et de diffuser des Gemmes:

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 de modifier l' README.rdoc et awesome_gem.gemspec, écrire du code en lib/awesome_gem/ et en ajoutant des tests RSpec en specs/.
6. lorsque vous êtes prêt à libérer, mise à jour de l' ChangeLog.rdoc fichier exécuté rake spec et rake rerdoc, ouvrez html/index.html et double-vérifier d'éventuelles fautes de frappe.
7. rake release
8. (Facultatif) soumettre un lien et explication de votre nouvelle génial gemme http://rubyflow.com

Asseyez-vous et se prélasser dans la gloire de votre premier Bijou. :)

Answer 5

Jetez un oeil à :

• site Web de houe
• Blog de Dr.Nic
• Webcast sur gemcutter