荒井省三のBlog : IronRuby

Rack ベースの Web アプリを IIS で動かしてみました

shozoa — Thu, 11 Jun 2009 10:32:00 GMT

前回にご紹介した Railsカンファレンスの IronRuby on Railsセッションで、Rails以外のWebフレームワークとしてrackが紹介されていました。rackは、Ruby向けの Webインターフェースを提供するフレームワークで、Ruby on Rails 2.3.x系も内部でrackと統合されています。このrackをIronRubyを使って、IISで動かしてみました。その動かし方を以下に記載します。

1.必要なもの

IronRuby 0.5.0
rack 1.0.0
IronRuby.Rack
Ruby 1.8系

2.rackのインストール

「igem install rack」コマンドでインストールします。
私の場合は、PATHとGEM_PATH環境変数を設定後に実行しました。実行すると以下のようなメッセージが出力されます。

C:>igem install rack
Successfully installed rack-1.0.0
1 gem installed
Installing ri documentation for rack-1.0.0...
Installing RDoc documentation for rack-1.0.0...
mscorlib:0:in `GetBytes': 値が有効な範囲にありません。
              (System::Text::EncoderFallbackException)
        from :0:in `write'
        from :0:in `puts'
        from c:/ruby/lib/ruby/site_ruby/1.8/rubygems/
             user_interaction.rb:227:in`alert_error'
        from c:/ruby/lib/ruby/site_ruby/1.8/rubygems/
             user_interaction.rb:103:in`alert_error'
        from c:/ruby/lib/ruby/site_ruby/1.8/rubygems/
             command_manager.rb:77:in `run'
        from c:/ruby/lib/ruby/site_ruby/1.8/rubygems/
             gem_runner.rb:39:in `run'
        from C:/IronRuby0.5.0/bin/igem:24

このエラーはIronRubyのバグのようで、riとrdocのインストールに問題があることを示しています。このエラーを発生させないためには、--no-ri --no-rdocオプションでriとrdocをインストールしない方法があります。
インストールが終了すると、IronRuby 0.5.0のライブラリパスへとrackがインストールされます。

3.HTTPハンドラをビルドします

githubからダウンロードしたIronRuby.Rackをビルドします。
私の場合は、以下のような手順で作業を行いました。
git clone git://github.com/jschementi/ironruby.git
コピーしたソースコードの中から、C:\Users\shozoa\wk\ironruby\Merlin\Main\Hosts\IronRuby.Rackフォルダを作業用フォルダへコピー。
IronRuby.Rack.slnファイルをVisual Studioで開いて、IronRuby.RackプロジェクトとIronRuby.Rack.Exampleプロジェクト以外のプロジェクトを削除(環境によって、IronRuby.Rack.Exampleプロジェクトは無効になっているかも知れません)
IronRuby 0.5.0の7つのアセンブリに対して参照をIronRuby.Rackプロジェクトへ追加しました。
これでIronRuby.Rackプロジェクトをビルドできるようになりました。

4.IISの環境を作成します

管理ツールのIISマネージャを開きます。
Default Web Sitesの下へ新規のアプリケーションを作成します。
エイリアスを「IronRuby.Rack.Example」にします。
物理パスにコピーしたソースコードの「IronRuby.Rack\IronRuby.Rack.Example」を指定します。
IronRuby.Rack.Example\web.config の configセクションを編集します。
```
<section name='microsoft.scripting'
type='Microsoft.Scripting.Hosting.Configuration.Section,
Microsoft.Scripting, Version=0.9.6.10, Culture=neutral,
PublicKeyToken=31bf3856ad364e35'
requirePermission='false' />
```
この変更は、アセンブリのバージョン番号とパブリックキートークンが異なるために行っています。
Visual Studio で IISのWebプロジェクトを編集するには、IISにいくつかのオプションが必要になります。このオプションとは、Windowsの機能のことです。追加されるには、アプリケーションの追加で以下の機能を追加します。
セキュリティ-要求フィルタリング、Windows認証
管理ツール-IIS6と互換性のある管理－IISメタベースとIIS6構成との互換性
管理ツール-IIS管理コンソール、IIS管理サービス、IIS管理スクリプトとツール
(注)Visual Studio 2008で編集しないのであれば、この作業は必要はありません。私は、IIS7で動作確認を行っています。
IronRuby.Rack.Example\Binフォルダへ必要なアセンブリを配置します。
IronRuby.Rackプロジェクトでビルドして出来たアセンブリ(私の場合Debug\Binフォルダにある8つ)をコピーしました。
RubyとIronRubyのライブラリに対して、IISを起動するアカウント(Network Service)に対してアクセス権限を付与します。
「C:Ruby」と「C:\IronRuby-0.5.0」へ読み取り権限を私は付与しました。

5.ブラウザでテストします

「http://localhost/IronRuby.Rack.Example」へアクセスします。

IronRuby running Rack says "Hello, World"
 at 木 6 11 16:22:32 +09:00 20

上記のように表示されれば成功です。この表示は、IronRuby.Rack.Example\app.rbに記述されたスクリプトを実行して出力しています。config.ru(rackの構成ファイル)などをカスタマイズすれば、別のアプリケーションへURLをマップしたりすることもできます。

6.IronRuby.Rackの制限事項

GEM_PATH環境変数が「C:\ruby\lib\ruby\gems\1.8」固定になっている(Application.cs)ため、ruby 1.8系のインストールフォルダが「c:\ruby」で無ければならないということです。
rackの構成ファイルが、Webアプリケーションのルート直下に無ければならない
制限ではないですが、HTTPハンドラは内部でRackupを行っています。
(注)この個所を応用すれば、別のフレームワークもサポートできるかも知れません。
Visual Studioの開発用Webサーバーには対応していません。

IronRuby で Ruby on Rails を動かしてみました

shozoa — Tue, 09 Jun 2009 09:17:00 GMT

昨年のRailsカンファレンスに続いて今年のRailsカンファレンスでは、「IronRuby on Rails」というセッションが行われました。このセッションでは、公開されたIronRuby 0.5.0とRuby on Rails 2.3.2を使って実際にRailsをIronRubyで動かしています。少し(大分かも)前から、IronRubyでRailsを動かすためのドキュメントが公開されています。このカンファレンスで何を紹介したかというサマリーが、Jimmyさんのブログで紹介されています。Railsを動かすドキュメントを使って、実際にRailsを動かしてみましたので、その手順を以下に記載していきます。

1.環境構築

IronRuby 0.5.0
Ruby 1.8系 (私は、OneClick Installer 1.8.6-27を使用しました)

IronRuby 0.5.0をダウンロードしてC:\IronRuby-0.5.0フォルダへ展開し、OneClick Installerで使ってC:\RubyへRubyをインストールしました。

2.Rails 2.3.2 の導入

RubyGems のアップデート
Ruby on Rails 2.3.2をRubyGemsを使ってインストール

#コマンドプロンプトで作業
gem update --system
gem install rails --v2.3.2 --include-dependencies

　(注)RubyGemsを利用するために、Ruby 1.8系が必要になります。

3.環境変数の設定

PATH環境変数へ IronRubyのBinフォルダへのパスを追加します。
GEM_PATH環境変数へRubyGemsのパスを設定します。

SET PATH=%PATH%;C:\IronRuby-0.5.0\bin
SET GEM_PATH=C:\ruby\lib\ruby\gems\1.8

4.IronRubyの構成ファイルである「ir.exe.config」のLibralyPathsの値にRuby1.8のライブラリパスを設定します。

<set language="Ruby" value="..\lib\IronRuby;
       c:\ruby\lib\ruby\site_ruby\1.8\;
       c:\ruby\lib\ruby\1.8\" option="LibraryPaths" />

(注)valueの値は読みやすいように改行していますが、実際に設定する場合は改行を含めないで下さい。またir.exe.configは、IronRuby 0.5.0を展開した中のBinサブフォルダに存在します。

4.SQL Server のActiveRecord Adapter の導入

MS SQL Server Adapter
ダウンロードした「mssql_adapter.rb」を「C:\Ruby\lib\ruby\gems\1.8\gems\activerecord-2.3.2\lib\active_record\connection_adapters」フォルダーにコピーします。

(注)もちろん、SQL Serverをインストールしておく必要があります。私の場合は、SQL Server 2008 Express Editionで確認を行いました。このアダプターでは、以下のようなデータ型の対応付けが行われています。

:primary_key => "int not null identity(1,1) primary key ",
:string      => { :name => "varchar", :limit => 255 },
:text        => { :name => "text" },
:integer     => { :name => "int" },
:float       => { :name => "float" },
:decimal     => { :name => "numeric" },
:datetime    => { :name => "datetime" },
:timestamp   => { :name => "datetime" },
:time        => { :name => "datetime" },
:date        => { :name => "datetime" },
:binary      => { :name => "varbinary", :limit => 'MAX' },
:binary      => { :name => "image" },
:boolean     => { :name => "bit" }

5.WEBrickに対するパッチを投入します

「C\Ruby\lib\ruby\1.8\webrick\httprequest.rb」へパッチを投入します。
パッチは、githubから入手します。

　パッチの内容は、２か所あります。最初に、163行目のHttpRequestクラスのto_sメソッドです。

#      ret = @request_line.dup
#      @raw_header.each{|line| ret << line }
       ret = @request_line ? @request_line.dup : ""
       @raw_header.each{|line| ret << line } if @raw_header

次は、8行目(require)の直後に追加します。

# IronRuby bug: IO#read seems to chop off the first char
class TCPSocket
  def read size
    recv size
  end
end

6.Railsからエンコード指定を取り除きます。2.3.2のRailsはデフォルトがUTF-8のエンコーディングです。が、IronRubyではUTF-8エンコーディングの文字列が組み合わさるとバグが発生するためです

「C:\Ruby\lib\ruby\gems\1.8\gems\rails-2.3.2\lib\initializer.rb」の「initializ_encoding」メソッドの実装をコメントアウトします。
407行目の「$KCODE='u' if RUBY_VERSION < '1.9'」をコメントにします。

ここまでで、準備が完了です。ここからは、Railsアプリケーションを作成していく作業となります。

7.新しいRailsアプリケーションを作成します

「irails IronRubyOnRails」コマンドを使用します。
「3.環境変数」を設定したコマンドプロンプトで作業を行います。

(注)成功すれば、コマンドプロンプトに「create ....」というログが表示されます。IronRubyでは、各種のコマンドの先頭に「i」というプレフィックスが付きます。インタラクティブRuby(irb)なら、「iirb」となります。これらのコマンドは、Windows向けにはBATファイルがあり、Linux向けには拡張子無しのシェルスクリプトファイルが提供されています。

8.データベースの設定を行います

IronRubyOnRails\config\database.ymlファイルを編集します。

development:
  adapter: mssql
  host: (local)\SQLEXPRESS
  database: ironruby_dev
  integrated_security: true

上記のように設定するか、host、database、integrated_securityパラメータを「connection_string」パラメータで置き換えます。

続いて「ironruby_dev」という名前のデータベースをSQL Serverで作成します。SQL Server 2008 Management Studio Expressを使用するのが簡単です。
(注)このパラメータ形式は、SQL Serverをご存じな方には馴染み易いことでしょう。ADO.NETなどで、指定する接続文字列をパラメータとして指定しているのです。

9.Scaffolding を使ってサンプルのアプリケーションを作成します

「ir script/generate scaffold post title:string body:text published:boolean」コマンドをIronRubyOnRailsフォルダで実行します。

(注)成功すればコマンドプロンプトに「create....」というログが表示されます。

10.アプリケーションコントローラーのバグ対応を行います。

「app\controllers\posts_controller.rb」で「default_url_options」メソッドをpublicに定義します。

class PostsController < ApplicationController
...
...
  # 私の場合は、最後に追加しました
  public :default_url_options
end

(注)この変更は、IronRubyのバグ1354に対する対応です。rails 2.3.2では、default_url_optionsメソッドがprotectedとして定義されています。IronRubyでは、publicである必要があります。publicに変更しないでWEBrickを起動すると、http リクエストに対するレスポンスが帰ってきません。default_url_optionsメソッドのエラーがコンソールに出力される場合もあります。

11.データベースのテーブルを作成します

「irake db:migrate」コマンドを実行してテーブルを作成します。

C:\IronRubyOnRails>irake db:migrate
(in C:/IronRubyOnRails)
==  CreatePosts: migrating =================
-- create_table(:posts)
   -> 0.0550s
   -> -1 rows
==  CreatePosts: migrated (0.0990s) ========

成功すれば上記のように「create table...」などのログがコンソールに出力されます。失敗すると以下のように「System::Text::EncoderFallbackException」が出力されます。

C:\IronRubyOnRails>irake db:migrate
(in C:/IronRubyOnRails)
rake aborted!
rake aborted!
mscorlib:0:in `GetBytes': 値が有効な範囲にありません。
          (System::Text::EncoderFallbackException)
        from :0:in `write'
        from :0:in `puts'
.....

失敗した場合は、「config\database.yml」の設定内容を見直してください。host: (local)\SQLEXPRESSなどを書き間違えると、このエラーが出力されます(私も書き間違いをしていて、このエラー原因を探すのに苦労しました)。

11.WEBrickを起動してテストを行います

「ir script/server」コマンドを実行します。

C:\IronRubyOnRails>ir script/server
=> Booting WEBrick
=> Rails 2.3.2 application starting on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2009-06-09 17:14:17] INFO  WEBrick 1.3.1
[2009-06-09 17:14:17] INFO  ruby 1.8.6 (2008-05-28) [i386-mswin32]
[2009-06-09 17:14:17] INFO  WEBrick::HTTPServer#start:
                                            pid=4568 port=3000

正常に起動すれば、上記のようなログが出力されます。しかしながら、私の環境(Windows Vista with SP2)では少し時間がかかります。

ブラウザで「http://localhost:3000/」へアクセスすれば、railsのページが表示されることでしょう。
「about your application's environment」をクリックします。

正常に実行されれば実行環境が上記のように表示されます。が、この情報はRailsのInfoControllerが処理する関係で、IronRubyとは表示されることはありません。あくまでも、Ruby 1.8系として表示されるだけです。
次に「http://localhost:3000/posts」へブラウザでアクセスします。

上記のようにpostsテーブルの一覧が表示されます。new postsのリンクをクリックしてデータを追加していけば、問題なく動作することを確認していくことができます。
この時点で、コンソールを確認すると以下のようなログが出力されていました。
```
Processing Rails::InfoController#properties
 (for 127.0.0.1 at 2009-06-09 17:21:5) [GET]
Completed in 584ms (View: 189, DB: 0) | 200 OK
             [http://localhost/rails/info/proerties]


Processing PostsController#index
 (for 127.0.0.1 at 2009-06-09 17:25:21) [GET]
Rendering template within layouts/posts
Rendering posts/index
Completed in 735ms (View: 540, DB: 0) | 200 OK
            [http://localhost/posts]
```
これらのログが表示されるのが、私の環境では少し遅くなっています。ブラウザでは問題なく動作しているのですが、WEBrickのログ出力が遅くなるという問題があるようです。もしかすると、環境依存かもしれません。

ここまでの動作で、IronRubyを使ってRuby on Rails 2.3.2が動作していることを確認することができました。データベースとしては、SQL Serverです。まだまだパフォーマンス的な問題や、バグが残っているにしてもIronRubyによる Ruby on Railsの実現が近くなってきたのを感じ取ることができます。是非、皆さんも試してみてください。そしてバグを見つけたら、フィードバックをしてください。

PS.昨年のRailsカンファレンスでもIronRubyでrailsを動かしていますが、日本では情報が少ないように感じています。是非、皆さんも動かしてみてください。

追記:WEBrickへのパッチを投入するファイル名を追加しました。

Silverline を試してみました

shozoa — Mon, 23 Mar 2009 09:01:00 GMT

昨年のRails Conference 2008 でデモが行われた Ruby on Rails のプラグインである Silverline を試してみました。このプラグインは、RoR 上で Silverlight アプリを生成するためのものです。Web上でのデモも確認することができます。この環境を構築するの使用したのは、以下のものになります。

One Click Ruby Installer 1.8.6-27 RC2
Ruby on Rails 2.0.2
gem install rails --version 2.0.2 --include-dependencyでインストール
Silverline
Silverline-Demos
sqlite3-ruby 1.2.4
SQLite 3.6.11

Ruby on Rails をgemでインストールした時に問題になったのが、proxy設定です。これには、「--http-proxy http://<サーバのIPアドレス>:<ポート名>」オプションを指定することで対応しました。必要なモジュールのインストールが完了したという前提で、Silverline-demosに含まれるサンプルを動作させた方法を以下に記述します。

新規のRailsアプリケーションを作成する
コマンド「rails new-silverline」を使って新規のrailsアプリケーションを作成します。

以下はrailsの環境設定です

config\database.ymlファイル
development:
  adapter: sqlite3
  encoding: utf-8     # 追加
  database: db/development.sqlite3
  timeout: 5000

config\environment.rbファイル

Rails::Initializer.run do |config|
  #
  :略
  :
  # 以下を追加
  config.action_controller.default_charset='UTF-8'
end

Silverlineプラグインのインストール
gitを使ってcloneしたsilverlineフォルダを vendor\pluginsフォルダへコピーします。
app\controlers\client_controller.rbを準備
silverline-demos\app\controlers\client_controller.rbをコピーします。この理由は、silverlineプラグインがclient_controller.rbをチェックするためです。
app\views\layouts\client.html.erbを準備
silverline-demos\app\views\layouts\client.html.erb をコピーします。これが、先程のコントローラーに対するビューになります。
この時点で「ruby script/server」でサーバーを起動して、http://localhost:3000/clientへアクセスすることで動作を確認することができます。「Show Time」をクリックすることで、時刻を取得した新しいページがレンダリングされると思います。
私の場合は、public\silverline.html(demosで提供されるindex.html)とpublic\clientaccesspolicy.xmlを準備しました。
両方ともsilverline-demos\publicにあります。

ここまでで、本当に基本的なSilverlightアプリケーションが動作しました。UIとしては、HTMLでコードとしてはIronRubyというものです。この動きの延長として、Read Evalute Print Loop(略してrepl、Web上のコンソール)のサンプルとして「TryRuby」があります。このTryRuby環境の作り方を以下を記述します。

必要なファイルをsilverline-demosからコピーします。
app\controllers\tryruby_controller.rb
app\helpers\tryruby_helper.rb
app\views\layouts\tryruby.html.erb
app\views\tryruby(_evalute.rb、index.html.erb)
app\public\images(loading2.gif、loading.net.gif)
app\public\javascripts(scrolling.js)
app\public\stylesheets(error.css)
index.html.erbの11行目を以下のように修正します
シングルクオーテーションが抜けているためです
```
<a href="javascript:void(0)" mce_href="javascript:void(0)" id="next" onclick="alert('next')">
```

config\route.rb に JSON のマップを追加します
map.connect "tryruby/instructions.:format",
 :controller => 'tryruby', :action => 'instructions'

これで http://localhost:3000/tryrubyへアクセスすることで動作を確認

```
することができます。
```

このTryRubyサンプルは、

起動時にSilverlightからRoRのtryruby\instructionsへリクエストします。そして、返ってきたJSON形式のデータを使って、操作のガイドを表示するようになっています。

silverline-demos自体を動作させるためには、以下の2つの操作が必要になります。

「raike db:migrate」コマンドでsqlliteの環境を作成する。
これは、postsというサンプルがDBを使用するためです。
vender\plugins\silverlineフォルダへ、silverlineプラグインの内容をコピーする。

他にも動作のおかしな所もありますが、基本的な動作を以上の操作で確認することができます。これが、Ruby on Railsに対するプラグインであるsilverlineの動作になります。

silverlineが行っている動作は、2つあります。

サーバー側で必要なコンテンツを生成すると同時にclient.xapを生成して、コンテンツをブラウザに返す
クライアント側のｌclient.xapに含まれたIronRubyスクリプトを使って、XAMLやJSONへのリクエストをサーバーへ投げること。

これらの動きを行うために、コントローラーやビュー(サーバー側とSilverlight側)を提供しているのがSilverlineとなります。

IronPython 2.0 リリース

shozoa — Thu, 11 Dec 2008 06:03:00 GMT

ついにIronPython 2.0がリリースされました。それと同期するようにDLRも公開されています。ふむDLRのバージョンは0.9となっていますが、12/10にUpされているのでRC2に同期した0.9から、どの程度更新されたかは不明です。

DLR-0.9をダウンロードしてみると、中にIronRuby、ToyScript、IronPythonも含まれています。IronPython.dllのバージョンを見ると2.0.11121.0なのでIronPython 2.0に含まれているのと同じバージョンになります。異なるのはタイムスタンプだけです。また、DLRに関するドキュメントがWORD文書で5つほど含まれています。DLRをホスティングするには、dlr-spec-hosting.docという文書が有益です。

PS:Silverlight Dynamic Lamguage SDKに含まれているバイナリと同じものが、DLR-0.9に含まれています。今回のソースコードに対応したものは、まだ公開されていないようです。

Silverlight Dynamic Language SDK の使い方4

shozoa — Tue, 28 Oct 2008 08:52:00 GMT

今回は、 Chiron.exeの/bや/z、/mオプションで作成されるアプリケーション・マニフェストを説明します。例題とするのは、DLR Consoleで使用されているAppManifest.xamlです。

<Deployment 
  xmlns="http://schemas.microsoft.com/client/2007/deployment"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  RuntimeVersion="2.0.31005.00" 
  EntryPointAssembly="Microsoft.Scripting.Silverlight"
  EntryPointType=
  "Microsoft.Scripting.Silverlight.DynamicApplication"
>
  <Deployment.Parts>
    <!-- Add additional assemblies here -->
    <AssemblyPart Source="Microsoft.Scripting.Silverlight.dll"/>
    <AssemblyPart Source="Microsoft.Scripting.Core.dll" />
    <AssemblyPart Source="Microsoft.Scripting.dll" />
    <AssemblyPart Source=
          "Microsoft.Scripting.ExtensionAttribute.dll" />
    <AssemblyPart Source="IronPython.dll" />
    <AssemblyPart Source="IronPython.Modules.dll" />
    <AssemblyPart Source="IronRuby.dll" />
    <AssemblyPart Source="IronRuby.Libraries.dll" />
    <AssemblyPart Source="Microsoft.JScript.Runtime.dll" />
    <AssemblyPart Source="Microsoft.JScript.Compiler.dll" />
  </Deployment.Parts>
</Deployment>

最初に取り上げるのが、Deployment要素のEntryPointAssembly属性とEntryPointType属性です。ここには、以下のように記述されています。

EntryPointAssembly="Microsoft.Scripting.Silverlight"
EntryPointType="Microsoft.Scripting.Silverlight.DynamicApplication"

属性名が表しているようにSilverlight2.0対応のランタイムが起動するプログラムが格納されたアセンブリと開始するクラスを指定しています。このDynamicApplicationクラスこそが、SilverlightとDLRを結びつけるものです。このエントリポイントのモデルは、DLRに限った話ではなくC#やVBを使ったSilverlightアプリケーションでも使用されているものです。そして、DynamicApplicationクラスはSystem.Windows.Applicationクラスを継承しています。

Deployment.Parts要素内のAssemblyPart要素にSilverlightランタイムが読み込むアセンブリをSource属性で指定します。ここで指定しているアセンブリを以下に示します。

アセンブリ名	説明
Microsoft.Scripting.Silverlight.dll	Silverlight 2.0ランタイムのエントリポイントです。
Microsoft.Scripting.Core.dll	DLRの本体です。
Microsoft.Scripting. ExtensionAttribute.dll	IronPython 2.0RC1から追加されたDLRの補助アセンブリです。ビルド時のSystem.Core.dllとの衝突を回避するために導入されました。
Microsoft.Scripting.dll	DLRを使用するための各種ヘルパーです。

これ以外のアセンブリが、動的言語のためのものです。アセンブリ名から、IronPython、IronRuby、Managed JScript用がどれかというのは自明でしょう。そしてSource属性は、上記のような書き方以外にURLによる記述も可能です。URLを使った表記の場合は、相対パスではなく絶対パス(http://で始まる)の記述になります。URLで記述した場合は、xapファイル内に対象のアセンブリを含める必要はありません。

プログラムを開発する上でSilverlight SDKなどで提供される拡張アセンブリを使用する場合は、AssemblyPart要素に記述する必要とxapファイルに含める必要があります。Visual StudioのSilverlightプロジェクトでは、この一連の作業をVisual Stduioが行ってくれます。動的言語で開発する場合は、自分でAppManifest.xamlへの記述とxapファイルへのアセンブリをパッケージングする必要があります。後は、使用される動的言語によって追加したアセンブリに対する参照を記述するれば、スクリプトの中から使用することが可能になります。

#IronPython
import clr
clr.AddReference(アセンブリ識別子かアセンブリ名)
import文かfrom -- import 文で参照を行う

#IronRuby
require 'アセンブリ識別子'

上記のように参照を行うことで、スクリプトの中から自由に参照したアセンブリを使用することができるようになります。ちなみに、アセンブリ識別子とは「System.Windows, Version=2.0.5.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e」という形式のことです。

最後に添付のapp.pyは、最初にご紹介したDLR Consoleのキーマッピングを日本語キーボード用に変更(TextInputHandlerクラス)したものです。ライセンスは、Silverlight Dynamic Language SDKがMS-PLですので、それに準拠したご使用をお願いいたします。

Silverlight Dynamic Language SDK の使い方3

shozoa — Mon, 27 Oct 2008 10:45:00 GMT

Dynamic Language SDK で提供されるスクリプトのserver.batとは、chiron.exeをラップしただけのものです。このため指定できるオプションを確認するには、「/?」か「/h」オプションを指定します。指定できるオプションを以下に示します。

オプション	説　　　明
/d:パス又は /dir、/directory	アプリケーション(スクリプトやプログラム)を格納しているフォルダを指定します。デフォルトは「app」になります。
/x:xapファイル又は /xap、/xapfile	xapファイルを作成する場合に「/x:app.xap」のようにxapファイルを指定します。/dで指定したフォルダの中身がxapファイルに格納されます。
/n 又は /nologo	バナーの表示を抑制します。
/s 又は /silent	コンソール出力を抑制します。
/z:xapファイル又は /zipdlr	DLRアプリケーション向けのxapファイルを生成します。/dで指定したフォルダにAppManifest.xamlが存在しなければ自動的に生成します。/xオプションとの違いは、スクリプトファイルを解析して必要なアセンブリと生成したAppManifest.xamlをxapファイル内に含めることです。
/w 又は /webserver	テスト用のWebサーバーを起動します。デフォルトのポートは、2060になります。ポートを指定する場合は、/w:ポート番号と指定します。
/b 又は /browser	テスト用のWebサーバーを起動して、ブラウザを起動します。開始時のURLを指定するには、/b:パスオプションを指定します。/dオプションを組み合わせれば、WebサーバーのトップURLの場所を指定することができます。
/m 又は /manifest	アプリケーション・マニフェスト(AppManifest.xaml)を生成します。
/? 又は /h、/help	ヘルプを表示します。
/r:パス又は /refpath	参照するアセンブリへのパスを指定します。デフォルトは、Chiron.exeが存在するフォルダを参照します。このオプションは、ヘルプに表示されません。

オプションの使い方は、ヘルプコマンドで確認するか、SDKに含まれるReadme.txtに記述されています。

前回に解説したプログラムをテスト実行するだけであれば、「chiron.exe /b /d:アプリケーションフォルダ」を実行することでブラウザで実行することができます。

配布用にXAPファイルを作成するには、以下のようにコマンドを入力します。

chiron.exe /d:アプリケーション・フォルダ /z:app.xap

これでXAPファイルが出来ますので、index.htmlとjavascriptフォルダ、stylesheetsフォルダ、作成したXAPファイルをWebサーバーへ配置すれば本番環境への移行が完了します。

chiron.exeには/xオプションでXAPファイルを作成できますが、このオプションは動的言語に特化したものではありません。どういう場合に使うかというと、既存のXAPファイルを展開して、中身のリソース(画像など)を入れ替えた場合などの再XAP化に使用することができます。つまり、リソース入れ替えでVisual StudioのリビルドなどをしなくてもXAPファイルを作成できるのです。具体的には、以下のようなコマンドを入力します。

chiron.exe /d:アプリケーション・フォルダ /x:app.xap

/dオプションで指定したフォルダに配置したファイル(AppManifest.xaml、dllなど)をそのままxapファイルにパッケージ化します。

/bオプションや/wオプションでWebサーバーを起動した場合は、ブラウザ・リクエストによるログがコンソールに表示されます。このコンソールを終了する場合は、コンソールで「CTRL+C」を入力するか、ブラウザで「http://localhost:2060/bye!」のように「bye!」コマンド入力してください。これで、Webサーバーが終了します。

追伸：IronPython 2.0 RC1が先週にリリースされました。今回はToyScriptのサンプルも公開されていますので、DLRの使い方を調べやすいと思います。

追記：RednaxelaFXさんのご指摘で、/nologの書き間違いを/nologoに訂正しました。それと/zオプションに/xオプションとの違いを追記しました。

Silverlight Dynamic Language SDK の使い方2

shozoa — Wed, 22 Oct 2008 05:41:00 GMT

今回は、SDKで提供されるテンプレート集の構造を説明します。最初にindex.htmlのobjectタグを解説します。

<object data="data:application/x-silverlight,"
        type="application/x-silverlight-2" 
        width="100%" height="100%">
  <!-- 
     XAPファイルを指定します。指定したファイル名が
      開発中に使用するフォルダ名になります。
    -->
  <param name="source" value="python.xap"/>

  <!-- 
      "initParams"はkey=valueの形式で、カンマ区切りで複数の
       パラメータを指定できます。
    -->
  <param name="initParams" value="debug=true,
         reportErrors=errorLocation" />
        
  <!-- Silverlightランタイムのエラーを処理する
        javascript関数を指定します。この関数は
        javascripts/error.js で定義されています。 -->
  <param name="onerror" value="onSilverlightError" />
      
  <!-- 
      他のパラメータは、Silverlightのプロパティです。
   -->
  <param name="background" value="white" />
  <param name="windowless" value="true" /&lg;

  <!-- 
      Silverlight ランタイムのインストール用のリンクです。
    -->
  <a href="http://go.microsoft.com/fwlink/?LinkID=124807" 
 　　　　 style="text-decoration: none;">
    <img src="http://go.microsoft.com/fwlink/?LinkId=108181" 
         alt="Get Microsoft Silverlight" 
         style="border-style: none"/>
  </a>
</object>

以下に指定しているパラメータの説明を記載します。

パラメータ名	説　　　明
objectタグのtype	"application/x-silverlight-2"がSilverlight2.0の指定です。HTTPサーバーのMIMEタイプに拡張子xapを設定する必要があります。
source	xapのファイル名を指定します。開発中の場合は、ファイル名(拡張子除き)のフォルダを作成します。この例では、「python」フォルダになります。
initParams	DynamicApplicationに対してカンマ区切りで複数のパラメータを指定します。これが動的言語を起動するために必須のものです。 start:複数のスクリプトファイルがあれば、エントリーポイントとなるスクリプトファイルを指定します。defaultは、「app」になっています。 debug：エラー時にスタックトレースを出力するかどうかを指定します(デバッグ用です)。defaultは、falseです。 reportError：エラーが発生した場合にエラー内容を出力するHTML要素のIDを指定します。この例では「errorLocation」を指定しており、HTML内でdivタグで定義しています。defaultはnullです。 exceptionDetail：例外の詳細情報(マネージスタックトレース)を出力するかどうかを指定します。defaultは、falseです。
onerror	Silverlightランタイムのエラーを処理するjavascript関数を指定します。

Silverlight2.0で動的言語を使う上で重要なのが、initParamsパラメータになります。ここで動的言語の起動用の様々な指定を行っています。このパラメータは、Microsoft.Scripting.Silverlight.DynamicApplicationクラスのコンストラクタに渡されます。独自のパラメータを指定した場合は、DynamicApplicationクラスのInitParamsプロパティを使って辞書オブジェクトへアクセスすることができますので、起動時に自分用のパラメータを指定することも可能です。

python言語のテンプレートでは、python.xapが指定されていますのでpythonフォルダ内にapp.pyがあることになります。このapp.pyの内容を以下に示します。

from System.Windows import Application
from System.Windows.Controls import UserControl

class App:
  def __init__(self):
    root = Application.Current.LoadRootVisual(
                         UserControl(), "app.xaml")
    root.Message.Text = "Welcome to Python and Silverlight!"

App()

Pythonコードで、Appクラスを定義してからAppクラスのインスタンスを作成するようになっています。ここでのポイントは、System.Windows.Applicationクラスの使い方にあります。

from 文は、C#のusing文、VBのImports文に相当します。
Application.CurrentプロパティでApplicationクラスのインスタンスを取得します。このインスタンスがDynamicApplicationクラスになっています。
LoadRootVisualメソッドを使ってXAMLファイルを読み込んでいます。このメソッドの1つ目の引数がUserControlのインスタンスで、2つ目の引数がXAMLのファイル名です。戻り値に、XAMLファイルで指定したルートオブジェクトが戻ります。1つ目の引数に指定するオブジェクトは、XAMLファイルのルートで指定したものになります。よって、Canvasタグが指定されている場合はCanvasオブジェクトになります。
root.Message.Textプロパティに文字列を指定しています。Messageオブジェクトは、XAMLファイルで定義されたTextBlockのインスタンスです。

以下にapp.xamlを示します。

<UserControl x:Class="System.Windows.Controls.UserControl"
    xmlns="http://schemas.microsoft.com/client/2007"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <Grid x:Name="layout_root" Background="White">
    <TextBlock x:Name="Message" FontSize="30" />
  </Grid>
</UserControl>

このapp.xamlをapp.pyと同じフォルダに配置します。従ってPythonのコードで指定しているXAMLファイル名を変更すれば、app.xamlである必要はありません。テンプレート集では、スクリプトファイルの名前がdefaultでappになっているために、XAMLファイルも同じように合わせていると思われます。
app.pyをユニコードのエンコードにして、設定している文字列を日本語にしてみてください。問題なく、日本語が表示されます。Silverlightで日本語を含むマルチバイトの言語を使用するには、スクリプトファイルのエンコードをユニコードにする必要があります。これは、使用する言語に左右されません。Silverlight上の言語実装が、このようになっている模様です。事実、IronPython2.0ベータのインタラクティブシェルなどで試すとファイルエンコーディングを指定して様々なエンコードのスクリプトファイルを処理することができます。よって、Silverlightで動作させるために削減された機能の1つが、スクリプトファイルのエンコーディング指定のようです。

追伸：サンプルのcollateraldamageのPython版について
ゲームのサンプルですが、Python版を試すとエラーが発生します。リーソースが見つかりませんというものです。エラーが発生しても継続することはできます。このエラーを回避するには、index.html内のonSilverlightError関数に以下を追加する必要があります。

  else if (errorType == "ImageError")
  {
      // ImageErrorを握り潰す
      return;
  }

これでリソースイメージエラーが発生しなくなります。

Silverlight Dynamic Language SDK の使い方1

shozoa — Sun, 19 Oct 2008 10:26:00 GMT

既にご案内したようにSilverlight 2.0に対応したDynamic Language SDKがリリースされています。Codeplexのサイトには、以下の5種類が公開されています。

sdlsdk-0.4.0(Everything)：バイナリ、サンプル、ソースが含まれています。
sdlsdk-0.4.0-bin：バイナリのみ。
sdlsdk-0.4.0-samples：サンプルのみ。
sdlsdk-0.4.0-src：ソースコードのみ。
sdlsdk-0.4.0-symblos：デバッグなどで使用するシンボル。

開発に利用するには、sdlsdk-0.4.0(Everything)がお勧めでしょう。このパッケージには以下のようなフォルダ構造が含まれています。

bin	chiron.exeや使用するdllが含まれます
samples	サンプルプログラム
script	起動用のスクリプトと開発用のテンプレート集(templatesフォルダ)
src	ソースコード(Managed JS除き)
ルート直下のファイル	Readmeとライセンス

テンプレート集を試すには、scriptフォルダでコマンドプロンプトを開いて、「server /b」を実行するとブラウザが開きます。templates/言語フォルダ/index.htmをブラウザで開くことで、テンプレート集で提供されているプログラムを動かすことができます。

　テンプレート集で提供されている構造は以下のようなものです。

javascriptフォルダ	error.js：Silverlightランタイムのエラー時に指定するonSilverlightError関数が定義されています。
言語フォルダ	app.言語拡張子、app.xaml：言語のコードサンプルと単純なXAML(GridとTextBlockだけ)が定義されています。
stylesheetsフォルダ	screen.css、error.css：error.cssはSilverlightランタイムのエラーなどを表示するスタイルシートで、フォントがCourier Newになっています。
index.html	Silverlightを起動する指定がobjectタグで記述されています。

このテンプレートを使ってカスタマイズして、動的言語を使ったSilverlight2 アプリを開発できるようになっています。

このテンプレートを使って開発するには、scriptフォルダにある「sl.bat」ファイルを使用するのが簡単です。sl.batの使い方は、scriptフォルダでコマンドプロンプトを開いて以下のようにコマンドを入力します。

　sl 言語アプリケーションフォルダ

言語には、「python」「ruby」「jscript」を指することができます(要は、templatesフォルダ内にある言語フォルダの名前です)。アプリケーションフォルダとは、開発するアプリケーションを格納するフォルダのことです。これで上記のコマンドを実行すると、templatesフォルダで提供されているテンプレート集を指定したアプリケーションフォルダにコピーしてくれます(xcopyです)。これで、必要なコードを記述していけばよいということになります。

提供されているサンプルを試す場合は、scriptフォルダでコマンドプロンプトを開いて以下のようにserver.batにオプションを付けて実行します。

server /d:..\samples /b

/dオプションで、開始するフォルダを指定しています。/bオプションは、ブラウザを開く指定です。後は、ブラウザを使って提供されているサンプル(jscript、python、ruby)のフォルダをナビゲートしてindex.htmlを開けば、サンプルプログラムが動作します。

次回は、実際の開発時の注意点などを含めてまとめていきます。

#この時点で試されるかたは、スクリプトファイルのエンコードをunicodeにするようにしてください。日本語を扱うには、エンコードがunicodeになっている必要があるからです。

Silverlight 2.0RTM 用のDynamic Language SDKが公開されました

shozoa — Thu, 16 Oct 2008 06:22:00 GMT

　Silverlight 2.0 RTM対応のDynamic Language SDKが、もうまもなく公開されるようです。JimmyさんのBlogで、リリースの案内が掲載されています。日本時間では、明日でしょうか。codeplexのサイトで公開されますので、今日・明日にでもUpされるのでしょう。
と書きながらチェックしたらUpされました。バージョンは、10月初めに公開された0.4.0のままです。

Dynamic Language SDK 0.4.0 が公開されています

shozoa — Fri, 03 Oct 2008 07:23:00 GMT

Silverlight2.0 RC0に対応したDynamic Language SDK 0.4.0が公開されています。

お知らせまで。

追伸:まだ、DLRの変更点とかまで調べきれていません。

DLR ベータ5 について

shozoa — Fri, 19 Sep 2008 11:46:00 GMT

IronPython 2.0ベータ5がリリースされてから、DLRにどのような変更が行われているかを調べてみました。一番、大きな変更はネームスペースの変更なのですが、ベータ4に対して以下のようになっています。

System.Scripting-> Microsoft.Scripting

Systemというネームスペースが廃止されて、元のMicrosoftというネームスペースに戻っています。それからScriptRuntimeクラスからCreateメソッドが廃止されて、コンストラクタがScriptRuntimeSetupクラスの引数を取るようになっています。この関係でWell Known Languageを指定するScriptRuntimeSetupクラスのコンストラクタからbool引数が廃止されています。この代わりにReadConfigurationメソッドが追加されています。この変更に伴ってScriptRuntimeクラスにもCreateFromConfigurationメソッドが追加されています。この追加されたメソッドを使用するには、app.configに以下の記述を行います。

<configuration>
  <configSections>
    <section name="microsoft.scripting"
        type="Microsoft.Scripting.Hosting.Configuration.Section,
              Microsoft.Scripting, Version=1.0.0.5000,
              Culture=neutral, PublicKeyToken=null"
              requirePermission="false" />
  </configSections>

  <microsoft.scripting>
    <languages>
      <language names="IronPython;Python;py"
                   extensions=".py"
                   displayName="IronPython 2.0 Beta"
                   type="IronPython.Runtime.PythonContext,
                   IronPython, Version=2.0.0.5000,
                   Culture=neutral, PublicKeyToken=null" />
    </languages>

    <options/>
  </microsoft.scripting>
</configuration>

languageタグに仕様使用する言語を記述しておくことで、ReadConfigurationやCreateFromConfigurationメソッドでScriptRuntimeSetupクラスをWell Known Languageで初期化することができます。IronRuby svn 148のソースツリーは、既にこの対応が行われていて、Python、Ruby、JScript、VB、ToyScriptのが記述されています(VBのリリース状況がどうかは不明です)。

それからObjectOperartions.GetMemberNamesメソッドは正常に動作するようにバグ対応が行われていました。また、Expressions.ExpressionクラスからCodeContextメソッドが削除され、Microsoft.Scripting.Ast.UtilsクラスにCodeContextメソッドが追加されています。細かな変更は他にもありますが、ホスティングする上では上記の内容程度で対応することができます。TechEdの独自言語サンプルなどのベータ5への移植は、それほど手間がかかりませんので、試される方は試してみてください。

DLR Console を使って時計をドラッグするサンプル

shozoa — Wed, 03 Sep 2008 11:49:00 GMT

前回のエントリで Silverlight Dynamic Language SDK 0.3.0がリリースされたと記載しました。このSDKで提供されているサンプルにDLR Consoleがあります。もっともDLR Consoleは、SDK 0.2.0(Silverlight 2.0 ベータ2と一緒に提供されたものです)で動作するようになっています。SDK 0.3.0に含まれているDLRを調べると、IronPythonのChangeset38029以降のもののようです。このためIronRubyプロジェクトで今日時点で公開されているSVN138よりも新しいDLRになります。このDLRでは、ホスティングAPIなどの細かな変更やネームスペースの変更が行われています。

SDK 0.3.0のDLR Consoleでは、時計をドラッグするというRuby用のスクリプトが含まれています。時計をドラッグするサンプルは、Jimmyさんのブログに解説がありビデオのリンクやDLR Consoleを試すリンクなどがあります(英語キーボードなのでご注意ください)。このサンプルを動かしているのが、以下の画像になります。

ここで入力しているコードを以下に記載します(Jimmyさんのブログには、一か所不足しているコードがありますので)。

require 'lib/clock'
$clock = Clock.show
require 'lib/drag'
Drag.new($clock.canvas).enable

これで私は上記のサンプルを動作させることができました。
ちなみに今日時点でIronPythonの最新のChangesetは38690がUpされています。

追伸:実はTechEdでこのデモをお見せしようとしたのですが、時間が足りなくて忘れてしまいました。Peer Talkで一部の方に受けていたのが、このサンプルです。

Dynamic Language SDK 0.3.0 がリリースされています

shozoa — Mon, 01 Sep 2008 11:09:00 GMT

Dynamic Language SDK のVer0.3.0がリリースされています。Dynamic Language SDKとは、DynamicSilverlight SDKと呼んでいたものの名称が変更されたものです。実行環境として、Silverlight 2.0 ベータ2が必要になります。ソースコードも公開されていまして、含まれているDLRのソースコードを見るとIronPython2.0 ベータ4よりも開発が進んだものになっています。含まれるバイナリには、IronRuby、IronPython、ManagedJScriptがあり、そのままでSilverlight2.0ベータ2環境で動作させることができます。

DLR B4 対応の MyCalc サンプルです

shozoa — Sat, 30 Aug 2008 16:14:00 GMT

TechEd 2008 Yokohamaでお話したようにDLRのホスティングのサンプルを公開します。今回は、1)MyCalc、2)Toolサンプルの2種類が含まれています。どちらもIronPython 2.0ベータ4のDLR対応ですので、DLRはIronPythonプロジェクトからダウンロードしてください。TechEdに参加して頂いた方には、事後になりますがカンファレンスDVDにも収録しますので、そちらを見ていただいても結構です。もっともDVDが届くのまで時間がかかりますので、早く知りたいという場合は、ここからダウンロードしてください。

それから当日にお話したと思いますが、IronPythonプロジェクトとIronRubyプロジェクトに含まれるDLRの状況を記載しておきます。

IronPython 2.0ベータ4に対応したIronRubyのソースを私は見つけていません。
IronPython Changeset37512とIronRuby SVN138のDLRは同期しています。
IronPython Chnageset38029のDLRは、37512から変更されていますのでご注意ください。

TechEdでお見せしたオブジェクト共有のデモの環境は、Silverlight2ベータ2とIronPython Chnageset37512、IronRuby SVN138です。それぞれのソースコードは、TechEd期間中にサブミットされた最新を使用しています。

本日はTechEdのセッション当日です

shozoa — Thu, 28 Aug 2008 02:20:00 GMT

何とか「.NETにおけるLightweight Language」のデモ準備が終わりました。最終的に利用するものは、Iron Ruby SVN 138とIronPython Changeset37512です。これにIronRuby アルファ、IronPython 2.0 ベータ4です。IronPythonのChangeset 38029が昨日にアップされていますが、含まれているDLRがIronRubyよりも新しくなっているために、Changeset37512にしました。これらのChangesetをビルドして試すと、ベータ5と名付ける予定だということがバージョン番号から理解できます。

Changeset38029では、LanguageContextクラスに変更が入っている模様なのですが、まだ詳細を調べきれていません。お時間のある方は調べてみてください。