Ruby IcedCoffeeScript

Ruby IcedCoffeeScript is a bridge to the official CoffeeScript compiler.

IcedCoffeeScript.compile File.read("script.coffee")

Installation

gem install iced-coffee-script

Note: This compiler library has replaced the original CoffeeScript compiler that was written in Ruby.

Dependencies

This library depends on the coffee-script-source gem which is updated any time a new version of CoffeeScript is released. (The iced-coffee-script-source gem's version number is synced with each official IcedCoffeeScript release.) This way you can build against different versions of IcedCoffeeScript by requiring the correct version of the iced-coffee-script-source gem.

In addition, you can use this library with unreleased versions of CoffeeScript by setting the COFFEESCRIPT_SOURCE_PATH environment variable:

export COFFEESCRIPT_SOURCE_PATH=/path/to/coffee-script/extras/coffee-script.js

JSON

The json library is also required but is not explicitly stated as a gem dependency. If you're on Ruby 1.8 you'll need to install the json or json_pure gem. On Ruby 1.9, json is included in the standard library.

ExecJS

The ExecJS library is used to automatically choose the best JavaScript engine for your platform. Check out its README for a complete list of supported engines.