Module: Gorillib::Concern

Included in:
Builder, Gorillib::Collection::CommonAttrs, Gorillib::Collection::ItemsBelongTo, Configurable, FancyBuilder, Model, Model::ActiveModelShim, Model::Conversion, Model::DocString, Model::LoadFromCsv, Model::LoadFromJson, Model::LoadFromTsv, Model::LoadLines, Model::PositionalFields, StringFixup
Defined in:
lib/gorillib/metaprogramming/concern.rb

Overview

A typical module looks like this:

module M def self.included(base) base.extend ClassMethods scope :disabled, where(:disabled => true) end

module ClassMethods
  ...
end

end

By using Gorillib::Concern the above module could instead be written as:

require 'active_support/concern'

module M extend Gorillib::Concern

included do
  scope :disabled, where(:disabled => true)
end

module ClassMethods
  ...
end

end

Moreover, it gracefully handles module dependencies. Given a +Foo+ module and a +Bar+ module which depends on the former, we would typically write the following:

module Foo def self.included(base) base.class_eval do def self.method_injected_by_foo ... end end end end

module Bar def self.included(base) base.method_injected_by_foo end end

class Host include Foo # We need to include this dependency for Bar include Bar # Bar is the module that Host really needs end

But why should +Host+ care about +Bar+'s dependencies, namely +Foo+? We could try to hide these from +Host+ directly including +Foo+ in +Bar+:

module Bar include Foo def self.included(base) base.method_injected_by_foo end end

class Host include Bar end

Unfortunately this won't work, since when +Foo+ is included, its base is the +Bar+ module, not the +Host+ class. With Gorillib::Concern, module dependencies are properly resolved:

require 'active_support/concern'

module Foo extend Gorillib::Concern included do class_eval do def self.method_injected_by_foo ... end end end end

module Bar extend Gorillib::Concern include Foo

included do
  self.method_injected_by_foo
end

end

class Host include Bar # works, Bar takes care now of its dependencies end

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.extended(base) ⇒ Object 



99
100
101
 
# File 'lib/gorillib/metaprogramming/concern.rb', line 99

def self.extended(base)
  base.instance_variable_set("@_dependencies", [])
end

Instance Method Details

#append_features(base) ⇒ Object 



103
104
105
106
107
108
109
110
111
112
113
114
 
# File 'lib/gorillib/metaprogramming/concern.rb', line 103

def append_features(base)
  if base.instance_variable_defined?("@_dependencies")
    base.instance_variable_get("@_dependencies") << self
    return false
  else
    return false if base < self
    @_dependencies.each { |dep| base.send(:include, dep) }
    super
    base.extend const_get("ClassMethods") if const_defined?("ClassMethods")
    base.class_eval(&@_included_block) if instance_variable_defined?("@_included_block")
  end
end

#included(base = nil, &block) ⇒ Object 



116
117
118
119
120
121
122
 
# File 'lib/gorillib/metaprogramming/concern.rb', line 116

def included(base = nil, &block)
  if base.nil?
    @_included_block = block
  else
    super
  end
end