rose 0.0.5

data/lib/rose/seedling.rb

@@ -0,0 +1,75 @@
+require 'rose/proxy'
+
+module Rose
+  # Defines the Rose DSL
+  class Seedling
+    # @return [Rose::Proxy::Row] the row proxy containing an array of Attributes
+    attr_reader :row
+
+    # @return [Rose::Proxy::Root] the root proxy containing attribute finder and updater
+    attr_reader :root
+
+    # @return [ObjectAdapter] the adapter
+    attr_reader :adapter
+
+    # @return [Hash] the options used by the adapter
+    attr_reader :options
+
+    # @return [Array] the alterations to be applied to the sprouted Seedling (the report)
+    attr_reader :alterations
+
+    # @param [ObjectAdapter] adapter An ObjectAdapter capable of sprouting a Seedling 
+    #   (running the report)
+    # @param [Hash] options 
+    # @option options [Class] :class (nil) Used during by the adapter to enforce items types
+    def initialize(adapter, options={})
+      @adapter     = adapter
+      @options     = options
+      @alterations = @options[:alterations] = []
+    end
+
+    # @yield Proxy::Row
+    def rows(&blk)
+      proxy = Proxy::Row.new
+      proxy.instance_eval(&blk)
+      @row = proxy
+    end
+
+    # @param [String, Symbol] column_name the column to sort by
+    # @param [:ascending, :descending] order the order to sort by
+    def sort(column_name, order = :ascending, &sort_block)
+      @options[:sort] = Attribute::Sort.new(column_name, order, &sort_block)
+      @alterations << @options[:sort]
+    end
+
+    # @yield Rose::Attribute::Filter
+    def filter(&filter_block)
+      @options[:filter] = Attribute::Filter.new(nil, nil, filter_block)
+      @alterations << @options[:filter]
+    end
+
+    # @param [String, Symbol] column_name the column to group by
+    # @yield Proxy::Summary
+    def summary(column_name, &blk)
+      proxy = Proxy::Summary.new(column_name)
+      proxy.instance_eval(&blk)
+      @options[:summary] = proxy
+      @alterations << @options[:summary]
+    end
+
+    # @param [String, Symbol] group_column the column to use for row data
+    # @param [String, Symbol] pivot_column the column to use for column data
+    # @param [Proc] value_block the block used to evalue the value data
+    def pivot(group_column, pivot_column, &value_block)
+      @options[:pivot] = Attribute::Pivot.new(group_column, pivot_column, value_block)
+      @alterations << @options[:pivot]
+    end
+
+    # @yield Proxy::Root
+    def roots(&blk)
+      proxy = Proxy::Root.new
+      proxy.instance_eval(&blk)
+      @root = proxy
+    end
+  end
+end

data/lib/rose/shell.rb

@@ -0,0 +1,40 @@
+module Rose
+  # This class is a wrapper around Seedling that provides methods
+  # we don't want invoked within the Rose#make DSL.
+  #
+  # A seedling with a shell is still a seedling. Hence, it should
+  # be have as such!
+  class Shell
+    # @return [Rose::Seedling] the current seedling
+    attr_reader :seedling
+
+    def initialize(seedling)
+      @seedling = seedling
+    end
+
+    # Provides bulk exporting
+    # @param [Array] items the items to sprout the seedling with
+    # @return [Ruport::Data::RoseTable] the resulting table
+    def bloom(items=[], options={})
+      @seedling.adapter.sprout(@seedling, @seedling.options.merge(options).merge(
+        :attributes => @seedling.row.attributes,
+        :items => items
+      ))
+    end
+
+    # Provides bulk importing
+    # @param [Hash] options
+    # @option options [Hash,String] :with (required) a Hash of identity (id) => attribute pairs, or a String to a CSV file to update the seedling with
+    # @option options [true, false] :preview (false) whether or not to use the previewer
+    def photosynthesize(items=[], options={})
+      @seedling.adapter.osmosis(@seedling, @seedling.options.merge(options).merge(
+        :items => items
+      ))
+    end
+
+    # Delegates methods to the current seedling
+    def method_missing(*args, &blk)
+      @seedling.send(*args, &blk)
+    end
+  end
+end

data/rose.gemspec

@@ -0,0 +1,86 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rose}
+  s.version = "0.0.5"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Henry Hsu"]
+  s.date = %q{2010-07-07}
+  s.description = %q{A slick Ruby DSL for reporting.}
+  s.email = %q{henry@qlane.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".autotest",
+     ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "features/rose.feature",
+     "features/step_definitions/rose_steps.rb",
+     "features/support/env.rb",
+     "lib/rose.rb",
+     "lib/rose/active_record.rb",
+     "lib/rose/attribute.rb",
+     "lib/rose/core_extensions.rb",
+     "lib/rose/object.rb",
+     "lib/rose/proxy.rb",
+     "lib/rose/ruport.rb",
+     "lib/rose/seedling.rb",
+     "lib/rose/shell.rb",
+     "rose.gemspec",
+     "spec/core_extensions_spec.rb",
+     "spec/db/schema.rb",
+     "spec/examples/update_flowers.csv",
+     "spec/examples/update_posts.csv",
+     "spec/rose/active_record_spec.rb",
+     "spec/rose/object_spec.rb",
+     "spec/rose_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/hsume2/rose}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Reporting like a spring rose, rows and rows of it}
+  s.test_files = [
+    "spec/core_extensions_spec.rb",
+     "spec/db/schema.rb",
+     "spec/rose/active_record_spec.rb",
+     "spec/rose/object_spec.rb",
+     "spec/rose_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<ruport>, [">= 1.6.3"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_development_dependency(%q<cucumber>, [">= 0"])
+    else
+      s.add_dependency(%q<ruport>, [">= 1.6.3"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<cucumber>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<ruport>, [">= 1.6.3"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<cucumber>, [">= 0"])
+  end
+end
+

data/spec/core_extensions_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+class MyObject
+  include Rose::CoreExtensions
+end
+
+describe "CoreExtensions" do
+  before do
+    @o = MyObject.new
+  end
+
+  describe "#require_keys" do
+    it "should raise exception if missing required key" do
+      lambda {
+        @o.require_keys({:name => 'foo'}, :value)
+      }.should raise_error(ArgumentError, "Missing required key(s): value")
+    end
+
+    it "should not raise exception if not missing required key" do
+      lambda {
+        @o.require_keys({:name => 'foo', :value => 'bar'}, :value)
+      }.should_not raise_error
+    end
+
+    it "should raise exception if missing required keys" do
+      lambda {
+        @o.require_keys({}, :name, :value)
+      }.should raise_error(ArgumentError, "Missing required key(s): name, value")
+    end
+
+    it "should not raise exception if not missing required keys" do
+      lambda {
+        @o.require_keys({:name => 'foo', :value => 'bar'}, :name, :value)
+      }.should_not raise_error
+    end
+  end
+
+  describe "#required_values" do
+    it "should return values of required keys" do
+      @o.expects(:require_keys).with({:name => 'foo', :value => 'bar'}, :name, :value)
+      foo, bar = @o.required_values({:name => 'foo', :value => 'bar'}, :name, :value)
+      foo.should == 'foo'
+      bar.should == 'bar'
+    end
+
+    it "should return value of required key" do
+      @o.expects(:require_keys).with({:name => 'foo', :value => 'bar'}, :name)
+      foo = @o.required_values({:name => 'foo', :value => 'bar'}, :name)
+      foo.should == 'foo'
+    end
+  end
+end

data/spec/db/schema.rb

@@ -0,0 +1,32 @@
+ActiveRecord::Schema.define(:version => 0) do
+  create_table :people, :force => true do |t|
+    t.column :name, :string
+    t.column :type, :string
+    t.column :password, :string
+    t.column :admin, :boolean, :default => false
+  end
+  
+  create_table :posts, :force => true do |t|
+    t.column :guid, :string
+    t.column :title, :string
+    t.column :body, :text
+    t.column :published, :boolean, :default => true
+  end
+  
+  create_table :comments, :force => true do |t|
+    t.column :post_id, :integer
+    t.column :author_id, :integer
+    t.column :body, :text
+  end
+  
+  create_table :subjects, :force => true do |t|
+    t.column :name, :string
+  end
+  
+  create_table :tests, :force => true do |t|
+    t.column :student_id, :integer
+    t.column :subject_id, :integer
+    t.column :score, :decimal
+    t.timestamps
+  end
+end

data/spec/examples/update_flowers.csv

@@ -0,0 +1,4 @@
+ID,Type,Color,Age
+0,roses,blue,1
+1,violets,red,2
+2,roses,green,3

data/spec/examples/update_posts.csv

@@ -0,0 +1,5 @@
+ID,Title,Comments
+P1,Post #1,2
+P2,Post #2,1
+P3,Third Post,0
+P4,Fourth Post,0

data/spec/rose/active_record_spec.rb

@@ -0,0 +1,434 @@
+require 'spec_helper'
+require 'rose/active_record'
+
+module RoseActiveRecordSpecs
+  class Person < ActiveRecord::Base
+    attr_protected :password
+  end
+
+  class Admin < Person
+  end
+
+  class Post < ActiveRecord::Base
+    has_many :comments
+  end
+
+  class Comment < ActiveRecord::Base
+    belongs_to :post
+    belongs_to :author, :class_name => "Person"
+  end
+
+  class Subject < ActiveRecord::Base
+    has_many :tests
+  end
+
+  class Test < ActiveRecord::Base
+    belongs_to :subject
+    belongs_to :student, :class_name => "Person"
+  end
+
+  describe Rose, "ActiveRecord adapter" do
+    before(:suite) do
+      # ActiveRecord::Base.logger = Logger.new(File.dirname(__FILE__) + "/log/test.log")
+      ActiveRecord::Migration.verbose = false
+      ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => ":memory:")
+      load(File.dirname(__FILE__) + "/../db/schema.rb")
+
+      person_1 = Person.create(:name => "Person #1")
+      person_2 = Person.create(:name => "Person #2")
+
+      post_1 = Post.create(:title => "Post #1", :guid => "P1")
+      post_1.comments.create(:author => person_1)
+      post_1.comments.create(:author => person_2)
+      post_2 = Post.create(:title => "Post #2", :guid => "P2")
+      post_2.comments.create(:author => person_2)
+    end
+
+    describe "make report" do
+      before do
+        Post.rose(:post_comments) do
+          rows do
+            column("Post", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+        end
+
+        Post.rose(:post_comments_sorted_asc) do
+          rows do
+            column("Post", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+          sort("Comments", :ascending)
+        end
+
+        Post.rose(:post_comments_sorted_desc) do
+          rows do
+            column("Post", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+          sort("Comments", :descending)
+        end
+      end
+
+      it "should report on posts' comments" do
+        Post.rose_for(:post_comments).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +--------------------+
+        |  Post   | Comments |
+        +--------------------+
+        | Post #1 | 2        |
+        | Post #2 | 1        |
+        +--------------------+
+        eo_table
+      end
+
+      it "should order by comments size" do
+        Post.rose_for(:post_comments_sorted_asc).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +--------------------+
+        |  Post   | Comments |
+        +--------------------+
+        | Post #2 | 1        |
+        | Post #1 | 2        |
+        +--------------------+
+        eo_table
+
+        Post.rose_for(:post_comments_sorted_desc).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +--------------------+
+        |  Post   | Comments |
+        +--------------------+
+        | Post #1 | 2        |
+        | Post #2 | 1        |
+        +--------------------+
+        eo_table
+      end
+
+      it "should report only posts with #2" do
+        Post.rose_for(:post_comments, :conditions => ["title like ?", "%#2%"]).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +--------------------+
+        |  Post   | Comments |
+        +--------------------+
+        | Post #2 | 1        |
+        +--------------------+
+        eo_table
+      end
+    end
+
+    describe "make report with sigma" do
+      before do
+        Comment.rose(:author_comments) do
+          rows do
+            column("Author") { |item| item.author.name }
+            column("Posts") { |item| item.post.title }
+            column("Comments") { |item| true }
+          end
+          summary("Author") do
+            column("Posts") { |posts| posts.join(", ") }
+            column("Comments") { |comments| comments.size }
+          end
+        end
+      end
+
+      it "should get authors and their comments" do
+        Comment.rose_for(:author_comments).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-----------------------------------------+
+        |  Author   |      Posts       | Comments |
+        +-----------------------------------------+
+        | Person #1 | Post #1          |        1 |
+        | Person #2 | Post #1, Post #2 |        2 |
+        +-----------------------------------------+
+        eo_table
+      end
+    end
+
+    describe "make report with pivot" do
+      it "should make report with pivot" do
+        elisa = Person.create(:name => "Elisa")
+        mary = Person.create(:name => "Mary")
+        english = Subject.create(:name => "English")
+        math = Subject.create(:name => "Math")
+        science = Subject.create(:name => "Science")
+        art = Subject.create(:name => "Art")
+        history = Subject.create(:name => "History")
+        french = Subject.create(:name => "French")
+
+        Test.create(:student => elisa, :subject => english, :score => 87, :created_at => Date.parse('January 2010'))
+        Test.create(:student => elisa, :subject => math, :score => 65, :created_at => Date.parse('January 2010'))
+        Test.create(:student => elisa, :subject => science, :score => 58, :created_at => Date.parse('January 2010'))
+        Test.create(:student => elisa, :subject => art, :score => 89, :created_at => Date.parse('January 2010'))
+        Test.create(:student => elisa, :subject => history, :score => 81, :created_at => Date.parse('January 2010'))
+        Test.create(:student => elisa, :subject => french, :score => 62, :created_at => Date.parse('January 2010'))
+
+        Test.create(:student => elisa, :subject => english, :score => 51, :created_at => Date.parse('February 2010'))
+        Test.create(:student => elisa, :subject => math, :score => 72, :created_at => Date.parse('February 2010'))
+        Test.create(:student => elisa, :subject => science, :score => 89, :created_at => Date.parse('February 2010'))
+        Test.create(:student => elisa, :subject => art, :score => 83, :created_at => Date.parse('February 2010'))
+        Test.create(:student => elisa, :subject => history, :score => 84, :created_at => Date.parse('February 2010'))
+        Test.create(:student => elisa, :subject => french, :score => 57, :created_at => Date.parse('February 2010'))
+
+        Test.create(:student => elisa, :subject => english, :score => 41, :created_at => Date.parse('March 2010'))
+        Test.create(:student => elisa, :subject => math, :score => 71, :created_at => Date.parse('March 2010'))
+        Test.create(:student => elisa, :subject => science, :score => 41, :created_at => Date.parse('March 2010'))
+        Test.create(:student => elisa, :subject => art, :score => 92, :created_at => Date.parse('March 2010'))
+        Test.create(:student => elisa, :subject => history, :score => 91, :created_at => Date.parse('March 2010'))
+        Test.create(:student => elisa, :subject => french, :score => 56, :created_at => Date.parse('March 2010'))
+
+        Test.create(:student => mary, :subject => english, :score => 87, :created_at => Date.parse('January 2010'))
+        Test.create(:student => mary, :subject => math, :score => 53, :created_at => Date.parse('January 2010'))
+        Test.create(:student => mary, :subject => science, :score => 35, :created_at => Date.parse('January 2010'))
+        Test.create(:student => mary, :subject => art, :score => 61, :created_at => Date.parse('January 2010'))
+        Test.create(:student => mary, :subject => history, :score => 58, :created_at => Date.parse('January 2010'))
+        Test.create(:student => mary, :subject => french, :score => 92, :created_at => Date.parse('January 2010'))
+
+        Test.create(:student => mary, :subject => english, :score => 68, :created_at => Date.parse('February 2010'))
+        Test.create(:student => mary, :subject => math, :score => 54, :created_at => Date.parse('February 2010'))
+        Test.create(:student => mary, :subject => science, :score => 56, :created_at => Date.parse('February 2010'))
+        Test.create(:student => mary, :subject => art, :score => 59, :created_at => Date.parse('February 2010'))
+        Test.create(:student => mary, :subject => history, :score => 61, :created_at => Date.parse('February 2010'))
+        Test.create(:student => mary, :subject => french, :score => 93, :created_at => Date.parse('February 2010'))
+
+        Test.create(:student => mary, :subject => english, :score => 41, :created_at => Date.parse('March 2010'))
+        Test.create(:student => mary, :subject => math, :score => 35, :created_at => Date.parse('March 2010'))
+        Test.create(:student => mary, :subject => science, :score => 41, :created_at => Date.parse('March 2010'))
+        Test.create(:student => mary, :subject => art, :score => 48, :created_at => Date.parse('March 2010'))
+        Test.create(:student => mary, :subject => history, :score => 67, :created_at => Date.parse('March 2010'))
+        Test.create(:student => mary, :subject => french, :score => 90, :created_at => Date.parse('March 2010'))
+
+        Test.rose(:scores) do
+          rows do
+            column("Month") { |test| I18n.l(test.created_at, :format => :short) }
+            column("Subject") { |test| test.subject.name }
+            column("Student") { |test| test.student.name }
+            column(:score => "Score")
+          end
+          pivot("Month", "Subject") do |matching_rows|
+            matching_rows.map(&:Score).map(&:to_f).sum
+          end
+        end
+
+        Test.rose_for(:scores).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +---------------------------------------------------------------------+
+        |    Month     |  Art  | Science | English | French | Math  | History |
+        +---------------------------------------------------------------------+
+        | 01 Jan 00:00 | 150.0 |    93.0 |   174.0 |  154.0 | 118.0 |   139.0 |
+        | 01 Feb 00:00 | 142.0 |   145.0 |   119.0 |  150.0 | 126.0 |   145.0 |
+        | 01 Mar 00:00 | 140.0 |    82.0 |    82.0 |  146.0 | 106.0 |   158.0 |
+        +---------------------------------------------------------------------+
+        eo_table
+      end
+    end
+
+    describe "run report" do
+      before do
+        Comment.rose(:author_comments) do
+          rows do
+            column("Author") { |item| item.author.name }
+            column("Posts") { |item| item.post.title }
+            column("Comments") { |item| item.destroy }
+          end
+        end
+      end
+
+      it "should run report within transaction" do
+        all_sizes = lambda { [Person.count, Post.count, Comment.count] }
+
+        lambda {
+          Comment.rose_for(:author_comments)
+        }.should_not change(all_sizes, :call)
+      end
+    end
+
+    describe "import report" do
+      before do
+        Post.rose(:with_update) {
+          rows do
+            identity(:guid => "ID")
+            column("Title", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+
+          sort("Comments", :descending)
+
+          roots do
+            find do |items, idy|
+              items.find { |item| item.guid == idy }
+            end
+            update do |record, updates|
+              record.update_attribute(:title, updates["Title"])
+            end
+          end
+        }
+
+        @post_3 = Post.create(:title => "Post #3", :guid => "P3")
+        @post_4 = Post.create(:title => "Post #4", :guid => "P4")
+      end
+
+      after do
+        @post_3.destroy; @post_4.destroy
+      end
+
+      it "should update report" do
+        Post.root_for(:with_update, {
+          :with => {
+            "P3" => { "Title" => "Third Post", "something" => "else" },
+            "P4" => { "Title" => "Fourth Post" }
+          }
+        }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-----------------------------+
+        | ID |    Title    | Comments |
+        +-----------------------------+
+        | P1 | Post #1     | 2        |
+        | P2 | Post #2     | 1        |
+        | P4 | Fourth Post | 0        |
+        | P3 | Third Post  | 0        |
+        +-----------------------------+
+        eo_table
+
+        Post.all.map(&:title).should == ["Post #1", "Post #2", "Third Post", "Fourth Post"]
+      end
+
+      it "should update report with conditions" do
+        Post.root_for(:with_update, {
+          :with => {
+            "P3" => { "Title" => "Third Post", "something" => "else" },
+            "P4" => { "Title" => "Fourth Post" }
+          }
+        }, { :conditions => ["title like ?", "%#3%"] }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +----------------------------+
+        | ID |   Title    | Comments |
+        +----------------------------+
+        | P3 | Third Post | 0        |
+        +----------------------------+
+        eo_table
+
+        Post.all.map(&:title).should == ["Post #1", "Post #2", "Third Post", "Post #4"]
+      end
+
+      it "should update report from CSV" do
+        Post.root_for(:with_update, {
+          :with => "spec/examples/update_posts.csv"
+        }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-----------------------------+
+        | ID |    Title    | Comments |
+        +-----------------------------+
+        | P1 | Post #1     | 2        |
+        | P2 | Post #2     | 1        |
+        | P4 | Fourth Post | 0        |
+        | P3 | Third Post  | 0        |
+        +-----------------------------+
+        eo_table
+
+        Post.all.map(&:title).should == ["Post #1", "Post #2", "Third Post", "Fourth Post"]
+      end
+    end
+    
+    describe "preview import report" do
+      before do
+        Post.rose(:for_import) {
+          rows do
+            identity(:guid => "ID")
+            column("Title", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+    
+          sort("Comments", :descending)
+    
+          roots do
+            find do |items, idy|
+              items.find { |item| item.guid == idy }
+            end
+            preview_update do |record, updates|
+              record.title = updates["Title"]
+            end
+            update { raise Exception, "not me!" }
+          end
+        }
+      end
+    
+      it "should preview changes" do
+        Post.root_for(:for_import, {
+          :with => {
+            "P1" => { "Title" => "First Post", "something" => "else" },
+            "P2" => { "Title" => "Second Post" }
+          },
+          :preview => true
+        }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-----------------------------+
+        | ID |    Title    | Comments |
+        +-----------------------------+
+        | P1 | First Post  | 2        |
+        | P2 | Second Post | 1        |
+        +-----------------------------+
+        eo_table
+    
+        Post.all.map(&:title).should == ["Post #1", "Post #2"]
+      end
+    end
+    
+    describe "create import report" do
+      before do
+        Post.rose(:for_create) {
+          rows do
+            identity(:guid => "ID")
+            column("Title", &:title)
+            column("Comments") { |item| item.comments.size }
+          end
+    
+          sort("Comments", :descending)
+    
+          roots do
+            find do |items, idy|
+              items.find { |item| item.guid == idy }
+            end
+            preview_create do |idy, updates|
+              post = Post.new(:guid => idy)
+              post.title = updates["Title"]
+              post
+            end
+            create do |idy, updates|
+              post = create_previewer.call(idy, updates)
+              post.save!
+              post
+            end
+          end
+        }
+      end
+      
+      it "should preview create" do
+        Post.root_for(:for_create, {
+          :with => {
+            "P3" => { "Title" => "Post #3" }
+          },
+          :preview => true
+        }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-------------------------+
+        | ID |  Title  | Comments |
+        +-------------------------+
+        | P1 | Post #1 | 2        |
+        | P2 | Post #2 | 1        |
+        | P3 | Post #3 | 0        |
+        +-------------------------+
+        eo_table
+      end
+      
+      it "should create" do
+        Post.root_for(:for_create, {
+          :with => {
+            "P3" => { "Title" => "Post #3" }
+          }
+        }).should match_table <<-eo_table.gsub(%r{^        }, '')
+        +-------------------------+
+        | ID |  Title  | Comments |
+        +-------------------------+
+        | P1 | Post #1 | 2        |
+        | P2 | Post #2 | 1        |
+        | P3 | Post #3 | 0        |
+        +-------------------------+
+        eo_table
+        
+        Post.last.title.should == "Post #3"
+        
+        Post.last.destroy
+      end
+    end
+  end
+
+end