compound 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4f1025df16249c199852986752859e1182992dc
-  data.tar.gz: 4cf21ac8e1adaf7c9b2d86f62437b6e73d5412e9
+  metadata.gz: 98be6fb9009b88f4ac28236382c858a5a837f67d
+  data.tar.gz: aebd4ba505f4fa915f9b5b133c80ecc87f5216aa
 SHA512:
-  metadata.gz: f4a198d31d92fd0e91c46b8519d2592177d524e486e6df2f5481df9303cf6f5f3539d804c62a74f1c3ce8c3e40590ffe5d2e8137e422ea66f4676935205372d8
-  data.tar.gz: 4566764d60336ee085f208c74bf5b1c5d63cbd8084ca5712902c94c69ff21c4d1c3d4d50f56b61dba77f8c3f7c4b97cf1d613d2727cadd6547593898e92b6384
+  metadata.gz: 7d2afc4bf916ff16a207545e27a2e5c6e8842edca0dbf5d58711f6c42bda320cb8657930d75bfa99b548fd7ad428dc189df4c68cd0b7eb7476884197ee1a3c04
+  data.tar.gz: fcdece2cbb55db2e6cccb7e054250af4b09639d19b92a6568ff4ed238d2479249ec89a4befb1e8a0cb5a92caa2af0de2f7ac59a81ff18ba9be1cf597574c3cdb

data/README.md

@@ -215,10 +215,11 @@ can initialize its internal state.  Traditional module composition will call
 the `extended` or `self.included` methods if they are defined by the module.
 However, modules intended for compounding should define a `compounded` method
 instead, to be called upon creation of the `Host`'s internal `Part` object.
+The `compounded` method should accept a single argument: the `Host` object.
 
 ``` ruby
   module Paint
-    def compounded
+    def compounded(host)
       @color = :royal_blue
     end
     attr_accessor :color
@@ -227,3 +228,46 @@ instead, to be called upon creation of the `Host`'s internal `Part` object.
   host.compound Paint
   host.color          #=> :royal_blue
 ```
+
+The `Host` will also pass itself to the `self.compounded` method on the module
+passed to `compound` if the method is defined.
+
+``` ruby
+  module Paint
+    def self.compounded(host)
+      @latest = host
+    end
+    attr_accessor :latest
+  end
+  
+  Paint.latest          #=> nil
+  host.compound Paint
+  Paint.latest == host  #=> true
+```
+
+# Calling a Method on Each Part
+
+Compound::Host has a private method for calling `send` on each of its `Part`
+objects.  Because it uses `send`, it can access both public and private methods
+of each `Part`.  The return values of the methods are collected into a hash
+with the compounded modules as the keys.
+
+``` ruby
+  module RedPaint
+    private
+    def load_brush(intensity)
+      '0x%02x0000' % intensity
+    end
+  end
+  
+  module BluePaint
+    private
+    def load_brush(intensity)
+      '0x0000%02x' % intensity
+    end
+  end
+  
+  host.define_singleton_method(:load_brushes) { send_to_all :load_brush, 0xff }
+  
+  host.load_brushes #=> { RedPaint=>'#ff0000', BluePaint=>'#0000ff' }
+```

data/lib/compound/host.rb

@@ -45,6 +45,19 @@ module Compound
         raise(NameError, "undefined method `#{sym}' for object `#{self}'")
     end
     
+  private
+    
+    # A private method to call send on each Compound::Part that defines the
+    # given method, whether publically or privately.  The return values are
+    # collected into a hash with the compounded modules as the keys.
+    def send_to_parts sym, *args, &block
+      @_compound_parts.each_with_object({}) do |part, hash|
+        hash[part.instance_variable_get(:@_compound_component_module)] = \
+          part.send sym, *args, &block \
+            if part.respond_to? sym, true
+      end
+    end
+    
   end
   
 end

data/lib/compound/part.rb

@@ -8,6 +8,7 @@ module Compound
     
     def initialize parent, mod
       @_compound_component_parent = parent
+      @_compound_component_module = mod
       extend mod
       compounded(parent) if mod.instance_methods.include? :compounded
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: compound
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Joe McIlvain
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-20 00:00:00.000000000 Z
+date: 2014-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -86,11 +86,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- lib/compound.rb
 - lib/compound/guard.rb
 - lib/compound/host.rb
 - lib/compound/part.rb
-- lib/compound.rb
-- README.md
 homepage: https://github.com/jemc/compound/
 licenses:
 - MIT License
@@ -111,8 +111,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.1.11
+rubygems_version: 2.2.0
 signing_key: 
 specification_version: 4
 summary: compound
 test_files: []
+has_rdoc: