Community

10 new features in Ruby 2.5

This is a guest post by Junichi Ito (@jnchito). Junichi is a Ruby programmer at SonicGarden.jp, translator of Everyday Rails Testing with RSpec, and one of the most popular Ruby writers/bloggers in Japan

Ruby 2.5.0-preview1 was released on October 10 2017. It introduces lots of new features and performance improvements. I have handpicked 10 new features to go over. I hope this article will help you understand some of the coming changes available in Ruby 2.5!

rescue/else/ensure are allowed inside do/end blocks without begin/end

You can write rescue/else/ensure clauses without begin/end keyword within do/end blocks:

[1].each do |n|
  n / 0
rescue
  # rescue
else
  # else
ensure
  # ensure
end

But you’ll get an error if you use {} blocks:

[1].each { |n|
  n / 0
rescue
  # rescue
else
  # else
ensure
  # ensure
}
#=> SyntaxError: (irb):3: syntax error, unexpected keyword_rescue, expecting '}'
#     rescue
#     ^~~~~~

Top-level constant lookup is removed

In Ruby 2.4, the following code works with a warning:

class Staff; end
class ItemsController; end

Staff::ItemsController
#=> warning: toplevel constant ItemsController referenced by Staff::ItemsController
#=> ItemsController

This is because the top-level constants are defined under Object class, and Ruby tries to look up the superclass of Staff class, and eventually finds ItemsController under the Object class which is a superclass of Staff class. The details were discussed here:

But in Ruby 2.5, Ruby won’t look up superclass. So the previous code fails with error:

Staff::ItemsController
#=> NameError: uninitialized constant Staff::ItemsController
#   Did you mean?  ItemsController

Bundler gem is now bundled

This change is postponed due to a big issue. Please see also:
https://github.com/ruby/ruby/commit/7825e8363d4b2ccad8e2d3f5eeba9e26f6656911

Bundler is bundled as a standard library. So you can use it without `gem install bundler`!

Print backtrace and error message in reverse order (experimental)

In Ruby 2.5, backtrace and error message are printed in reverse order. For example, in Ruby 2.4:

$ ruby ./test/error_example.rb
./test/error_example.rb:7:in `/': divided by 0 (ZeroDivisionError)
    from ./test/error_example.rb:7:in `method_2'
    from ./test/error_example.rb:2:in `method_1'
    from ./test/error_example.rb:10:in `'

In Ruby 2.5:

$ ruby ./test/error_example.rb
Traceback (most recent call last):
        3: from ./test/error_example.rb:10:in `'
        2: from ./test/error_example.rb:2:in `method_1'
        1: from ./test/error_example.rb:7:in `method_2'
./test/error_example.rb:7:in `/': divided by 0 (ZeroDivisionError)

As of preview1, this is an experimental feature and applied only when STDERR is unchanged and a tty.

Kernel#yield_self

Kernel#yield_self is introduced. This method takes a receiver as a block argument and returns a block value as it is:

2.yield_self { |n| n * 10 } #=> 20

names = ['Alice', 'Bob']
names.join(', ').yield_self { |s| "(#{s})" } #=> "(Alice, Bob)"

String#delete_prefix/delete_suffix

String#delete_prefix/delete_suffix can remove prefix and suffix from a string:

'invisible'.delete_prefix('in') #=> "visible"
'pink'.delete_prefix('in') #=> "pink"

'worked'.delete_suffix('ed') #=> "work"
'medical'.delete_suffix('ed') #=> "medical"

Array#prepend/append as aliases of unshift/push

Array#prepend/append are added as aliases of unshift/push methods:

array = [3, 4]
array.prepend(1, 2) #=> [1, 2, 3, 4]
array               #=> [1, 2, 3, 4]

array = [1, 2]
array.append(3, 4)  #=> [1, 2, 3, 4]
array               #=> [1, 2, 3, 4]

Hash#transform_keys/transform_keys!

Hash#transform_keys can change keys according to the return value of a block:

hash = { a: 1, b: 2 }
hash.transform_keys { |k| k.to_s }
#=> { 'a' => 1, 'b' => 2 }

`transform_keys!` is a destructive version:

hash = { a: 1, b: 2 }
hash.transform_keys! { |k| k.to_s }
#=> { 'a' => 1, 'b' => 2 }

hash
#=> { 'a' => 1, 'b' => 2 }

Dir.children/each_child

You might have used Dir.entries method:

Dir.entries('./test/dir_a')
#=> [".", "..", "code_a.rb", "text_a.txt"]

If you want to remove “.” and “..” from the returned values, you can Dir.children instead:

Dir.children('./test/dir_a')
#=> ['code_a.rb', 'text_a.txt']

Dir.each_child returns not an array but an Enumerator object:

Dir.each_child('./test/dir_a')
#=> #<Enumerator: Dir:each_child(\"./test/dir_a\")>"

Dir.each_child('./test/dir_a').to_a
#=> ['code_a.rb', 'text_a.txt']

ERB#result_with_hash

The following code shows how to assign local variables to ERB template in Ruby 2.4:

require 'erb'
require 'ostruct'

namespace = OpenStruct.new(a: 2, b: 3)
template = 'Result: <%= a * b %>'
ERB.new(template).result(namespace.instance_eval { binding }) #=> "Result: 6"

But in Ruby 2.5, you can rewrite with ERB#result_with_hash like this:

require 'erb'

template = 'Result: <%= a * b %>'
ERB.new(template).result_with_hash(a: 2, b: 3) #=> "Result: 6"

Other changes

You can find other changes on the Ruby 2.5 NEWS page: NEWS for Ruby 2.5.0

Love Ruby 2.5!

image description