Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
MacRuby is an implementation of Ruby 1.9 directly on top of Mac OS X core technologies such as the Objective-C runtime and garbage collector, the LLVM compiler infrastructure and the Foundation and ICU frameworks.
Ruby C C++ Objective-C Emacs Lisp Shell

This branch is even with MacRuby:tags/0.5b1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
benchmark
bin
data/hotcocoa_template
ext
framework
include
lib
misc
mspec
onig
rakelib
sample-macruby
sample
spec
test-macruby
test/libs
test_vm
tool
.cvsignore
.document
.gitignore
COPYING
GPL
HACKING.rdoc
LEGAL
LGPL
MacRuby.m
README.rdoc
Rakefile
TODO
array.c
b.rb
bench.rb
bignum.c
bridgesupport.cpp
bridgesupport.h
bs.c
bs.h
bs_lex.h
bs_struct_readers.c
class.c
compar.c
compiler.cpp
compiler.h
complex.c
cont.c
dir.c
dispatcher.cpp
distruby.rb
dln.c
dln.h
dmydln.c
dmyencoding.c
dmyext.c
dmytranscode.c
dtrace.d
encoding.c
enum.c
enumerator.c
error.c
eval.c
eval_error.c
eval_jump.c
eval_safe.c
file.c
gc-stub.m
gc.c
gcd.c
gem_prelude.rb
gen_bs_struct_readers.rb
golf_prelude.rb
hash.c
id.c
id.h
inits.c
instruby.rb
io.c
keywords
lex.c.blt
lex.c.src
lgamma_r.c
llvm.h
load.c
main.cpp
markgc.c
marshal.c
math.c
numeric.c
objc.h
objc.m
object.c
pack.c
parse.y
prec.c
prelude.rb
proc.c
process.c
random.c
range.c
rational.c
re.c
ruby.1
ruby.c
rubytest.rb
runruby.rb
set.c
signal.c
sprintf.cpp
st.c
string.c
struct.c
test_vm.rb
thread.c
thread_pthread.h
time.c
transcode.c
transcode_data.h
util.c
variable.c
version.c
version.h
vm.cpp
vm.h
vm_eval.c
vm_method.c

README.rdoc

MacRuby

MacRuby is a Ruby implementation based on Mac OS X technologies, such as the Objective-C runtime and garbage collector, the CoreFoundation framework and the LLVM compiler infrastructure.

It is the goal of MacRuby to enable the creation of full-fledged Mac OS X applications which do not sacrifice performance in order to enjoy the benefits of using Ruby.

MacRuby is copyrighted free software by Apple Inc and covered by the terms of the Ruby license. Please refer to the COPYING file for more information.

The project website contains more documentation, such as tutorials and guides: macruby.org

Requirements

  • An Intel machine. PowerPC machines are not supported anymore, but may still work. An Intel 64-bit machine (Intel Core Duo 2) is recommended.

  • Mac OS X 10.5.6 or later.

  • LLVM ToT, compiled for both i386 and x86_64.

    LLVM is a moving target and breaks periodically. We recommend to install revision 82747.

    $ svn co -r 82747 https://llvm.org/svn/llvm-project/llvm/trunk llvm-trunk
    $ cd llvm-trunk
    $ ./configure
    $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make
    $ sudo env UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make install

    Note that compiling LLVM can take quite a while. If you have a machine with multiple cores, which is quite likely, you might want to speed up the process by using all/more cores. However, doing this can make your machine unresponsive during compilation. To use multiple cores pass the `-j N' option, where `N' stands for the number of cores you'd like to use. So for a Core Duo the command would look like:

    $ UNIVERSAL=1 UNIVERSAL_ARCH="i386 x86_64" ENABLE_OPTIMIZED=1 make -j2

Build Instructions

You can build MacRuby by doing the following command:

$ rake

Once done, you can run the RubySpec-based regression tests as well as the performance suite:

$ rake spec:ci
$ rake bench:ci

To install MacRuby on your machine:

$ sudo rake install

Then you should be all set! Please report us any problem you will find (the macruby.org website has pointers). Thanks!

Something went wrong with that request. Please try again.