Home.ja

Home (English)

RTask

RTask は Ruby の gem パッケージをとびっきり簡単に公開するためのツールです。

たったひとつのコマンドを実行するだけでgem, tgz, zipパッケージをリリースできます
たったひとつのコマンドを実行するだけでAPI文書をRubyForgeにアップロードできます
リリース関連の仕事はRTaskが引き受けちゃうので、簡単なプロジェクトならRakefileも不要になります。

またお好みでこうした便利な機能をRakeのタスクとしてRakeで使うことも出来ます。

インストール


% sudo gem install rtask

使い方

リリースの方法

最初に rubyforge と gemify を準備して下さい。


# rubyforge コマンドを久々に使う人は login & config を忘れずに
% rubyforge setup
% rubyforge login

# 新しいプロジェクトを申請したばかりの人は config も忘れないでね
% rubyforge config <project name>

# gemify コマンドで .gemified ファイルを作成しておいて下さい
% gemify

では次のコマンドを実行して下さい。


% rtask -r

たったこれでリリース完了です！

API文書のアップロード方法


% rtask -p

たったこれだけ！

余計なファイルを消しましょう


% rtask -c

Rake で RTask を使う

最初に Rakefile の先頭に次のものをコピーして下さい。


require "rubygems"
require "rtask"

RTask.new

これだけで普通のプロジェクトに必要なタスクが追加されます。


% rake -T
rake clean         # Remove any temporary products.
rake clobber       # Remove any generated file.
rake clobber_rdoc  # Remove rdoc products
rake gem           # Create the gem package
rake publish       # Upload API documentation
rake rdoc          # Build the rdoc HTML Files
rake release       # Release new gem version
rake rerdoc        # Force a rebuild of the RDOC files
rake tgz           # Create the tgz package

とっても素敵なタスクがたくさん追加されました。こんなにたくさん要らない？そういう時には次のようにします。


require "rubygems" 
require "rtask" 

RTask.new(:use => :packages)


rake gem       # Create the gem package
rake packages  # Create packages
rake tgz       # Create the tgz package
rake zip       # Create the zip package