パーフェクトRuby RakeとRakefile

##Rake

RakeはRubyで記述されたbuildツールでMakeやAnt,Mavenと同種のツールです。

設定ファイルに記述されている作業を上から順に実行してくれる

Rakeの特徴

• Rubyで記述ができる
• 言語内DSLを採用
• Rakefileというファイルに一連の処理を定義する
  （この処理のまとまりを「タスク」と呼ぶ）

※ DSL...
Domain-Specific Language
特定の領域で特化して設計された言語
(例)Rake, RSpec, SQLとか

Rakefile

build定義を記述するファイル

• rakeだったらRakefile
• Antだったらbuild.xml
• MakeだったらMakefile

Rakeの実行方法

Rakeはrakeコマンドに引数として、実行したいタスクを渡すことで
タスクを実行する。

rake 実行タスク名

例
以下のようにRakefileが記述されていた場合

desc 'Task description'
task :task_name do
  puts 'Rake task'
end

実行コマンド例

rake task_name # => Rake task

rakeコマンドに-Tオプションを渡して実行すると、
定義されているタスク一覧が表示できる
「desc」メソッドで説明文を記載しておけば、
タスク一覧には説明文も表示することができる。

rake -T
# 以下のように表示される
# rake task_name  # Task description

また、-tオプション(小文字のt)を指定するとトレース情報を得ることができる。

rake task_name -t
# 以下のように出力される
# ** Invoke task_name (first_time)
# ** Execute task_name
# =>Rake task

defaultについて
Rakeで何もタスクを指定していないときに実行されるタスク
以下のように定義する

task :default => :タスク名

task :default => :task_name

desc 'Task description'
  task :task_name do
  puts 'Rake task'
end

rake

---

taskメソッドとは別の定義の方法について

ファイルタスク

fileメソッドの引数にはファイル名の文字列を指定する
文字列が示すファイルがある場合はファイルタスクの実行がスキップされる。

使いどころ

• ファイルの有無判定
  実行例 参考p.412 リスト 12.13

---

クリーンタスク

buildの過程でできた一時ファイルを一括で削除してくれる
利用するにはRakefileでrequire 'raka/clean'する必要がある

require 'rake/clean'
...

requireするとCLEANとCLOBBERいう定数が定義される。
この定数に削除したいファイル名を指定すると削除される。

require 'rake/clean'
...

CLEAN.include(./hoge/*) # includeメソッドで指定ができる

CLEANはbuildの過程でできた一時ファイル
CLOBER一時ファイルだけでなくbuildでできたファイルも消せる。

---

ディレクトリタスク

ディレクトリを自動で作ってくれるタスク
ディレクトリが存在しなければ自動で作成し、
存在していれば処理をスキップする。

つかいどころ

• buildで作ったファイルを保存するディレクトリを作成するとき

使い方
directory メソッドにディレクトリ名を渡してあげる

directory "hoge" # hogeディレクトリを作成してくれる

#coding: utf-8

HOGE = "hoge_dir"
directory HOGE # この段階ではディレクトリは作られなかった
desc "directoryタスクの確認"
task :dir => HOGE do
  sh "ls hoge_dir" 
end

Hikaru-no-MacBook-Pro:ruby_practice fukuzawh$ rake dir -t
** Invoke dir (first_time)
** Invoke hoge_dir (first_time)
** Execute hoge_dir
mkdir -p hoge_dir
** Execute dir
ls hoge_dir

# 2回目
Hikaru-no-MacBook-Pro:ruby_practice fukuzawh$ rake dir -t
** Invoke dir (first_time)
** Invoke hoge_dir (first_time, not_needed)
** Execute dir
ls hoge_dir

---

ルール

特定のパターンの名前のファイルに対して動的に処理を定義する
ruleメソッドを使う

つかいどころ

• 特定のファイル名や拡張子に対して動的に処理を加えたいとき

実行例 p.417 12-3-7
本の例では、タスクを実行するときに.cファイルをコンパイルすることをしている。

---

グループ化

動作が似ているタスクをグループ化する
namespaceメソッドを使う

つかいどころ

• 動作が似ているタスクをグループ化したいとき

#coding: utf-8

namespace :check do
  desc 'ログファイルのチェック'
  task :log do
  end

  desc 'ymlファイルのチェック'
  task :yml do
  end
end

実行は以下のようにするとできる
rake namespace:タスク名

rake check:log

---

Rakeコマンドのオプション

man rake

または

rake --help

で調べる