Make Your Own Ruby Gem
White

Lê Minh Tuấn viết ngày 17/09/2015

1.RubyGems, So what is it?

2.Gem command basic

3.My first gem.


Let's get started

1. RubyGems, So what is it?

  • gem là một package managercủa Ruby.
  • Quản lý các thư viện của Ruby.
  • Tương tự :
    • npm (Javascript)
    • apt-get (Linux)
    • yum (Cenos)
    • activator (Scala)
    • composer (PHP)
  • Bản thânRails hay (Ruby on Rails) cũng là một gem của Ruby (rails lằm trong thư mục gem)

Kiểm tra :

$ which rails
$ # => /home/leminhtuan/.rvm/gems/ruby-2.2.0/bin/rails

$ gem list | grep rails
$ # => rails (4.2.1)
  • Từ Ruby version 1.9 thì gem là một phần trong thư viện chuẩn của Ruby (install song Ruby là thấy gem luôn)
$ which gem
$ # => /home/leminhtuan/.rvm/rubies/ruby-2.2.0/bin/gem

  • gem cũng như các tool trên, được tạo ra với mục đích đơn giản hóa việc install/remove các plugin in trong một Ruby project.
  • Khi làm việc trong một project lớn với nhiều coder và sử dụng nhiều thư viện thậm chí phải quan tâm đến nguồn và version của thư viện vậy làm thế nào để việc sử dụng thư viện được thống nhất trong cả project, gem sẽ giải quyết vấn đề đó.
  • Bạn sẽ thấy rõ hơn gem rất hữa dụng khi làm trên một project có nhiều team cùng code và sử dụng nhiều plugin (thư viện).
  • gem không phải là một plugin mà là chương trình quản lý các plugin (version, source, install, remove)


gem "GEM_NAME" in Gemfile <===> gem install GEM_NAME

  • Khi install 1 gem bằng cách dùng lệnh gem install GEM_NAME là ta cài thêm 1 gem vào thư mục gem của bạn, ví dụ: /home/leminhtuan/.rvm/gems/ruby-2.2.0/bin/
  • Khi thêm dòng "gem "GEM_NAME"" vào file Gemfile và sau đó chạy "bundle" thực chất là ta cũng sẽ gọi tới lệnh gem install GEM_NAME và cài vào thư mục tưowng tự, nếu đã cài gem rồi thì khi chạy bundle thì rails sẽ không cài lại mà chỉ check xem có đúng version không, nếu không mới cài lại.

2. Gem command basic

  • Install a gem
    • gem install mygem
  • Show list of gem which is installed
    • gem list --local / gem list. Check a gem is installed or not (gem list | grep gem_name)
  • Uninstall a gem
    • gem uninstall mygem
  • Build a gem
    • gem build hola.gemspec

*Tip : Check a gem be installed or not *

 $ ruby -e "puts(require('[gem_name]'))"
 $ true
 $ gem list | grep [gem_name]
 $ gem_name (0.0.0)

3. My first gem.

  • I will create a "Hello world!" gem.

STEP 1 : Tạo một thư mục có cấu truc như bên dưới, tất nhiên đổi tên "mygem" thành tên gem của bạn.

$ mkdir mygem
$ cd mygem
$ touch mygem.gemspec
$ mkdir lib
$ cd lib 
$ touch mygem.rb

  • Sau khi tạo song thư mục, bạn sẽ kiểm tra và thấy cấu trúc như sau.

    • Thư mục lib chứa tất cả các code Ruby mà bạn code trong gem của bạn.
    • Trong thư mục lib bạn có thể có rất nhiều file .rb nhưng phải có một file trùng tên với tên gem, bởi vì nó phải thế (theo convention), file này sẽ được gọi (load) khi bạn chạy câu lệnh require 'mygem'
    • File trùng tên với tên gem trong thư muc lib có nhiệm vụ setting cho gem. (giống file main).
  • mygem.gemspec là file có mục đích mô tả thông tin gem của bạn

    • tác giả
    • vesion
    • name
    • date

Screenshot from 2015-07-13 15:37:52.png

STEP 2: Implement Code gem của bạn.

  • Code trong file lib/mygem.rb (File này trùng tên với tên gem)
class Mygem
    def self.hi                                                                 
        puts "Hello world!"                                                     
    end                                                                         
end  

Step 3: Defines what’s in the gem

  • Ta định nghĩa thông tin của Gem trong file mygem.gemspec

Gem::Specification.new do |s|
  s.name        = 'mygem'
  s.version     = '0.0.0'
  s.date        = '2010-04-28'
  s.summary     = "My gem!"
  s.description = "A simple hello world gem"
  s.authors     = ["Nick tuan"]
  s.email       = 'leminhtuan2015@gmail.com'
  s.files       = ["lib/mygem.rb"]
  s.homepage    = 'http://rubygems.org/gems/mygem'
  s.license     = 'MIT'
end

STEP 4: Build you gem

$ gem build mygem.gemspec

  • Kết quả.

Screenshot from 2015-07-13 16:15:06.png

  • Sau khi build bạn sẽ thấy xuất hiện một file mới trong thư mục gem của bạn có tên là mygem-0.0.0.gem
  • Đây chính là một ruby gem mà bạn đã tạo được.
  • Tất nhiên bây giờ bạn có thể install gem này và dùng giống như các thư viên khác.

STEP 5: Install your gem

$ gem install mygem-0.0.0.gem

Screenshot from 2015-07-13 16:16:38.png

Step 6: Use Gem

$ irb
$ require "mygem"
$ Mygem.hi


Screenshot from 2015-07-13 16:23:38.png

Many thanks.

Thank you so much for reading. please leave a comment or give me feedbacks so that i can better myself.

Bình luận


White
{{ comment.user.name }}
Bỏ hay Hay
{{comment.like_count}}
Male avatar
{{ comment_error }}
Hủy
   

Hiển thị thử

Chỉnh sửa

White

Lê Minh Tuấn

11 bài viết.
22 người follow
Kipalog
{{userFollowed ? 'Following' : 'Follow'}}
Cùng một tác giả
White
15 2
1. Maven là gì? 2. Maven hoạt động như nào? 3. Tại Sao cần Maven? 4. Cài đặt Maven 5. Khởi tạo một Project Java bằng Maven 6. Cấu trúc POM.xml...
Lê Minh Tuấn viết hơn 2 năm trước
15 2
White
15 8
(Ảnh) 1. Elasticsearch là gì ??? 2. ElasticSearch dùng cho những ứng dụng nào ??? 3. Vấn đề : Hiện nay tất cả các hệ thống thông tin (hay c...
Lê Minh Tuấn viết hơn 2 năm trước
15 8
White
11 0
(Ảnh) 1. Software design pattern là gì ? 2. Có bắt buộc phải sử dụng design pattern khi lập trình ? 3. Có bao nhiêu design pattern ? 5. Bà...
Lê Minh Tuấn viết hơn 2 năm trước
11 0
{{like_count}}

kipalog

{{ comment_count }}

bình luận

{{liked ? "Đã kipalog" : "Kipalog"}}


White
{{userFollowed ? 'Following' : 'Follow'}}
11 bài viết.
22 người follow

 Đầu mục bài viết

Vẫn còn nữa! x

Kipalog vẫn còn rất nhiều bài viết hay và chủ đề thú vị chờ bạn khám phá!