ちょっとActiveScaffoldを使う機会があったので自分用にメモ。

まずは配布サイト。

• ActiveScaffold :: A Ruby on Rails plugin for dynamic, AJAX CRUD interfaces

インストール方法。

   1  % ./script/plugin install http://activescaffold.googlecode.com/svn/tags/active_scaffold

利用レポート、チュートリアルなど。

• ActiveScaffold を使って Ruby on Rails を機能アップする
• ActiveScaffold プラグイン
• Ruby on RailsのActiveScaffoldチュートリアル
• ActiveScaffold簡単まとめ

ActiveScaffoldの前身であるAjaxScaffoldGeneratorはGemで提供されていたのですが、ActiveScaffoldはプラグインのみの提供。

Railsで利用可能なGeneratorを設置可能な場所について、優先度が高い順に紹介します。

1. RAILS_ROOT/generators Railsアプリケーションのルートに設置。意外と知られていない気がします。
2. vendor/plugins/*/generatorsもしくはvendor/plugins/*/rails_generators よくあるGeneratorプラグインの構成ですね。rails_generatorsでも良いというのはあまり知られていない気がします。
3. ~/.rails/generators ユーザのホームディレクトリの下にユーザ固有のGeneratorを設置できます。 これもあんまり知られてないのではないかと思います。
4. *_generatorという名前のGem。login_generatorとか、Gemとして提供されているGeneratorですね。これはそこそこ知られていると思います。

RailsのGeneratorは、コード生成の仕組みとして意外と汎用的なので、Generatorがもっとカジュアルに使われるようになると、3の使い方のように、自分用Generatorとかを置きたくなることもあるかも？

See Also

• Generatorを置く場所

Generatorプラグインを作る方法はこちらの 「Generatorプラグインの作り方」 を参照していただくとして、今回はGenerator Gemの作り方を紹介します。

Generatorの実装自体は、基本的にはプラグインと同様でOKです。 Generatorプラグインの場合、 vendor/plugins/foo_generator/generators/foo/ 以下にfoo Generatorを置くのですが、Generator Gemの場合は foo/以下をそのままGemのルートディレクトリに持ってきます。 つまり、以下のような感じのファイル構成になります。

   1  [GEM_ROOT] % ls
   2  foo_generator.rb templates/ README.txt

注意すべき点は以下の二つです。

• Gemの名称はfoo_generatorでなければならない。これは、RailsがGenerator GemをLookupするのにGem名のパターンマッチを行っているからです。
• foo_generator.rbの先頭で、Generatorの既定クラスの定義をrequireする。例えば、Rails::Generator::NamedBaseの派生Generatorを作るのであれば、先頭に以下を加えます。

     1  require "rails_generator/base"
  

あとはGemを作ってインストールすればOK。 ./script/generate -hを実行して、作ったGemが Installed Generators / Rubygems: の項に入ってるかどうか確認してみましょう。

NewGem-0.22.2 を使って生成したGemの雛形で、config/hoe.rbのAUTHORに製作者名の文字列の配列を指定した場合に、rake packageでエラーが発生していたので、その対処法のメモ。

   1  $hoe = Hoe.new(GEM_NAME, VERS) do |p|
   2    #p.developer(AUTHOR, EMAIL)
   3    p.author = AUTHOR
   4    p.email = EMAIL

上記のようにp.developerを使うのをやめて、直接authorとemailを設定します。そのうちNewGemか Hoe のどちらかが修正されると思いますが、とりあえず。