mruby

mruby library bindings for Crystal. Currently only unsafe, generated bindings. Very much a work-in-progress.

Installation

0. Install llvm and any dependencies required for mruby on your platform

• On macOS, brew install llvm will install the required dependencies (Xcode LLVM may work fine on more recent macOS versions.)

1. Add the dependency to your shard.yml:

   dependencies:
     mruby:
       github: maxfierke/mruby.cr

2. Run shards install

3. Run cd lib/mruby && make to generate the lib binding. (May want to do this in your Makefile or other build configuration)

Usage

require "mruby"

mrb = LibMRuby.mrb_open
code = "5.times { puts 'mruby is awesome!' }"
LibMRuby.mrb_load_string(mrb, code)
LibMRuby.mrb_close(mrb)

See src/lib_mruby.cr once generated to view exposed methods (currently only those from mruby.h and mruby/compile.h)

Development

• Follow Installation step 0 to get the required libraries installed.
  • If you're on macOS, ensure gnu-sed is installed. (e.g. brew install gnu-sed)
• Run make to generate the lib bindings
• Run make spec to run the tests

Contributing

1. Fork it (https://github.com/maxfierke/mruby.cr/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• Max Fierke - creator and maintainer