A native implementation of CoffeeScript [1] that runs on the Rubinius VM [2].

  1. Whence comes the name Poetics?

  2. Poetics is a partial anagram of the word CoffeeScript. It is also a nod to Jeremy Ashkenas, the author of CoffeeScript, and his interest in code as literature.

  3. Why a native implementation?

  4. CoffeeScript is an interesting language in its own right. Rather than merely being a syntax layer on top of Javascript, and bound to expressing its semantics in those of Javascript, it deserves its own implementation. Many of the reasons to use CoffeeScript in Node.js would also apply to using this native implementation.

Installation

First, install Rubinius:

1. Using RVM (http://rvm.beginrescueend.com).

  rvm install rbx

2. Or directly (http://rubini.us/doc/en/what-is-rubinius/).

Second, install Poetics:

rbx -S gem install poetics

Running Poetics

Poetics provides a REPL for exploratory programming or runs CoffeeScript scripts.

rbx -S poetics -h

The REPL presently just parses code and returns an S-Expression representation:

$ rbx -S poetics
> 42
[:number, 42.0, 1, 1]
> "hello, y'all"
[:string, "hello, y'all", 1, 1]
>

Getting Help

Poetics is a work in progress. If you encounter trouble, please file an issue at github.com/brixen/poetics/issues

Contributing

If you find Poetics interesting and would like to help out, fork the project on Github and submit a pull request.

People

Poetics was created by Brian Ford (brixen) to force him to really learn Javascript and CoffeeScript.

<add your name here>

License

Poetics is MIT licensed. See the LICENSE file.

Credits

Jeremy has created an very interesting language in CoffeeScript. This implementation steals bits and pieces from other projects:

Rubinius (github.com/evanphx/rubinius/) KPeg (github.com/evanphx/kpeg/) Atomy (github.com/vito/atomy/) Poison (github.com/brixen/poison/) Talon (github.com/evanphx/talon/)

1

CoffeeScript (jashkenas.github.com/coffee-script/)

2

Rubinius (rubini.us)