merbでgeneratorプラグインを作る方法
merbでGeneratorプラグインを作る方法を紹介します。
merbのgeneratorの仕組みは、
templater
という汎用的なGeneratorフレームワークを使って作られています。
なので、基本的にはtemplaterを使ったGeneratorの作り方という事になります。
まずは、Generatorプラグインのひな形を生成します。
pre>>
% merb-gen plugin hello
<<--
Gemの形で提供されるものであれば、merb-pluginの形式である必要は無いですが、簡単にそれを用意してくれるので、merb-gen pluginを使ってみました。
さて、続いて、GEM_ROOTにGeneratorsというファイルを作ります。
ruby>>
scope 'merb-gen' do
dir = File.join(File.dirname(FILE), 'lib', 'generators/')
Merb.add_generators dir + 'hello_generator'
end
<<--
続いて、GEM_ROOT/lib以下のディレクトリ構成を以下のような感じにします。
pre>>
lib-- generators |-- hello_generator.rb -- templates
-- hello |-- app | -- app以下のファイル群
-- spec -- spec以下のファイル群
<<--
hello_generator.rbが、Railsのgeneratorで言うところの
Generatorマニフェストファイルに相当します。
以下はmerb-mailerのgeneratorファイルの例です。
ruby>>
module Merb::Generators
class MailerGenerator < NamespacedGenerator
def self.source_root
File.dirname(__FILE__) / 'templates' / 'mailer'
end
desc <<-DESC
Generates a mailer
DESC
option :testing_framework, :desc => 'Testing framework to use (one of: rspec, test_unit)'
first_argument :name, :required => true, :desc => "mailer name"
template :mailer do |t|
t.source = 'app/mailers/%file_name%_mailer.rb'
t.destination = File.join("app/mailers", base_path, "#{file_name}_mailer.rb")
end
template :notify_on_event do |t|
t.source = 'app/mailers/views/%file_name%_mailer/notify_on_event.text.erb'
t.destination = File.join("app/mailers/views", base_path, "#{file_name}_mailer/notify_on_event.text.erb")
end
template :controller_spec, :testing_framework => :rspec do |t|
t.source = 'spec/mailers/%file_name%_mailer_spec.rb'
t.destination = File.join("spec/mailers", base_path, "#{file_name}_mailer_spec.rb")
end
end
add :mailer, MailerGenerator
end
<<--
あとは、GemをインストールすればOK.