Skip to content
Lightweight Ruby
C Ruby Yacc C++ Batchfile Shell
Branch: master
Clone or download
matz Merge pull request #4831 from shuujii/always-enable-the-rational-and-…

Always enable the rational and complex literals
Latest commit 1bb1df1 Nov 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark [ci skip] Remove no meaning statement in `bm_app_lc_fizzbuzz.rb` Jan 23, 2019
doc Release `mruby 2.1.0`. Nov 19, 2019
examples Clear terminated space Sep 7, 2018
include Merge pull request #4831 from shuujii/always-enable-the-rational-and-… Nov 19, 2019
lib Defer getting `caller_dir` until needed in `MRuby::LoadGems#gem` Nov 10, 2019
mrbgems Always enable the rational and complex literals Nov 19, 2019
mrblib Merge pull request #4527 from lopopolo/string-each-line-paragraph-mode Sep 12, 2019
oss-fuzz Merge pull request #4445 from bshastry/modifiy-ossfuzz-fork-config May 17, 2019
src Refactor `mrb_string_value_cstr` Nov 18, 2019
tasks Remove unused code to old Visual Studio in `tasks/toolchains/visualcp… Oct 4, 2019
test Squeeze redundant spaces in `test/t/numeric.rb` [ci skip] Oct 25, 2019
.gitignore Remove unneeded `/src/` in `.gitignore` Aug 29, 2019
.gitlab-ci.yml Gitlab tests for multiple configurations Feb 16, 2017
.travis.yml Refactor .travis.yml to remove duplicated env: MRUBY_CONFIG. Oct 5, 2018
.yardopts Rename `MITL` to `LICENSE` in `.yardopts`; ref 67728c1 [ci skip] Mar 12, 2019
AUTHORS Fix typo in `AUTHORS` [ci skip] Mar 12, 2019 Refine documentation for C99 compliance; ref #4685 [ci skip] Sep 10, 2019
Doxyfile Update version to `2.1.0`. (mruby 2.1.0 RC) Oct 18, 2019
LEGAL Rename `MITL` to `LICENSE` to conform GitHub convention. Mar 11, 2019
LICENSE Rename `MITL` to `LICENSE` to conform GitHub convention. Mar 11, 2019
Makefile change doc directory and reduce warnings Aug 25, 2019
NEWS add document Apr 20, 2012 Update version to `2.1.0`. (mruby 2.1.0 RC) Oct 18, 2019
Rakefile Require `Regexp.escape` before interpolating `build_dir`; fix #4817 Nov 11, 2019
TODO Remove things we've done in `TODO` file. Dec 20, 2018
appveyor.yml Use Rake instead of MiniRake on AppVeyor Mar 18, 2019
appveyor_config.rb Do not overwrite ``. May 15, 2019
build_config.rb Use mruby-onig-regexp instead in example Aug 20, 2019
minirake Improve MiniRake rule enhancement for Rake compatibility Aug 7, 2019
mruby-source.gemspec Switch gem API to constants only Sep 6, 2015
travis_config.rb Fix warnings for invalid C++ option with `enable_cxx_abi`; ref #3618, #… Sep 13, 2019

Build Status

What is mruby

mruby is the lightweight implementation of the Ruby language complying to (part of) the ISO standard. Its syntax is Ruby 2.x compatible.

mruby can be linked and embedded within your application. We provide the interpreter program "mruby" and the interactive mruby shell "mirb" as examples. You can also compile Ruby programs into compiled byte code using the mruby compiler "mrbc". All those tools reside in the "bin" directory. "mrbc" is also able to generate compiled byte code in a C source file, see the "mrbtest" program under the "test" directory for an example.

This achievement was sponsored by the Regional Innovation Creation R&D Programs of the Ministry of Economy, Trade and Industry of Japan.

How to get mruby

The stable version 2.1.0 of mruby can be downloaded via the following URL:

The latest development version of mruby can be downloaded via the following URL:

The trunk of the mruby source tree can be checked out with the following command:

$ git clone

You can also install and compile mruby using ruby-install, ruby-build or rvm.

mruby home-page

The URL of the mruby home-page is:

Mailing list

We don't have a mailing list, but you can use GitHub issues.

How to compile and install (mruby and gems)

See the file.

Running Tests

To run the tests, execute the following from the project's root directory.

$ make test


$ ruby ./minirake test

Building documentation

There are two sets of documentation in mruby: the mruby API (generated by yard) and C API (Doxygen)

To build both of them, simply go

rake doc

You can also view them in your browser

rake view_api
rake view_capi

How to customize mruby (mrbgems)

mruby contains a package manager called mrbgems. To create extensions in C and/or Ruby you should create a GEM. For a documentation of how to use mrbgems consult the file For example code of how to use mrbgems look into the folder examples/mrbgems/.


mruby is released under the MIT License.

Note for License

mruby has chosen a MIT License due to its permissive license allowing developers to target various environments such as embedded systems. However, the license requires the display of the copyright notice and license information in manuals for instance. Doing so for big projects can be complicated or troublesome. This is why mruby has decided to display "mruby developers" as the copyright name to make it simple conventionally. In the future, mruby might ask you to distribute your new code (that you will commit,) under the MIT License as a member of "mruby developers" but contributors will keep their copyright. (We did not intend for contributors to transfer or waive their copyrights, Actual copyright holder name (contributors) will be listed in the AUTHORS file.)

Please ask us if you want to distribute your code under another license.

How to Contribute

See the contribution guidelines, and then send a pull request to We consider you have granted non-exclusive right to your contributed code under MIT license. If you want to be named as one of mruby developers, please include an update to the AUTHORS file in your pull request.

You can’t perform that action at this time.