Ruby: Wie schreibe ich einen Edelstein? [geschlossen]

160

Ich möchte ein Paket für Ruby schreiben und es als Juwel zur Verfügung stellen.
Was sind die Werkzeuge, Schritte und Fallstricke?
Gibt es gute Tutorials, Screencasts usw., mit denen Sie lernen konnten, wie es geht?

ruby rubygems

— glmxndr
quelle

216

Rubygems.orgs Guides sind eine der besten Quellen, um Ihr eigenes Juwel zu schreiben.

Wenn Sie Bundler in Ihrer App verwenden, sollten Sie sich Ryan Biggs Leitfaden zur Entwicklung eines RubyGem mit Bundler und dem Railscast zum Erstellen von Edelsteinen mit Bundler ansehen .

Wenn Sie an Tools interessiert sind, mit denen Sie Edelsteine schreiben können:

Juwelier - Meinungsbildendes Tool zum Erstellen und Verwalten von Rubygem-Projekten. Es gibt auch einen Gemcutter und Jeweller Railscast .
Hoe - Von den Jungs bei seattlrb.
gem-this fügt eine Reihe hilfreicher Rechenaufgaben hinzu.

Einige Tutorials / Anleitungen:

Erstellen Sie Ihren ersten Edelstein
Verwenden von Bundler und RVM zum Erstellen eines Rubygem - Verwenden von Bundler und RVM zum Erstellen eines Edelsteins
Edelsteinverpackung: Best Practices
Ruby Gem Recipe - Einführung in die Erstellung eines Edelsteins mit Bundler und Juwelier
Wie man einen Rubinstein baut und auf Gemcutter hostet - Tutorial mit Echoe und Gemcutter
Die Wahrheit über Gemspecs - geht über Gemspecs und Tipps zum Umgang mit ihnen
Verpackung mit RubyGems - eine Kurzanleitung für Juwelier
Edelstein, der - James Adam - Werkzeuge überprüft, die beim Bau von Edelsteinen helfen (Hacke, Newgem, Echoe, Gemhub, Juwelier, Edelstein dies)
Verwenden von Gemcutters API über die Befehlszeile
Neuer Edelstein mit Bundler - Beispiel-Rakefile - Nützliches Rakefile zum Bereitstellen und Veröffentlichen eines Edelsteins
Lass uns einen Edelstein schreiben
Wie man mit Bundler, testgetriebener Entwicklung, Travis CI und Overalls einen Rubinstein baut, oh mein Gott!

— Jack Chu
quelle

3

gem buildwird von RubyGems selbst bereitgestellt. Mit dem Gemcutter-Gem (und bald auch mit RubyGems) können Sie lediglich ein RubyGem mithilfe der API pushen. gemcutter.org/pages/gem_docs gemcutter.org/pages/api_docs

— qrush

Danke, ich habe die Antwort bearbeitet.

— Jack Chu

6

So erstelle und veröffentliche ich normalerweise Gems:

Melden Sie sich für https://github.com an
Melden Sie sich für https://rubygems.org an
$ gem install ore rubygems-tasks rdoc rspec
$ mine awesome_gem
cd awesome_gem/und bearbeiten Sie das README.rdocund awesome_gem.gemspec, schreiben Sie Code ein lib/awesome_gem/und fügen Sie RSpec-Tests hinzu specs/.
wenn Sie bereit zu lösen sind, aktualisieren Sie die ChangeLog.rdocDatei, laufen rake specund rake rerdoc, öffnen html/index.htmlund überprüfen Sie für alle Fehler.
rake release
(Optional) Senden Sie einen Link und eine Erklärung Ihres neuen fantastischen Edelsteins an http://rubyflow.com

Lehnen Sie sich zurück und genießen Sie den Ruhm Ihres ersten Edelsteins. :) :)

— postmodern
quelle

6

Sie müssen nicht mit dem Schreiben eines Edelsteins beginnen, sondern nur Code schreiben, Tests schreiben, ihn verwenden, wie Sie möchten, und wenn Sie damit zufrieden sind, verwenden Sie gem this , um das entsprechende Rakefile zu generieren.

Es ist hilfreich, wenn Sie sich an die Ansätze halten, die andere Edelsteine verfolgen (ein lib-Verzeichnis haben, vermeiden, Dateien so zu benennen, dass sie mit anderen Edelsteinen in Konflikt geraten könnten, einige Tests schreiben, wenn Sie können, eine Readme-Datei haben), aber es ist nicht erforderlich.

Sobald Sie etwas haben, das Sie teilen möchten, legen Sie es auf Github und schieben Sie es zu gemcutter .

Denken Sie nicht darüber nach, verwenden Sie keine Hacke oder andere Overkill-Werkzeuge, haben Sie Spaß, tun Sie nichts, was ich nicht tun würde.

— cwninja
quelle