Ruby: Bagaimana cara menulis permata? [Tutup]

160

Saya ingin menulis paket untuk Ruby dan membuatnya tersedia sebagai permata.
Apa alat, langkah dan jebakan?
Apakah ada tutorial, screencast, dll yang bagus, yang membantu Anda belajar bagaimana melakukannya?

glmxndr
sumber

Jawaban:

216

Panduan Rubygems.org adalah salah satu sumber terbaik untuk menulis permata Anda sendiri.

Jika Anda menggunakan Bundler di aplikasi Anda, Anda mungkin ingin melihat panduan Ryan Bigg untuk Mengembangkan RubyGem menggunakan Bundler dan Railscast tentang membuat permata dengan Bundler .

Jika Anda tertarik pada alat untuk membantu Anda menulis permata:

Beberapa tutorial / panduan:

Jack Chu
sumber
3
gem builddisediakan oleh RubyGems sendiri. Semua permata Gemcutter (dan segera, RubyGems yang tepat) memungkinkan Anda lakukan adalah mendorong RubyGem menggunakan API. gemcutter.org/pages/gem_docs gemcutter.org/pages/api_docs
qrush
Terima kasih, saya sudah mengedit responsnya.
Jack Chu
6

Inilah yang biasanya saya buat dan lepaskan Permata:

  1. Daftar untuk https://github.com
  2. Daftar untuk https://rubygems.org
  3. $ gem install ore rubygems-tasks rdoc rspec
  4. $ mine awesome_gem
  5. cd awesome_gem/dan edit README.rdocdan awesome_gem.gemspec, tulis kode dalam lib/awesome_gem/dan tambahkan tes RSpec di specs/.
  6. ketika Anda siap untuk merilis, perbarui ChangeLog.rdocfile, jalankan rake specdan rake rerdoc, buka, html/index.htmldan periksa kembali apakah ada kesalahan ketik.
  7. rake release
  8. (Opsional) kirimkan tautan dan penjelasan tentang permata mengagumkan baru Anda ke http://rubyflow.com

Duduk dan berjemur dalam kemuliaan Permata pertama Anda. :)

postmodern
sumber
6

Anda tidak perlu mulai menulis permata, cukup tulis beberapa kode, tulis beberapa tes, gunakan sesuka Anda, dan sekali Anda puas, gunakan permata ini untuk menghasilkan Rakefile yang relevan.

Ini membantu jika Anda tetap pada pendekatan yang diambil permata lain (memiliki direktori lib, hindari penamaan file dengan cara yang bisa berbenturan dengan permata lain, tulis beberapa tes jika Anda bisa, miliki readme), tetapi itu tidak perlu.

Setelah Anda memiliki sesuatu yang ingin Anda bagikan, letakkan di github dan dorong ke gemcutter .

Jangan terlalu memikirkannya, jangan gunakan cangkul atau alat berlebihan lainnya, bersenang-senang, jangan melakukan apa pun yang tidak akan saya lakukan.

cwninja
sumber