RubyGemはめっちゃ簡単に作れる！　

2014-12-06

RubyライブラリのRubyGemは知らないとハードル高そうに見えますが、実際にはかなり簡単に作れます。
これから積極的にRubyGemを作ってOSSの世界に貢献していきたいので簡単な作り方をまとめました。

🐝 準備

まずは準備のためにgemのアップデートと、Bundlerのアップデートを行います。

# gem自信のアップデート
gem update --system

# bundler未インストールの場合はインストール
gem install bundler

# bundlerインストール済の場合はアップデート
gem update bundler

🚜 ひな型の作成

今回はtest_gemという名前のGemを制作していきます。

# test_gemのひな形を作成(Rspec付き)
bundle gem test_gem -t

ちなみに、Rails PluginのGemを作成する場合にはgem install railsをしたうえで次のコマンドを実行します。

# test unitをスキップしたpluginの作成
rails plugin new test_gem2 -T --skip-test-unit --mountable

今回はbundle gem test_gemの方を説明していきます。Rails Pluginの詳細は次のサイトに解説があります！

rails pluginコマンドで簡単に出来るgemの作成方法

🍣 作成されたファイルの概要

今回作成されたファイルの簡単な説明。

bundle gem test_gem -t
  create  test_gem/Gemfile
  create  test_gem/Rakefile
  create  test_gem/LICENSE.txt
  create  test_gem/README.md => このgemの説明や使い方を記述
  create  test_gem/.gitignore
  create  test_gem/test_gem.gemspec => このgemの説明や依存関係などを記述
  create  test_gem/lib/test_gem.rb => プログラムを記述
  create  test_gem/lib/test_gem/version.rb => このgemのバージョン情報を記述
  create  test_gem/.rspec
  create  test_gem/spec/spec_helper.rb
  create  test_gem/spec/test_gem_spec.rb
  create  test_gem/.travis.yml => travisを使う際の設定を記述

🐯 test_gem.gemspecの修正

test_gem.gemspecの中身は以下のようにになっています。

# coding: utf-8
lib = File.expand_path('../lib', __FILE__)
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
require 'test_gem/version'

Gem::Specification.new do |spec|
  spec.name          = 'test_gem'
  spec.version       = TestGem::VERSION
  spec.authors       = ['morizyun']
  spec.email         = ['merii.ken@gmail.com']
  spec.summary       = %q{TODO: Write a gem summary}
  spec.description   = %q{TODO: Write a gem description}
  spec.homepage      = 'http://morizyun.github.io'
  spec.license       = 'MIT'

  spec.files         = `git ls-files -z`.split("\x0")
  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
  spec.require_paths = ['lib']

  spec.add_development_dependency 'bundler', '~> 1.7'
  spec.add_development_dependency 'rake', '~> 10.0'
  spec.add_development_dependency 'rspec'
end

最低限修正が必要な部分を抜き出すと次のようになります。

# このgemの説明を書く
spec.summary       = %q{TODO: Write a gem summary}
spec.description   = %q{TODO: Write a gem description}

# このgemのHomepageを書く
spec.homepage      = 'http://morizyun.github.io'

# 依存するgemが存在する場合のみ、次のように指定
spec.add_dependency 'xxxx', '~>x.x'

# 開発時だけに必要な依存gemが存在する場合のみ、次のように指定
spec.add_development_dependency 'yyyy', '~>y.y'

🐰 Gemの実装

今回はテスト的にHello World!と出力するようにします。lib/test_gem.rbを開いて次のように変更します。

require 'test_gem/version'

module TestGem
  def self.greet
    'Hello World!'
  end
end

🗽 実行してみよう

では先ほど作成したgemを実行してみます

# gem のインストール
bundle install

# rubyの対話型インタプリタを起動
bundle exec irb                                                                              [2.1.4]
irb(main):001:0> require 'test_gem'
=> true

irb(main):002:0> TestGem.greet
Hello World!

ということで無事実行できました！

😼 RSpecを書こう

先ほどのTestGem.greetのテストをRSepcで書いていきます。spec/test_gem_spec.rbを次のように変更します。

require 'spec_helper'

describe TestGem do
  it 'has a version number' do
    expect(TestGem::VERSION).not_to be nil
  end

  describe '#greet' do
    it 'returns "Hello World!"' do
      expect(TestGem.greet).to eq('Hello World!')
    end
  end
end

🗻 実行コマンドを追加

コンソール上でrun_test_gemというコマンドを使うとgemの内容を実行したい場合は
たとえばbin/run_test_gemを作成して、次のように書きます。

#!/usr/bin/env ruby

require 'test_gem'

puts TestGem.greet

🏈 Gemをパッケージ化します

次にGemをパッケージ化します。コマンドとしては、gem build xxx.gemspecです。

gem build test_gem.gemspec
=> Successfully built RubyGem
=> Name: test_gem
=> Version: 0.0.1
=> File: test_gem-0.0.1.gem

gem install test_gem
=> Successfully installed test_gem-0.0.1
=> 1 gem installed

run_test_gem
=> "Hello World!"

🚕 Gemを公開する

『GitHub』などのpublicなリポジトリを作成。

# まずはgit commit
git add . -A && git commit -m 'first commit'

# gitのリモートリポジトリを設定
git remote add origin git@github.com:morizyun/test_gem.git

# そして release
rake release

今回はすでに登録されているgemと名前がかぶっているので登録はできませんが、被らない名前にすればこれで公開できます。