disposable 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f223895880d3cf7e132a9fc7fe289d2364cda94
-  data.tar.gz: f6fb9b0b50ab1f76f6a76c233bc6a7b764d715c0
+  metadata.gz: 90e97c08c2c16f6c4990b4e07aa18181665590f5
+  data.tar.gz: cadf5067b7b35c87ec40f2c1f33193d957a9b5ab
 SHA512:
-  metadata.gz: b419406d81071ac149d0bb88a4b4165763b752be5530125ddb4a2165b05ffb704087cc5502d37bde78ef75b132bf49b101d9b7ec475ef3754904619f5039cae9
-  data.tar.gz: 8f18dd625473e5880a7a600698bb36eef37cf1791df67ed59e91c9f0179e168d16a32e201002afa8d3bbb85f75d426b88fb5c28f7958d19404d8a8b1878112a9
+  metadata.gz: 8183c7256adf882d8506c53301bb9e9e60f8f0fb6e1d6f55c5da6fdd241667034c120a7209f1042126c241986935c29b9037775f29c4f1d50aa447e75ad4a513
+  data.tar.gz: 2222286b902c93dd4948b738ec44eeab397dab55bbb79cf043660d2ecb04eee7a96f4c5b0c0e5c27c3c367936d3e93b453dce5653af17f4a68ecab423189cf09

data/.travis.yml

@@ -2,7 +2,6 @@ language: ruby
 rvm:
   - 2.0.0
   - 1.9.3
-  - 1.8.7
 gemfile:
   - gemfiles/Gemfile.rails-3.0
   - gemfiles/Gemfile.rails-2.3

data/README.md

@@ -1,15 +1,30 @@
 # Disposable
 
+_Provides domain objects on top of your ORM layer._
 
-why?
-because i want this to fuckin work: Wallpaper.find(51).update_attributes(enabled:false)
-i want to see my fields when opening the class file, a la DataMapper.
+## Introduction
+
+Disposable gives you "_Twins_" which are domain objects, decoupled from ActiveRecord, DataMapper or whatever ORM you use.
+
+Twins are non-persistent domain objects. That is reflected in the name of the gem. However, they can read and write values from a persistent object.
+
+Twins are an integral part of the [Trailblazer](https://github.com/apotonick/trailblazer) architectural style which provides clean layering of concerns.
+
+They give you an encapsulated alternative to delegators that many projects use to separate domain and persistence and help you restricting the domain API.
+
+## Why?
+
+The goal is to have business logic sitting in twin classes, while your models (ideally) contain persistence configuration, only.
+
+Beyond that, twins can be used in form objects, cells view models, representers, contracts, and actually any Ruby code :)
+
+Twins may contain validations, nevertheless, in Trailblazer, validations (or "Contracts") sit one layer above. They still can be part of your domain, though.
 
 ## Twin
 
-Twins implement light-weight domain objects that contain business logic - no persistance logic. They have read- and write access to a persistant object (or a composition of those) and expose a sub-set of accessors to that persistant "brother", making it a "data mapper-like phantom".
+Twins implement light-weight domain objects that contain business logic - no persistance logic. They have read- and write access to a persistent object (or a composition of those) and expose a sub-set of accessors to that persistent "brother", making it a "data mapper-like phantom".
 
-Being designed to wrap persistant objects, a typical "brother" class could be an ActiveRecord one.
+Being designed to wrap persistent objects, a typical "brother" class could be an ActiveRecord one.
 
 ```ruby
 class Song < ActiveRecord::Base
@@ -17,13 +32,13 @@ class Song < ActiveRecord::Base
 end
 ```
 
-You don't wanna work with that persistant brother directly anymore. A twin will wrap it and indirect domain from persistance.
+You don't wanna work with that persistent brother directly anymore. A twin will wrap it and indirect domain from persistance.
 
 The twin itself has a _ridiculous_ simple API.
 
 ```ruby
 class Twin::Song < Disposable::Twin
-  model ::Song                  # the persistant ActiveRecord brother class
+  model ::Song                  # the persistent ActiveRecord brother class
 
   property :title
   property :album, twin: Album  # a nested twin.
@@ -32,7 +47,7 @@ class Twin::Song < Disposable::Twin
 
 ### Creation
 
-You can create fresh, blank-slate twins yourself. They will create a new persistant object automatically.
+You can create fresh, blank-slate twins yourself. They will create a new persistent object automatically.
 
 ```ruby
 song = Twin::Song.new(title: "Justified Black Eye")
@@ -43,10 +58,11 @@ song = Twin::Song.new(title: "Justified Black Eye")
 This doesn't involve any database operations at all.
 
 
-### Creation Using Finders
+### Finders
+
+You can use any finder/scope defined in your model to create twins.
 
-(to be implemented)
-Every `Twin` subclass exposes all finders from the brother class. However, instances from the persistance layer are automatically twin'ed.
+Since `::find` is pretty common, it is defined directly on the twin class.
 
 ```ruby
 song = Twin::Song.find(1)
@@ -54,6 +70,18 @@ song = Twin::Song.find(1)
 #=> #<Twin::Song title: "Already Won" album: #<Twin::Album>>
 ```
 
+This invokes the actual finder method on the model class. Every found model will simply be wrapped in its twin.
+
+
+Any other scope or finder can be called on `finders`.
+
+```ruby
+song = Twin::Song.finders.where(name: "3 O'Clock Shot")
+
+#=> [#<Twin::Song title: "3 O'Clock Shot" album: #<Twin::Album>>]
+```
+
+
 
 ### Read And Write Access
 
@@ -65,7 +93,7 @@ song.title #=> "Already Won"
 song.album.name #=> "The Songs of Tony Sly: A Tribute"
 ```
 
-Note that writing to the twin **does not** change any state on the persistant brother.
+Note that writing to the twin **does not** change any state on the persistent brother.
 
 ```ruby
 song.title = "Still Winning" # no change on Song, no write to DB.
@@ -74,125 +102,13 @@ song.title = "Still Winning" # no change on Song, no write to DB.
 
 ### Saving
 
-Calling `#save` will sync all properties to the brother object and advice the persistant brother to save. This works recursively, meaning that nested twins will do the same with their pendant.
+Calling `#save` will sync all properties to the brother object and advice the persistent brother to save. This works recursively, meaning that nested twins will do the same with their pendant.
 
 ```ruby
 song.save # write to DB.
 ```
 
-* Twins don't know anything about the underlying persistance layer.
-* Lazy-loading
-
-
-
-## Composition
-
-hiding composed datastructures
-mapping methods, with optional as:
-
-
-## To be documented properly
-
-Facade existing (model) class
-where to decorate old instances from collections?
-  option.invoice_template => .items
-
-
-
-class Invoice
-	class Option
-	  facades InvoiceOption
-
-	  collection :items, original => :invoice_template
-	  	def items invoice_template.collect ..
-	  - or: opt.invoice_tempate.facade.
-
-	end
-
-
-Why facades?
-you don't wanna add code to existing shit
-transparently change the API
-you don't have to worry about what's happening in the underlying pile of shit (GstCalculations module), you only correct the API on top of it
-no inheritance, composition whereever possible (interfaces between layers)
-optional, still use old assets
-don't/step-wise change existing "running" code
-
-you basically don't change existing code but build extracted components on top of your legacy app
-
-* facades
-* overriding public methods in facade
-* temporary Refinements
+## Notes
 
-* steps of refactoring
-
-
-"partial refactoring"
-"explicit refactoring"
-
-
-* make it simple to split existing model into smaller (reducing validations etc)
-* mark dead code
-* by explicit use of `facade` you can track "dirt"
-
-* rename options => DSL
-
-TODO: Write a gem description
-* generator for Facades
-loading of facades?
-location of facades? i wanna have Facade::Client, not facades/ClientFacade.
-FACADE keeps all configuration in one place (like a new has_many), also you can track which methods you actually need in your data model. this wouldn't be possible that easy with inheritance.
-
-Facadable#facade
-Facade#facaded
-
-
-idea: collect # REFAC lines
-
-
-running with Rails 2.3->4.0, 1.8.7 ..as that makes sense
-
-
-## Refinement
-
-injected into instance _after_ construction
-
-## Build
-
-
-
-FacadeClass
-  extend Build
-
-  module ClassMethods
-    def initializer
-    def another_class_method # FIXME: does that work?
-
-make anonymous class, allow overriding initializer and (works?) add class methods.
-
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'disposable'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install disposable
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+* Twins don't know anything about the underlying persistance layer.
+* Lazy-loading TBI

data/disposable.gemspec

@@ -19,11 +19,12 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "uber"
-  spec.add_dependency "representable", "~> 1.8.1"
+  spec.add_dependency "representable", "~> 2.0.0"
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "minitest"
   spec.add_development_dependency "activerecord"
   spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "database_cleaner"
 end

data/gemfiles/Gemfile.rails-2.3

@@ -4,3 +4,4 @@ source "http://rubygems.org"
 gemspec :path => '../'
 
 gem 'rails', '2.3.18'
+gem 'nokogiri', '~> 1.5.0'

data/gemfiles/Gemfile.rails-2.3.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../
   specs:
-    disposable (0.0.2)
+    disposable (0.0.4)
       representable (~> 1.8.1)
       uber
 
@@ -18,11 +18,10 @@ GEM
     activeresource (2.3.18)
       activesupport (= 2.3.18)
     activesupport (2.3.18)
-    mini_portile (0.5.3)
+    database_cleaner (1.3.0)
     minitest (5.0.8)
-    multi_json (1.9.3)
-    nokogiri (1.6.1)
-      mini_portile (~> 0.5.0)
+    multi_json (1.10.0)
+    nokogiri (1.5.11)
     rack (1.1.6)
     rails (2.3.18)
       actionmailer (= 2.3.18)
@@ -32,12 +31,12 @@ GEM
       activesupport (= 2.3.18)
       rake (>= 0.8.3)
     rake (10.1.0)
-    representable (1.8.1)
+    representable (1.8.2)
       multi_json
       nokogiri
       uber
     sqlite3 (1.3.8)
-    uber (0.0.4)
+    uber (0.0.6)
 
 PLATFORMS
   ruby
@@ -45,8 +44,10 @@ PLATFORMS
 DEPENDENCIES
   activerecord
   bundler (~> 1.3)
+  database_cleaner
   disposable!
   minitest
+  nokogiri (~> 1.5.0)
   rails (= 2.3.18)
   rake
   sqlite3

data/gemfiles/Gemfile.rails-3.0.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../
   specs:
-    disposable (0.0.2)
+    disposable (0.0.4)
       representable (~> 1.8.1)
       uber
 
@@ -35,11 +35,11 @@ GEM
       abstract (>= 1.0.0)
     i18n (0.5.0)
     json (1.8.0)
-    mini_portile (0.5.3)
+    mini_portile (0.6.0)
     minitest (5.0.8)
-    multi_json (1.9.3)
-    nokogiri (1.6.1)
-      mini_portile (~> 0.5.0)
+    multi_json (1.10.0)
+    nokogiri (1.6.2.1)
+      mini_portile (= 0.6.0)
     rack (1.2.8)
     rack-mount (0.6.14)
       rack (>= 1.0.0)
@@ -54,14 +54,14 @@ GEM
     rake (10.1.0)
     rdoc (3.12.2)
       json (~> 1.4)
-    representable (1.8.1)
+    representable (1.8.2)
       multi_json
       nokogiri
       uber
     sqlite3 (1.3.8)
     thor (0.14.6)
     tzinfo (0.3.38)
-    uber (0.0.4)
+    uber (0.0.6)
 
 PLATFORMS
   ruby

data/lib/disposable/twin/finders.rb

@@ -0,0 +1,29 @@
+module Disposable::Twin::Finders
+  def find(*args)
+    finders.find(*args)
+  end
+
+  # Use Song::Twin.finders.where(..) or whatever finder/scope is defined in the model.
+  # It will return each model wrapped in a Twin.
+  def finders
+    FinderBuilder.new(self, _model)
+  end
+
+  class FinderBuilder
+    def initialize(*args)
+      @twin_class, @model_class = *args
+    end
+
+  private
+    def method_missing(*args, &block)
+      models = execute(*args, &block)
+
+      return @twin_class.new(models) unless models.respond_to?(:each) # sorry for all the magic, but that's how ActiveRecord works.
+      models.collect { |mdl| @twin_class.new(mdl) }
+    end
+
+    def execute(*args, &block)
+      @model_class.send(*args, &block)
+    end
+  end
+end

data/lib/disposable/twin.rb

@@ -4,6 +4,13 @@ require 'representable/hash'
 
 module Disposable
   class Twin
+    class Definition < Representable::Definition
+      def dynamic_options
+        super + [:twin]
+      end
+    end
+
+
     class Decorator < Representable::Decorator
       include Representable::Hash
       include AllowSymbols
@@ -13,6 +20,10 @@ module Disposable
         Class.new(self) # By subclassing, representable_attrs.clone is called.
       end
 
+      def self.definition_class
+        Definition
+      end
+
       def twin_names
         representable_attrs.
           find_all { |attr| attr[:twin] }.
@@ -44,19 +55,37 @@ module Disposable
       property(name, options.merge(:collection => true), &block)
     end
 
+    # this method should only be called in finders, and considered semi-private. it should only be called once as the top stack entry.
     def self.from(model) # TODO: private.
       new(model)
     end
 
-    def self.new(model=nil)
-      model, options = nil, model if model.is_a?(Hash) # sorry but i wanna have the same API as ActiveRecord here.
-      super(model || _model.new, *[options].compact) # TODO: make this nicer.
+    def self.new(model={}, object_map=ObjectMap.new)
+      super(model, object_map)
     end
 
-    def self.find(id)
-      new(_model.find(id))
+
+    # TODO: improve speed when setting up a twin.
+    def initialize(model, object_map)
+      options = {}
+      options, model = model, self.class._model.new if model.is_a?(Hash)
+
+
+      # model, options = nil, model if model.is_a?(Hash) # sorry but i wanna have the same API as ActiveRecord here.
+      @model = model #|| self.class._model.new
+
+      object_map[@model] = self # DISCUSS: how to we handle compositions here?
+
+      from_hash(
+        self.class.new_representer.new(@model).to_hash(:object_map => object_map). # always read from model, even when it's new.
+        merge(options)
+      )
     end
 
+
+    require 'disposable/twin/finders'
+    extend Finders
+
     # hash for #update_attributes (model API): {title: "Future World", album: <Album>}
     def self.save_representer
       # TODO: do that only at compile-time!
@@ -78,16 +107,22 @@ module Disposable
     def self.new_representer
       representer = Class.new(representer_class) # inherit configuration
 
-      # wrap incoming nested model in it's Twin.
+      # wrap incoming nested model in its Twin.
       representer.representable_attrs.
         find_all { |attr| attr[:twin] }.
         each { |attr| attr.merge!(
-          :prepare      => lambda { |object, args| args.binding[:twin].call.new(object) }) }
+          :prepare      => lambda { |object, args|
+            if twin = args.user_options[:object_map][object]
+              twin
+            else
+              args.binding[:twin].evaluate(nil).new(object, args.user_options[:object_map])
+            end
+          }) }
 
       # song_title => model.title
       representer.representable_attrs.each do |attr|
         attr.merge!(
-          :getter      => lambda { |args| send("#{args.binding[:private_name]}") },
+          :getter => lambda { |args| send("#{args.binding[:private_name]}") },
         )
       end
 
@@ -105,26 +140,23 @@ module Disposable
       representer.representable_attrs.
         each { |attr| attr.merge!(
           :representable => true,
-          :serialize => lambda { |model, args| model.save }
+          :serialize => lambda do |twin, args|
+            processed = args.user_options[:processed_map]
+
+            twin.save(processed) unless processed[twin] # don't call save if it is already scheduled.
+          end
         )}
 
       representer
     end
 
 
-    # TODO: improve speed when setting up a twin.
-    def initialize(model, options={})
-      @model = model
-
-      # DISCUSS: does the case exist where we get model AND options? if yes, test. if no, we can save the mapping and just use options.
-      from_hash(self.class.new_representer.new(model).to_hash.
-        merge(options))
-    end
-
     # it's important to stress that #save is the only entry point where we hit the database after initialize.
-    def save # use that in Reform::AR.
+    def save(processed_map=ObjectMap.new) # use that in Reform::AR.
+      processed_map[self] = true
+
       pre_save = self.class.pre_save_representer.new(self)
-      pre_save.to_hash(:include => pre_save.twin_names) # #save on nested Twins.
+      pre_save.to_hash(:include => pre_save.twin_names, :processed_map => processed_map) # #save on nested Twins.
 
 
 
@@ -150,6 +182,9 @@ module Disposable
     attr_reader :model # TODO: test
 
 
+    class ObjectMap < Hash
+    end
+
     # class Composition < self
     #   def initialize(hash)
     #     hash = hash.first

data/lib/disposable/version.rb

@@ -1,3 +1,3 @@
 module Disposable
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/lib/disposable.rb

@@ -5,8 +5,6 @@ module Disposable
   autoload :Composition,  'disposable/composition'
 end
 
-require "disposable/facade"
-
-if defined?(ActiveRecord)
-  require 'disposable/facade/active_record'
-end
+# if defined?(ActiveRecord)
+#   require 'disposable/facade/active_record'
+# end

data/test/composition_test.rb

@@ -2,7 +2,7 @@ require 'test_helper'
 
 class CompositionTest < MiniTest::Spec
   module Model
-    Band  = Struct.new(:id, :title,)
+    Band  = Struct.new(:id, :title)
     Album = Struct.new(:id, :name, :album)
   end
 

data/test/test_helper.rb

@@ -8,3 +8,8 @@ class Track
 
   attr_reader :title
 end
+
+
+require 'active_record'
+require 'database_cleaner'
+DatabaseCleaner.strategy = :truncation

data/test/twin/active_record_test.rb

@@ -1,6 +1,5 @@
 require 'test_helper'
 
-require 'active_record'
 class Album < ActiveRecord::Base
   has_many :songs
 end
@@ -33,6 +32,7 @@ class TwinActiveRecordTest < MiniTest::Spec
     class Album < Disposable::Twin
       property :id
       property :name
+      collection :songs, :twin => lambda { |*| Twin::Song }
 
       model ::Album
     end
@@ -40,13 +40,42 @@ class TwinActiveRecordTest < MiniTest::Spec
     class Song < Disposable::Twin
       property :id
       property :title
-      property :album, :twin => Album#, representable: true  #, setter: lambda { |v, args| self.album=(Album.from(v)) }
+      property :album, :twin => Album
 
       model ::Song
     end
   end
 
 
+  # new models
+  describe "::from, nested circular dependency" do
+    let (:song) { ::Song.new(:title => "Broken", :album => album) }
+    let (:album) { ::Album.new(:name => "The Process Of  Belief") }
+
+    before { album.songs = [song] } # circular dependency.
+
+    let(:twin) { Twin::Song.from(song) }
+
+    it { twin.album.songs.must_equal [twin] }
+  end
+
+  # existing, nested, models
+  describe "::from existing models, nested circular dependency" do
+    let (:song) { ::Song.create(:title => "Broken", :album => album) }
+    let (:album) { ::Album.create(:name => "The Process Of  Belief") }
+
+    before { album.songs.must_equal [song] } # circular dependency.
+
+    let(:twin) { Twin::Song.from(song) }
+
+    it { twin.album.songs.must_equal [twin] }
+
+    it do
+      twin.save
+      twin.album.songs.must_equal [twin]
+    end
+  end
+
 
   describe "::find" do
     let (:song_model) { ::Song.create(:title => "Savage") }
@@ -58,6 +87,40 @@ class TwinActiveRecordTest < MiniTest::Spec
   end
 
 
+  describe "::finders" do
+    before {
+      DatabaseCleaner.clean
+      savage
+      starlight
+    }
+    let (:savage)    { ::Song.create(:title => "Savage") }
+    let (:starlight) { ::Song.create(:title => "Starlight") }
+
+    describe "collections" do
+      subject { Twin::Song.finders.all }
+
+      it { subject.size.must_equal 2 }
+
+      it { subject[0].must_be_kind_of Twin::Song }
+      it { subject[0].id.must_equal savage.id }
+      it { subject[0].title.must_equal "Savage" }
+
+      it { subject[1].must_be_kind_of Twin::Song }
+      it { subject[1].id.must_equal starlight.id }
+      it { subject[1].title.must_equal "Starlight" }
+    end
+
+    describe "::where" do
+      subject { Twin::Song.finders.where(:title => "Starlight") }
+
+      it { subject.size.must_equal 1 }
+
+      it { subject[0].must_be_kind_of Twin::Song }
+      it { subject[0].id.must_equal starlight.id }
+      it { subject[0].title.must_equal "Starlight" }
+    end
+  end
+
 
   describe "::save, nested not set" do
     let (:twin) { Twin::Song.new(:title => "1.80 Down") }

data/test/twin/twin_test.rb

@@ -15,7 +15,7 @@ class TwinTest < MiniTest::Spec
     class Album < Disposable::Twin
       property :id # DISCUSS: needed for #save.
       property :name
-      collection :songs, :twin => Song
+      collection :songs, :twin => lambda { |*| Song }
 
       model Model::Album
     end
@@ -23,7 +23,7 @@ class TwinTest < MiniTest::Spec
     class Song < Disposable::Twin
       property :id # DISCUSS: needed for #save.
       property :title
-      property :album, :twin => Album #, setter: lambda { |v, args| self.album=(Album.from(v)) }
+      property :album, :twin => Album
 
       model Model::Song
     end

metadata

@@ -1,111 +1,125 @@
 --- !ruby/object:Gem::Specification
 name: disposable
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-21 00:00:00.000000000 Z
+date: 2014-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: uber
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: representable
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 2.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.8.1
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   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'
 - !ruby/object:Gem::Dependency
   name: minitest
   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'
 - !ruby/object:Gem::Dependency
   name: activerecord
   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'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   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'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  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: Domain-Oriented Refactoring Framework.
@@ -115,8 +129,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
+- .gitignore
+- .travis.yml
 - CHANGES.md
 - Gemfile
 - LICENSE.txt
@@ -131,13 +145,10 @@ files:
 - gemfiles/Gemfile.rails-3.0.lock
 - lib/disposable.rb
 - lib/disposable/composition.rb
-- lib/disposable/facade.rb
-- lib/disposable/facade/active_record.rb
 - lib/disposable/twin.rb
+- lib/disposable/twin/finders.rb
 - lib/disposable/version.rb
-- test/active_record_test.rb
 - test/composition_test.rb
-- test/facade_test.rb
 - test/test_helper.rb
 - test/twin/active_record_test.rb
 - test/twin/composition_test.rb
@@ -152,26 +163,23 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       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.
 test_files:
-- test/active_record_test.rb
 - test/composition_test.rb
-- test/facade_test.rb
 - test/test_helper.rb
 - test/twin/active_record_test.rb
 - test/twin/composition_test.rb
 - test/twin/twin_test.rb
-has_rdoc: 

data/lib/disposable/facade/active_record.rb

@@ -1,8 +0,0 @@
-class Disposable::Facade
-  module ActiveRecord
-    def is_a?(klass)
-      # DISCUSS: should we use facade_options here for the class?
-      klass == __getobj__.class or super
-    end
-  end
-end

data/lib/disposable/facade.rb

@@ -1,94 +0,0 @@
-require "delegate"
-require "uber/inheritable_attr"
-
-module Disposable
-  class Facade < SimpleDelegator
-    extend Uber::InheritableAttr
-    inheritable_attr :facade_options
-    self.facade_options = [nil, {}]
-
-
-    module Facadable
-      # used in facaded.
-      def facade!(facade_class=nil)
-        facade_class ||= self.class.facade_class
-        facade_class.facade!(self)
-      end
-
-      def facade(facade_class=nil)
-        facade_class ||= self.class.facade_class
-        facade_class.facade(self)
-      end
-    end
-
-
-    class << self
-      def facades(klass, options={})
-        facade_options = [klass, options] # TODO: test.
-
-        self.facade_options = facade_options
-
-        facade_class = self
-        klass.instance_eval do
-          include Facadable
-          @_facade_class = facade_class
-
-          def facade_class
-            @_facade_class
-          end
-        end # TODO: use hooks.
-      end
-
-      # TODO: move both into Facader instance.
-      def facade(facaded)
-        if facade_options.last[:if]
-          return facaded unless facade_options.last[:if].call(facaded)
-        end
-
-        # TODO: check if already facaded.
-        facade!(facaded)
-      end
-
-      def facade!(facaded)
-        new(facaded)
-      end
-    end
-
-    # Forward #id to facaded. this is only a concern in 1.8.
-    def id
-      __getobj__.id
-    end
-
-
-    alias_method :facaded, :__getobj__
-
-
-    # Extend your facade and call Song.build, includes ClassMethods (extend constructor).
-    module Subclass
-      def build(*args)
-        facade_class = self
-        Class.new(facade_options.first).class_eval do
-          include facade_class::InstanceMethods # TODO: check if exists.
-          extend facade_class::ClassMethods # TODO: check if exists.
-
-          self
-        end.new(*args)
-      end
-
-      alias_method :subclass, :build
-    end
-
-
-    module Refine
-      def initialize(facaded) # DISCUSS: should we override ::facade here?
-        super.tap do |res|
-          refine(facaded)
-        end
-      end
-
-      def refine(facaded)
-        facaded.extend(self.class::Refinements)
-      end
-    end
-  end
-end

data/test/active_record_test.rb

@@ -1,80 +0,0 @@
-require 'test_helper'
-
-require 'active_record'
-class Invoice < ActiveRecord::Base
-  has_many :invoice_items
-end
-
-class InvoiceItem < ActiveRecord::Base
-  belongs_to :invoice
-end
-
-ActiveRecord::Base.establish_connection(
-  :adapter => "sqlite3",
-  :database => "#{Dir.pwd}/database.sqlite3"
-)
-
-# ActiveRecord::Schema.define do
-#   create_table :invoices do |table|
-#     table.timestamps
-#   end
-# end
-
-# ActiveRecord::Schema.define do
-#   create_table :invoice_items do |table|
-#     table.column :invoice_id, :string
-#     table.timestamps
-#   end
-# end
-
-# TODO: test auto-loading of Rails assets.
-require 'disposable/facade/active_record'
-
-class ActiveRecordAssociationsTest < MiniTest::Spec
-  class Item < Disposable::Facade
-    facades InvoiceItem
-
-    include Disposable::Facade::ActiveRecord
-  end
-
-  let (:invoice) { Invoice.new }
-  it "allows adding facades to associations" do
-    # tests #is_a?
-    InvoiceItem.new.facade.class.must_equal Item
-    InvoiceItem.new.facade.is_a?(InvoiceItem).must_equal true
-
-    invoice.invoice_items << InvoiceItem.new.facade
-  end
-
-
-  class InvoiceFacade < Disposable::Facade
-    facades ::Invoice
-
-    include Disposable::Facade::ActiveRecord
-    #has_many :items, :class_name => ::InvoiceItem, :foreign_key_name => :invoice_item_id
-
-    module InstanceMethods # IncludeMethods, Included
-      extend ActiveSupport::Concern
-      included do
-        has_many :items, :class_name => ::InvoiceItem, :foreign_key => :invoice_item_id
-
-        def self.name
-          "anon"
-        end
-
-      end
-    end
-    module ClassMethods # ExtendMethods, Extended
-    end
-
-    extend Disposable::Facade::Subclass
-  end
-
-  it "what" do
-    invoice = InvoiceFacade.subclass
-    invoice.items << item = InvoiceItem.new
-    # TODO: test items << Facade::Item.new
-
-    invoice.items.must_equal([item])
-  end
-end

data/test/facade_test.rb

@@ -1,128 +0,0 @@
-require 'test_helper'
-
-class FacadeTest < MiniTest::Spec
-  class Track < ::Track
-  end
-
-  class Song < Disposable::Facade
-    facades Track
-  end
-
-  class Hit < Disposable::Facade
-  end
-
-  let (:track) { Track.new }
-
-  it { track.class.must_equal Track }
-  it { track.facade.class.must_equal Song }
-
-  it "allows passing facade name" do # FIXME: what if track doesn't have Facadable?
-    track.facade(Hit).class.must_equal Hit
-  end
-  # DISCUSS: should this be Hit.facade(track) ?
-
-  describe "::facade" do
-    it { Hit.facade(track).class.must_equal Hit }
-  end
-
-  it "facades only once" do
-  end
-
-  describe "#id" do
-    let (:track) do Track.new.instance_eval {
-      def id; 1; end
-      self }
-    end
-
-    # DISCUSS: this actually tests Facadable.
-    it "calls original" do
-      track.facade.id.must_equal 1
-    end
-  end
-
-  it "responds to #facaded" do
-    Song.new(facaded = Object.new).facaded.must_equal facaded
-  end
-end
-
-class FacadesWithOptionsTest < MiniTest::Spec
-  class Track < ::Track
-  end
-
-  class Song < Disposable::Facade
-    facades Track, :if => lambda { |t| t.title }
-  end
-
-  it { Track.new(:title => "Trudging").facade.class.must_equal Song }
-  it { Track.new.facade.class.must_equal Track }
-
-  describe "#facade!" do
-    it "ignores :if" do
-      Track.new.facade!.class.must_equal Song
-    end
-  end
-end
-
-class SubclassTest < MiniTest::Spec
-  class Track
-    attr_reader :title
-
-    def initialize(options)
-      @title = options[:title] # we only save this key.
-      raise "rename didn't work" if options[:name]
-    end
-  end
-
-#require 'disposable/facade/active_record'
-  class Song < Disposable::Facade
-    facades Track
-    # has_one :album
-    # rename_options
-
-    extend Subclass # do ... end instead of ClassMethods.
-    #include Disposable::Facade::ActiveRecord
-
-    module InstanceMethods
-      # DISCUSS: this could be initializer do .. end
-      def initialize(options)
-        options[:title ] = options.delete(:name)
-        super
-      end
-    end
-    module ClassMethods
-
-    end
-  end
-
-  #it { Track.facade(Song).new(:name => "Bombs Away").title.must_equal "Bombs Away" }
-  it { Song.subclass(:name => "Bombs Away").title.must_equal "Bombs Away" }
-  # it "what" do
-  #   Song.build(:name => "Bombs Away").facade(Song).is_a?(Track).must_equal true
-  # end
-end
-
-
-class RefinementsTest < MiniTest::Spec
-  class Track
-    def length
-      duration.round(2)
-    end
-
-    def duration
-      4.321
-    end
-  end
-
-  class Song < Disposable::Facade
-    facades Track
-    include Disposable::Facade::Refine
-
-    module Refinements
-      def duration
-        5.309
-      end
-    end
-  end
-
-  it { Track.new.facade.length.must_equal 5.31 }
-end