ここでの動作環境は次のとおり。

インストールにはRubyGemsを用いるのが便利だ。ターミナル上で、次の1文をタイプする。

% sudo gem install coffee-script
	
Successfully installed coffee-script-0.2.3
1 gem installed
Installing ri documentation for coffee-script-0.2.3...
Installing RDoc documentation for coffee-script-0.2.3...

% rehash
% coffee

coffee compiles CoffeeScript source files into JavaScript.

Usage:
  coffee path/to/script.coffee
    -i, --interactive                run a CoffeeScript REPL (requires Narwhal)
    -r, --run                        compile and run a script (requires Narwhal)
    -o, --output [DIR]               set the directory for compiled JavaScript
    -w, --watch                      watch scripts for changes, and recompile
    -p, --print                      print the compiled JavaScript to stdout
    -l, --lint                       pipe the compiled JavaScript through JSLint
    -e, --eval                       compile a cli scriptlet or read from stdin
    -t, --tokens                     print the tokens that the lexer produces
    -v, --verbose                    print at every step of code generation
    -n, --no-wrap                    raw output, no function safety wrapper
    -g, --globals                    attach all top-level variable as globals
        --install-bundle             install the CoffeeScript TextMate bundle
        --version                    display CoffeeScript version
    -h, --help                       display this help message

「sudo gem install coffee-script」でcoffee-scriptをインストール。完了後、実際にcoffeeコマンドを実行する。

実際にコンパイルをおこなうときは、coffeeコマンドにファイル名を渡してやればよい。用意されているcoffeeコマンドの引数と利用例は次のとおりだ。

引数 内容
-i, --interactive 対話型評価環境でCoffeeScriptを起動する。要Narwhal
-r, --run コンパイル後、スクリプトを実行する。要Narwhal
-o --output コンパイル結果のJavaScriptファイル出力先を指定
-w, --watch スクリプトの変更を監視し、リコンパイルする
-p, --print コンパイル結果のJavaScriptファイルを標準出力
-l, --lint コンパイル結果のJavaScriptファイルをjslコマンドで評価。要JavaScript Lint
-e, --eval 引数として渡されたCoffeeScript、または標準入力の内容をコンパイルして表示
-t, --tokens トークンを表示
-v, --verbose コード生成までのステップを表示
-n, --no-wrap コンパイル結果を(function(){ })();でくくらない
--install-bundle CoffeeScript TextMate bundleをインストール
--version CoffeeScriptのバージョンを表示
-h, --help ヘルプメッセージを表示
コマンド例 内容
% coffee path/to/script.coffee path/to/script.coffeeをコンパイル
% coffee --interactive 対話型評価環境でCoffeeScriptを起動する
% coffee --watch --lint experimental.coffee experimental.coffeeのコンパイル結果をjslコマンドで評価/監視
% coffee --print app/scripts/*.coffee app/scriptsディレクトリ以下の全coffeeファイルコンパイル結果を標準出力

--interactiveと--runにはNarwhalが、--lintにはJavaScript Lintが別途必要だ。これらのオプションを使用する場合はあらかじめ準備しておこう。なおNarwhalの使い方については「サーバサイドJavaScriptライブラリ「Narwhal」を使ってみよう」や「サーバサイドJavaScriptライブラリ「Narwhal」のAPIを知る」に詳しくまとめられているので、あわせて参照されたい。

つづいてCoffeeScriptの言語リファレンスについて調べてみよう。