tablette 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d1ea4083f7a84daf2dc1cdd21a1fddce42ab0e08
+  data.tar.gz: a194c4045ce19b05f0ec69c022c239cb7cef32a7
+SHA512:
+  metadata.gz: 91950838b5802f5c25485d8bc1cb872d835501115cbc2b457105c12821898a3efa5dd157c2bd2900ad66e1f13bec45d1592fc1b4db9d1411945b78a5970e00fc
+  data.tar.gz: 723deac30f5dcf8f06a6f9580ea607dd1c99eb4a7016f1b6005a31a1bb6f7311c1d301f094583932f0b2a80f17933ffe8c54f00f787cba3672661cbbf86451e0

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in slashadmin-table_for.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Victor Sokolov
+
+MIT License
+
+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.md

@@ -0,0 +1,169 @@
+# Tablette
+
+Inspired by discussion at: https://github.com/evilmartians/slashadmin/issues/3.
+Rails table renderer that tries to be flexible.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tablette'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tablette
+
+## Usage
+
+Somwhere in your app:
+
+```ruby
+short_table = Tablette::Table.new do
+  column :id
+  column :name
+end
+
+puts short_table.to_html(collection, User)
+```
+
+You will see following:
+
+```html
+# <table>
+#   <thead><tr><th>Id</th><th>User name</th></tr></thead>
+#   <tbody>
+#     <tr><td>1</td><td>John Doe</td></tr>
+#     <tr>...</tr>
+#   </tbody>
+# </table>
+```
+
+## Full definition
+
+```ruby
+table = Tablette::Table.new do
+  html_options class: 'table'
+
+  header do
+    row do
+      column 'Id', html_options: { colspan: 5 }
+      column do
+        'Doctor strangelove'
+      end
+    end
+  end
+
+  body do
+    html_options class: 'sortable'
+    row do
+      html_options do |member, index|
+        { data: { id: member.id, index: index } }
+      end
+
+      column html_options: ->(member, _) { { data: { value: member.id } } } do |_, index|
+        index
+      end
+      column :id
+      column :age do |member, _|
+        "Dead at #{member.age}"
+      end
+      column do |_, index|
+        sample_helper_function(index)
+      end
+    end
+
+    row html_options: { class: 'small' } do
+      tag 'overriden_tr'
+
+      column :test do
+        "test"
+      end
+
+      column :age, formatter: :sample_formatter
+    end
+  end
+
+  footer do
+    row do
+      column html_options: { rowspan: 3 } do
+        "On foot"
+      end
+    end
+  end
+end
+
+puts table.to_html(collection)
+```
+
+Every element accepts:
+* html_options - to customize default options.
+* override_html_options - to completely override default html options.
+* tag - to change tag name.
+
+Default HTML options are:
+* data-id - for tbody/tr.
+* data-key - for tbody/tr/td.
+
+Options which are set by blocks accepts:
+* |member, index| - for row and column inside body element.
+* |collection, klass = nil| - for table, header and footer (and all nested elements)
+* Same for body.
+
+Method called with :formatter option accepts value, member and index.
+
+You can override default html options for an element with :override_html_options
+option.
+
+You can specify two or more rows in body section. All of this rows will be
+rendered for every collection item.
+
+## Global configuration
+
+Table elements can be customized at application level.
+
+Somewhere in initializer:
+
+```ruby
+Tablette::Table.config.html_options     = { class: 'table' }
+Tablette::HeaderRow.config.html_options = proc { |_, resource_class = nil|
+  { class: resource_class.name.underscore }
+}
+```
+
+You can use: Table, Header, Body, Footer, HeaderRow, BodyRow, FooterRow,
+HeaderColumn, BodyColumn, FooterColumn.
+
+So, you can replace table with ordered list or something you need.
+
+## Partial rendering
+
+Could be useful for twitter-style pagination:
+
+```ruby
+table.element_to_html(:header, collection, User)
+table.element_to_html(:body, collection, User)
+table.element_to_html(:footer, collection, User)
+```
+
+## TODO
+
+1. Think about sorting.
+2. Formatted output.
+3. Data attrs for everything.
+4. Authospan.
+5. :row as parameter.
+6. Reusable columns
+7. Shortened column definition
+8. Tablette.render() do
+
+## 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

data/Rakefile

@@ -0,0 +1,5 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec

data/lib/tablette/columns.rb

@@ -0,0 +1,84 @@
+module Tablette
+  class Column < Element
+    config.tag = 'td'
+
+    def initialize(*args, &block)
+      self.value = block
+      self.key   = args.first if args.first.is_a?(String) or args.first.is_a?(Symbol)
+
+      config.builtin_html_options = ->(member, index = nil) do
+        classes = []
+
+        if self.key.present?
+          classes << self.key.to_s
+        end
+
+        if index.kind_of? Numeric
+          if index.odd?
+            classes << "odd"
+          else
+            classes << "even"
+          end
+        end
+
+        if classes.any?
+          { :class => classes.join(" ") }
+        else
+          {}
+        end
+      end
+
+      # Bypass block evaling: in this case it's not a config but a value formatter
+      super(*args, &nil)
+    end
+
+    def colspan(args)
+      override_html_options, html_options =
+        get_options([:override_html_options, :html_options], *args)
+
+      options = override_html_options.merge html_options
+      options[:colspan]
+    end
+
+    protected
+    attr_accessor :key, :value
+  end
+
+  class BodyColumn < Column
+    protected
+    def html_content(member, index)
+      value = @renderer.wrap_content(self.value).call(member, index) if self.value.present?
+      value ||= member.send(key) if key.present? and member.respond_to?(key)
+
+      if config.formatter.present?
+        value ||= send(config.formatter, key, member, index)
+      end
+
+      value
+    end
+  end
+
+  class HeaderColumn < Column
+    config.tag = 'th'
+
+    protected
+    def html_content(collection, resource_class = nil)
+      return @renderer.wrap_content(value).call(collection, resource_class) if value.is_a?(Proc)
+      if resource_class.respond_to?(:human_attribute_name) && key.present?
+        resource_class.human_attribute_name(key)
+      else
+        key
+      end
+    end
+  end
+
+  class FooterColumn < Column
+    config.tag = 'td'
+
+    protected
+    def html_content(*args)
+      return @renderer.wrap_content(value).call(*args) if value.is_a?(Proc)
+      key
+    end
+  end
+end

data/lib/tablette/element/configuration.rb

@@ -0,0 +1,14 @@
+module Tablette
+  class Element
+    protected
+
+    config.allowed_configuration_options = %w(
+      tag html_options override_html_options
+    )
+    config.html_options                  = {}
+    config.builtin_html_options          = {}
+    config.override_html_options         = {}
+    config.render_nested_elements        = []
+    config.tag                           = nil
+  end
+end

data/lib/tablette/element/nesting.rb

@@ -0,0 +1,88 @@
+module Tablette
+  class Element
+    class << self
+      protected
+      # Defines DSL method for configuring nested element.
+      # If no args/block passed - returns currently defined elements as array.
+      #
+      # Example:
+      #   class Table < Element
+      #     nest :body, Body
+      #   end
+      #
+      #   table = Table.new do
+      #     body do
+      #       (...)
+      #     end
+      #   end
+      #
+      #   table.body.first.to_html # <tbody>...</tbody>
+      def nest(accessor_name, klass, opts = {})
+        ivar_name = opts[:ivar_name] || accessor_name
+        merge_children = opts[:merge_children] || false
+        define_method accessor_name do |*args, &block|
+          items = instance_variable_get("@#{ivar_name}") || []
+          return items if args.blank? && block.blank?
+          
+          inherited_config = {
+            :renderer => @renderer,
+            :helper   => @helper
+          }
+          
+          if args.last.kind_of? Hash
+            last = args.pop
+            args << last.merge(inherited_config)
+          else
+            args << inherited_config
+          end
+          
+          value = klass.new(*args, &block)
+          if merge_children && items.any?
+            items.first.merge_with! value
+          else
+            items.push(value)
+          end
+          instance_variable_set("@#{ivar_name}", items)
+          value
+        end
+        protected accessor_name
+      end
+
+      # Defines top-level shortcut DSL method.
+      #
+      # Example:
+      #   class Body < Element
+      #     nest :row, BodyRow
+      #   end
+      #
+      #   class Table < Element
+      #     nest_through :body, :row, :column # Table#column calls .body.row.column
+      #   end
+      #
+      #   table = Table.new do
+      #     column :id
+      #   end
+      #
+      #   table.body.first.row.first.column.first.to_html # <td data-name="id">...</td>
+      def nest_through(*chain)
+        nested_method = chain.last
+
+        define_method nested_method do |*args, &block|
+          _get_chained(self, chain.dup, *args, &block)
+        end
+      end
+    end
+
+    private
+    def _get_chained(context, chain, *args, &block)
+      key = chain.shift
+      if chain.empty?
+        context.send(key, *args, &block)
+      else
+        # Get last defined element, or define new blank
+        nested_item = context.send(key).last || context.send(key) { }
+        _get_chained(nested_item, chain, *args, &block)
+      end
+    end
+  end
+end

data/lib/tablette/element/rendering.rb

@@ -0,0 +1,58 @@
+module Tablette
+  class Element
+    # Translates element to html tag.
+    def to_html(*args)
+      tag, override_html_options, user_html_options, builtin_html_options =
+        get_options([:tag, :override_html_options, :html_options, :builtin_html_options], *args)
+
+      raise "Set tag option for #{self.class.name}" if tag.blank?
+
+      html_options = override_html_options.merge user_html_options
+
+      builtin_html_options.each do |key, value|
+        if html_options.include? key
+          html_options[key] = "#{value} #{html_options[key]}"
+        else
+          html_options[key] = value
+        end
+      end
+      
+      @renderer.element = self
+      begin
+        @renderer.produce_element tag, html_options, html_content(*args)
+      ensure
+        @renderer.element = nil
+      end
+    end
+
+    def element_to_html(element, *args)
+      send(element).map do |item|
+        item.to_html(*args)
+      end
+    end
+
+    protected
+    # HTML content for element. Renders elements set by :render_nested_elements
+    # wrapped by :tag.
+    def html_content(*args)
+      nested = get_options(:render_nested_elements, *args).first
+
+      if nested.blank?
+        raise "Set render_nested_elements options or override #html_content/#to_html for #{self.class.name}"
+      end
+
+      nested.map { |e| element_to_html(e, *args) }.flatten!(1)
+    end
+
+    private
+
+    # Gets given option values. If an option is a block - yields it and
+    # returns value.
+    def get_options(keys, *args)
+      keys = Array.wrap(keys)
+      keys.map do |name|
+        config[name].is_a?(Proc) ? config[name].call(*args) : config[name]
+      end
+    end
+  end
+end

data/lib/tablette/element.rb

@@ -0,0 +1,51 @@
+module Tablette
+  class Element
+    include ActiveSupport::Configurable
+
+    attr_accessor :renderer, :helper
+    
+    def initialize(*args, &definition)
+      options = args.extract_options!
+      if options.include? :renderer
+        @renderer = options.delete :renderer
+      end
+      
+      if options.include? :helper
+        @helper = options.delete :helper
+      end
+      
+      instance_exec(&definition) if block_given?
+      config.merge!(options)
+    end
+
+    def respond_to?(method)
+      super || @helper.respond_to?(method) || config.allowed_configuration_options.include?(method.to_s)
+    end
+  
+    def method_missing(method, *args, &block)
+      if @helper.respond_to? method
+        @helper.send method, *args, &block
+      elsif config.allowed_configuration_options.include?(method.to_s)
+        # Catches a call to configuration option setter.
+        #
+        # Example:
+        # body do
+        #   html_options { class: 'test' } # Holds such calls
+        # end
+      
+        config[method] = args.first || block
+      
+        class_eval do
+          define_method method do |value|
+            config[method] = value
+          end
+          protected method
+        end
+      
+        config[method]
+      else
+        super
+      end
+    end
+  end
+end

data/lib/tablette/html_renderer.rb

@@ -0,0 +1,44 @@
+module Tablette
+  module HTMLRenderer
+    def self.element=(element)
+    
+    end
+  
+    def self.produce_element(tag, attributes, content)
+      content = content.join if content.kind_of? Array
+  
+      "<#{tag} #{_to_html_args(attributes)}>#{content}</#{tag}>"
+    end
+  
+    def self.to_html(root)
+      if root.kind_of? Array
+        root.join
+      else
+        root
+      end
+    end
+
+    def self.wrap_content(proc)
+      proc
+    end
+
+    # Translates html_options to HTML attributes string. Accepts nested
+    # data-attributes.
+    #
+    # Example:
+    #   _to_html_args(ref: true, data: { id: 1 }) # ref="true" data-id="1"
+    def self._to_html_args(options, prepend = nil)
+      options = options || {}
+      html_args = options.map do |key, value|
+        if value.is_a?(Hash)
+          _to_html_args(value, key)
+        else
+          key = "#{prepend}-#{key}" if prepend.present?
+          %{#{key}="#{value}"}
+        end
+      end
+
+      html_args.join(' ')
+    end
+  end
+end

data/lib/tablette/rows.rb

@@ -0,0 +1,70 @@
+module Tablette
+  class Row < Element
+    attr_reader :columns
+
+    config.tag = 'tr'
+    config.render_nested_elements = %w(column)
+
+    def columns_for_row(args)
+      columns = 0
+
+      self.column.each do |column|
+        colspan = column.colspan(args)
+
+        if colspan.nil? || colspan == "auto"
+          columns += 1
+        else
+          columns += colspan
+        end
+      end
+
+      columns
+    end
+
+    def update_auto_colspan!(columns, args)
+      auto_column = nil
+
+      self.column.each do |column|
+        next unless column.colspan(args) == "auto"
+
+        if auto_column.nil?
+          auto_column = column
+        else
+          raise "multiple columns with colspan=auto are defined"
+        end
+      end
+
+      row_columns = columns_for_row(args)
+      if auto_column.nil?
+        if row_columns != columns
+          raise "mismatched number of columns in table: #{columns} in table, #{row_columns} defined in row"
+        end
+      else
+        auto_column.config[:html_options][:colspan] = columns - row_columns + 1
+      end
+    end
+  end
+
+  class BodyRow < Row
+    config.override_html_options = proc { |member, index|
+      { data: { id: member.try(:id) } }
+    }
+
+    nest :column, BodyColumn
+
+    protected
+    def html_content(member, index)
+      column.map do |column|
+        column.to_html(member, index)
+      end
+    end
+  end
+
+  class HeaderRow < Row
+    nest :column, HeaderColumn
+  end
+
+  class FooterRow < Row
+    nest :column, FooterColumn
+  end
+end

data/lib/tablette/sections.rb

@@ -0,0 +1,69 @@
+module Tablette
+  class Section < Element
+    config.render_nested_elements = %w(row)
+
+    def columns_for_section(args)
+      columns = 0
+
+      self.row.each do |row|
+        row_columns = row.columns_for_row args
+        columns = row_columns if row_columns > columns
+      end
+
+      columns
+    end
+
+    def update_auto_colspan!(columns, args)
+      self.row.each do |row|
+        row.update_auto_colspan! columns, args
+      end
+    end
+  end
+
+  class Body < Section
+    config.tag = 'tbody'
+
+    nest :row, BodyRow
+    nest_through :row, :column
+
+    def columns_for_section(args)
+      collection, resource_class = args
+      return 0 if collection.empty?
+
+      super([collection.first, 0])
+    end
+
+    def update_auto_colspan!(columns, args)
+
+    end
+
+    protected
+    def html_content(collection, resource_class = nil)
+      collection.map.with_index do |member, index|
+        row.map { |row| row.to_html(member, index) }
+      end
+    end
+  end
+
+  class Header < Section
+    config.tag = 'thead'
+
+    nest :row, HeaderRow
+    nest_through :row, :column
+
+    def merge_with!(header)
+      self.row.concat header.row
+    end
+  end
+
+  class Footer < Section
+    config.tag = 'tfoot'
+
+    nest :row, FooterRow
+    nest_through :row, :column
+
+    def merge_with!(footer)
+      self.row.concat footer.row
+    end
+  end
+end

data/lib/tablette/table.rb

@@ -0,0 +1,49 @@
+module Tablette
+  class Table < Element
+    config.tag = 'table'
+    config.render_nested_elements = %w(header! body footer!)
+    config.allowed_configuration_options = %w(tag html_options)
+    config.builtin_html_options = { :class => "tablette" }
+    
+    nest :header!, Header, :ivar_name => :header, :merge_children => true
+    nest :body, Body
+    nest :footer!, Footer, :ivar_name => :footer, :merge_children => true
+
+    nest_through :body, :row, :column
+    
+    def initialize(*args, &block)
+      @renderer = HTMLRenderer
+      @helper = nil
+      
+      super
+    end
+
+    def header(&block)
+      header! do
+        column(html_options: { colspan: 'auto'}, &block)
+      end
+    end
+
+    def footer(&block)
+      footer! do
+        column(html_options: { colspan: 'auto'}, &block)
+      end
+    end
+
+    def to_html(*args)
+      columns = 0
+
+      all_sections = [ self.header!, self.body, self.footer! ].flatten
+      all_sections.each do |section|
+        section_columns = section.columns_for_section args
+        columns = section_columns if section_columns > columns
+      end
+
+      all_sections.each do |section|
+        section.update_auto_colspan! columns, args
+      end
+
+      @renderer.to_html(super)
+    end
+  end
+end

data/lib/tablette/version.rb

@@ -0,0 +1,3 @@
+module Tablette
+  VERSION = "0.1.0"
+end

data/lib/tablette.rb

@@ -0,0 +1,16 @@
+require 'active_support/core_ext/object/blank'
+require 'active_support/core_ext/object/inclusion'
+require 'active_support/core_ext/string/inflections'
+require 'active_support/core_ext/object/try'
+require 'active_support/configurable'
+
+require 'tablette/version'
+require 'tablette/element'
+require 'tablette/element/configuration'
+require 'tablette/element/rendering'
+require 'tablette/element/nesting'
+require 'tablette/columns'
+require 'tablette/rows'
+require 'tablette/sections'
+require 'tablette/table'
+require 'tablette/html_renderer'

data/spec/grid_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+describe 'Grid' do
+  context 'defined fully' do
+    subject { sample_table_full_described }
+
+    it 'should render correctly' do
+      subject.should have_tag 'table', with: { class: 'table' }, count: 1 do
+        with_tag 'thead', count: 1 do
+          with_tag 'th', text: 'Doctor strangelove', count: 1
+          with_tag 'th', text: 'Id', count: 1
+        end
+
+        with_tag 'tbody', with: { class: 'sortable' }, count: 1 do
+          sample_collection.each_with_index do |member, index|
+            with_tag "tr[data-id='#{member.id}'][data-index='#{index}']"
+
+            with_tag 'td', with: { 'data-value' => member.id }, text: index, count: 1
+            with_tag 'td', text: member.id, count: 1
+            with_tag 'td', text: "Dead at #{member.age}", count: 1
+            with_tag 'td', text: "I hope this helps #{index}", count: 1
+
+            with_tag 'overriden_tr'
+
+            with_tag 'td', text: member.age
+          end
+        end
+
+        with_tag 'tfoot', count: 1 do
+          with_tag 'td', text: 'On foot', count: 1
+        end
+      end
+    end
+  end
+
+  context 'partial rendering' do
+    subject do
+      sample_table_full_described_definition.element_to_html(:body, sample_collection).join
+    end
+
+    it 'should render header, footer, body separately' do
+      
+      subject.should_not have_tag 'thead'
+      subject.should_not have_tag 'tfoot'
+
+      subject.should have_tag 'tbody'
+      subject.should have_tag 'tr'
+      subject.should have_tag 'td'
+    end
+  end
+
+  context 'defined shortly' do
+    subject { sample_table_short }
+
+    it 'should render correctly' do
+      subject.should have_tag 'table', count: 1 do
+        with_tag 'tbody', count: 1
+        with_tag 'thead', count: 1
+        with_tag 'tr', count: 4
+      end
+    end
+  end
+
+  context 'with active record objects' do
+    subject { sample_table_active_record }
+
+    it 'should get right headings from active record' do
+      subject.should have_tag 'thead', count: 1 do
+        with_tag 'th', text: 'Humanized id', count: 1
+        with_tag 'th', text: 'Humanized age', count: 1
+      end
+
+      subject.should_not have_tag 'tfoot'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'tablette'
+require 'support/sample_table'
+require 'rspec-html-matchers'
+
+RSpec.configure do |config|
+end

data/spec/support/sample_table.rb

@@ -0,0 +1,103 @@
+require 'ostruct'
+
+class ActiveRecordMock
+  def self.human_attribute_name(name)
+    "Humanized #{name.to_s}"
+  end
+end
+
+def sample_collection
+  [
+    OpenStruct.new(id: 10, age: 27, value: 'Jim Morrison'),
+    OpenStruct.new(id: 20, age: 70, value: 'William Blake'),
+    OpenStruct.new(id: 30, age: 89, value: 'Robert Lee Frost')
+  ]
+end
+
+def sample_helper_function(arg)
+  "I hope this helps #{arg}"
+end
+
+def sample_formatter(key, member, index)
+  "Formatter for #{member[key]}"
+end
+
+def sample_table_full_described_definition
+  Tablette::Table.new do
+    html_options class: 'table'
+
+    header! do
+      column 'Id', html_options: { colspan: 5 }
+      column do
+        'Doctor strangelove'
+      end
+    end
+
+    body do
+      html_options class: 'sortable'
+      row do
+        html_options do |member, index|
+          { data: { id: member.id, index: index } }
+        end
+
+        column html_options: ->(member, _) { { data: { value: member.id } } } do |_, index|
+          index
+        end
+        column :id
+        column :age do |member, _|
+          "Dead at #{member.age}"
+        end
+        column do |_, index|
+          sample_helper_function(index)
+        end
+      end
+
+      row html_options: { class: 'small' } do
+        tag 'overriden_tr'
+
+        column :test do
+          "test"
+        end
+
+        column :age, formatter: :sample_formatter
+      end
+    end
+
+    footer do
+      "On foot"
+    end
+  end
+end
+
+def sample_table_full_described
+  sample_table_full_described_definition.to_html(sample_collection)
+end
+
+def sample_table_short
+  table = Tablette::Table.new do
+    header do
+      column 'Id'
+      column 'Age'
+    end
+
+    column :id
+    column :age
+  end
+  table.to_html(sample_collection)
+end
+
+def sample_table_active_record
+  table = Tablette::Table.new do
+    header! do
+      column :id
+      column :age
+      column "Custom string"
+      column do
+        "Custom block"
+      end
+    end
+    column :id
+    column :age
+  end
+  table.to_html(sample_collection, ActiveRecordMock)
+end

data/tablette.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'tablette/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "tablette"
+  gem.version       = Tablette::VERSION
+  gem.authors       = ["Victor Sokolov", "Sergey Gridasov"]
+  gem.email         = ["gzigzigzeo@gmail.com", "grindars@gmail.com"]
+  gem.description   = %q{HTML table generator}
+  gem.summary       = %q{HTML table generator}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'activesupport', '>= 3'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec-html-matchers'
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: tablette
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Victor Sokolov
+- Sergey Gridasov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: 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: rspec-html-matchers
+  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: HTML table generator
+email:
+- gzigzigzeo@gmail.com
+- grindars@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/tablette.rb
+- lib/tablette/columns.rb
+- lib/tablette/element.rb
+- lib/tablette/element/configuration.rb
+- lib/tablette/element/nesting.rb
+- lib/tablette/element/rendering.rb
+- lib/tablette/html_renderer.rb
+- lib/tablette/rows.rb
+- lib/tablette/sections.rb
+- lib/tablette/table.rb
+- lib/tablette/version.rb
+- spec/grid_spec.rb
+- spec/spec_helper.rb
+- spec/support/sample_table.rb
+- tablette.gemspec
+homepage: ''
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.0.0
+signing_key: 
+specification_version: 4
+summary: HTML table generator
+test_files:
+- spec/grid_spec.rb
+- spec/spec_helper.rb
+- spec/support/sample_table.rb