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?

ruby rubygems

— glmxndr
sumber

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:

Jeweller - Alat yang disarankan untuk membuat dan mengelola proyek Rubygem. Ada juga Gemcutter dan Jeweller Railscast .
Cangkul - Dari orang-orang di seattlrb.
permata-ini menambahkan banyak tugas menyapu membantu.

Beberapa tutorial / panduan:

Menciptakan Permata Pertama Anda
Menggunakan bundler dan rvm untuk membangun rubygem - Menggunakan bundler dan rvm untuk membuat permata
Kemasan Permata: Praktik Terbaik
Resep Permata Ruby - Pengantar Intro untuk membuat permata menggunakan bundler dan perhiasan
Cara membangun permata ruby dan menyimpannya di gemcutter - tutorial menggunakan echoe dan gemcutter
The Truth About Gemspecs - membahas tentang gemspecs dan tips untuk menghadapinya
Pengemasan dengan RubyGems - panduan ringkas untuk Jeweler
permata itu - James Adam - ulasan alat yang membantu membangun permata (cangkul, newgem, gema, permata, permata, permata ini)
Menggunakan Api Gemcutter dari Commandline
Permata Baru dengan Bundler - Sample Rakefile - rakefile yang berguna untuk menyebarkan dan menerbitkan permata
Mari Menulis Permata
Cara Membangun Permata Ruby Dengan Bundler, Pengembangan Berbasis Tes, Travis CI Dan Baju, Ya ampun!

— 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:

Daftar untuk https://github.com
Daftar untuk https://rubygems.org
$ gem install ore rubygems-tasks rdoc rspec
$ mine awesome_gem
cd awesome_gem/dan edit README.rdocdan awesome_gem.gemspec, tulis kode dalam lib/awesome_gem/dan tambahkan tes RSpec di specs/.
ketika Anda siap untuk merilis, perbarui ChangeLog.rdocfile, jalankan rake specdan rake rerdoc, buka, html/index.htmldan periksa kembali apakah ada kesalahan ketik.
rake release
(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