web-dev-qa-db-de.com

Ruby: Wie schreibe ich einen Edelstein?

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

160
glmxndr

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

Wenn Sie in Ihrer App Bundler verwenden, sollten Sie sich Ryan Biggs Anleitung zu Entwickeln eines RubyGems mit Bundler und Railscast zum Erstellen von Edelsteinen mit ansehen Bundler .

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

Einige Tutorials/Anleitungen:

215
Jack Chu

Sie brauchen nicht mit dem Schreiben eines Gems zu beginnen, schreiben Sie einfach Code, schreiben Sie einige Tests, verwenden Sie ihn, wie Sie möchten, und wenn Sie damit zufrieden sind, verwenden Sie gem this , um das relevante Rakefile zu generieren.

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

Sobald Sie etwas haben, das Sie teilen möchten, setzen Sie es auf Github und drücken Sie es auf Gemcutter .

Überlegen Sie nicht, verwenden Sie keine Hacke oder andere Overkill-Werkzeuge, haben Sie Spaß, tun Sie nichts, was ich nicht tun würde.

6
cwninja

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 README.rdoc Und awesome_gem.gemspec, Schreiben Sie Code in lib/awesome_gem/ Und fügen Sie RSpec-Tests in specs/ Hinzu.
  6. wenn Sie zum Release bereit sind, aktualisieren Sie die Datei ChangeLog.rdoc, führen Sie rake spec und rake rerdoc aus, öffnen Sie html/index.html und suchen Sie erneut nach Tippfehlern.
  7. rake release
  8. (Optional) senden Sie einen Link und eine Erklärung Ihres neuen, großartigen Edelsteins an http://rubyflow.com

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

6
postmodern