Introduction
This project brings mruby to the browser. It uses [emscripten]
(https://github.com/kripken/emscripten) to compile the mruby source code into
JavaScript and runs in the browser.
Build Status
Since emscripten SDK does not provide pre-built binaries for Linux, we cannot use Travis CI right now. We want to be nice and don't try to rebuild whole LLVM each time we are pushing new code :)
How to Install
Webruby now depends on emsdk to provide emscripten and LLVM infrustructure. To install webruby, following the following steps:
- Install emsdk following instructions at here
- Install latest incoming version of emscripten sdk(right now webruby still depends on code from incoming branch of emscripten, once this goes into a release version, we will lock the version for better stability)
- Activate latest incoming version
- Webruby should be able to pick up the correct version of emscripten from emsdk. If not, feel free to create an issue :)
Notes
Thanks to @scalone and @sadasant, webruby is already used in production: http://rubykaigi.org/2014/presentation/S-ThiagoScalone-DanielRodriguez
However, you might still want to give it a full test before using it in production :)
Demos
- webruby irb - A nice-looking full-fledged webruby irb. Thanks to @joshnuss for his work!
- Webruby tutorial - minimal example of webruby project, a full description is at here
- mruby - This is only a minimal demo of web irb, if you want to try out mruby in a browser, I strongly suggest the demo above.
- geometries - a WebGL example using webruby, mruby-js and three.js. NOTE: from a practical point of view, I agree that this can be easily implemented using JS. However, this demo shows how easy it is to interact with the JavaScript environment using Ruby.
License
This project is distributed under the MIT License. See LICENSE for further details.