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?
160
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:
Einige Tutorials / Anleitungen:
gem build
wird 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_docsSo erstelle und veröffentliche ich normalerweise Gems:
$ gem install ore rubygems-tasks rdoc rspec
$ mine awesome_gem
cd awesome_gem/
und bearbeiten Sie dasREADME.rdoc
undawesome_gem.gemspec
, schreiben Sie Code einlib/awesome_gem/
und fügen Sie RSpec-Tests hinzuspecs/
.ChangeLog.rdoc
Datei, laufenrake spec
undrake rerdoc
, öffnenhtml/index.html
und überprüfen Sie für alle Fehler.rake release
Lehnen Sie sich zurück und genießen Sie den Ruhm Ihres ersten Edelsteins. :) :)
quelle
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.
quelle