You’ll love module_function
module_function 可以把一个模块的实例方法同时定义成模块级方法。
模块级方法的意思是，这些方法的接受者可以是该模块本身。
你可以给 module_function 传递一个方法名作为参数：
module X
def foo
'bar'
end
module_function :foo
end
$ X.foo
=> 'bar'
如果 module_function 没有跟随参数，则它后面的所有方法都会被定义为模块级方法：
module X
module_function
def foo
'huhu'
end
end
$ X.foo
=> 'huhu'
当一个类混入了该模块后，所有通过 module_function 定义的方法默认都是 private 的实例方法。
请看下面的不同：
module A
def hello
p "Yeah"
end
end
class B
include A
end
B.new.hello
# >> "Yeah"
module A
def hello
p "Yeah"
end
module_function :hello
end
class B
include A
end
B.new.hello
# ~> NoMethodError
# ~> private method `hello' called for #<B:0x007fb262031d78>
更妙的是，这些模块级方法都是实例方法的副本，所以给其中的一个方法打猴子补丁不会影响其它部分。
最后所有 module_function 接受的字符串参数会被内部转换成符号类型。
Why should I be using this?
下面是一个引用 Erb::Util 的例子，通常我们这样使用模块方法：
require 'erb'
class X
include ERB::Util
def call
url_encode 'http://www.google.com'
end
end
$ X.new.call
=> 'http%3A%2F%2Fwww.google.com'
或者也可以这样
require 'erb'
class Y
def call
ERB::Util.url_encode 'http://www.google.com'
end
end
$ Y.new.call
=> 'http%3A%2F%2Fwww.google.com'
因为使用 include 混入模块会影响 is_a? 类型检查和条件比较符 ===。
所以利用 module_function 我们可以直接使用 url_encode 而不需要破坏继承链。
