Skip to content
This repository

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.

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 ext
Octocat-spinner-32 framework committing experimental branch content March 11, 2009
Octocat-spinner-32 icu-1060
Octocat-spinner-32 include
Octocat-spinner-32 lib
Octocat-spinner-32 misc
Octocat-spinner-32 mspec
Octocat-spinner-32 perf add perf_string.rb to do benchmark of string March 01, 2012
Octocat-spinner-32 rakelib
Octocat-spinner-32 sample-macruby
Octocat-spinner-32 sample committing experimental branch content March 11, 2009
Octocat-spinner-32 spec
Octocat-spinner-32 test-macruby Remove references to hotcocoa from the MacRuby sources April 14, 2011
Octocat-spinner-32 test-mri
Octocat-spinner-32 test_vm implemented rb_provided() and rb_feature_provided(). these come from … September 19, 2011
Octocat-spinner-32 tool removed rb_nibtool.old March 21, 2011
Octocat-spinner-32 .document
Octocat-spinner-32 .gitignore
Octocat-spinner-32 BSDL
Octocat-spinner-32 COPYING update to new ruby license October 17, 2011
Octocat-spinner-32 ChangeLog.markdown
Octocat-spinner-32 GPL committing experimental branch content March 11, 2009
Octocat-spinner-32 HACKING.rdoc
Octocat-spinner-32 LEGAL
Octocat-spinner-32 LGPL committing experimental branch content March 11, 2009
Octocat-spinner-32 MacRuby.m
Octocat-spinner-32 MacRubyDebuggerConnector.h
Octocat-spinner-32 MacRubyDebuggerConnector.m
Octocat-spinner-32 NSArray.m
Octocat-spinner-32 NSDictionary.m
Octocat-spinner-32 NSString.m
Octocat-spinner-32 README.rdoc Note in the README that you can make installation less noisy February 21, 2012
Octocat-spinner-32 Rakefile
Octocat-spinner-32 TODO Remove instruby.rb now that porting is complete January 19, 2012
Octocat-spinner-32 array.c
Octocat-spinner-32 array.h
Octocat-spinner-32 auto_zone_1060.h Fix auto_zone header for SL May 25, 2010
Octocat-spinner-32 b.rb now compile some of the VM primitives into bitcode that will be added… May 24, 2010
Octocat-spinner-32 bignum.c
Octocat-spinner-32 bridgesupport.cpp
Octocat-spinner-32 bridgesupport.h
Octocat-spinner-32 bs.c
Octocat-spinner-32 bs.h
Octocat-spinner-32 bs_lex.h fixed compilation on Leopard August 11, 2009
Octocat-spinner-32 bs_struct_readers.c statically generate the struct reader methods, 128 seems necessary at… April 23, 2009
Octocat-spinner-32 class.c
Octocat-spinner-32 class.h
Octocat-spinner-32 compar.c
Octocat-spinner-32 compiler.cpp
Octocat-spinner-32 compiler.h
Octocat-spinner-32 complex.c
Octocat-spinner-32 cont.c include/ruby/macruby.h -> macruby_internal.h January 08, 2011
Octocat-spinner-32 debugger.cpp
Octocat-spinner-32 debugger.h
Octocat-spinner-32 dir.c
Octocat-spinner-32 dispatcher.cpp
Octocat-spinner-32 distruby.rb committing experimental branch content March 11, 2009
Octocat-spinner-32 dln.c
Octocat-spinner-32 dln.h .rbo files are now initialized using a gcc constructor instead of an … September 26, 2009
Octocat-spinner-32 dmydln.c committing experimental branch content March 11, 2009
Octocat-spinner-32 dmyencoding.c committing experimental branch content March 11, 2009
Octocat-spinner-32 dmyext.c committing experimental branch content March 11, 2009
Octocat-spinner-32 dmytranscode.c committing experimental branch content March 11, 2009
Octocat-spinner-32 dtrace.d removed the insn__entry and insn__return probes now that yarv is gone October 09, 2009
Octocat-spinner-32 encoding.c
Octocat-spinner-32 encoding.h
Octocat-spinner-32 encoding_ucnv.h
Octocat-spinner-32 enum.c
Octocat-spinner-32 enumerator.c
Octocat-spinner-32 env.c
Octocat-spinner-32 error.c
Octocat-spinner-32 eval.c
Octocat-spinner-32 eval_error.c
Octocat-spinner-32 eval_jump.c
Octocat-spinner-32 eval_safe.c
Octocat-spinner-32 exported_symbols_list
Octocat-spinner-32 file.c
Octocat-spinner-32 gc-stub.m
Octocat-spinner-32 gc.c
Octocat-spinner-32 gcd.c
Octocat-spinner-32 gcd.h
Octocat-spinner-32 gem_prelude.rb
Octocat-spinner-32 gen_bs_struct_readers.rb statically generate the struct reader methods, 128 seems necessary at… April 23, 2009
Octocat-spinner-32 golf_prelude.rb committing experimental branch content March 11, 2009
Octocat-spinner-32 hash.c
Octocat-spinner-32 hash.h
Octocat-spinner-32 id.c
Octocat-spinner-32 id.h
Octocat-spinner-32 inits.c
Octocat-spinner-32 interpreter.cpp
Octocat-spinner-32 interpreter.h
Octocat-spinner-32 io.c
Octocat-spinner-32 irb.1 Add "See Also" sections May 21, 2010
Octocat-spinner-32 kernel.c
Octocat-spinner-32 keywords committing experimental branch content March 11, 2009
Octocat-spinner-32 lex.c.blt committing experimental branch content March 11, 2009
Octocat-spinner-32 lex.c.src committing experimental branch content March 11, 2009
Octocat-spinner-32 lgamma_r.c committing experimental branch content March 11, 2009
Octocat-spinner-32 llvm.h now depend on revision 127367 of branch LLVM 2.9 March 11, 2011
Octocat-spinner-32 load.c
Octocat-spinner-32 macruby_internal.h
Octocat-spinner-32 main.cpp
Octocat-spinner-32 markgc.c update copyrights to 2011 January 15, 2011
Octocat-spinner-32 marshal.c
Octocat-spinner-32 math.c
Octocat-spinner-32 mt.c integrate Mersenne Twister based random number generator from 1.9 ups… February 13, 2010
Octocat-spinner-32 numeric.c
Octocat-spinner-32 objc.h
Octocat-spinner-32 objc.m
Octocat-spinner-32 object.c
Octocat-spinner-32 pack.c
Octocat-spinner-32 parse.y
Octocat-spinner-32 prec.c
Octocat-spinner-32 proc.c
Octocat-spinner-32 process.c
Octocat-spinner-32 random.c
Octocat-spinner-32 range.c
Octocat-spinner-32 rational.c
Octocat-spinner-32 re.c
Octocat-spinner-32 re.h
Octocat-spinner-32 ruby.1 committing experimental branch content March 11, 2009
Octocat-spinner-32 ruby.c
Octocat-spinner-32 ruby_deploy.1 cover new --gem and --bs options February 10, 2011
Octocat-spinner-32 rubyc.1 Added some linker options to rubyc August 27, 2010
Octocat-spinner-32 rubyd.1 Add "See Also" sections May 21, 2010
Octocat-spinner-32 rubytest.rb committing experimental branch content March 11, 2009
Octocat-spinner-32 runruby.rb committing experimental branch content March 11, 2009
Octocat-spinner-32 sandbox.c
Octocat-spinner-32 signal.c
Octocat-spinner-32 sprintf.c
Octocat-spinner-32 st.c fix incorrect using of GC_WB() January 04, 2012
Octocat-spinner-32 string.c
Octocat-spinner-32 struct.c
Octocat-spinner-32 symbol.c
Octocat-spinner-32 symbol.h
Octocat-spinner-32 test_vm.rb supported show known problems. April 12, 2011
Octocat-spinner-32 thread.c
Octocat-spinner-32 time.c
Octocat-spinner-32 transcode.c
Octocat-spinner-32 ucnv.c
Octocat-spinner-32 util.c made static to get rid of name clash January 18, 2012
Octocat-spinner-32 variable.c
Octocat-spinner-32 version.c
Octocat-spinner-32 version.h
Octocat-spinner-32 vm.cpp
Octocat-spinner-32 vm.h
Octocat-spinner-32 vm_eval.c
Octocat-spinner-32 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 the MacRuby team 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 64-bit machine. PowerPC and Intel 32-bit machines are not supported anymore, but may still work.

  • Mac OS X 10.6 or later.

  • LLVM ToT, compiled for x86_64.

    LLVM is a moving target and breaks periodically. We recommend to install revision 127367 of branch 2.9, being sure to specify the correct C and C++ compilers through environment variables.

    $ svn co https://llvm.org/svn/llvm-project/llvm/branches/release_29@127367 llvm-2.9
    $ cd llvm-2.9
    $ env CC=/usr/bin/gcc CXX=/usr/bin/g++ ./configure --enable-bindings=none --enable-optimized --with-llvmgccdir=/tmp
    $ env CC=/usr/bin/gcc CXX=/usr/bin/g++ make
    $ sudo env CC=/usr/bin/gcc CXX=/usr/bin/g++ 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:

    $ env CC=/usr/bin/gcc CXX=/usr/bin/g++ make -j2

    If you would prefer to update an existing LLVM Subversion working copy you need to be careful to remove any previous build files before you compile:

    $ svn status --no-ignore | awk '{print $2}' | xargs rm -rf
    $ svn revert -R .
    $ svn switch <repository-URL>

Note for using Xcode 4.3 (or later)

If you use the Xcode 4.3 (or later), you might need to configure Xcode path before installing MacRuby:

$ sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer/

Build Instructions

You can build MacRuby by doing the following command:

$ rake

Or, as with LLVM, you can specify the amount of jobs to run simultaneously:

$ rake jobs=2

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 # --quiet

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

Contribute

Once you've made your great commits:

  1. Fork MacRuby

  2. Create a topic branch - git checkout -b my_branch

  3. Push to your branch - git push origin my_branch

  4. Create a pull request: github.com/USERNAME/MacRuby/pull/new/master

  5. That's it!

Something went wrong with that request. Please try again.