From: Maksim Bartenev <bartenev@...>
Date: 2007-01-27T01:43:56+09:00
Subject: Got completely stuck with using 'class <<' feature.

------=_Part_57497_1589398.1169829830331
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

Hello!

I'm more than a bit confused with module inclusion and 'class <<' syntax for
class definition, so I'm asking for some help.
Here's a short program that produces an effect I cannot understand:

module One
  def self.included mod
    mod.extend Two
  end

  def one
    'one'
  end
end

module Two
  def two
    'two'
  end
end

module Three
  def self.included mod
    class << mod
      include One

      def three
        'three'
      end
    end
  end
end

class Klass1
  include Three
end

class Klass2
  include One
end


I get the following results after loading the .rb file:

irb(main):003:0> Klass1.methods.include? 'one'
=> true
irb(main):004:0> Klass1.instance_methods.include? 'one'
=> false
irb(main):005:0> Klass2.instance_methods.include? 'one'
=> true
irb(main):006:0> Klass2.methods.include? 'one'
=> false
irb(main):007:0> Klass1.methods.include? 'three'
=> true
irb(main):008:0> Klass1.methods.include? 'two'
=> false
irb(main):009:0> Klass1.instance_methods.include? 'two'
=> false
irb(main):010:0> Klass2.methods.include? 'two'
=> true
irb(main):011:0> Klass2.instance_methods.include? 'two'
=> false

What I am asking for is a step by step explanation of what happens here, as
I'm completely confused.
What I am trying to achieve is to make #two a class method of Klass1 - I
have no idea, why it doesn't show up in Klass1.methods.

The complexity of this array of inclusions is actually explained by the fact
that this sample is an oversimplified pattern extracted
from a project I'm working on now with modules One and Two being used by
client classes in my script. One uses extend to append
Two's methods to a class' list of class methods, thus extending both its
class and instance methods. However to work properly
methods form One and Two require some additional methods to be defined in
classes that include them. I want my
classes (e.g. Klass1) to include both those necessary methods and module One
by specifying just one include statement.
With that statement a utility module would be included (module Three) that
both defines additional methods I mentioned
before and mixes One into a class it gets included into. Unfortunately I
didn't succeed with this approach as methods
from Two wouldn't mix as client class' class methods. So I created a small
model of this situation to trace possible problems
with inclusions, and the results got me completely confused, so I decided to
post the code for small model in this mailing list
and ask for help and explanation.

Best regards,
Maksim Bartenev

------=_Part_57497_1589398.1169829830331--