dining-table 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d79df74fda15fcb68b6215a45dbdee28c6ddf5d3
+  data.tar.gz: bb73bf1a0edc0fe3c0aeda71acafbc13ae337e65
+SHA512:
+  metadata.gz: 637d781f1ec3417a01f6d1f3004ccc60e8a95b64bef354c96703760259643aab537dfcec0bacef622587fb72a7d9bba8cfa5411cb5c19685c6145ff4ea403b99
+  data.tar.gz: 9ef097bc93ee0492e6bda519020089349da0fb552473f9c74d81da15a4bc0153308707a7a66cd472e48887b45e76ebd8d5d099aee667da1f77275655ded343a2

data/Gemfile

@@ -0,0 +1,4 @@
+group :development do
+  gem "bundler", "~> 1.0"
+  gem "juwelier", "~> 2.1.0"
+end

data/Gemfile.lock

@@ -0,0 +1,59 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.4.0)
+    builder (3.2.2)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.3.0)
+    github_api (0.13.1)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      multi_json (>= 1.7.5, < 2.0)
+      oauth2
+    hashie (3.4.4)
+    highline (1.7.8)
+    json (1.8.3)
+    juwelier (2.1.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+      semver
+    jwt (1.5.1)
+    mini_portile2 (2.0.0)
+    multi_json (1.12.0)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    oauth2 (1.1.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0, < 1.5.2)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    rack (1.6.4)
+    rake (11.1.2)
+    rdoc (4.2.2)
+      json (~> 1.4)
+    semver (1.0.1)
+    thread_safe (0.3.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  juwelier (~> 2.1.0)
+
+BUNDLED WITH
+   1.12.3

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Michaël Van Damme
+
+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,298 @@
+# dining-table
+
+dining-table was inspired by the (now unfortunately unmaintained) [table_cloth](https://github.com/bobbytables/table_cloth) gem. 
+This gem is definitely not a drop-in replacement for [table-cloth](https://github.com/bobbytables/table_cloth), it aims to be less dependent on Rails 
+(no Rails required to use `dining-table`) and more flexible.
+In addition, it not only supports HTML output but you can output tabular data in csv or xlsx formats as well.
+
+## Installation
+
+Add the following to your Gemfile:
+
+```ruby
+gem 'dining-table'
+```
+
+## Basic example
+
+A table is defined by creating a table class (usually placed in app/tables) that inherits from `DiningTable::Table` and implements the `define' method:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand
+    column :number_of_doors
+    column :stock
+  end
+end
+```
+
+In your views, you can now provide a collection of `@cars` and render the table in HTML:
+
+```ruby
+<%= CarTable.new(@cars, self).render %>
+```
+
+By default, a table will have a header with column names, and no footer. There is one row per element in the collection (`@cars` in this example), and rows are rendered in order.
+
+## Table class
+
+### Defining columns
+
+Columns are defined by using `column` in the `define` method of the table class. The content of the cell is determined by calling the
+corresponding method of the object: for `column :brand`, the `brand` method is called for each car in the collection, and the result is placed in the appropriate cells.
+If this is not what you want, you can provide a block:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand do |object|
+      object.brand.upcase
+    end
+  end
+end
+```
+
+### Headers and footers
+
+When you don't explicitly specify a header, the header is set using `human_attribute_name` (if the objects in the collection respond to that method). 
+You can also manually specify a header:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand, header: I18n.t('car.brand') do |object|
+      object.brand.upcase
+    end
+  end
+end
+```
+
+The custom header can be a string, but also a lambda or a proc.
+
+By default, `dining-table` doesn't add a footer to the table, except when at least one column explicitly specifies a footer:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand
+    column :stock, footer: lambda { "Total: #{ collection.sum(&:stock) }" }
+  end
+end
+```
+
+Please note how the collection passed in when creating the table obect (`@cars` in `CarTable.new(@cars, self)`) is available as `collection`.
+
+### Links and view helpers
+
+When rendering the table in a view using `<%= CarTable.new(@cars, self).render %>`, the `self` parameter is the view context. It is made available through the `h` 
+method (or the `helpers` method if you prefer to be more explicit). You can use `h` to get access to methods like Rails' `link_to`, path helpers, and view helpers:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand do |object|
+      h.link_to( object.brand, h.car_path(object) )
+    end
+    column :stock do |object|
+      h.number_with_delimiter( object.stock )
+    end
+  end
+end
+```
+
+You can also use `h` in headers or footers:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand, header: h.link_to('Brand', h.some_path)
+  end
+end
+```
+
+When you want to render a table outside of a view (or when rendering csv or xlsx tables, see further) you have the following options:
+* Pass in `nil` if you don't use the `h` helper in any column: `CarTable.new(@cars, nil).render`
+* If you do use `h`, pass in an object that responds to the methods you use. This might be a Rails view context, or any other object:
+
+```ruby
+# in app/tables/car_table.rb
+class CarTable < DiningTable::Table
+  def define
+    column :brand do |object|
+      h.my_helper( object.brand )
+    end
+  end
+end
+
+# somewhere else
+class FakeViewContext
+  def my_helper(a)
+    a
+  end
+end
+
+# when rendering
+cars = Car.order(:brand)
+CarTable.new(cars, FakeViewContext.new).render
+```
+
+### Actions
+
+In the case of HTML tables, one often includes an actions column with links to show, edit, delete, etc. the object. While you can do that using a regular column 
+it is easier using a special actions column:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand
+    actions header: I18n.t('shared.action') do |object|
+      action { |object| h.link_to( I18n.t('shared.show'), h.car_path(object) ) }
+      action { |object| h.link_to( I18n.t('shared.edit'), h.edit_car_path(object) ) if object.editable? }
+    end
+  end
+end
+```
+
+### Options
+
+When creating the table object to render, you can pass in an options hash:
+
+```ruby
+<%= CarTable.new(@cars, self, admin: current_user.admin? ).render %>
+```
+
+The passed in options are available as `options` when defining the table. One example of where this is useful is hiding certain columns or actions from non-admin users:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    admin = options[:admin]
+  
+    column :brand
+    column :number_of_doors
+    column :stock if admin
+    actions header: I18n.t('shared.action') do |object|
+      action { |object| h.link_to( I18n.t('shared.show'), h.car_path(object) ) }
+      action { |object| h.link_to( I18n.t('shared.edit'), h.edit_car_path(object) ) if admin }
+    end
+  end
+end
+```
+
+## Presenters
+
+### HTML
+
+The default presenter is HTML (i.e. `DiningTable::Presenters::HTMLPresenter`), so `CarTable.new(@cars, self).render` will generate a table in HTML.
+When defining columns, you can specify options that apply only when using a certain presenter. For example, here we provide css classes for `td` and `th` 
+elements for some columns in the html table:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand
+    column :number_of_doors, html: { td_options: { class: 'center' }, th_options: { class: :center } }
+    column :stock, html: { td_options: { class: 'center' }, th_options: { class: :center } }
+  end
+end
+```
+
+The same table class can also be used with other presenters (csv, xlsx or a custom presenter), but the options will only be in effect when using the HTML presenter.
+
+By instantiating the presenter yourself it is possible to specify options. For example:
+
+```ruby
+<%= CarTable.new(@cars, self, presenter: DiningTable::Presenters::HTMLPresenter.new( class: 'table table-bordered' )).render %>
+```
+
+It is also possible to wrap the table in another tag (a div for instance):
+
+```ruby
+<%= CarTable.new(@cars, self, 
+                 presenter: DiningTable::Presenters::HTMLPresenter.new( class: 'table table-bordered',
+                                                                        wrap: { tag: :div, class: 'table-responsive' } )).render %>
+```
+
+Both of these html options are usually best set as defaults, see [Configuration](#configuration) 
+
+### CSV
+
+`dining-table` can also generate csv files instead of HTML tables. In order to do that, specify the presenter when instantiating the table object. You could do
+the following in a Rails controller action, for instance:
+
+```ruby
+def export_csv
+  collection = Car.order(:brand)
+  csv = CarTable.new( collection, nil, :presenter => DiningTable::Presenters::CSVPresenter.new ).render
+  send_data( csv, :filename => 'export.csv', :content_type => "text/csv" )
+end
+```
+
+The CSV Presenter uses the CSV class from the Ruby standard library. Options passed in through the :csv key will be passed on to `CSV.new`:
+
+```ruby
+csv = CarTable.new( collection, nil, :presenter => DiningTable::Presenters::CSVPresenter.new( csv: { col_sep: ';' } ) ).render
+```
+
+CSV options can also be set as defaults, see [Configuration](#configuration) 
+
+It can often be useful to use the same table class with both html and csv presenters. Usually, you don't want the action column in your csv file. 
+You can easilly omit it when the presenter is not HTML:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand
+    actions header: I18n.t('shared.action') do |object|
+      action { |object| h.link_to( I18n.t('shared.show'), h.car_path(object) ) }
+      action { |object| h.link_to( I18n.t('shared.edit'), h.edit_car_path(object) ) }
+    end if presenter.type?(:html)
+  end
+end
+```
+
+Note that you also have access to the `presenter` inside column blocks, so if necessary you can adapt a column's content accordingly:
+
+```ruby
+class CarTable < DiningTable::Table
+  def define
+    column :brand do |object|
+      if presenter.type?(:html)
+        h.link_to( object.brand, h.car_path(object) )
+      else
+        object.brand  # no link for csv and xlsx
+      end
+    end
+  end
+end
+```
+
+### Excel (xlsx)
+
+The Excel presenter depends on [axlsx](https://github.com/randym/axlsx). Note that `dining-table` doesn't require `axlsx`, you have to add it to 
+your Gemfile yourself if you want to use the Excel presenter.
+
+In order to use the Excel presenter, pass it in as a presenter and provide an axlsx worksheet:
+
+```ruby
+collection = Car.order(:brand)
+# sheet is the axlsx worksheet in which the table will be rendered
+CarTable.new( collection, nil, :presenter => DiningTable::Presenters::ExcelPresenter.new( sheet ) ).render
+```
+
+## Configuration <a name="configuration"></a>
+
+You can set default options for the different presenters in an initializer (e.g. `config/initializers/dining-table.rb`):
+
+```ruby
+DiningTable.configure do |config|
+  config.html_presenter.default_options = { class: 'table table-bordered table-hover',
+                                            wrap: { tag: :div, class: 'table-responsive' } }
+  config.csv_presenter.default_options  = { :csv => { col_sep: ';' } }
+end
+```
+
+## Copyright
+
+Copyright (c) 2016 Michaël Van Damme. See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'juwelier'
+Juwelier::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "dining-table"
+  gem.homepage = "http://github.com/mvdamme/dining-table"
+  gem.license = "MIT"
+  gem.summary = %Q{Create tables easily. Supports html, csv and xlsx.}
+  gem.description = %Q{Easily output tabular data, be it in HTML, CSV or XLSX. Create clean table classes instead of messing with views to create nice tables.}
+  gem.email = "michael.vandamme@vub.ac.be"
+  gem.authors = ["Micha\u{eb}l Van Damme"]
+  # dependencies defined in Gemfile
+end
+Juwelier::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Code coverage detail"
+task :simplecov do
+  ENV['COVERAGE'] = "true"
+  Rake::Task['test'].execute
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "dining-table #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/dining-table.gemspec

@@ -0,0 +1,60 @@
+# Generated by juwelier
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: dining-table 0.1.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "dining-table"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Micha\u{eb}l Van Damme"]
+  s.date = "2016-07-31"
+  s.description = "Easily output tabular data, be it in HTML, CSV or XLSX. Create clean table classes instead of messing with views to create nice tables."
+  s.email = "michael.vandamme@vub.ac.be"
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "dining-table.gemspec",
+    "lib/dining-table.rb",
+    "lib/dining-table/columns/actions_column.rb",
+    "lib/dining-table/columns/column.rb",
+    "lib/dining-table/config.rb",
+    "lib/dining-table/presenters/csv_presenter.rb",
+    "lib/dining-table/presenters/excel_presenter.rb",
+    "lib/dining-table/presenters/html_presenter.rb",
+    "lib/dining-table/presenters/presenter.rb",
+    "lib/dining-table/presenters/spreadsheet_presenter.rb",
+    "lib/dining-table/table.rb"
+  ]
+  s.homepage = "http://github.com/mvdamme/dining-table"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.4.8"
+  s.summary = "Create tables easily. Supports html, csv and xlsx."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<juwelier>, ["~> 2.1.0"])
+    else
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<juwelier>, ["~> 2.1.0"])
+    end
+  else
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<juwelier>, ["~> 2.1.0"])
+  end
+end
+

data/lib/dining-table.rb

@@ -0,0 +1,12 @@
+require 'dining-table/config'
+
+require 'dining-table/table'
+
+require 'dining-table/columns/column'
+require 'dining-table/columns/actions_column'
+
+require 'dining-table/presenters/presenter'
+require 'dining-table/presenters/html_presenter'
+require 'dining-table/presenters/spreadsheet_presenter'
+require 'dining-table/presenters/csv_presenter'
+require 'dining-table/presenters/excel_presenter'

data/lib/dining-table/columns/actions_column.rb

@@ -0,0 +1,36 @@
+module DiningTable
+  
+  module Columns
+
+    class ActionsColumn < Column
+      
+      def value(object)
+        if block
+          @incremental_value = ''
+          @current_object = object
+          self.instance_eval(&block)
+          @incremental_value
+        end
+      end
+      
+      private
+      
+        def action(&block)
+          action_value = yield(@current_object)
+          @incremental_value += action_value.try(:to_s) if action_value
+        end
+
+        # offer methods normally available on Table that could be used by the action blocks
+        [ :h, :helpers, :collection, :index, :presenter ].each do |method|
+          self.class_eval <<-eos, __FILE__, __LINE__+1
+            def #{method}(*args)
+              table.#{method}
+            end
+          eos
+        end
+      
+    end
+
+  end
+
+end

data/lib/dining-table/columns/column.rb

@@ -0,0 +1,55 @@
+module DiningTable
+  
+  module Columns
+
+    class Column
+      
+      attr_accessor :name, :table, :options, :block
+      
+      def initialize( table, name, options = {}, &block)
+        self.table = table
+        self.name = name
+        self.options = options
+        self.block = block
+      end
+      
+      def value(object)
+        if block
+          block.call(object, self)
+        else
+          object.send(name).try(:to_s) if object.respond_to?(name)
+        end
+      end
+      
+      def header
+        @header ||= begin
+          label = determine_label(:header)
+          return label if label
+          object_class = table.collection.first.try(:class)
+          object_class.human_attribute_name( name ) if object_class && object_class.respond_to?( :human_attribute_name )
+        end
+      end
+
+      def footer
+        @footer ||= determine_label(:footer)
+      end
+      
+      def options_for(identifier)
+        options[ identifier ] || { }
+      end
+    
+      private
+      
+        def determine_label( name )
+          if options[ name ]
+            label_ = options[ name ]
+            label_ = label_.call if label_.respond_to?(:call)
+            return label_.try(:to_s) 
+          end
+        end
+
+    end
+
+  end
+
+end

data/lib/dining-table/config.rb

@@ -0,0 +1,35 @@
+# configuration, see http://robots.thoughtbot.com/mygem-configure-block.
+module DiningTable
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+
+  class PresenterConfiguration
+    attr_accessor :default_options
+
+    def initialize
+      @default_options = { }
+    end
+  end
+
+  class Configuration
+    attr_accessor :html_presenter
+    attr_accessor :csv_presenter
+    attr_accessor :excel_presenter
+
+    def initialize
+      @html_presenter  = PresenterConfiguration.new
+      @csv_presenter   = PresenterConfiguration.new
+      @excel_presenter = PresenterConfiguration.new
+    end
+  end
+
+end
+
+SuckerPunch::Backgroundable.configure {}

data/lib/dining-table/presenters/csv_presenter.rb

@@ -0,0 +1,41 @@
+module DiningTable
+  
+  module Presenters
+
+    class CSVPresenter < SpreadsheetPresenter
+      
+      def initialize( *args )
+        super
+        self.output = ''
+      end
+      
+      def identifier
+        :csv
+      end
+      
+      def output
+        stringio.string
+      end
+      
+      private
+      
+        attr_writer :output
+        attr_accessor :stringio
+        
+        def csv
+          @csv ||= begin
+            self.stringio = StringIO.new
+            csv_options = options[:csv] || { }
+            CSV.new(stringio, csv_options)
+          end
+        end
+        
+        def add_row(array)
+          csv.add_row( array )
+        end
+
+    end
+
+  end
+
+end

data/lib/dining-table/presenters/excel_presenter.rb

@@ -0,0 +1,28 @@
+module DiningTable
+  
+  module Presenters
+
+    class ExcelPresenter < SpreadsheetPresenter
+      
+      def initialize( worksheet, *args )
+        super( *args )
+        self.worksheet = worksheet
+      end
+      
+      def identifier
+        :xlsx
+      end
+      
+      private
+      
+        attr_accessor :worksheet
+        
+        def add_row(array)
+          worksheet.add_row( array )
+        end
+
+    end
+
+  end
+
+end

data/lib/dining-table/presenters/html_presenter.rb

@@ -0,0 +1,142 @@
+module DiningTable
+  
+  module Presenters
+
+    class HTMLPresenter < Presenter
+      
+      def initialize( *args )
+        super
+        self.output  = ''
+      end
+      
+      def identifier
+        :html
+      end
+      
+      def start_table
+        if options[:wrap]
+          add_tag(:start, wrap_tag, wrap_options )
+        end
+        add_tag(:start, :table, options )
+      end
+      
+      def end_table
+        add_tag(:end, :table)
+        if options[:wrap]
+          add_tag(:end, wrap_tag )
+        end
+      end
+      
+      def start_body
+        add_tag(:start, :tbody)
+      end
+      
+      def end_body
+        add_tag(:end, :tbody)
+      end
+      
+      def render_row( object )
+        add_tag(:start, :tr)
+        columns.each do |column|
+          value = column.value( object )
+          render_cell( value, column.options_for( identifier ) )
+        end
+        add_tag(:end,   :tr)
+      end
+
+      def render_header
+        add_tag(:start, :thead)
+        add_tag(:start, :tr)
+        columns.each do |column|
+          value = column.header
+          render_header_cell( value, column.options_for( identifier )  )
+        end
+        add_tag(:end,   :tr)
+        add_tag(:end,   :thead)
+      end
+      
+      def render_footer
+        footers = columns.each.map(&:footer)
+        if footers.map(&:blank?).uniq != [ true ]
+          add_tag(:start, :tfoot)
+          add_tag(:start, :tr)
+          columns.each_with_index do |column, index|
+            value = footers[index]
+            render_footer_cell( value, column.options_for( identifier )  )
+          end
+          add_tag(:end,   :tr)
+          add_tag(:end,   :tfoot)
+        end
+      end
+
+      def output
+        @output.html_safe
+      end
+      
+      private
+      
+        attr_writer :output
+        
+        def output_
+          @output
+        end
+        
+        def add_tag(type, tag, options = {})
+          string = send("#{ type.to_s }_tag", tag, options)
+          output_ << string
+        end
+      
+        def start_tag(tag, options = {})
+          "<#{ tag.to_s } #{ options_string(options) }>"
+        end
+      
+        def end_tag(tag, options = {})
+          "</#{ tag.to_s }>"
+        end
+        
+        def render_cell( string, options )
+          render_general_cell( string, options, :td, :td_options )
+        end
+
+        def render_header_cell( string, options )
+          render_general_cell( string, options, :th, :th_options )
+        end
+        
+        def render_footer_cell( string, options )
+          render_general_cell( string, options, :td, :footer_options )
+        end
+        
+        def render_general_cell( string, options, cell_tag, options_identifier )
+          add_tag(:start, cell_tag, options[ options_identifier ] )
+          output_ << string.to_s
+          add_tag(:end,   cell_tag)
+        end
+
+        def options_string(options)
+          return '' if options.nil?
+          options.each_key.inject('') do |result, key|
+            result += " #{key.to_s}=\"#{ options[key] }\"" if !options_to_skip.include?( key )
+            result
+          end
+        end
+        
+        # don't output these keys as html options in options_string
+        def options_to_skip
+          [ :wrap ]
+        end
+
+        def wrap_tag
+          options[:wrap][:tag]
+        end
+
+        def wrap_options
+          options_ = options[:wrap].dup
+          options_.delete(:tag)
+          options_
+        end
+        
+    end
+
+  end
+
+end

data/lib/dining-table/presenters/presenter.rb

@@ -0,0 +1,51 @@
+module DiningTable
+  
+  module Presenters
+
+    class Presenter
+      
+      attr_accessor :table, :options, :view_context
+      
+      def initialize( options = {} )
+        self.options = default_options.merge( options )
+      end
+      
+      def connect_to( table )
+        self.table = table
+      end
+      
+      def identifier
+        raise NotImplementedError
+      end
+      
+      def type?( identifier_ )
+        identifier == identifier_
+      end
+      
+      [ :start_table, :end_table, :render_header, :start_body, :end_body, :row, :render_footer, :output ].each do |method|
+        self.class_eval <<-eos, __FILE__, __LINE__+1
+          def #{method}(*args)
+          end
+        eos
+      end
+      
+      private
+      
+        def columns
+          table.columns
+        end
+        
+        def default_options
+          presenter = "#{ identifier }_presenter"
+          if DiningTable.configuration.respond_to?( presenter )
+            DiningTable.configuration.send( presenter ).default_options
+          else
+            { }
+          end
+        end
+
+    end
+
+  end
+
+end

data/lib/dining-table/presenters/spreadsheet_presenter.rb

@@ -0,0 +1,54 @@
+module DiningTable
+  
+  module Presenters
+
+    class SpreadsheetPresenter < Presenter
+      
+      def render_row( object )
+        values = columns.map do |column|
+          value = column.value( object )
+          value = clean( value ) if !!options[:clean]
+          value
+        end
+        add_row( values )
+      end
+
+      def render_header
+        add_row( header_strings )
+      end
+      
+      def render_footer
+        footers = footer_strings
+        if footers.map(&:blank?).uniq != [ true ]
+          add_row( footers )
+        end
+      end
+      
+      private
+      
+        def header_strings
+          columns.map(&:header)
+        end
+        
+        def footer_strings
+          columns.map(&:footer)
+        end
+
+        def add_row( row )
+          raise NotImplementedError
+        end
+
+        def clean(string)
+          replacements = [['&mdash;', '--'], ['&ndash;', '-'], ['&nbsp;', ' '] ]
+          base = view_context.strip_tags(string)
+          replacements.each do |pattern, replacement|
+            base.gsub!(pattern, replacement)
+          end
+          base
+        end
+        
+    end
+
+  end
+
+end

data/lib/dining-table/table.rb

@@ -0,0 +1,69 @@
+module DiningTable
+
+  class Table
+    
+    attr_accessor :collection, :presenter, :options, :index, :columns, :action_columns, :view_context
+    
+    def initialize( collection, view_context, options = {} )
+      self.collection = collection
+      self.view_context = view_context
+      self.index     = 0
+      self.columns   = [ ]
+      self.options   = options
+      initialize_presenter( options )
+      define
+    end
+    
+    def define
+      raise NotImplementedError
+    end
+    
+    def render
+      presenter.start_table
+      presenter.render_header unless no_header
+      collection.each_with_index do |object, index_|
+        self.index = index_
+        presenter.render_row( object )
+      end
+      presenter.render_footer
+      presenter.end_table
+      presenter.output
+    end
+    
+    def helpers
+      view_context
+    end
+    alias_method :h, :helpers
+    
+    private
+    
+      attr_accessor :no_header
+    
+      # auxiliary function
+      def column(name, options = {}, &block)
+        klass = options[:class]
+        klass ||= Columns::Column
+        self.columns << klass.new(self, name, options, &block)
+      end
+      
+      def actions(options = {}, &block)
+        column(:actions__, { :class => Columns::ActionsColumn }.merge( options ), &block )
+      end
+      
+      def initialize_presenter( options )
+        self.presenter = options[ :presenter ]
+        self.presenter ||= default_presenter.new
+        self.presenter.connect_to( self )
+      end
+      
+      def default_presenter
+        Presenters::HTMLPresenter
+      end
+      
+      def skip_header
+        self.no_header = true
+      end
+      
+  end
+
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: dining-table
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michaël Van Damme
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: juwelier
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+description: Easily output tabular data, be it in HTML, CSV or XLSX. Create clean
+  table classes instead of messing with views to create nice tables.
+email: michael.vandamme@vub.ac.be
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- dining-table.gemspec
+- lib/dining-table.rb
+- lib/dining-table/columns/actions_column.rb
+- lib/dining-table/columns/column.rb
+- lib/dining-table/config.rb
+- lib/dining-table/presenters/csv_presenter.rb
+- lib/dining-table/presenters/excel_presenter.rb
+- lib/dining-table/presenters/html_presenter.rb
+- lib/dining-table/presenters/presenter.rb
+- lib/dining-table/presenters/spreadsheet_presenter.rb
+- lib/dining-table/table.rb
+homepage: http://github.com/mvdamme/dining-table
+licenses:
+- MIT
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Create tables easily. Supports html, csv and xlsx.
+test_files: []