table_for_helper 0.2

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 TODO: Write your name
+
+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,76 @@
+table_for helper
+================
+
+A Rails helper for generating tables from resources collections that works like form_for helper.
+
+## Installation
+
+Add it to your Gemfile:
+
+    gem 'table_for'
+
+Run the following command to install it:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install table_for
+
+## Usage
+
+    <%= table_for RESOURCES [, TABLE_TAG_OPTIONS] [BLOCK] %>
+
+In the BLOCK you can configurate columns and footer cells
+
+    <%= table_for @users do |t|
+      t.column :NAME [, TH_TAG_OPTIONS] [VALUE_BUILDER_BLOCK]
+      ...
+      t.footer :NAME [, TD_TAG_OPTIONS] [VALUE_BUILDER_BLOCK]
+      ...
+    %>
+    
+A VALUE_BUILDER_BLOCK must return a value for a cell.
+    
+For example, if you place this into a view:
+
+    <%= table_for @users, :class => 'table' do |t|
+      t.column :email
+      t.column Role, :class => 'span3' do |row|
+        row.role.title
+      end
+      t.column :created_at
+      t.column :view_action, '' do |row|
+        link_to 'view', user_path(row.id)
+      end
+    end %>
+    
+It's will render something like this:
+
+    <table class="table">
+      <thead>
+        <tr>
+          <th>Email</th>
+          <th class="span3">Role</th>
+          <th>Created at</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td>user@mail</td>
+          <td>Seller</td>
+          <td>12.10.12, 14:30</td>
+          <td><a href="/users/1">view</a></td>
+        </tr>
+        ...
+      </tbody>
+    </table>
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/table_for/builder.rb

@@ -0,0 +1,100 @@
+module TableFor
+  class Builder
+    include ActionView::Helpers::TagHelper
+
+    # Initialize variables
+    def initialize collection, options = nil
+      @collection = collection
+      @options = options.symbolize_keys
+      @model = collection.first.class
+
+      @head = {}
+      @body = {}
+      @footer = {}
+      @footer_options = {}
+      
+      yield self if block_given?
+    end
+
+    # Add a new column to the table
+    def column name, title = nil, options = nil, &block
+      # Move a value from the title to options variable for 2 params usage
+      if title.is_a? Hash
+        options = title
+        title = nil
+      end
+
+      # Take a title for this column from the dictionary
+      if !title
+        # A title for a reference
+        if name.is_a? Class
+          title = name.model_name.human
+        # A title for an model attribute
+        else
+          title = @model.human_attribute_name(name)
+        end
+      end
+
+      # Create a html head cell
+      @head[name] = content_tag('th', title, options)
+
+      # Save a builder for rows
+      @body[name] = block if block_given?
+    end
+
+    # Add a footer row column value
+    def footer name, options = nil, &block
+      # Save a builder for a footer cell
+      @footer[name] = block if block_given?
+
+      # Save options for a footer cell
+      @footer_options[name] = options if options
+    end
+
+    # Generate a html
+    def to_html
+      # Add all model attributes if no block given
+      @model.attribute_names.each{|name| column(name)} if @head.empty?
+
+      # Save list of view attributes
+      columns = @head.keys
+
+      # Create a html row tag for head cells
+      head = content_tag('tr', @head.values.join.html_safe)
+
+      # Construct body html rows
+      body = ''
+      @collection.each do |resource|
+        row = ''
+        columns.each do |column|
+          if @body[column]
+            cell = @body[column].call(resource)
+          else
+            cell = resource[column]
+          end
+          row << content_tag('td', cell.to_s)
+        end
+        body << content_tag('tr', row.html_safe)
+      end
+
+      # Construct the footer row
+      footer = ''
+      if !@footer.empty?
+        columns.each do |column|
+          if @footer[column]
+            footer << content_tag('td', @footer[column].call(@collection), @footer_options[column])
+          else
+            footer << content_tag('td')
+          end
+        end
+        footer = content_tag('tr', footer.html_safe)
+      end
+
+      # Join all table parts, put it to a table tag and return
+      table = ''
+      table << content_tag('thead', head)
+      table << content_tag('tbody', body.html_safe + footer.html_safe)
+      content_tag('table', table.html_safe, @options)
+    end
+  end
+end

data/lib/table_for/version.rb

@@ -0,0 +1,3 @@
+module TableFor
+  VERSION = "0.2"
+end

data/lib/table_for.rb

@@ -0,0 +1,13 @@
+require "table_for/version"
+require "table_for/builder"
+
+module TableFor
+  # Creates a html table from a resource collection
+  def table_for(resources, options = {}, &block)
+    Builder.new(resources, options, &block).to_html
+  end
+end
+
+ActionController::Base.class_eval do
+  helper TableFor
+end

data/table_for_helper.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/table_for/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Nick Nizovtsev']
+  gem.email         = ['nizovtsevnv@gmail.com']
+  gem.description   = %q{A Rails helper for generating tables from resources collections.}
+  gem.summary       = %q{Easily making tables from collections with a DSL.}
+  gem.homepage      = 'http://github.com/nizovtsevnv/table_for_helper'
+
+  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.name          = "table_for_helper"
+  gem.require_paths = ["lib"]
+  gem.version       = TableFor::VERSION
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: table_for_helper
+version: !ruby/object:Gem::Version
+  version: '0.2'
+  prerelease: 
+platform: ruby
+authors:
+- Nick Nizovtsev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-20 00:00:00.000000000 Z
+dependencies: []
+description: A Rails helper for generating tables from resources collections.
+email:
+- nizovtsevnv@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/table_for.rb
+- lib/table_for/builder.rb
+- lib/table_for/version.rb
+- table_for_helper.gemspec
+homepage: http://github.com/nizovtsevnv/table_for_helper
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Easily making tables from collections with a DSL.
+test_files: []