type_wrapper 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1b0ccfe16ab90f4f07518274c6845ac0055fe7da
-  data.tar.gz: 727a2f9f2f1bd9780fdc8669cd0db03c16ff5f4b
+  metadata.gz: 69d54edce7635369ec8d00ab82bd42a96c9a7394
+  data.tar.gz: b64a288d3a8ead6d044efe8d4882df5189e4e341
 SHA512:
-  metadata.gz: a0a6bc7d172fe270878473fed419bcc73a39c8a0dece6428f09c727ce7b93afd4c895344f44dde317a0e50fbdeb0a2315d0a5c92ad1920c15357229437bbfcd7
-  data.tar.gz: d4fe98670eab3f07a487c49d16f079f3b1e522581c7890e551dd138e274d5634a08838cd8beb31ad662019c7bf0b9c98c6eda8ebfacf5ba1a0a99e4a528f7ff7
+  metadata.gz: 3cf9f7abf54087cf97bd05633590fe0660ea9f066c8875254fc9fce47f19e3486f9f3a208ed884d891763c87118386ca1010c816f3331f31551dfa7a5c18eb5b
+  data.tar.gz: 198d91a0c3a5ad32434559cd5a16323ea342b03202f64cfeb40655310d22fd3087281e941485a9e71efcbe414e83db8362290a4b15ec4fedfaa0fc6ff2f53070

data/README.md

@@ -1,6 +1,7 @@
 # TypeWrapper
 
 [![Gem Version](https://badge.fury.io/rb/type_wrapper.svg)](https://badge.fury.io/rb/type_wrapper)
+[![Build Status](https://travis-ci.org/RichOrElse/type-wrapper.svg?branch=master)](https://travis-ci.org/RichOrElse/type-wrapper)
 
 Delegator pattern in Ruby without object schizophrenia. Because Object#extend at runtime is evil.
 
@@ -22,6 +23,10 @@ Or install it yourself as:
 
 ## Usage
 
+### TypeWrapper
+
+Construct a delegator class using square brackets '[]' method with type as the first argument followed by mixins. 
+
 ```ruby
 module ToArray
   def to_a
@@ -43,18 +48,39 @@ peter = PersonPresenter.new(Person.new('Peter'))
 peter.to_a
 ```
 
+### TypeWrapper::Module
+
+Define a block with the 'new' method and pass the 'mod' parameter to 'using' keyword.
+
+```ruby
+AwesomeSinging = TypeWrapper::Module.new do |mod| using mod
+  def sing
+    "#{name} sings #{song}"
+  end
+
+  def song
+    "Everything is AWESOME!!!"
+  end
+end
+
+Lego = Struct.new(:name)
+
+using AwesomeSinging[Lego]
+Lego.new("Emmet").sing
+```
+
 ## Pros
 
 * Five (5) times faster than [Object#extend](https://apidock.com/ruby/Object/extend).
 * Delegation without [self schizophrenia](https://en.wikipedia.org/wiki/Schizophrenia_(object-oriented_programming)).
 * [Decorator Pattern](https://en.wikipedia.org/wiki/Decorator_pattern) with multiple traits.
-* Allows [DCI](http://dci.github.io/) in Ruby without [blowing the method cache at run time](https://tonyarcieri.com/dci-in-ruby-is-completely-broken).
+* Allows [DCI](https://github.com/RichOrElse/wrapper-based/) in Ruby without [blowing the method cache at run time](https://tonyarcieri.com/dci-in-ruby-is-completely-broken).
 
 ## Cons
 
+* Must use TypeWrapper::Module to allow procedural code in mixins.
 * Three (3) times slower than calling class method. [See benchmark.](https://github.com/RichOrElse/wrapper-based/tree/master/examples/benchmark.rb)
-* [Procedural code](https://en.wikipedia.org/wiki/Procedural_programming) inside Mixin is broken, methods scoped in Mixin cannot directly call another method in the same scope of the Mixin.
-* Methods applied by [Object#extend](https://apidock.com/ruby/Object/extend) takes precedence over Mixin methods.
+* Methods applied with [Object#extend](https://apidock.com/ruby/Object/extend) takes precedence over Mixin methods.
 
 ## Development
 

data/lib/type_wrapper/module.rb

@@ -0,0 +1,51 @@
+module TypeWrapper
+# == Basic Usage
+#
+# === Define a block with the 'new' method and pass the 'mod' parameter to 'using' keyword.
+#
+#   AwesomeSinging = TypeWrapper::Module.new do |mod| using mod
+#     def sing
+#       "#{name} sings #{song}"
+#     end
+#
+#     def song
+#       "Everything is AWESOME!!!"
+#     end
+#   end
+#
+# === Use as refinement module by passing the 'refines' method with types.
+#  
+#   Lego = Struct.new(:name)
+#   using AwesomeSinging[Lego]
+#   Lego.new("Emmette").sing
+#
+
+  class Module < ::Module
+    def initialize(default = Object, *types, &blk)
+      mod, @block = self, blk
+      types.unshift(default).each do |type|
+        refine(type) { module_exec mod, &blk }
+      end
+      super(&blk)
+    end
+
+    def refines(*types)
+      self.class.new(*types, &@block)
+    end
+
+    alias_method :[], :refines
+
+    module Refines
+      refine ::Module do
+        def refines(*types)
+          mod = self
+          Module.new do
+            types.each do |type|
+              refine(type) { prepend mod }
+            end
+          end # new Module
+        end # refines method
+      end # ::Module refinements
+    end # Refinements module
+  end # Module class
+end # TypeWrapper module

data/lib/type_wrapper/version.rb

@@ -1,3 +1,3 @@
 module TypeWrapper
-  VERSION = "1.1.0"
+  VERSION = "1.2.0".freeze
 end

data/lib/type_wrapper.rb

@@ -1,4 +1,5 @@
 require "type_wrapper/version"
+require "type_wrapper/module"
 require 'delegate'
 
 module TypeWrapper
@@ -10,20 +11,21 @@ module TypeWrapper
                               @delegate_tw_obj # return object we are delegating to
                             end
 
-  def self.[](type, *modules)
-    raise TypeError, "wrong argument type (expected Class)" unless Class === type
-    raise TypeError, "wrong argument type (expected Module(s))" unless modules.all? { |mod| mod.class == Module }
-    raise ArgumentError, "wrong number of arguments (given 1, expected 2+)" if modules.empty?
+  def self.[](*types)
+    raise TypeError, "wrong argument type (expected Module(s))" if types.include?(nil)
+    raise ArgumentError, "wrong number of arguments (given #{types.size}, expected 2+)" if types.size < 2
 
-    FOR[type, *modules]
+    FOR[*types]
   end
+  
+  using Module::Refines
 
   FOR = -> type, *behaviors do
         Class.new(Delegator) do
           include TypeWrapper
           const_set :Type, type
           const_set :BEHAVIORS, behaviors
-          const_set :Trait, Module.new { refine(type) { prepend(*behaviors.reverse) } }
+          const_set :Trait, Module.new { behaviors.each { |mod| include mod.refines(type) } }
           forwarding = behaviors.flat_map(&:public_instance_methods) - public_instance_methods
           code = forwarding.uniq.map { |meth| "def %{meth}(*args, &block) __getobj__.%{meth}(*args, &block) end" % { meth: meth } }
           class_eval code.unshift("using Trait").join("\n")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: type_wrapper
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Ritchie Paul Buitre
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-06-30 00:00:00.000000000 Z
+date: 2017-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -69,6 +69,7 @@ files:
 - bin/setup
 - examples/benchmark.rb
 - lib/type_wrapper.rb
+- lib/type_wrapper/module.rb
 - lib/type_wrapper/version.rb
 - type_wrapper.gemspec
 homepage: https://github.com/RichOrElse/type-wrapper/
@@ -91,7 +92,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Delegator pattern in Ruby without object schizophrenia. Because Object#extend