159
votes

Continuing the "Hidden features of ..." meme, let's share the lesser-known but useful features of Ruby programming language.

Try to limit this discussion with core Ruby, without any Ruby on Rails stuff.

See also:

(Please, just one hidden feature per answer.)

Thank you

1
  • should be community wiki Dec 4, 2009 at 13:02

46 Answers 46

80
votes

From Ruby 1.9 Proc#=== is an alias to Proc#call, which means Proc objects can be used in case statements like so:

def multiple_of(factor)
  Proc.new{|product| product.modulo(factor).zero?}
end

case number
  when multiple_of(3)
    puts "Multiple of 3"
  when multiple_of(7)
    puts "Multiple of 7"
end
1
  • 1
    I actually wrote an gem at one point to do this, but my code was (a) a mess, and (b) slow. I'm very glad that the functionality has made it into core. Dec 14, 2009 at 13:47
76
votes

Peter Cooper has a good list of Ruby tricks. Perhaps my favorite of his is allowing both single items and collections to be enumerated. (That is, treat a non-collection object as a collection containing just that object.) It looks like this:

[*items].each do |item|
  # ...
end
4
  • 38
    A more explicit (and thus nicer) form of this is Array(items).each
    – mislav
    Dec 13, 2009 at 19:49
  • If items is a string you don't have to enclose it with [*…]. String.each doesn't iterate over characters as some may expect. It just returns itself to the block.
    – mxcl
    Feb 17, 2010 at 13:49
  • What use would this ever serve? Just curious.
    – Ed S.
    Oct 1, 2010 at 0:19
  • 1
    @Ed: it's nice if you're writing a method and want to allow the user of the method to either pass a varargs list or an Array. Oct 2, 2010 at 4:26
63
votes

Don't know how hidden this is, but I've found it useful when needing to make a Hash out of a one-dimensional array:

fruit = ["apple","red","banana","yellow"]
=> ["apple", "red", "banana", "yellow"]

Hash[*fruit]    
=> {"apple"=>"red", "banana"=>"yellow"}
1
  • Note that Hash[ [["apple","red"], ["banana","yellow"] ] produces the same result. Dec 8, 2011 at 18:44
54
votes

One trick I like is to use the splat (*) expander on objects other than Arrays. Here's an example on a regular expression match:

match, text, number = *"Something 981".match(/([A-z]*) ([0-9]*)/)

Other examples include:

a, b, c = *('A'..'Z')

Job = Struct.new(:name, :occupation)
tom = Job.new("Tom", "Developer")
name, occupation = *tom
5
  • 13
    Incidentally, for the curious, this works by implicitly calling to_a on the target of the splat.
    – Bob Aman
    Jun 22, 2009 at 11:43
  • 1
    If you're not interested in the match, you can have text, number = *"text 555".match(/regexp/)[1..-1]. Jan 11, 2010 at 0:39
  • text, number = "Something 981".scan(/([A-z]*) ([0-9]*)/).flatten.map{|m| Integer(m) rescue m} Jan 20, 2010 at 10:22
  • 7
    Both good tricks, but there's got to be a point where it's too much magic, right?!
    – tomafro
    Jan 22, 2010 at 13:45
  • 1
    @Andrew, did you consider, that match can return nil? nil does not have method []
    – Alexey
    Jun 20, 2011 at 19:15
51
votes

Wow, no one mentioned the flip flop operator:

1.upto(100) do |i|
  puts i if (i == 3)..(i == 15)
end
4
  • 11
    Right... someone's gonna have to explain this one to me. It works, but I can't figure out why.
    – Bob Aman
    Jun 16, 2010 at 15:35
  • 12
    The flip flop operator is a statefull if. Its state switches to true as soon as i == 3 and switches to false after i != 3 and i == 15. Similar to a flip-flop: en.wikipedia.org/wiki/Flip-flop_%28electronics%29 Jun 16, 2010 at 15:55
  • 1
    I wouldn’t exactly call this a hidden feature, so much of an annoyance. I remember the first time I was introduced to it in #Ruby on Freenode, years ago; I’ve used basically every single feature of Ruby at some point except this one. Sep 11, 2011 at 21:24
  • 1
    I wouldn't call it an annoyance, it's just something you haven't used. I use it and it can reduce code nicely, especially when I am grabbing blocks of lines from files based on some criteria. Dec 8, 2011 at 20:01
49
votes

One of the cool things about ruby is that you can call methods and run code in places other languages would frown upon, such as in method or class definitions.

For instance, to create a class that has an unknown superclass until run time, i.e. is random, you could do the following:

class RandomSubclass < [Array, Hash, String, Fixnum, Float, TrueClass].sample

end

RandomSubclass.superclass # could output one of 6 different classes.

This uses the 1.9 Array#sample method (in 1.8.7-only, see Array#choice), and the example is pretty contrived but you can see the power here.

Another cool example is the ability to put default parameter values that are non fixed (like other languages often demand):

def do_something_at(something, at = Time.now)
   # ...
end

Of course the problem with the first example is that it is evaluated at definition time, not call time. So, once a superclass has been chosen, it stays that superclass for the remainder of the program.

However, in the second example, each time you call do_something_at, the at variable will be the time that the method was called (well, very very close to it)

5
  • 2
    Note: Array#rand is provided by ActiveSupport which you can use outside of Rails as easily as require 'activesupport'
    – rfunduk
    Jun 22, 2009 at 14:27
  • 24
    Array#choice is 1.8.7 only! Don't use it, it's gone in 1.9 and will be gone in 1.8.8. Use #sample Dec 4, 2009 at 14:59
  • python: class DictList([dict,list][random.randint(0,1)]): pass Feb 20, 2010 at 7:42
  • def do_something_at(something, at = lambda{Time.now}) at.call #now dynamically assign time end Nov 17, 2010 at 16:41
  • You can also call methods on the object you're calling the method on in the default parameter list.
    – Martin T.
    Feb 7, 2012 at 9:35
47
votes

Another tiny feature - convert a Fixnum into any base up to 36:

>> 1234567890.to_s(2)
=> "1001001100101100000001011010010"

>> 1234567890.to_s(8)
=> "11145401322"

>> 1234567890.to_s(16)
=> "499602d2"

>> 1234567890.to_s(24)
=> "6b1230i"

>> 1234567890.to_s(36)
=> "kf12oi"

And as Huw Walters has commented, converting the other way is just as simple:

>> "kf12oi".to_i(36)
=> 1234567890
1
  • 1
    And for completeness, String#to_s(base) can be used to convert back to an integer; "1001001100101100000001011010010".to_i(2), "499602d2".to_i(16) etc all return the original Fixnum. Jun 24, 2011 at 11:58
40
votes

Hashes with default values! An array in this case.

parties = Hash.new {|hash, key| hash[key] = [] }
parties["Summer party"]
# => []

parties["Summer party"] << "Joe"
parties["Other party"] << "Jane"

Very useful in metaprogramming.

1
  • 1
    yeah true. Ruby hash can accept '<<' operator if there's already default value assign with '=' (don't care even if it's empty assignment) otherwise the hash wont accept '<<'. CMIIW
    – mhd
    Jul 27, 2010 at 7:19
38
votes

Another fun addition in 1.9 Proc functionality is Proc#curry which allows you to turn a Proc accepting n arguments into one accepting n-1. Here it is combined with the Proc#=== tip I mentioned above:

it_is_day_of_week = lambda{ |day_of_week, date| date.wday == day_of_week }
it_is_saturday = it_is_day_of_week.curry[6]
it_is_sunday = it_is_day_of_week.curry[0]

case Time.now
when it_is_saturday
  puts "Saturday!"
when it_is_sunday
  puts "Sunday!"
else
  puts "Not the weekend"
end
0
37
votes

Download Ruby 1.9 source, and issue make golf, then you can do things like this:

make golf

./goruby -e 'h'
# => Hello, world!

./goruby -e 'p St'
# => StandardError

./goruby -e 'p 1.tf'
# => 1.0

./goruby19 -e 'p Fil.exp(".")'
"/home/manveru/pkgbuilds/ruby-svn/src/trunk"

Read the golf_prelude.c for more neat things hiding away.

35
votes

Boolean operators on non boolean values.

&& and ||

Both return the value of the last expression evaluated.

Which is why the ||= will update the variable with the value returned expression on the right side if the variable is undefined. This is not explicitly documented, but common knowledge.

However the &&= isn't quite so widely known about.

string &&= string + "suffix"

is equivalent to

if string
  string = string + "suffix"
end

It's very handy for destructive operations that should not proceed if the variable is undefined.

1
  • 2
    More precisely, string &&= string + "suffix" is equivalent to string = string && string + "suffix". That && and || return their second argument is discussed in the PickAx, p. 154 (Part I - Facets of Ruby, Expressions, Conditional Execution). Jan 7, 2012 at 23:14
29
votes

The Symbol#to_proc function that Rails provides is really cool.

Instead of

Employee.collect { |emp| emp.name }

You can write:

Employee.collect(&:name)
5
  • This is, apparently, an "order of magnitude slower" than using a block. igvita.com/2008/07/08/6-optimization-tips-for-ruby-mri Sep 20, 2008 at 15:51
  • I just tried it out, and found there was no significant difference between the two. I'm not sure where this "order of magnitude" stuff came from. (Using Ruby 1.8.7) Apr 13, 2009 at 19:54
  • 1
    Doing this outside of Rails is also handy and can be done with require 'activesupport' since that's actually where most of these helpers are from.
    – rfunduk
    Jun 22, 2009 at 14:23
  • 8
    this used to be slow because of active_support's implemenetation, i.e. it accepted multiple arguments so you could do cool shit like (1..10).inject &:*, but the main use case was often only calling a method on each member of a collection e.g. %w(the quick brown fox).map &:upcase. as of 1.8.7 it's core ruby and performance is reasonable. May 26, 2010 at 8:32
  • 4
    @thenduks: And it can be done without activesupport's help in ruby 1.8.7 and 1.9. Sep 30, 2010 at 23:56
28
votes

One final one - in ruby you can use any character you want to delimit strings. Take the following code:

message = "My message"
contrived_example = "<div id=\"contrived\">#{message}</div>"

If you don't want to escape the double-quotes within the string, you can simply use a different delimiter:

contrived_example = %{<div id="contrived-example">#{message}</div>}
contrived_example = %[<div id="contrived-example">#{message}</div>]

As well as avoiding having to escape delimiters, you can use these delimiters for nicer multiline strings:

sql = %{
    SELECT strings 
    FROM complicated_table
    WHERE complicated_condition = '1'
}
2
  • 19
    not any character, but it's still pretty cool. It also works with other literals: %() / %{} / %[] / %<> / %|| %r() / %r{} / %r[] / %r<> / %r|| %w() / %w{} / %w[] / %w<> / %w||
    – Bo Jeanes
    Mar 1, 2010 at 11:05
  • There's also the herenow doc syntax: <<BLOCK ... BLOCK , which I like to use for things like multiline SQL statements etc.
    – Martin T.
    Feb 7, 2012 at 9:38
26
votes

Use a Range object as an infinite lazy list:

Inf = 1.0 / 0

(1..Inf).take(5) #=> [1, 2, 3, 4, 5]

More info here: http://banisterfiend.wordpress.com/2009/10/02/wtf-infinite-ranges-in-ruby/

2
  • The lazy_select in the linked article is very neat. Aug 25, 2011 at 2:21
  • This is really awesome. I like how Infinity is a float, that way when I tried this: (-Inf..Inf).take(4) it raised a (logically consistent) can't iterate from float error. :D
    – zachaysan
    Aug 30, 2011 at 21:36
25
votes

I find using the define_method command to dynamically generate methods to be quite interesting and not as well known. For example:

((0..9).each do |n|
    define_method "press_#{n}" do
      @number = @number.to_i * 10 + n
    end
  end

The above code uses the 'define_method' command to dynamically create the methods "press1" through "press9." Rather then typing all 10 methods which essentailly contain the same code, the define method command is used to generate these methods on the fly as needed.

1
  • 4
    The only problem with define_method is that it doesn't allow blocks to be passed as parameters in ruby 1.8. See this blog post for a workaround. Sep 30, 2010 at 23:54
23
votes

module_function

Module methods that are declared as module_function will create copies of themselves as private instance methods in the class that includes the Module:

module M
  def not!
    'not!'
  end
  module_function :not!
end

class C
  include M

  def fun
    not!
  end
end

M.not!     # => 'not!
C.new.fun  # => 'not!'
C.new.not! # => NoMethodError: private method `not!' called for #<C:0x1261a00>

If you use module_function without any arguments, then any module methods that comes after the module_function statement will automatically become module_functions themselves.

module M
  module_function

  def not!
    'not!'
  end

  def yea!
    'yea!'
  end
end


class C
  include M

  def fun
    not! + ' ' + yea!
  end
end
M.not!     # => 'not!'
M.yea!     # => 'yea!'
C.new.fun  # => 'not! yea!'
3
  • 4
    If you just want to declare private methods in modules, just use the private keyword. In addition to making the method private in classes that include the module, module_function copies the method to the module instance. In most cases this is not what you want.
    – tomafro
    Apr 3, 2009 at 8:24
  • I know you can just use private. But this is a question on Ruby's hidden features. And, I think most people have never heard of module_function (myself included) until they see it in the doc and start to play around with it. Apr 7, 2009 at 18:43
  • An alternative to using module_function (2nd way) is to just use extend self (which looks pretty nice :D)
    – J-_-L
    May 17, 2011 at 20:27
23
votes

Short inject, like such:

Sum of range:

(1..10).inject(:+)
=> 55
3
  • 2
    Worth noting you need Ruby 1.9 or Rails with Ruby 1.8 for this to work.
    – mxcl
    Feb 17, 2010 at 14:38
  • 1
    @Max Howell: or require 'backports' :-) Jul 22, 2010 at 1:00
  • 1
    Isn't this a duplicate of hoyhoy's answer? Sep 30, 2010 at 23:56
21
votes

Warning: this item was voted #1 Most Horrendous Hack of 2008, so use with care. Actually, avoid it like the plague, but it is most certainly Hidden Ruby.

Superators Add New Operators to Ruby

Ever want a super-secret handshake operator for some unique operation in your code? Like playing code golf? Try operators like -~+~- or <--- That last one is used in the examples for reversing the order of an item.

I have nothing to do with the Superators Project beyond admiring it.

0
19
votes

I'm late to the party, but:

You can easily take two equal-length arrays and turn them into a hash with one array supplying the keys and the other the values:

a = [:x, :y, :z]
b = [123, 456, 789]

Hash[a.zip(b)]
# => { :x => 123, :y => 456, :z => 789 }

(This works because Array#zip "zips" up the values from the two arrays:

a.zip(b)  # => [[:x, 123], [:y, 456], [:z, 789]]

And Hash[] can take just such an array. I've seen people do this as well:

Hash[*a.zip(b).flatten]  # unnecessary!

Which yields the same result, but the splat and flatten are wholly unnecessary--perhaps they weren't in the past?)

1
19
votes

Auto-vivifying hashes in Ruby

def cnh # silly name "create nested hash"
  Hash.new {|h,k| h[k] = Hash.new(&h.default_proc)}
end
my_hash = cnh
my_hash[1][2][3] = 4
my_hash # => { 1 => { 2 => { 3 =>4 } } }

This can just be damn handy.

1
  • 1
    I would wrap it in a module to have same feeling like native hash init: module InfHash; def self.new; Hash.new {|h,k| h[k] = Hash.new(&h.default_proc)}; end; end
    – asaaki
    Jun 8, 2011 at 18:37
16
votes

Destructuring an Array

(a, b), c, d = [ [:a, :b ], :c, [:d1, :d2] ]

Where:

a #=> :a
b #=> :b
c #=> :c
d #=> [:d1, :d2]

Using this technique we can use simple assignment to get the exact values we want out of nested array of any depth.

15
votes

Class.new()

Create a new class at run time. The argument can be a class to derive from, and the block is the class body. You might also want to look at const_set/const_get/const_defined? to get your new class properly registered, so that inspect prints out a name instead of a number.

Not something you need every day, but quite handy when you do.

3
  • 1
    MyClass = Class.new Array do; def hi; 'hi'; end; end seems to be equivalent to class MyClass < Array; def hi; 'hi'; end; end.
    – yfeldblum
    Nov 30, 2009 at 3:52
  • 1
    Probably more true than I had thought about. It even appears that you can inherit from a variable rather than only a constant. However, the sugared version (second) doesn't appear to work if you need to construct the class name at run time. (Baring eval, of course.) Dec 2, 2009 at 22:42
  • This technique is pretty well described in the book Metaprogramming Ruby. Sep 27, 2011 at 19:26
13
votes

create an array of consecutive numbers:

x = [*0..5]

sets x to [0, 1, 2, 3, 4, 5]

3
  • Yep,but it's not as short and sweet ;)
    – horseyguy
    Jan 23, 2010 at 12:17
  • 2
    terseness is objective, readability is matter of taste and experience
    – Alexey
    Jun 20, 2011 at 19:41
  • The splat (*) operator basically calls to_a anyway. Jan 21, 2012 at 4:49
13
votes

A lot of the magic you see in Rubyland has to do with metaprogramming, which is simply writing code that writes code for you. Ruby's attr_accessor, attr_reader, and attr_writer are all simple metaprogramming, in that they create two methods in one line, following a standard pattern. Rails does a whole lot of metaprogramming with their relationship-management methods like has_one and belongs_to.

But it's pretty simple to create your own metaprogramming tricks using class_eval to execute dynamically-written code.

The following example allows a wrapper object to forwards certain methods along to an internal object:

class Wrapper
  attr_accessor :internal

  def self.forwards(*methods)
    methods.each do |method|
      define_method method do |*arguments, &block|
        internal.send method, *arguments, &block
      end
    end
  end

  forwards :to_i, :length, :split
end

w = Wrapper.new
w.internal = "12 13 14"
w.to_i        # => 12
w.length      # => 8
w.split('1')  # => ["", "2 ", "3 ", "4"]

The method Wrapper.forwards takes symbols for the names of methods and stores them in the methods array. Then, for each of those given, we use define_method to create a new method whose job it is to send the message along, including all arguments and blocks.

A great resource for metaprogramming issues is Why the Lucky Stiff's "Seeing Metaprogramming Clearly".

3
  • I wish to dive head first into metaprogramming in ruby. Could you provide some references to get started with it (Other than the given link)? Books will do too. Thanks.
    – Chirantan
    May 5, 2009 at 9:05
  • PragProg's videocasting serie "The Ruby Object Model and Metaprogramming" its a good introduction to meta programming using ruby: pragprog.com/screencasts/v-dtrubyom/…
    – caffo
    Jun 22, 2009 at 7:38
  • @Chirantan, have a look at Metaprogramming Ruby. Sep 27, 2011 at 19:30
12
votes

use anything that responds to ===(obj) for case comparisons:

case foo
when /baz/
  do_something_with_the_string_matching_baz
when 12..15
  do_something_with_the_integer_between_12_and_15
when lambda { |x| x % 5 == 0 }
  # only works in Ruby 1.9 or if you alias Proc#call as Proc#===
  do_something_with_the_integer_that_is_a_multiple_of_5
when Bar
  do_something_with_the_instance_of_Bar
when some_object
  do_something_with_the_thing_that_matches_some_object
end

Module (and thus Class), Regexp, Date, and many other classes define an instance method :===(other), and can all be used.

Thanks to Farrel for the reminder of Proc#call being aliased as Proc#=== in Ruby 1.9.

11
votes

The "ruby" binary (at least MRI's) supports a lot of the switches that made perl one-liners quite popular.

Significant ones:

  • -n Sets up an outer loop with just "gets" - which magically works with given filename or STDIN, setting each read line in $_
  • -p Similar to -n but with an automatic puts at the end of each loop iteration
  • -a Automatic call to .split on each input line, stored in $F
  • -i In-place edit input files
  • -l Automatic call to .chomp on input
  • -e Execute a piece of code
  • -c Check source code
  • -w With warnings

Some examples:

# Print each line with its number:
ruby -ne 'print($., ": ", $_)' < /etc/irbrc

# Print each line reversed:
ruby -lne 'puts $_.reverse' < /etc/irbrc

# Print the second column from an input CSV (dumb - no balanced quote support etc):
ruby -F, -ane 'puts $F[1]' < /etc/irbrc

# Print lines that contain "eat"
ruby -ne 'puts $_ if /eat/i' < /etc/irbrc

# Same as above:
ruby -pe 'next unless /eat/i' < /etc/irbrc

# Pass-through (like cat, but with possible line-end munging):
ruby -p -e '' < /etc/irbrc

# Uppercase all input:
ruby -p -e '$_.upcase!' < /etc/irbrc

# Same as above, but actually write to the input file, and make a backup first with extension .bak - Notice that inplace edit REQUIRES input files, not an input STDIN:
ruby -i.bak -p -e '$_.upcase!' /etc/irbrc

Feel free to google "ruby one-liners" and "perl one-liners" for tons more usable and practical examples. It essentially allows you to use ruby as a fairly powerful replacement to awk and sed.

10
votes

The send() method is a general-purpose method that can be used on any Class or Object in Ruby. If not overridden, send() accepts a string and calls the name of the method whose string it is passed. For example, if the user clicks the “Clr” button, the ‘press_clear’ string will be sent to the send() method and the ‘press_clear’ method will be called. The send() method allows for a fun and dynamic way to call functions in Ruby.

 %w(7 8 9 / 4 5 6 * 1 2 3 - 0 Clr = +).each do |btn|
    button btn, :width => 46, :height => 46 do
      method = case btn
        when /[0-9]/: 'press_'+btn
        when 'Clr': 'press_clear'
        when '=': 'press_equals'
        when '+': 'press_add'
        when '-': 'press_sub'
        when '*': 'press_times'
        when '/': 'press_div'
      end

      number.send(method)
      number_field.replace strong(number)
    end
  end

I talk more about this feature in Blogging Shoes: The Simple-Calc Application

2
  • Sounds like a great way to open a security hole.
    – mP.
    Apr 2, 2009 at 13:31
  • 4
    I'd use symbols wherever possible.
    – reto
    Apr 20, 2010 at 13:47
9
votes

Fool some class or module telling it has required something that it really hasn't required:

$" << "something"

This is useful for example when requiring A that in turns requires B but we don't need B in our code (and A won't use it either through our code):

For example, Backgroundrb's bdrb_test_helper requires 'test/spec', but you don't use it at all, so in your code:

$" << "test/spec"
require File.join(File.dirname(__FILE__) + "/../bdrb_test_helper")
2
  • Does this fix problems where gem A requires foo-1.0.0, and gem B requires foo-1.0.1? Jan 8, 2010 at 2:10
  • No because "something"'s code won't be available: this only simulates that "something" is required, but it is really doesn't require it. $" is an array containing the module names loaded by require (it's used by require to prevent loading modules twice). So, if you use this to fool gems, that will produce a crash when the gems try to use the actual "something" code, because it won't exist. You may instead want to force laoding a concrete version of a gem (eg foo-1.0.0), instead of the latest one: docs.rubygems.org/read/chapter/4#page71
    – olegueret
    Jan 13, 2010 at 13:05
9
votes

Defining a method that accepts any number of parameters and just discards them all

def hello(*)
    super
    puts "hello!"
end

The above hello method only needs to puts "hello" on the screen and call super - but since the superclass hello defines parameters it has to as well - however since it doesn't actually need to use the parameters itself - it doesn't have to give them a name.

9
votes
private unless Rails.env == 'test'
# e.g. a bundle of methods you want to test directly

Looks like a cool and (in some cases) nice/useful hack/feature of Ruby.

Not the answer you're looking for? Browse other questions tagged or ask your own question.