Ruby-LLVM is a Ruby language binding to the LLVM compiler infrastructure library. LLVM allows users to create just-in-time (JIT) compilers, ahead-of-time (AOT) compilers for multiple architectures, code analyzers and more. LLVM bindings can also be used to speed up Ruby code by compiling and loading computationally intensive algorithms on the fly.
- LLVM 3.2, including libLLVM-3.2 (compile LLVM with --enable-shared).
- In order to ensure the usability of JIT features (i.e. create_jit_compiler), compile LLVM with --enable-jit as well.
The first two digits of ruby-llvm's version number refer to the required major and minor version of LLVM. The third digit refers to the ruby-llvm release itself. Because LLVM's api changes often, this coupling between LLVM and ruby-llvm versions is useful.
LLVM can be installed with Homebrew by executing brew install llvm --shared
Caveats:
LLVM 3.2 ships with an unresolved bug in which its version string is "3.2svn" rather than "3.2". Some package maintainers have patched the version string before building LLVM. The Homebrew maintainers, however, have decided not to maintain a patch set (see this thread.) Unfortunately, the bug breaks ruby-llvm's FFI bindings.
A patched formula for LLVM has been created by thoughtpolice. This formula is unsupported, but if you would like to give it a shot, use the following command.
brew install https://raw.github.com/ruby-llvm/ruby-llvm/master/misc/homebrew/llvm.rb --shared --with-clang
- The LLVM project
- ffi-gen – Generate FFI bindings with LLVM and Clang
Ruby-LLVM is available under the BSD 3-clause (see LICENSE), Copyright (c) 2010-2013 Jeremy Voorhis
Ruby-LLVM is possible because of its contributors:
- Evan Phoenix
- David Holroyd
- Takanori Ishikawa
- Ronaldo M. Ferraz
- Mac Malone
- Chris Wailes
- Ary Borenszweig
- Richard Musiol
- Juan Wajnerman
- Steven Farlie
- Peter Zotov
- Austin Seipp
- Torsten Rüger
- Nathaniel Barnes