direction 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 99cab337abb6c620be8fe3226ced09dab0d5da77
-  data.tar.gz: d986a770755c0e04e05d14781ea6c6aa59b98d40
+  metadata.gz: 727eb9585c633d12cc9995c9c73cc524eeba82ff
+  data.tar.gz: d069923519bf447766d13afbe2ab621137d229b4
 SHA512:
-  metadata.gz: 86177cffdf52eea6125884f34ab68e91f1cc445f6e8484dce645c63f20397f994c61bffa2159033f1595f64888f999885eb9d8dd7cc51c23af41a37b3c858dea
-  data.tar.gz: 3a0d61725e295c362273c653a4901e0226e1a64648c733aeff0e46cb2534c0852d213e87ea393ea2f5ccb38b4676b3de430708d14c31d7add889169054b91bfb
+  metadata.gz: c5e95f10ed99d01e632041d81d2157da594d5c46c8f3a85895b1ce70e47119345b66b77d29cd846582ae4c4b9bbe00b4766e7ebf21996bfbfb38e0ce58cfad8c
+  data.tar.gz: b84abee5835f01a005bfc615585e3bb71ba454088b012a63eac26a4f539c7afd7a907eb80e12ff0e6df96b506649e8663679868def45d6ce2902fec3931fd527

data/README.md

@@ -11,11 +11,26 @@ Provide a feature like the Forwardable library, but set the return value to self
 It provides a class level "command" method to do message forwarding.
 
 ```ruby
-class SomeClass
+class Person
   extend Direction
 
-  command [:name, :id] => :collaborator, [:color, :type] => :partner
+  command [:print_address] => :home
+
+  attr_accessor :home
+end
+
+class Home
+  def print_address(template)
+    template << "... the address.."
+  end
 end
+
+template = STDOUT
+person = Person.new
+person.home = Home.new
+#commands won't leak internal structure and return the receiver of the command
+person.print_address(template) #=> person
+
 ```
 
 This will define methods on instances that forward to the provided receiver while enforcing encapsulation of the relationship between objects.

data/lib/direction.rb

@@ -7,7 +7,8 @@ require "direction/version"
 # class SomeClass
 #   extend Direction
 # 
-#   command [:name, :id] => :collaborator, [:color, :type] => :@partner
+#   command [:print_details, :setup_things] => :collaborator
+#   query [:name, :id] => :collaborator, :type => :@partner
 # end
 # 
 # This will define methods on instances that forward to the
@@ -28,4 +29,18 @@ module Direction
     end
     self.class_eval method_defs.join(' '), __FILE__, __LINE__
   end
+
+  def query(options)
+    method_defs = []
+    options.each_pair do |key, value|
+      Array(key).map do |command_name|
+        method_defs.unshift %{
+          def #{command_name}(*args, &block)
+            #{value}.__send__(:#{command_name}, *args, &block)
+          end
+        }
+      end
+    end
+    self.class_eval method_defs.join(' '), __FILE__, __LINE__
+  end
 end

data/lib/direction/version.rb

@@ -1,3 +1,3 @@
 module Direction
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/test/direction_test.rb

@@ -3,6 +3,7 @@ require 'test_helper'
 class Person
   extend Direction
   command [:make_me_a_sandwich, :cook] => :@friend
+  query [:activities, :go] => :friend
   attr_accessor :friend
 end
 
@@ -14,6 +15,14 @@ class Friend
   def cook(what)
     Menu.record what
   end
+
+  def activities
+    'running, biking, hiking'
+  end
+
+  def go(do_what)
+    Activities.record do_what
+  end
 end
 
 module Menu
@@ -28,7 +37,19 @@ module Menu
   end
 end
 
-describe Direction do
+module Activities
+  def self.record(text)
+    list << text
+  end
+  def self.list
+    @list ||= []
+  end
+  def self.clear
+    @list = []
+  end
+end
+
+describe Direction, 'command' do
   let(:friend){ Friend.new }
   let(:person){ person = Person.new
                 person.friend = friend
@@ -52,4 +73,25 @@ describe Direction do
     person.cook('yum')
     assert_includes Menu.list, "yum"
   end
+end
+
+describe Direction, 'query' do
+  let(:friend){ Friend.new }
+  let(:person){ person = Person.new
+                person.friend = friend
+                person
+              }
+  before do
+    Activities.clear
+  end
+
+  it 'forwards a message to another object' do
+    assert_includes person.activities, "running, biking, hiking"
+  end
+
+  it 'forwards additional arguments' do
+    assert_equal [], Activities.list
+    person.go('have fun')
+    assert_includes Activities.list, "have fun"
+  end
 end

data/test/sample.rb

@@ -0,0 +1,83 @@
+require 'direction'
+
+class MicroManager
+  def initialize(server)
+    @server = server
+  end
+  attr_accessor :server
+end
+
+class Server
+  def initialize(kitchen)
+    @kitchen = kitchen
+    @accountant = kitchen.accountant
+  end
+  attr_reader :kitchen
+  attr_accessor :customer
+  
+  def order_food(food)
+    puts "I'll put that order in for you right now"
+    sleep(2)
+    kitchen.make_food(food)
+    serve_food(food)
+  end
+  
+  def serve_food(food)
+    retrieve_food(food)
+    sleep(2)
+    puts " <Server retrieved #{food}>"
+    return_to_customer(food)
+  end
+  
+  def retrieve_food(food)
+    kitchen.provide_food(food)
+  end
+  
+  def return_to_customer(food)
+    puts "Here's your order of #{food}"
+  end
+  
+  def pay_bill
+    @accountant.accept_funds
+  end
+end
+
+class Kitchen
+  def make_food(food)
+    puts " <Kitchen preparing #{food}>"
+    sleep(3)
+    puts " <Kitchen made #{food}>"
+  end
+  
+  def provide_food(food)
+    puts " <Kitchen served up #{food}>"
+  end
+  
+  def accountant
+    @accountant ||= Accountant.new
+  end
+end
+
+class Accountant
+  def accept_funds
+    puts " $$$ Cha-ching!"
+  end
+end
+
+class Customer
+  extend Direction
+  def initialize(server)
+    @server = server
+  end
+  attr_accessor :server
+  
+  command [:order_food, :pay_bill] => :server
+end
+
+def setup
+  @kitchen = Kitchen.new
+  @server = Server.new(@kitchen)
+  @manager = MicroManager.new(@server)
+  @customer = Customer.new(@server)
+  @manager
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: direction
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - "'Jim Gay'"
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-09 00:00:00.000000000 Z
+date: 2014-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -54,6 +54,7 @@ files:
 - lib/direction.rb
 - lib/direction/version.rb
 - test/direction_test.rb
+- test/sample.rb
 - test/test_helper.rb
 homepage: ''
 licenses:
@@ -81,4 +82,5 @@ specification_version: 4
 summary: Forward messages to collaborators in East-oriented style.
 test_files:
 - test/direction_test.rb
+- test/sample.rb
 - test/test_helper.rb