tabletastic 0.2.0.pre → 0.2.0.pre2

data/CHANGELOG.rdoc

@@ -1,7 +1,11 @@
-Git
+Git (for upcoming v0.2.0 release)
+
 * Updating to Rails3 API and idioms
+* Adding default table html options
+* Adding default lambda (table block) so that table_for can be called without passing a block
 
 v0.1.3 (Dec 28, 2009)
+
 * Changing destroy action to have confirmation by default
 
 v0.1.2 (Nov 25, 2009)

data/README.rdoc

@@ -210,6 +210,63 @@ will product html like:
 
 If it _still_ isn't flexible enough for your needs, it might be time to return to static html/erb.
 
+== Default Options and Tabletastic initializer
+
+As of version 0.2.0, you can now setup some of your own defaults in an initializer file.
+
+For example, create a file called tabletastic.rb in your config/initializers folder.
+
+Within that file, there are several defaults that you can setup for yourself, including:
+
+  Tabletastic.default_table_html
+  Tabletastic.default_table_block
+
+Both of these options are setup up so that inline options will still override whatever they are set to,
+but providing them here will save you some code if you commonly reuse options.
+
+By default, +default_table_html+ is simple an empty hash <code>{}</code>. By providing your own defaults, you can ensure that all
+of your tables have a specific html +class+ or +cellspacing+, or whatever.
+
+If <code>Tabletastic.default_table_html</code> is set to <code>{:cellspacing => 0, :class => 'yowza'}</code>,
+then all tabletastic tables will have this html by default, unless overridden:
+
+  table_for(@posts) do |t|
+
+will produce:
+
+  <table class="yowza" cellspacing="0" id="posts">
+
+Similarly, all of those calls to +table_for+ can get boring since you might be using the same block every time.
+The option +default_table_block+ lets you set a default lambda so that you can omit the block with +table_for+.
+Since by default +default_table_block+ is set to <code>lambda{|table| table.data}</code>, the following:
+
+  <%= table_for(@posts) %>
+
+will be the same as
+
+  <%= table_for(@posts) do |t|
+        t.data
+      end %>
+
+However, just like +default_table_html+, you can set a different block in the initializer file for your block to default to.
+For example:
+
+  Tabletastic.default_table_block = lambda {|table| table.data :actions => :all }
+
+will make the following equivalent:
+
+  <%= table_for(@posts) %>
+
+  <%= table_for(@posts) do |t|
+        t.data :actions => :all
+      end %>
+
+And to omit those action links, you can just use +table_for+ the old-fashioned way:
+
+  <%= table_for(@posts) do |t|
+        t.data
+      end %>
+
 == Note on Patches/Pull Requests
 
 * Fork the project.

data/init.rb

@@ -0,0 +1,2 @@
+# Include hook code here
+require 'tabletastic'

data/lib/tabletastic/helper.rb

@@ -0,0 +1,36 @@
+module Tabletastic
+  module Helper
+    # returns and outputs a table for the given active record collection
+    def table_for(collection, *args, &block)
+      block = Tabletastic.default_table_block unless block_given?
+      klass = default_class_for(collection)
+      options = args.extract_options!
+      initialize_html_options(options, klass)
+      result = block.call(TableBuilder.new(collection, klass, self))
+
+      content_tag(:table, result, options[:html])
+    end
+
+    private
+    # Finds the class representing the objects within the collection
+    def default_class_for(collection)
+      if collection.respond_to?(:proxy_reflection)
+        collection.proxy_reflection.klass
+      elsif !collection.empty?
+        collection.first.class
+      end
+    end
+
+    def initialize_html_options(options, klass)
+      options[:html] ||= {}
+      options[:html][:id] ||= get_id_for(klass)
+      options[:html].reverse_merge!(Tabletastic.default_table_html)
+    end
+
+    def get_id_for(klass)
+      klass ? klass.model_name.collection : ""
+    end
+  end
+end
+
+ActionView::Base.send :include, Tabletastic::Helper

data/lib/tabletastic/version.rb

@@ -1,3 +1,3 @@
 module Tabletastic
-  VERSION = "0.2.0.pre"
+  VERSION = "0.2.0.pre2"
 end

data/lib/tabletastic.rb

@@ -1,28 +1,9 @@
 require 'tabletastic/table_builder'
+require 'tabletastic/helper'
 
 module Tabletastic
-  # returns and outputs a table for the given active record collection
-  def table_for(collection, *args, &block)
-    raise ArgumentError, "you must provide a block" unless block_given?
-    klass = default_class_for(collection)
-    options = args.extract_options!
-    options[:html] ||= {}
-    options[:html][:id] ||= get_id_for(klass)
-    result = block.call(TableBuilder.new(collection, klass, self))
-    content_tag(:table, result, options[:html])
-  end
+  @@default_table_html = {}
+  @@default_table_block = lambda {|table| table.data}
 
-  private
-  # Finds the class representing the objects within the collection
-  def default_class_for(collection)
-    if collection.respond_to?(:proxy_reflection)
-      collection.proxy_reflection.klass
-    elsif !collection.empty?
-      collection.first.class
-    end
-  end
-
-  def get_id_for(klass)
-    klass ? klass.model_name.collection : ""
-  end
+  mattr_accessor :default_table_html, :default_table_block
 end

data/spec/spec_helper.rb

@@ -17,9 +17,9 @@ smart_require 'rspec', '>= 1.3.0', 'spec'
 require 'spec/autorun'
 smart_require 'nokogiri'
 smart_require 'rspec_tag_matchers', '>= 1.0.0'
-smart_require 'activesupport', '>= 3.0.0.beta2', 'active_support'
-smart_require 'actionpack',    '>= 3.0.0.beta2', 'action_pack'
-smart_require 'activerecord',  '>= 3.0.0.beta2', 'active_record'
+smart_require 'activesupport', '>= 3.0.0.beta3', 'active_support'
+smart_require 'actionpack',    '>= 3.0.0.beta3', 'action_pack'
+smart_require 'activerecord',  '>= 3.0.0.beta3', 'active_record'
 require 'action_controller'
 require 'action_view/base'
 require 'action_view/template'
@@ -113,3 +113,4 @@ end
 
 include TabletasticSpecHelper
 include Tabletastic
+include Tabletastic::Helper

data/spec/tabletastic_spec.rb

@@ -23,4 +23,28 @@ describe "Tabletastic#table_for" do
       end
     end
   end
+
+  describe "default options" do
+    before do
+      Tabletastic.default_table_html = {:class => 'default', :cellspacing => 0}
+    end
+
+    it "should allow default table html to be set" do
+      concat(table_for([]){})
+      output_buffer.should have_tag("table.default")
+    end
+
+    it "can be overridden with inline options" do
+      concat(table_for([], :html => {:class => 'newclass'}){})
+      output_buffer.should have_tag("table.newclass")
+      output_buffer.should_not have_tag("table.default")
+    end
+  end
+  
+  describe "without a block" do
+    it "should use default block" do
+      concat table_for([])
+      output_buffer.should have_tag("table")
+    end
+  end
 end

metadata

@@ -6,8 +6,8 @@ version: !ruby/object:Gem::Version
   - 0
   - 2
   - 0
-  - pre
-  version: 0.2.0.pre
+  - pre2
+  version: 0.2.0.pre2
 platform: ruby
 authors: 
 - Joshua Davey
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-10 00:00:00 -05:00
+date: 2010-04-18 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,7 @@ dependencies:
         version: "0"
   type: :development
   version_requirements: *id001
-description: A table builder for active record collections   that produces semantically rich and accessible markup
+description: A table builder for active record collections that produces semantically rich and accessible table markup
 email: josh@joshuadavey.com
 executables: []
 
@@ -40,6 +40,7 @@ extra_rdoc_files:
 - README.rdoc
 - LICENSE
 files: 
+- lib/tabletastic/helper.rb
 - lib/tabletastic/table_builder.rb
 - lib/tabletastic/table_field.rb
 - lib/tabletastic/version.rb
@@ -47,6 +48,7 @@ files:
 - LICENSE
 - README.rdoc
 - CHANGELOG.rdoc
+- init.rb
 has_rdoc: true
 homepage: http://github.com/jgdavey/tabletastic
 licenses: []
@@ -70,8 +72,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       segments: 
       - 1
       - 3
-      - 5
-      version: 1.3.5
+      - 6
+      version: 1.3.6
 requirements: []
 
 rubyforge_project: