ruby の gem を開発する時のメモ
概要
最近、gem を開発してみて得た知見などをメモとして残しておきます。
gem の名前が被っていないか調べる
開発前に gem の名前が被っていないか調べます。
完全一致で検索するには exact オプションを使います。
gem search -e NAME
bundler で gem の雛形を作る
下記のコマンドを使うと bundler で gem の雛形を作ることができます。
bundle gem NAME
bundle config に設定が無い場合は test に何を使うかなどの質問がされます。
一度答えると次回からは同じ設定が引き継がれます。
オプションで直接指定も可能です。
実行ファイル付きで gem の雛形を作る
CLI を作る時は exe (bin) オプションを使うと実行ファイルの作成なども行ってくれます。
bundle gem NAME -b
irb で試す
./bin/console を使うと開発中の gem を require した状態で irb を立ち上げることができます。
./bin/console
gem を install する
rake install で gem を install することができます。
なお、bundler で作った雛形は git 管理下のファイルのみ install 対象になるので注意。
rake install
gem を release する
rake release コマンドを使うと以下のことをしてくれます。
- git の tag を作成
- git push
- gem の build
- gem の push