Contents

Opal: Ruby compiler/runtime for the browser
=============================================

### NOTE: opal has been renamed from vienna. Vienna is now just a code name for the build tools

Opal is the runtime/standard lib for ruby in the browser.

Installing
-----------

    # Insall gem from gemcutter/rubygems
    sudo gem install opal

Trying out
----------
To make a test project, use the following command where project_name is the name of the project to use.

    # make the project
    opal new project_name
    # jump into the project
    cd project_name

The project also creates a Rakefile with an 'opal' task. Run this task, and then opal will continuously watch your ruby file for changes, and then recompile it everytime you change the code.

    rake opal

Open index.html in the browser to run the project.

Next steps
----------

Opal has many of the libraries built. Check out the documentation (more coming soon), ask me questions on freenode (adambeynon): usually in #ruby, #ruby-lang, #javascript etc, or email me: [e-mail].

Command line tools / v8
-----------------------

I am playing with experimental support for therubyracer. Essentially, this gem allows you to embed the v8 javascript engine into ruby applications. Vienna has support for this allowing, firstly, a REPL system for trying out commands, but more importantly/interestingly, can run an entire opal application through the engine. The compilation step is not necessary as ruby files are compiled as they are required. For now, all specs are by default run through this system. Node, *nix (unix/linux) only, no windows support for opal command line.

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
opal-0.2.2	opals/opal/README.md
opal-0.2.0	opals/opal/README.md