Mustang development is proudly sponsored by Cubox, Agile Rails Devshop
Mustang - V8 engine in Ruby’s body
TheRubyRacer and PyV8 influence…
You can of course ask why we wrote library which seems to be very similar to TheRubyRacer… yeah it seems, but there are a lot of differences. Here is short comparison of TheRubyRacer and Mustang:
- Both are using similar integration with ruby’s garbage collector. Actually, Mustang’s code which handles that references is just improved version of TheRubyRacer’s code (check the ext/v8/v8_ref.cpp).
- Both are reflecting JS objects to ruby and vice-versa.
- Once reflected ruby object (and vice-versa) is always the same object in ruby world.
- All reflected V8 objects acts exacltly the same as ruby natives. For example you can deal with Mustang::V8::Array exactly the same as with native Ruby arrays (eg. they are comparable with ruby objects, etc).
- Functions are reflected more accurately. Ruby objects’ methods are represented properly.
- Classes are converted to V8 function templates, so you can deal with them as with prototypes.
- Different approach to deal with contexts, compiling JS scripts and exceptions handling.
- Support for regexp reflections.
- Way more friendly ruby api.
- A very thorough test suite (over 250 tests passing on all ruby versions)
- Clean codebase, less magic, fully documented.
- Lower memory usage.
And the most important, like i said before, Mustang is used as core element of our bigger idea, so it have to exactly fit to our needs.
Before you install mustang gem make sure you have
$ sudo apt-get install scons # on debian $ sudo pacman -S scons # on archlinux $ brew install scons # on mac...
$ gem install mustang
$ git clone git://github.com/nu7hatch/mustang.git $ cd mustang $ rake compile $ rake install
require 'mustang' cxt = ::.new cxt.eval("'Hello' + ' World!';") # => 'Hello World!' cxt.eval("var a=1;") cxt.eval("a+5;") # => 6 cxt[:puts] = method(:puts) cxt.eval("puts(a)") # displays "1" on the screen cxt[:a] # => 1
TODO: coming soon…
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don’t break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright (c) 2010 Kriss ‘nu7hatch’ Kowalik. See LICENSE for details.