easy-table 0.2.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/.rspec

@@ -0,0 +1 @@
+--format nested --color

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Kristian Mandrup
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,167 @@
+# Easy Table
+
+Table helpers for your views to facilitate creating tables using a nice DSL similar to what 'simpleform' and 'formtastic' are for forms ;)
+
+## Install
+
+<code>gem install easy-table</code>
+
+## Demo
+
+<pre> 
+  <code>
+  data_table @posts, %w{Id Title}, :summary => 'many posts', :caption => 'posts table'  
+
+  =>
+  <table>
+    <thead>
+      <tr>
+        <th>id</th>
+        <th>title</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td>1</td>
+        <td>my post</td>
+      </tr>
+      <tr>
+        <td>2</td>
+        <td>my other post</td>
+      </tr>
+    </tbody>
+  </table>  
+  </code>
+</pre>
+
+## Helpers
+
+The following is the current Table Helper API. 
+
+_Note:_ This API clearly needs to be cleaned up in the "near" future ;)
+
+### Table
+
+* data_table
+* table
+* render_table
+
+### Table parts
+
+* render_tbody
+* table_body
+* render_caption
+* render_header
+* render_footer
+* header_row
+
+### Rows
+
+* row
+* data_rows
+* data_row
+
+### Cells
+
+* cells
+* cell
+
+### Misc
+
+* indent_tag_
+
+## Usage   
+
+The following examples might not all be compatible with any API changes. 
+Please raise an issue if you find a mismatch or have a problem using it ;)
+Thanks!
+
+Example: Using *table* helper
+
+<pre>
+  <% table @posts, %w{ID title} do |post, klass| -%>
+      <tr class="<%= klass %>">
+        <td><%= post.id</td>
+        <td><%= post.title </td>
+      </tr>
+  <% end -%>  
+</pre>
+
+Example: Using *row* helper
+
+<pre>
+  <% table @posts, %w{ID title} do |post, klass| -%>
+      <% row klass do |post| -%>
+        <td><%= post.id %></td>
+        <td><%= post.title %></td>
+      <% end -%>
+  <% end -%>  
+</pre>
+
+Example: Using *row* and *cell* helpers
+
+<pre>
+  <% table @posts, %w{ID title} do |post, klass| -%>
+      <% row klass do |post| -%>
+        <%= cell post.id %>
+        <%= cell post.title %>
+      <% end -%>
+  <% end -%>  
+</pre>
+
+Example: Using *data_row* helper
+
+<pre>
+  <% table @posts, %w{ID title} do |post, klass| -%>
+      <% data_row post, %w{id title}, klass -%>
+  <% end -%>  
+</pre>
+
+
+Example: Using *cells* helper
+
+The last argument to cells is the CSS classes to cycle
+
+<pre>
+  <% table @posts, %w{ID title} do |post, klass| -%>
+      <% row klass do |post| -%>
+        <%= cells post, %w{id title}, %w{number label} %>
+      <% end -%>
+  <% end -%>  
+</pre>
+
+Example: Using *rows* helper
+
+<pre>
+  <% render_table 'posts', 'Posts table', do -%>
+      <% rows @posts, klass, :id, :title -%>
+  <% end -%>  
+</pre>
+
+
+Example: Using *data_table* helper
+
+This will by default try to extract attribute names from the headers list!
+<pre>
+  <% data_table @posts, %w{ID title}, :summary => 'Posts table' -%>
+</pre>
+
+Supply an :attributes options hash value to select attributes to display
+
+<pre>
+  <% data_table @posts, %w{Number Title}, :attributes => %w{id label} -%>
+</pre>
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 Kristian Mandrup. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,24 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "easy-table"
+    gem.summary = %Q{Simple table helper DSL similar to the well known form helpers}
+    gem.description = %Q{Makes it easy to add tables to your views using a nice DSL similar to the form helpers}
+    gem.email = "kmandrup@gmail.com"
+    gem.homepage = "http://github.com/kristianmandrup/easy-table"
+    gem.authors = ["Kristian Mandrup"]
+    gem.add_development_dependency "rspec", ">= 2.0.0.beta.19"
+    gem.add_development_dependency 'rspec-action_view', '>= 0.3.0'
+
+    gem.add_dependency 'rails3_plugin_toolbox', '>= 0.3.4'
+    gem.add_dependency "activesupport", ">= 3.0.0.rc"
+    gem.add_dependency "sugar-high", ">= 0.1.4"
+    gem.add_dependency "sugar-high", ">= 0.1.4"
+    
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/easy-table.gemspec

@@ -0,0 +1,95 @@
+# 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{easy-table}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Kristian Mandrup"]
+  s.date = %q{2010-08-26}
+  s.description = %q{Makes it easy to add tables to your views using a nice DSL similar to the form helpers}
+  s.email = %q{kmandrup@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     ".rspec",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "easy-table.gemspec",
+     "lib/easy-table.rb",
+     "lib/easy-table/cell.rb",
+     "lib/easy-table/namespaces.rb",
+     "lib/easy-table/rails_config.rb",
+     "lib/easy-table/row.rb",
+     "lib/easy-table/row/data.rb",
+     "lib/easy-table/table.rb",
+     "lib/easy-table/table/base.rb",
+     "lib/easy-table/table/data_table.rb",
+     "lib/easy-table/tag.rb",
+     "lib/easy-table/util.rb",
+     "lib/easy-table/view_extension.rb",
+     "spec/easy-table/cell_spec.rb",
+     "spec/easy-table/row/data_row_spec.rb",
+     "spec/easy-table/row/row_spec.rb",
+     "spec/easy-table/table/base_spec.rb",
+     "spec/easy-table/table/data_table_spec.rb",
+     "spec/easy-table/table/table_spec.rb",
+     "spec/easy-table/tag_spec.rb",
+     "spec/easy-table/util_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/kristianmandrup/easy-table}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Simple table helper DSL similar to the well known form helpers}
+  s.test_files = [
+    "spec/easy-table/cell_spec.rb",
+     "spec/easy-table/row/data_row_spec.rb",
+     "spec/easy-table/row/row_spec.rb",
+     "spec/easy-table/table/base_spec.rb",
+     "spec/easy-table/table/data_table_spec.rb",
+     "spec/easy-table/table/table_spec.rb",
+     "spec/easy-table/tag_spec.rb",
+     "spec/easy-table/util_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_development_dependency(%q<rspec>, [">= 2.0.0.beta.19"])
+      s.add_development_dependency(%q<rspec-action_view>, [">= 0.3.0"])
+      s.add_runtime_dependency(%q<rails3_plugin_toolbox>, [">= 0.3.4"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 3.0.0.rc"])
+      s.add_runtime_dependency(%q<sugar-high>, [">= 0.1.4"])
+      s.add_runtime_dependency(%q<sugar-high>, [">= 0.1.4"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.0.0.beta.19"])
+      s.add_dependency(%q<rspec-action_view>, [">= 0.3.0"])
+      s.add_dependency(%q<rails3_plugin_toolbox>, [">= 0.3.4"])
+      s.add_dependency(%q<activesupport>, [">= 3.0.0.rc"])
+      s.add_dependency(%q<sugar-high>, [">= 0.1.4"])
+      s.add_dependency(%q<sugar-high>, [">= 0.1.4"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.0.0.beta.19"])
+    s.add_dependency(%q<rspec-action_view>, [">= 0.3.0"])
+    s.add_dependency(%q<rails3_plugin_toolbox>, [">= 0.3.4"])
+    s.add_dependency(%q<activesupport>, [">= 3.0.0.rc"])
+    s.add_dependency(%q<sugar-high>, [">= 0.1.4"])
+    s.add_dependency(%q<sugar-high>, [">= 0.1.4"])
+  end
+end
+

data/lib/easy-table.rb

@@ -0,0 +1,2 @@
+require 'easy-table/view_extension'
+require 'easy-table/rails_config'

data/lib/easy-table/cell.rb

@@ -0,0 +1,38 @@
+require 'easy-table/util'
+require 'easy-table/tag'
+
+module EasyTable::ViewExt
+  module Cell
+    def header_row heads
+      content = []
+      heads.each do |head| 
+        content << indent_tag(3, :th, head)
+        content << ''.indent(2) if head == heads.last        
+      end
+      content.join.html_safe
+    end
+    
+    def cells object, attributes, options = {}
+      content = []            
+      reset_cycle('cells')
+      attributes.each_with_index do |attrib, index|    
+        cls_opt = class_option(:classes, options, :name => 'cells')
+        
+        content << cell(object, attrib, options.merge(cls_opt))
+        content << ''.indent(2) if attrib == attributes.last
+      end
+      content.join.html_safe
+    end
+
+    def cell object, attribute, options = {} 
+      options.delete(:classes)
+      options.delete(:cell_classes)
+      options.delete(:row_classes)
+      options.delete(:row)
+      value = object.send(attribute) || "Unknown attribute: #{attribute}"
+      indent_tag(3, :td, value, options).html_safe
+    end  
+    
+    include EasyTable::ViewExt::Util    
+  end
+end

data/lib/easy-table/namespaces.rb

@@ -0,0 +1,8 @@
+require 'sugar-high/module'
+
+# create namespaces
+module EasyTable
+  module ViewExt
+    modules :table, :row, :cell, :tag
+  end
+end

data/lib/easy-table/rails_config.rb

@@ -0,0 +1,7 @@
+require 'rails3_plugin_toolbox'
+
+Rails3::PluginExtender.new do
+  extend_rails :view do
+    with EasyTable::ViewExt
+  end
+end  

data/lib/easy-table/row.rb

@@ -0,0 +1,41 @@
+require 'require_all'
+require_all File.dirname(__FILE__) + '/row'
+require 'easy-table/cell'
+
+module EasyTable::ViewExt
+  module Row
+    def render_header heads
+      return nil if heads.empty?
+
+      indent_tag 1, :thead do
+        indent_tag 2, :tr do 
+          header_row heads          
+        end.indent 1
+      end.html_safe  
+    end
+
+    def render_footer footer, headers             
+      size = case headers
+      when Fixnum
+        headers
+      when Array
+        headers.size
+      else
+        raise ArgumentError, "Must take a 2nd argument that indicates number of columns the footer should span"
+      end
+      return nil if footer.blank?
+      indent_tag 1, :tfoot do
+        indent_tag 2, :tr do      
+          indent_tag(3, :th, footer, :colspan => size).indent 2
+        end.indent(1)
+      end.html_safe
+    end
+  
+    def row object, options={}, &block
+      content = with_output_buffer { yield object }
+      indent_tag(2, :tr, content, options).html_safe
+    end
+    
+    includes :data
+  end
+end