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?

glmxndr
quelle

Antworten:

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:

Einige Tutorials / Anleitungen:

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:

  1. Melden Sie sich für https://github.com an
  2. Melden Sie sich für https://rubygems.org an
  3. $ gem install ore rubygems-tasks rdoc rspec
  4. $ mine awesome_gem
  5. 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/.
  6. 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.
  7. rake release
  8. (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