Module: CoreExt::Module::RetroactiveModuleInclusion

Defined in:
lib/retroactive_module_inclusion.rb

Instance Method Summary (collapse)

Instance Method Details

- (Object) retroactively_include(mod) (private)

Includes mod retroactively, i.e., extending to all classes and modules which had included self beforehand.

Example:

module Stats
  def mean
    inject(&:+) / count.to_f
  end
end

Enumerable.module_eval { retroactively_include Stats }

(1..2).mean  #=>  1.5

Raises:

  • (TypeError) 


22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
# File 'lib/retroactive_module_inclusion.rb', line 22

def retroactively_include(mod) # :doc:
  raise TypeError, "wrong argument type #{mod.class} (expected Module)" unless mod.is_a? ::Module # ::Module would in general be equivalent to Object::Module and simply Module would mean CoreExt::Module in this context

  # Although one would expect +A.module_eval("include B")+ to make methods
  # from module +B+ available to all classes and modules that had previously
  # included module +A+, this is not the case due to a limitation in Ruby's
  # object model (see [dynamic module include problem][1]). Thus, one has two
  # possible solutions:
  #   * use Module#include_retroactively instead of Module#include
  #   * reopen +A+ and define the methods directly inside it
  #
  # JRuby (at least up to version 1.5.6) has ObjectSpace disabled by default,
  # thus it must be enabled manually ([reference][2]).
  #
  # [1]: http://eigenclass.org/hiki/The+double+inclusion+problem                      "Dynamic Module Include Problem"
  # [2]: http://ola-bini.blogspot.com/2007/07/objectspace-to-have-or-not-to-have.html "ObjectSpace: to have or not to have"
  #
  prev_jruby_objectspace_state = nil # only for scope reasons
  if defined?(RUBY_DESCRIPTION) && RUBY_DESCRIPTION =~ /jruby/i
    require 'jruby'
    prev_jruby_objectspace_state = JRuby.objectspace
    JRuby.objectspace = true
  end
  ObjectSpace.each_object(::Module) do |m|
    if m <= self # equiv. to "if m.include?(self) || m == self"
      m.module_eval { include mod }
    end
  end
  if defined?(RUBY_DESCRIPTION) && RUBY_DESCRIPTION =~ /jruby/i
    JRuby.objectspace = prev_jruby_objectspace_state
  end
end