opal 0.11.4 → 1.0.0.beta1

data/CONTRIBUTING.md

@@ -1,12 +1,10 @@
 # Contributing and Reporting
 
 This is the issue tracker for Opal. If you have a more general question about
-using Opal (or related libraries) then use the [stackoverflow tag (#opalrb)][SO], the
-[#opal][freenode] irc channel on *FreeNode*, or the *Gitter* chatroom at [opal/opal][gitter]
+using Opal (or related libraries) then use the [stackoverflow tag (#opalrb)][SO], or the *Gitter* chatroom at [opal/opal][gitter]
 (also available as IRC at `irc.gitter.im`).
 
 [SO]: http://stackoverflow.com/questions/ask?tags=opalrb
-[freenode]: http://webchat.freenode.net/?channels=opal
 [gitter]: https://gitter.im/opal/opal
 
 What follows is a quick checklist you can before sending issues or pull-requests, for in-depth instructions on how to hack the internals of Opal and setup the development environment please see [`HACKING.md`][hacking].
@@ -35,10 +33,10 @@ What follows is a quick checklist you can before sending issues or pull-requests
 
 3.  Make sure to have updated all the relevant documentation, both for API (using _yardoc_ syntax) and the Guides
 
-4.  Add a Changelog entry at the top of `CHANGELOG.md`
+4.  Add a Changelog entry at the top of `UNRELEASED.md`
 
 
-### A note on commits in PR
+### A note on commits in PRs
 
 You could be asked to squash your commits during a PR review. That doesn't mean there's a preference for a single commit for each PR, rather it's a request to have each commit focused on a specific group changes and avoid the sequence of changes, fixups and reverts that tell an interesting story but in the end make the use of `git blame` quite difficult.
 

data/Gemfile

@@ -9,25 +9,26 @@ tilt_version      = ENV['TILT_VERSION']
 rack_version      = ENV['RACK_VERSION']
 sprockets_version = ENV['SPROCKETS_VERSION']
 
-# Stick with older racc until
-# https://github.com/tenderlove/racc/issues/22
-# is solved.
-gem 'racc', '< 1.4.10', platform: :jruby
 gem 'json', '< 1.8.1',  platform: :ruby if ruby_version < v['2.2']
-gem 'rack-test', '< 1.0' if ruby_version < v['2.2.2']
+gem 'rack-test', '< 0.8' if ruby_version <= v['2.0']
 gem 'rubysl', platform: :rbx
 gem 'coveralls', platform: :mri
 
-gem 'puma' # Some browsers have problems with WEBrick
-
-gem 'rack',      rack_version      if rack_version
-gem 'tilt',      tilt_version      if tilt_version
+# Some browsers have problems with WEBrick
+gem 'puma' unless RUBY_ENGINE == 'truffleruby'
 
+gem 'rack', rack_version if rack_version
+gem 'tilt', tilt_version if tilt_version
 gem 'sprockets', sprockets_version if sprockets_version
-gem 'mspec', path: 'spec/mspec'
 
 group :repl do
-  gem 'therubyracer', platform: :mri, require: false
+  if RUBY_VERSION.to_f >= 2.3
+    gem 'mini_racer', platform: :mri, require: false
+  else
+    gem 'mini_racer', '< 0.2.0', platform: :mri, require: false
+    gem 'libv8', '~> 6.3.0', platform: :mri, require: false
+  end
+
   gem 'therubyrhino', platform: :jruby, require: false
 end
 
@@ -46,5 +47,9 @@ group :development do
 end unless ENV['CI']
 
 group :doc do
-  gem 'redcarpet'
+  gem 'redcarpet' unless RUBY_ENGINE == 'truffleruby'
+end
+
+platforms :ruby, :mswin, :mswin64, :mingw, :x64_mingw do
+  gem 'c_lexer', '2.5.3.0.0' unless RUBY_ENGINE == 'truffleruby'
 end

data/Guardfile

@@ -49,7 +49,6 @@ class ::Guard::Opal < Plugin
     path = m[0]
     puts color("Searching specs for #{m[0]}...", :yellow)
     case path
-    when %r{grammar\.y$}  then system 'rake racc'
     when %r{^spec/lib}     then rspec path
     when %r{^spec/ruby} then mspec path
     when %r{^opal/corelib}

data/HACKING.md

@@ -195,38 +195,4 @@ Array#permutation_generates_from_a_defensive_copy,_ignoring_mutations
 
 ## Parser
 
-## Enabling debug output from Racc
-
-To enable debug output in the Racc grammar set the `RACC_DEBUG` env var and recompile the grammar. While the env variable is set the parser will output the debug info for the parsing process.
-
-```bash
-$ export RACC_DEBUG=true
-$ bundle exec rake racc               # recompile the grammar
-$ bundle exec exe/opal --sexp -e "42" # ask Opal for the SExp of some code
-
-read    :tINTEGER(tINTEGER) [42, [1, 0]]
-
-shift   tINTEGER
-        [ (tINTEGER [42, [1, 0]]) ]
-
-…cut…
-
-shift   $end
-        [ (program (:int, 42)) ($end [false, [1, 2]]) ($end [false, [1, 2]]) ]
-
-goto    403
-        [ 0 1 97 403 ]
-
-accept
-
-(:int, 42)
-```
-
-When done unset the env variable and recompile the grammar.
-
-```bash
-$ unset RACC_DEBUG
-$ bundle exec rake racc               # recompile the grammar
-$ bundle exec exe/opal --sexp -e "42" # ask Opal for the SExp of some code
-(:int, 42)
-```
+Opal relies on the `parser` gem, see debug/development documentation there to know more about its internals: https://whitequark.github.io/parser/.

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (C) 2013 by Adam Beynon
+Copyright (C) 2013-2019 by Adam Beynon and the Opal contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -16,4 +16,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE.

data/README.md

@@ -1,25 +1,27 @@
 # Opal
 
-[![Build Status (Linux)](http://img.shields.io/travis/opal/opal/master.svg?style=flat)](http://travis-ci.org/opal/opal)
+[![Build Status (Linux)](https://img.shields.io/travis/opal/opal/master.svg?style=flat)](https://travis-ci.org/opal/opal)
 [![Build Status (Windows)](https://ci.appveyor.com/api/projects/status/jtsvwl8tfgn3u67n/branch/master?svg=true)](https://ci.appveyor.com/project/elia/opal/branch/master)
-[![Gem Version](http://img.shields.io/gem/v/opal.svg?style=flat)](http://badge.fury.io/rb/opal)
-[![Code Climate](http://img.shields.io/codeclimate/github/opal/opal.svg?style=flat)](https://codeclimate.com/github/opal/opal)
+[![Gem Version](https://img.shields.io/gem/v/opal.svg?style=flat)](https://badge.fury.io/rb/opal)
+[![Code Climate](https://img.shields.io/codeclimate/github/opal/opal.svg?style=flat)](https://codeclimate.com/github/opal/opal)
 [![Coverage Status](https://coveralls.io/repos/opal/opal/badge.svg?branch=master&service=github)](https://coveralls.io/github/opal/opal?branch=elia%2Fcoveralls)
 
 
 Opal is a Ruby to JavaScript source-to-source compiler. It also has an
 implementation of the Ruby corelib.
 
-Opal is [hosted on GitHub](http://github.com/opal/opal). Chat is available on *Gitter* at [opal/opal](https://gitter.im/opal/opal) (also available as IRC at `irc.gitter.im`) and the Freenode IRC channel at [#opal](http://webchat.freenode.net/?channels=opal).
-Ask questions on [stackoverflow (tag #opalrb)](http://stackoverflow.com/questions/ask?tags=opalrb). Get the [Opalist newsletter](http://opalist.co) for updates and community news.
+Opal is [hosted on GitHub](https://github.com/opal/opal). Chat is available on *Gitter* at [opal/opal](https://gitter.im/opal/opal) (also available as IRC at `irc.gitter.im`).
+Ask questions on [stackoverflow (tag #opalrb)](https://stackoverflow.com/questions/ask?tags=opalrb). Get the [Opalist newsletter](http://opalist.co) for updates and community news.
 
-[![Inline docs](http://inch-ci.org/github/opal/opal.svg?branch=master&style=flat)](http://opalrb.com/docs)
+[![Inline docs](https://inch-ci.org/github/opal/opal.svg?branch=master&style=flat)](https://opalrb.com/docs)
 [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/opal/opal?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
-[![Stack Overflow](http://img.shields.io/badge/stackoverflow-%23opalrb-orange.svg?style=flat)](http://stackoverflow.com/questions/ask?tags=opalrb)
+[![Stack Overflow](https://img.shields.io/badge/stackoverflow-%23opalrb-orange.svg?style=flat)](https://stackoverflow.com/questions/ask?tags=opalrb)
+[![Backers on Open Collective](https://opencollective.com/opal/backers/badge.svg)](#backers) 
+[![Sponsors on Open Collective](https://opencollective.com/opal/sponsors/badge.svg)](#sponsors) 
 
 ## Usage
 
-See the website for more detailed instructions and guides for Rails, jQuery, Sinatra, rack, CDN, etc. [http://opalrb.com](http://opalrb.com).
+See the website for more detailed instructions and guides for Rails, jQuery, Sinatra, rack, CDN, etc. [https://opalrb.com](https://opalrb.com).
 
 ### Compiling Ruby code with the CLI (Command Line Interface)
 
@@ -102,9 +104,8 @@ your web applications.
 <html>
   <head>
     <meta charset="utf-8">
-    <script src="http://cdn.opalrb.com/opal/current/opal.js"></script>
-    <script src="http://cdn.opalrb.com/opal/current/opal-parser.js"></script>
-    <script type="text/javascript">Opal.load('opal-parser')</script>
+    <script src="https://cdn.opalrb.com/opal/current/opal.js" onload="Opal.load('opal')"></script>
+    <script src="https://cdn.opalrb.com/opal/current/opal-parser.js" onload="Opal.load('opal-parser')"></script>
 
     <script type="text/ruby">
       puts "hi"
@@ -204,13 +205,41 @@ version of a browser is 24.x, we support the 24.x and 23.x versions.
 as the last 2 versions of Opera. For example, if the current Opera version is 20.x,
 then we support Opera 12.1x, 19.x and 20.x but not Opera 15.x through 18.x.
 
-Cross-browser testing is sponsored by [SauceLabs](http://saucelabs.com).
+Cross-browser testing is sponsored by [SauceLabs](https://saucelabs.com).
+
+## Contributors
+
+This project exists thanks to all the people who contribute. [![contributors](https://opencollective.com/opal/contributors.svg?width=890&button=false")](https://github.com/opal/opal/graphs/contributors)
+
+
+## Backers
+
+Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/opal#backer)]
+
+<a href="https://opencollective.com/opal#backers" target="_blank"><img src="https://opencollective.com/opal/backers.svg?width=890"></a>
+
+
+## Sponsors
+
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/opal#sponsor)]
+
+<a href="https://opencollective.com/opal/sponsor/0/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/0/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/1/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/1/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/2/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/2/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/3/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/3/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/4/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/4/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/5/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/5/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/6/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/6/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/7/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/7/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/8/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/8/avatar.svg"></a>
+<a href="https://opencollective.com/opal/sponsor/9/website" target="_blank"><img src="https://opencollective.com/opal/sponsor/9/avatar.svg"></a>
+
 
 ## License
 
 (The MIT License)
 
-Copyright (C) 2013-2015 by Adam Beynon
+Copyright (C) 2013-2019 by Adam Beynon and the Opal contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/Rakefile

@@ -1,14 +1,11 @@
 # FIXME: there must be a better way
 Encoding.default_external = 'utf-8'
 
-require 'bundler'
-Bundler.require
-Bundler::GemHelper.install_tasks
-
 import 'tasks/github.rake'
 import 'tasks/testing.rake'
 import 'tasks/building.rake'
 import 'tasks/linting.rake'
 import 'tasks/benchmarking.rake'
+import 'tasks/releasing.rake'
 
 task :default => [:rspec, :mspec, :minitest]

data/UNRELEASED.md

@@ -0,0 +1,133 @@
+<!--
+Whitespace conventions:
+- 4 spaces before ## titles
+- 2 spaces before ### titles
+- 1 spaces before normal text
+-->
+
+### Added
+
+- Added `Module#prepend` and completely overhauled the module and class inheritance system (#1826)
+- Methods and properties are now assigned with `Object.defineProperty()` as non-enumerable (#1821)
+- Backtrace now includes the location inside the source file for syntax errors (#1814)
+- Added support for a faster C-implemented lexer, it's enough to add `gem 'c_lexer` to the `Gemfile` (#1806)
+- Added `Date#to_n` that returns the JavaScript Date object (in native.rb). (#1779, #1792)
+- Added `Array#pack` (supports only `C, S, L, Q, c, s, l, q, A, a` formats). (#1723)
+- Added `String#unpack` (supports only `C, S, L, Q, S>, L>, Q>, c, s, l, q, n, N, v, V, U, w, A, a, Z, B, b, H, h, u, M, m` formats). (#1723)
+- Added `File#symlink?` for Node.js. (#1725)
+- Added `Dir#glob` for Node.js (does not support flags). (#1727)
+- Added support for a static folder in the "server" CLI runner via the `OPAL_CLI_RUNNERS_SERVER_STATIC_FOLDER` env var
+- Added the CLI option `--runner-options` that allows passing arbitrary options to the selected runner, currently the only runner making use of them is `server` accepting `port` and `static_folder`
+- Added a short helper to navigate constants manually: E.g. `Opal.$$.Regexp.$$.IGNORECASE` (see docs for "Compiled Ruby")
+- Added initial support for OpenURI module (using XMLHttpRequest on browser and [xmlhttprequest](https://www.npmjs.com/package/xmlhttprequest) on Node). (#1735)
+- Added `String#prepend` to the list of unsupported methods (because String are immutable in JavaScript)
+- Added methods (most introduced in 2.4/2.5):
+    * `Array#prepend` (#1757)
+    * `Array#append` (#1757)
+    * `Array#max` (#1757)
+    * `Array#min` (#1757)
+    * `Complex#finite?` (#1757)
+    * `Complex#infinite?` (#1757)
+    * `Complex#infinite?` (#1757)
+    * `Date#to_time` (#1757)
+    * `Date#next_year` (#1885)
+    * `Date#prev_year` (#1885)
+    * `Hash#slice` (#1757)
+    * `Hash#transform_keys` (#1757)
+    * `Hash#transform_keys!` (#1757)
+    * `Numeric#finite?` (#1757)
+    * `Numeric#infinite?` (#1757)
+    * `Numeric#infinite?` (#1757)
+    * `Integer#allbits?` (#1757)
+    * `Integer#anybits?` (#1757)
+    * `Integer#digits` (#1757)
+    * `Integer#nobits?` (#1757)
+    * `Integer#pow` (#1757)
+    * `Integer#remainder` (#1757)
+    * `Integer.sqrt` (#1757)
+    * `Random.urandom` (#1757)
+    * `String#delete_prefix` (#1757)
+    * `String#delete_suffix` (#1757)
+    * `String#casecmp?` (#1757)
+    * `Kernel#yield_self` (#1757)
+    * `String#unpack1` (#1757)
+	* `String#to_r` (#1842)
+	* `String#to_c` (#1842)
+	* `String#match?` (#1842)
+	* `String#unicode_normalize` returns self (#1842)
+	* `String#unicode_normalized?` returns true (#1842)
+	* `String#[]=` throws `NotImplementedError`(#1836)
+
+- Added support of the `pattern` argument for `Enumerable#all?`, `Enumerable#any?`, `Enumerable#none?`. (#1757)
+- Added `ndigits` option support to `Number#floor`, `Number#ceil`, `Number#truncate`. (#1757)
+- Added `key` and `receiver` attributes to the `KeyError`. (#1757)
+- Extended `Struct.new` to support `keyword_init` option. (#1757)
+- Added a new `Opal::Config.missing_require_severity` option and relative `--missing-require` CLI flag. This option will command how the builder will behave when a required file is missing. Previously the behavior was undefined and partly controlled by `dynamic_require_severity`. Not to be confused with the runtime config option `Opal.config.missing_require_severity;` which controls the runtime behavior.
+- Added `Matrix` (along with the internal MRI utility `E2MM`)
+- Use shorter helpers for constant lookups, `$$` for relative (nesting) lookups and `$$$` for absolute (qualified) lookups
+- Add support for the Mersenne Twister random generator, the same used by CRuby/MRI (#657 & #1891)
+- [Nodejs] Added support for binary data in `OpenURI` (#1911, #1920)
+- [Nodejs] Added support for binary data in `File#read` (#1919, #1921)
+- [Nodejs] Added support for `File#readlines` (#1882)
+- [Nodejs] Added support for `ENV#[]`, `ENV#[]=`, `ENV#key?`, `ENV#has_key?`, `ENV#include?`, `ENV#member?`, `ENV#empty?`, `ENV#keys`, `ENV#delete` and `ENV#to_s` (#1928)
+
+
+### Changed
+
+- **BREAKING** The dot (`.`) character is no longer replaced with [\s\S] in a multiline regexp passed to Regexp#match and Regexp#match? (#1796, #1795)
+  * You're advised to always use [\s\S] instead of . in a multiline regexp, which is portable between Ruby and JavaScript
+- **BREAKING** `Kernel#format` (and `sprintf` alias) are now in a dedicated module `corelib/kernel/format` and available exclusively in `opal` (#1930)
+  * Previously the methods were part of the `corelib/kernel` module and available in both `opal` and `opal/mini`
+- Filename extensions are no longer stripped from filenames internally, resulting in better error reporting (#1804)
+- The internal API for CLI runners has changed, now it's just a callable object
+- The `--map` CLI option now works only in conjunction with `--compile` (or `--runner compiler`)
+- The `node` CLI runner now adds its `NODE_PATH` entry instead of replacing the ENV var altogether
+- Added `--disable-web-security` option flag to the Chrome headless runner to be able to do `XMLHttpRequest`
+- Migrated parser to 2.5. Bump RUBY_VERSION to 2.5.0.
+- Exceptions raised during the compilation now add to the backtrace the current location of the opal file if available (#1814).
+- Better use of `displayName` on functions and methods and more readable temp variable names (#1910)
+- Source-maps are now inlined and already contain sources, incredibly more stable and precise (#1856)
+
+
+### Deprecated
+
+- The CLI `--server-port 1234` option is now deprecated in favor of using `--runner-options='{"port": 1234}'`
+- Including `::Native` is now deprecated because it generates conflicts with core classes in constant lookups (both `Native::Object` and `Native::Array` exist). Instead `Native::Werapper` should be used.
+- Using `node_require 'my_module'` to access the native `require()` function in Node.js is deprecated in favor of <code>\`require('my_module')\`</code> because static builders need to parse the call in order to function (#1886).
+
+
+### Removed
+
+- The `node` CLI runner no longer supports passing extra node options via the `NODE_OPT` env var, instead Node.js natively supports the `NODE_OPTIONS` env var.
+- The gem "hike" is no longer an external dependency and is now an internal dependency available as `Opal::Hike` (#1881)
+- Removed the internal Opal class `Marshal::BinaryString` (#1914)
+- Removed Racc, as it's now replaced by the parser gem (#1880)
+
+
+
+### Fixed
+
+- Fix handling of trailing semicolons and JavaScript returns inside x-strings, the behavior is now well defined and covered by proper specs (#1776)
+- Fixed singleton method definition to return method name. (#1757)
+- Allow passing number of months to `Date#next_month` and `Date#prev_month`. (#1757)
+- Fixed `pattern` argument handling for `Enumerable#grep` and `Enumerable#grep_v`. (#1757)
+- Raise `ArgumentError` instead of `TypeError` from `Numeric#step` when step is not a number. (#1757)
+- At run-time `LoadError` wasn't being raised even with `Opal.config.missing_require_severity;` set to `'error'`.
+- Fixed `Kernel#public_methods` to return instance methods if the argument is set to false. (#1848)
+- Fixed an issue in `String#gsub` that made it start an infinite loop when used recursively. (#1879)
+- `Kernel#exit` was using status 0 when a number or a generic object was provided, now accepts numbers and tries to convert objects with `#to_int` (#1898, #1808).
+- Fixed metaclass inheritance in subclasses of Module (#1901)
+- `Method#to_proc` now correctly sets parameters and arity on the resulting Proc (#1903)
+- Fixed bridged classes having their prototype removed from the original chain by separating them from the Ruby class (#1909)
+- Improve `String#to_proc` performance (#1888)
+- Fixed/updated the examples (#1887)
+- `Opal.ancestors()` now returns false for when provided with JS-falsy objects (#1839)
+- When subclassing now the constant is set before calling `::inherited` (#1838)
+- `String#to_sym` now returns the string literal (#1835)
+- `String#center` now correctly checks length (#1833)
+- `redo` inside `while` now works properly (#1820)
+- Fixed compilation of empty/whitespace-only x-strings (#1811)
+- Fix `||=` assignments on constants when the constant is not yet defined (#1935)
+- Fix `String#chomp` to return an empty String when `arg == self` (#1936)
+- Fix methods of `Comparable` when `<=>` does not return Numeric (#1945)
+- Fix Class#native_alias error message (#1946)

data/benchmark-ips/README.md

@@ -0,0 +1,6 @@
+Usage:
+
+    bundle exec rake bench:ips
+    bundle exec rake bench:ips FILE=benchmark-ips/bm_while_true_vs_loop.rb
+
+For details see `tasks/benchmarking.rake`

data/benchmark-ips/bm_block_vs_yield.rb

@@ -0,0 +1,21 @@
+module BmBlockVsYield
+  def self._block(&block)
+    block.call
+  end
+
+  def self._yield
+    yield
+  end
+end
+
+Benchmark.ips do |x|
+  x.report('block') do
+    BmBlockVsYield._block { 1+1 }
+  end
+
+  x.report('yield') do
+    BmBlockVsYield._yield { 1+1 }
+  end
+
+  x.compare!
+end

data/benchmark-ips/bm_js_symbols_vs_strings.rb

@@ -0,0 +1,28 @@
+Benchmark.ips do |x|
+  %x{
+    var o = {}
+    o[Symbol.for('foo')] = 123
+    o.foo = 123
+    var foo = Symbol('foo')
+    o[foo] = 123
+    var a = 0, b = 0, c = 0
+  }
+
+  x.report('global symbol') do
+    `a += o[Symbol.for('foo')]`
+  end
+
+  x.report('symbol') do
+    `a += o[foo]`
+  end
+
+  x.report('ident') do
+    `b += o.foo`
+  end
+
+  x.report('string') do
+    `c += o['foo']`
+  end
+
+  x.compare!
+end

data/benchmark-ips/bm_while_true_vs_loop.rb

@@ -0,0 +1,19 @@
+Benchmark.ips do |x|
+  x.report('while true') do
+    n = 0
+    while true
+      n += 1
+      break if n == 10000
+    end
+  end
+
+  x.report('loop') do
+    n = 0
+    loop do
+      n += 1
+      break if n == 10000
+    end
+  end
+
+  x.compare!
+end