記事の引越しから漏れていたのでサルベージ。

RubyInsideで紹介されていたUsing Omnigraffle to visualise Rails model associationsに触発されて、 Model同士の関係をグラフで表示するプラグインを作ってみました。

こんな感じのグラフを表示します。

使い方は、まずプラグインをインストールします。

$ ./script/plugin install http://svn.labs.drecom.jp/rails/plugins/trunk/model_graph

このプラグインはControllerジェネレータになっているので、次のように ModelGraphを表示するControllerを生成します。

$ ./script/generate model_graph

これによってModelGraphControllerが生成されるので、あとは'/model_graph'にアクセスすれば、上図のようなグラフが表示されます。もちろんGraphVizに依存しているので、事前にインストールしておく必要があります。

オリジナルの実装に加えて、app/models以外の場所に存在するすべてのModelの関係を表せるように改良してあります。

デフォルトのURLマッピングを削除している場合は、routes.rbにmodel_graphコントローラのindexアクションにマップするURLの記述を追加してください。

map.connect 'model_graph', :controller => 'model_graph'

ジェネレータプラグインなので、不要になったら

$ ./script/destroy model_graph

を実行すれば削除できます。

デフォルトではPNG形式の画像が出力されますが、'/model_graph?format=svg'のようにフォーマットを指定する事で、GraphVizがサポートするpng、gif、jpeg、svgの4種類の形式で出力する事ができます。

記事の引越しから漏れていたのでサルベージ。

secondlifeさんの記事 に反応して後で書こうかなあと思っていたら、大分時間がたってしまいましたが、めげずに書いてみます。

1. p/pp

こちらはRailsに限らず良く使われている方法ですが、RailsではWebサーバをフォアグラウンドプロセスとして立ち上げた状態で使う感じになります。

   1  $ ./script/server

p/ppに慣れている人にはわかりやすくて良いと思います。

2. logger.debug

さて、続いてlogger.debugを使う方法です。

   1  logger.debug "something interesting information"

p/ppの代わりにlogger.debugを呼ぶ事で、結果がlog/development.logなどのlog/$RAILS_ENV.logファイルに書き出されます。 書き出されたファイルを、

   1  $ tail -f log/development.log

しておくと、p/ppでデバッグする時と同じような感じでデバッグ出力を見る事が出来ます。また、出力結果はlogファイルとして残っているので、後で参照する事もできます。

3. script/console

script/consoleは、実行時にデータベースの中身がどうなっているかを知りたい時に非常に便利です。script/consoleコマンドを実行すると、Railsの環境を読み込んだ状態でirbが立ち上がるので、ActiveRecordを使ってfindしたりcreateしたりdestroy_allしたり、好きなようにDBをいじる事ができます。本当に素晴らしい機能ですね。

4. script/breakpointer

script/consoleはとても素晴らしいのですが、アクション実行中のsessionの状態を調べたりするのには使えません。そんな時は、script/breakpointerを使う事ができます。

   1  $ ./script/breakpointer

まず、あらかじめbreakpointerを立ち上げておきます。続いて、状態を確認したい場所にbreakpointを仕込みます。

   1  class FooController < ApplicationController
   2    def bar
   3      # something
   4      breakpoint
   5      # something
   6    end

あとは、ブラウザからアクセスしてbarアクションを実行すると、待ち受けていたbreakpointerでirbが立ち上がるので、必要な情報を自由に閲覧・操作する事ができます。

5. better rails debugger

script/breakpointerはとても便利ですが、ステップ実行が出来ないという問題があります。 実際にステップ実行がどうしても必要という場面はあまり無いのですが、あればあったほうが便利ですね。そんな時は、ruby-debugというGemを使います。 これは前回のRails勉強会のときにyuguiさんから教えていただいた方法なのですが、まずはruby-debugをインストールします。

   1  # gem install ruby-debug

次に、ブレークポイントを仕込みます。

   1  class FooController < ApplicationController
   2    def bar
   3      # something
   4      debugger
   5      # something
   6    end

あとは、p/ppデバッグをするときのようにWebrickやMongrel等のWebサーバをフォアグラウンドで立ち上げ、目的のコードが実行されるようにブラウザからアクセスします。 すると、Webサーバのプロセス上でdebug.rb（と似たような感じのもの）が立ち上がるので、通常のrubyスクリプトを デバッグする時と同じ要領でデバッグを行う事ができます。

6. test/autotest

Ruby on Railsでは、テスト用のフレームワークがはじめから使える状態になっています。 テスト駆動開発では、テストを書いてから実装を書きますが、適当な動作検証用のコードをテストとして書くことで、デバッグに使う事もできます。この際、毎回テストをrakeコマンドから実行するのは時間が掛かるので、ZenTestのautotestを使うのがお勧めです。 autotestを使うと、編集されたファイルに関連するテストだけを実行してくれるので、rakeコマンドを実行するよりも軽快なレスポンスが得られます。さらにredgreenを併用すると気分良くデバッグを行う事ができるのでお勧め。

7. tail -f log/development.log&; autotest

最後に、僕が今使っている方法を紹介します。 開発用とは別に一つターミナルを立ち上げて、RAILS_ROOTで以下のコマンドを実行。

   1  $ tail -f log/development.log&; autotest

こうしておくと、プログラムやテストコードを編集した時はautotestの出力が表示され、ブラウザからアクセスした時にはロガーの出力が表示されます。 基本的に両者が同時に行われる事は無いので、一つのターミナルを有効利用する事ができておすすめ。

というわけで、Railsでデバッグを行う方法の紹介でした。

記事の引越しから漏れていたのでサルベージ。

RubyGems パッケージの作り方 - rubyforge 登録まで

僕はまだRubyForgeにGemを登録した事がないので、secondlifeさんの記事はとても参考になりました。蛇足感もありますが、多様性は善という事で、HoeというGemを使ったもう一つのRubyGemsパッケージの作り方を紹介します。

Hoeは、Seattle.rb Projects による一連のプロジェクトの中の一つで、やはりnewgemと同じようにRubyGemsの作成を簡単にしてくれるGemです。

Hoeを使ってGemを作る流れは、

1. sowコマンドでGemの雛形を生成
2. 雛形を元にGemを作成

という感じで、非常に簡単です。具体的に簡単なGemを作る方法を紹介します。

まずはHoeをインストールしましょう。

# gem install hoe --include-dependencies

そしてGemの雛形を生成します。

   1  $ sow sample
   2  creating project sample
   3  ... done, now go fix all occurances of 'FIX'
   4  
   5    sample/Rakefile:9:  # p.summary = 'FIX'
   6    sample/README.txt:2:    by FIX
   7    sample/README.txt:3:    FIX
   8    sample/README.txt:7:FIX
   9    sample/README.txt:11:* FIX
  10    sample/README.txt:15:    FIX
  11    sample/README.txt:19:+ FIX
  12    sample/README.txt:23:+ FIX
  13    sample/README.txt:29:Copyright (c) 2006 FIX

とりあえずこのFIXというところをカスタマイズすればOKという親切ぶりです。 そしてさらに、次のようなRakeタスクが生成されます。

   1  $ rake -T
   2  (in /home/takiuchi/sample)
   3  rake announce         # Generate email announcement file and post to rubyforge.
   4  rake audit            # Run ZenTest against the package
   5  rake check_manifest   # Verify the manifest
   6  rake clean            # Clean up all the extras
   7  rake clobber_docs     # Remove rdoc products
   8  rake clobber_package  # Remove package products
   9  rake debug_gem        # Show information about the gem.
  10  rake default          # Run the default tasks
  11  rake docs             # Build the docs HTML Files
  12  rake email            # Generate email announcement file.
  13  rake install          # Install the package. Uses PREFIX and RUBYLIB
  14  rake install_gem      # Install the package as a gem
  15  rake multi            # Run the test suite using multiruby
  16  rake package          # Build all the packages
  17  rake post_news        # Post announcement to rubyforge.
  18  rake publish_docs     # Publish RDoc to RubyForge
  19  rake redocs           # Force a rebuild of the RDOC files
  20  rake release          # Package and upload the release to rubyforge.
  21  rake repackage        # Force a rebuild of the package files
  22  rake ridocs           # Generate ri locally for testing
  23  rake test             # Run the test suite. Use FILTER to add to the command line.
  24  rake uninstall        # Uninstall the package.

なんとも魅力的な名前のタスク達ではないでしょうか。 rakeコマンドを打つだけでRubyForge上でのいろんな作業が出来てしまいそうです。

そのほか細かいところは同じなので、secondlifeさんの記事をご参照ください。

LiveConsole

昔、Rails勉強会の懇親会で yuguiさん と話した、走り続けるプログラムの事を思い出した。

• 起動や停止するという概念が無いプログラム
• 自己複製による並列処理
• 蓄積したバグによる老化と死、世代交代

そして、それを記述するための言語。

継承、遺伝、進化。

ブラウザ以外のUserAgentからRailsアプリケーションにリクエストを送る場合、Railsが管理しているsessionの仕組みとは別に、自分でセッションをセットアップしたくなる事があります。

そのような場合は、たとえばクエリパラメータからsession_idを渡したりするのですが、GET methodで受け渡したsession_idからRailsのsessionを再現するためには、以下のように記述します。

   1  FooController < ApplicationController
   2    session :off, :if => (proc do |req|
   3      return false unless req.parameters[:action] == 'bar'
   4      if req.parameters[:session_id]
   5        @original_session_options = req.session_options
   6        req.session_options[:session_id] = req.parameters[:session_id]
   7      end
   8      false
   9    end)
  10    prepend_before_filter :only => 'bar' do
  11      if @original_session_options
  12        @original_session_options[:session_id] = nil
  13      end
  14    end

before_filterを使っていないのは、before_filterでは Railsのsession処理に間に合わないためです。

更新履歴

• 2007/11/20 不具合があったため内容を修正しました

Rails勉強会＠東京#02-24

Genki Takiuchi

• Twitter: http://twitter.com/takiuchi
• Facebook: http://www.facebook.com/profile.php?id=701866760

Recent Situation:

• Founded small company.
• Moved to Shindaita from Ebisu.
• Became slightly familiar with MAC.
• And also with Rails 2.0

Favorite Things:

• C/C++ Template, JavaScript, Ruby.
• Thinking algorithm, Rendering (CG) and 3D.
• Vim7, Zsh, GNU screen, rails.vim, ZenTest.

Thank you!

画面の内容に合わせて、必要なJavaScriptやStyleSheetをincludeする場合、 以前紹介した content_forを使うのが便利ですが、 画面内で何度も呼び出される partial のなかに記述したりすると、 呼び出された回数分だけ include されてしまったりして不便です。

そこで、画面内で一回だけ content_for を実行するためのプラグイン、 content_for_once を作りました。こちらに置いてあります。

• http://svn.s21g.com/public/rails/plugins/content_for_once/

使い方。まずはプラグインをインストールします。

   1  % ./script/plugin install https://svn.s21g.com/public/rails/plugins/content_for_once/

あとは、Viewから以下のようにして呼び出します。

   1  <% content_for_once :head do %>
   2    <%= javascript_include_tag 'iepngfix' %>
   3  <% end %>

これで、このコードが実行されたときに、一度だけJavaScriptが includeされるようになります。

Ultraviolet によるシンタックス・ハイライトに対応しました。

書式は以下のような感じです。

ruby>>
def foo
  bar
end
<<--

レンダリング結果は以下のとおり。

   1  def foo
   2    bar
   3  end

前回の続き。導入そのままでは、

• link作成ダイアログがリサイズできない
• エディタのフォントサイズが小さい

という問題がありました。 Wikiサイトを調べると、割とすんなりと解決。

advlinkプラグイン導入
http://wiki.moxiecode.com/index.php/TinyMCE:Plugins/advlink

Content用css導入
http://wiki.moxiecode.com/index.php/TinyMCE:Configuration/content_css
FAQ:How do I change the default font size/face color of the editor?

具体的には

   1        tinyMCE.init({
   2        (略)
   3        content_css : "/stylesheets/tinymce.css",
   4        plugins : "advlink",
   5        extended_valid_elements : "a[name|href|target|title|onclick|rel]",

うむ。FCKより小回りが利くかもですね。
そして標準のプラグインがおおいのも++。advlinkも標準です：標準のプラグイン一覧

会社設立や、それに伴う環境の変化への対応などのため、しばらく開発がとまってしまっていた ShootingStar ですが、ipod touch＆iphoneへの対応作業をほぼ完了いたしました。

DEMO: http://www.cocktail-party.jp/

もうしばらくコードの整理をしてから、version 3.2.5 をリリースいたします。

よろしくお願いいたします。