Dump compiled iseq by binary (kakidasu) and load binary (yomidasu)
Switch branches/tags
Nothing to show
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin initial commit Dec 11, 2015
exe reorder require May 2, 2016
lib support YOMIKOMU_YOMIKOMANAI envval Feb 16, 2017
test fix tests Dec 12, 2015
.gitignore initial commit Dec 11, 2015
.travis.yml initial commit Dec 11, 2015
Gemfile initial commit Dec 11, 2015
LICENSE.txt initial commit Dec 11, 2015
README.md support YOMIKOMU_YOMIKOMANAI envval Feb 16, 2017
Rakefile initial commit Dec 11, 2015
yomikomu.gemspec 0.3.0 Apr 12, 2016



  • yomikomu gem enables to load compiled instruction sequences (bytecodes).
  • kakidasu command compiles and stores compiled instruction sequences (bytecodes).

This gem requires Ruby 2.3.0. Most of code is ported from ruby/sample/iseq_load.rb.


Add this line to your application's Gemfile:

gem 'yomikomu'

And then execute:

$ bundle

Or install it yourself as:

$ gem install yomikomu



You can use the following configuration with environment variables.

  • YOMIKOMU_STORAGE (default: fs): choose storage type.
    • 'fs' (default) stores binaries in the same directory (for examlple, x.rb will be compiled to x.rb.yarb in the same directory).
    • 'fs2' stores binaries in specific directory.
    • 'fsgz' stores files same as 'fs', but gz compressed.
    • 'fs2gz' stores files same as 'fs2', but gz compressed.
    • 'dbm' stores binaries using dbm
    • 'flatfile' stores binaries in one flat file. Updating is not supported. Use with YOMIKOMU_AUTO_COMPILE.
  • YOMIKOMU_STORAGE_DIR (default: "~/.ruby_binaries"): choose directory where binary files are stored.
  • YOMIKOMU_AUTO_COMPILE (default: false): if this value is true, then compile all required scripts implicitly.
  • YOMIKOMU_YOMIKOMANAI (default: not defined): disable all YOMIKOMU features.
  • YOMIKOMU_INFO (default: not defined): show some information.
  • YOMIKOMU_DEBUG (default: not defined): show many information.

Compile and store instruction sequences

You only need to use the following command.

$ kakidasu [file or dir] ...

Compile specified file or files (*.rb) in specified directory. If no files or directories are specified, then use "libdir" of installed Ruby.

Load compiled binary

You only need to require yomikomu.


After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.


Bug reports and pull requests are welcome on GitHub at https://github.com/ko1/yomikomu.


The gem is available as open source under the terms of the MIT License.