disposable 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8c253349d4d314ee180fd275bf708c5d1dc3fcc2
-  data.tar.gz: 76b13c0d6262f330cc183c2498ab60f8cb0bf127
+  metadata.gz: c3ede9bea8a77d3c3ca49a1d8d30e4d85174064b
+  data.tar.gz: bc8db041e0b26ce6520db6c0d647ad04f3fdffb4
 SHA512:
-  metadata.gz: 5d5f2a357dac409f5d1c89dd20a2dc66d6de8526bc27f62a9b7b290291d8ff2d7073cc3c06b74722ceba3be6ed9289de47ed1ac08b63ea81b50ef620999b7927
-  data.tar.gz: 8d21e16cf85e61cec5cc2591386b1879642588b5afe48d41f490f7880b1467f3259004155407a5d582d00c3c79ff86990b0abd270489e9918db200b936665c5a
+  metadata.gz: 241f8a98b1db05b79d6df1a725081648317c9eb913fca3bef48d487c8b8214d3089913285a1b6a0c581a8c7f778528924cf60ca8cc675143a3130603c959b13e
+  data.tar.gz: bb406f4d2550786497c0d3dc80b77ec69b97643f68adcba6ad2a9c78ef54121206a882edcf8363357ee5f325b0f8b60d70310efce9f829433d12de85a8f1c2b5

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.1.4
+
+* Add `Twin::Coercion`.
+
 # 0.1.3
 
 * Fix `Composition#save`, it now returns true only if all models could be saved.

data/README.md

@@ -173,6 +173,39 @@ You can also specify nested objects with an explicit class.
 property :artist, twin: TwinArtist
 ```
 
+## Features
+
+You can simply `include` feature modules into twins. If you want a feature to be included into all inline twins of your schema, use `::feature`.
+
+```ruby
+class AlbumTwin < Disposable::Twin
+  feature Coercion
+
+  property :artist do
+    # this will now include Coercion, too.
+```
+
+## Coercion
+
+Twins can use [Virtus](https://github.com/solnic/virtus) coercion. This will override the setter in your twin, coerce the incoming value, and call the original setter. _Nothing more_ will happen.
+
+```ruby
+class AlbumTwin < Disposable::Twin
+  feature Coercion
+  feature Setup::SkipSetter
+
+  property :id, type: Integer
+```
+
+The `:type` option defines the coercion type. You may incluce `Setup::SkipSetter`, too, as otherwise the coercion will happen at initialization time and in the setter.
+
+```ruby
+twin.id = "1"
+twin.id #=> 1
+```
+
+Again, coercion only happens in the setter.
+
 ## Collections
 
 Collections can be defined analogue to `property`. The exposed API is the `Array` API.

data/disposable.gemspec

@@ -26,5 +26,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "minitest"
   spec.add_development_dependency "activerecord"
   spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "virtus"
   # spec.add_development_dependency "database_cleaner"
 end

data/lib/disposable/twin/coercion.rb

@@ -0,0 +1,23 @@
+require "virtus"
+
+# confession: i love virtus' coercion.
+module Disposable::Twin::Coercion
+  module ClassMethods
+    def property(name, options={}, &block)
+      super(name, options, &block).tap do
+        coercing_setter!(name, options[:type])  # define coercing setter after twin.
+      end
+    end
+
+    def coercing_setter!(name, type)
+      mod = Module.new do
+        define_method("#{name}=") { |value| super Virtus::Attribute.build(type).coerce(value) }
+      end
+      include mod
+    end
+  end
+
+  def self.included(includer)
+    includer.extend ClassMethods
+  end
+end

data/lib/disposable/version.rb

@@ -1,3 +1,3 @@
 module Disposable
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

data/test/twin/coercion_test.rb

@@ -0,0 +1,86 @@
+require "test_helper"
+
+require "disposable/twin/coercion"
+
+class CoercionTest < MiniTest::Spec
+  Band = Struct.new(:label)
+
+  class Irreversible < Virtus::Attribute
+    def coerce(value)
+      value*2
+    end
+  end
+
+  class Twin < Disposable::Twin
+    feature Coercion
+    feature Setup::SkipSetter
+
+    property :id
+    property :released_at, :type => DateTime
+
+    property :hit do
+      property :length, :type => Integer
+      property :good,   :type => Virtus::Attribute::Boolean
+    end
+
+    property :band do
+      property :label do
+        property :value, :type => Irreversible
+      end
+    end
+  end
+
+  subject do
+    Twin.new(album)
+  end
+
+  let (:album) {
+    OpenStruct.new(
+      id: 1,
+      :released_at => "31/03/1981",
+      :hit         => OpenStruct.new(:length => "312"),
+      :band        => Band.new(OpenStruct.new(:value => "9999.99"))
+    )
+  }
+
+  # it { subject.released_at.must_be_kind_of DateTime }
+  it { subject.released_at.must_equal "31/03/1981" } # NO coercion in setup.
+  it { subject.hit.length.must_equal "312" }
+  it { subject.band.label.value.must_equal "9999.99" }
+
+
+  it do
+    subject.id = Object
+    subject.released_at = "30/03/1981"
+    subject.hit.length = "312"
+    subject.band.label.value = "9999.99"
+
+    subject.id = Object
+    subject.released_at.must_be_kind_of DateTime
+    subject.released_at.must_equal DateTime.parse("30/03/1981")
+    subject.hit.length.must_equal 312
+    subject.hit.good.must_equal nil
+    subject.band.label.value.must_equal "9999.999999.99" # coercion happened once.
+  end
+end
+
+
+class CoercionWithoutSkipSetterTest < MiniTest::Spec
+  class Irreversible < Virtus::Attribute
+    def coerce(value)
+      value*2
+    end
+  end
+
+  class Twin < Disposable::Twin
+    feature Coercion
+    property :id, type: Irreversible
+  end
+
+  it do
+    twin = Twin.new(OpenStruct.new(id: "1"))
+    twin.id.must_equal "11" # coercion happens in Setup.
+    twin.id = "2"
+    twin.id.must_equal "22"
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: disposable
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-28 00:00:00.000000000 Z
+date: 2015-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: uber
@@ -114,6 +114,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: virtus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Decorators on top of your ORM layer.
 email:
 - apotonick@gmail.com
@@ -147,6 +161,7 @@ files:
 - lib/disposable/twin.rb
 - lib/disposable/twin/builder.rb
 - lib/disposable/twin/changed.rb
+- lib/disposable/twin/coercion.rb
 - lib/disposable/twin/collection.rb
 - lib/disposable/twin/composition.rb
 - lib/disposable/twin/option.rb
@@ -170,6 +185,7 @@ files:
 - test/twin/benchmarking.rb
 - test/twin/builder_test.rb
 - test/twin/changed_test.rb
+- test/twin/coercion_test.rb
 - test/twin/collection_test.rb
 - test/twin/composition_test.rb
 - test/twin/expose_test.rb
@@ -224,6 +240,7 @@ test_files:
 - test/twin/benchmarking.rb
 - test/twin/builder_test.rb
 - test/twin/changed_test.rb
+- test/twin/coercion_test.rb
 - test/twin/collection_test.rb
 - test/twin/composition_test.rb
 - test/twin/expose_test.rb