disposable 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0961ea267a9adeeb55f33da903f0bd85e21070f4
-  data.tar.gz: f3ff1a24210acaaa96a933d3889ccee74c4db7b2
+  metadata.gz: fbd96277db19aa9fdf0cb9d0b46942cb2cbd2983
+  data.tar.gz: d3cc09426627c5bcc459b80d1eb90deaf66268f8
 SHA512:
-  metadata.gz: bb3cbf404ad41a23dd6b25aa6fc49029a5d0e1ec75d657eed33440c1acb8ee5c2915048ecf1b2bf3c2737d5abf8c285ded7770cff552f3c5205a73e897a307b0
-  data.tar.gz: c96c0291615cfe64633d8a155b417fcf506eb306b14e968fe36c6001166f2acecce25f9b1f60bc51f1206f71264e75907186c2eb6719e3a09768a96568f82f85
+  metadata.gz: df682d54394835e9d682f3a1e2815be97d849640f7c4b0a171dc31cd2ccb431e24e47df3dcbf019c1bc87a93638dc0239afabb0cb63f513feaf3892dafeb20af
+  data.tar.gz: f6023c52816ca6ba2636d05b1cd49fe660d68bfd4af1cff88f45142c844e1b29b6da3732ff9dfc805aa4ae1c250d64ab840aaac287215352ecb73c393b7e70e3

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.0.8
+
+* Introduce the `Twin::Builder` module to easily allow creating a twin in a host object's constructor.
+
 # 0.0.7
 
 * Make disposable require representable 2.x.

data/lib/disposable/twin.rb

@@ -3,8 +3,9 @@ require 'representable/decorator'
 require 'representable/hash'
 require 'disposable/twin/representer'
 require 'disposable/twin/option'
+require 'disposable/twin/builder'
 
-# Twin.new(model/composition hash, options)
+# Twin.new(model/composition hash/hash, options)
 #   assign hash to @fields
 #   write: write to @fields
 #   sync/save is the only way to write back to the model.
@@ -17,7 +18,7 @@ module Disposable
 
 
     def self.property(name, options={}, &block)
-      options[:private_name]  = options.delete(:as) || name
+      options[:private_name] = options.delete(:as) || name
       options[:pass_options] = true
 
       representer_class.property(name, options, &block).tap do |definition|

data/lib/disposable/twin/builder.rb

@@ -0,0 +1,46 @@
+module Disposable
+  class Twin
+    # Allows setting a twin class for a host object (e.g. a cell, a form, or a representer) using ::twin
+    # and imports a method #build_twin to initialize this twin.
+    #
+    # Example:
+    #
+    #   class SongTwin < Disposable::Twin
+    #     properties :id, :title
+    #     option :is_released
+    #   end
+    #
+    #   class Cell
+    #     include Disposable::Twin::Builder
+    #     twin SongTwin
+    #
+    #     def initialize(model, options)
+    #       @twin = build_twin(model, options)
+    #     end
+    #   end
+    #
+    # An optional block passed to ::twin will be called per property yielding the Definition instance.
+    module Builder
+      def self.included(base)
+        base.class_eval do
+          extend Uber::InheritableAttr
+          inheritable_attr :twin_class
+          extend ClassMethods
+        end
+      end
+
+      module ClassMethods
+        def twin(twin_class, &block)
+          twin_class.representer_class.representable_attrs.each { |dfn| yield(dfn) } if block_given?
+          self.twin_class = twin_class
+        end
+      end
+
+    private
+
+      def build_twin(*args)
+        self.class.twin_class.new(*args)
+      end
+    end
+  end
+end

data/lib/disposable/version.rb

@@ -1,3 +1,3 @@
 module Disposable
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/test/twin/twin_test.rb

@@ -161,4 +161,56 @@ class TwinOptionTest < TwinTest
   it { Song.new(song, preview?: true, highlight?: false).preview?.must_equal true }
 end
 
+
+class TwinBuilderTest < MiniTest::Spec
+  class Twin < Disposable::Twin
+    property :id
+    property :title
+    option   :is_released
+  end
+
+  describe "without property setup" do
+    class Host
+      include Disposable::Twin::Builder
+
+      twin Twin
+
+      def initialize(*args)
+        @model = build_twin(*args)
+      end
+
+      attr_reader :model
+    end
+
+    subject { Host.new(TwinTest::Model::Song.new(1, "Saturday Night"), is_released: true) }
+
+    # model is simply the twin.
+    it { subject.respond_to?(:title).must_equal false }
+    it { subject.model.id.must_equal 1 }
+    it { subject.model.title.must_equal "Saturday Night" }
+    it { subject.model.is_released.must_equal true }
+  end
+
+
+  describe "without property setup" do
+    class HostWithReaders
+      include Disposable::Twin::Builder
+
+      extend Forwardable
+      twin(Twin) { |dfn| def_delegator :@model, dfn.name }
+
+      def initialize(*args)
+        @model = build_twin(*args)
+      end
+    end
+
+    subject { HostWithReaders.new(TwinTest::Model::Song.new(1, "Saturday Night"), is_released: true) }
+
+    # both twin gets created and reader method defined.
+    it { subject.id.must_equal 1 }
+    it { subject.title.must_equal "Saturday Night" }
+    it { subject.is_released.must_equal true }
+  end
+end
+
 # TODO: test coercion!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: disposable
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Nick Sutterer
@@ -110,6 +110,7 @@ files:
 - lib/disposable.rb
 - lib/disposable/composition.rb
 - lib/disposable/twin.rb
+- lib/disposable/twin/builder.rb
 - lib/disposable/twin/composition.rb
 - lib/disposable/twin/finders.rb
 - lib/disposable/twin/new.rb
@@ -143,7 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.1
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Domain-Oriented Refactoring Framework.
@@ -152,4 +153,3 @@ test_files:
 - test/test_helper.rb
 - test/twin/composition_test.rb
 - test/twin/twin_test.rb
-has_rdoc: