fat_table 0.2.2

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rdoc/task'
+
+RDoc::Task.new do |rdoc|
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_files.include('README.rdoc', 'lib')
+end
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/TODO.org

@@ -0,0 +1,31 @@
+* TODO Conversion to Spreadsheets
+- State "TODO"       from              [2017-04-21 Fri 10:36]
+This is a [[https://github.com/westonganger/spreadsheet_architect][gem]] that I can include into the Table model to convert a table into
+a spread-sheet, or even a sheet in a multi-sheet spreadsheet file.
+
+* DONE Formatters
+CLOSED: [2017-04-21 Fri 10:36]
+- State "WAIT"       from "TODO"       [2017-04-21 Fri 10:36]
+- State "TODO"       from              [2017-04-21 Fri 10:35]
+Need to think about ways to define formatters for Table for different output
+types, including tty, color-tty, latex, csv, spreadsheet?
+
+* DONE Add a Group Boundary concept
+CLOSED: [2017-04-21 Fri 10:36]
+- State "WAIT"       from "TODO"       [2017-04-21 Fri 10:36]
+- State "TODO"       from              [2017-04-21 Fri 10:35]
+If I want a table to perform sub-totals at various break points, need to have a
+way for a table to record its grouping boundaries. Maybe an array of row
+numbers?  Automatically injected by the group-by method?
+
+* DONE Add uniq method and set operations
+CLOSED: [2017-03-02 Thu 15:54]
+- State "WAIT"       from "TODO"       [2017-03-02 Thu 15:54]
+- State "TODO"       from              [2017-03-02 Thu 15:54]
+For tables, add a method that eliminates any duplicate rows. Perhaps just apply
+Array#uniq to the columns?
+
+* TODO Add from_yql for fetching from Yahoo
+- State "TODO"       from              [2017-04-21 Fri 10:35]
+Add a constructor to allow fetching stock data from yql.  Perhaps grab all
+available fields, then allow a select of those of interest.

data/bin/ft_console

@@ -0,0 +1,119 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'fat_table'
+require 'pry'
+
+data =
+  [['Date', 'Code', 'Raw', 'Shares', 'Price', 'Info', 'Ok'],
+   ['2013-05-29', 'S', 15_700.00, 6601.85, 24.7790, 'ENTITY3', 'F'],
+   ['2013-05-02', 'P', 118_186.40, 118_186.4, 11.8500, 'ENTITY1', 'T'],
+   ['2013-05-20', 'S', 12_000.00, 5046.00, 28.2804, 'ENTITY3', 'F'],
+   ['2013-05-23', 'S', 8000.00, 3364.00, 27.1083, 'ENTITY3', 'T'],
+   ['2013-05-23', 'S', 39_906.00, 16_780.47, 25.1749, 'ENTITY3', 'T'],
+   ['2013-05-20', 'S', 85_000.00, 35_742.50, 28.3224, 'ENTITY3', 'T'],
+   ['2013-05-02', 'P', 795_546.20, 795_546.2, 1.1850, 'ENTITY1', 'T'],
+   ['2013-05-29', 'S', 13_459.00, 5659.51, 24.7464, 'ENTITY3', 'T'],
+   ['2013-05-20', 'S', 33_302.00, 14_003.49, 28.6383, 'ENTITY3', 'T'],
+   ['2013-05-29', 'S', 15_900.00, 6685.95, 24.5802, 'ENTITY3', 'T'],
+   ['2013-05-30', 'S', 6_679.00, 2808.52, 25.0471, 'ENTITY3', 'T'],
+   ['2013-05-23', 'S', 23_054.00, 9694.21, 26.8015, 'ENTITY3', 'F']]
+
+tab_a_str = <<-EOS
+  | Id | Name  | Age | Address    | Salary |  Join Date |
+  |----+-------+-----+------------+--------+------------|
+  |  1 | Paul  |  32 | California |  20000 | 2001-07-13 |
+  |  3 | Teddy |  23 | Norway     |  20000 | 2007-12-13 |
+  |  4 | Mark  |  25 | Rich-Mond  |  65000 | 2007-12-13 |
+  |  5 | David |  27 | Texas      |  85000 | 2007-12-13 |
+  |  2 | Allen |  25 | Texas      |        | 2005-07-13 |
+  |  8 | Paul  |  24 | Houston    |  20000 | 2005-07-13 |
+  |  9 | James |  44 | Norway     |   5000 | 2005-07-13 |
+  | 10 | James |  45 | Texas      |   5000 |            |
+  EOS
+
+tab_b_str = <<-EOS
+  | Id | Dept        | Emp Id |
+  |----+-------------+--------|
+  |  1 | IT Billing  |      1 |
+  |  2 | Engineering |      2 |
+  |  3 | Finance     |      7 |
+  EOS
+
+tab_a = FatTable.from_org_string(tab_a_str)
+tab_b = FatTable.from_org_string(tab_b_str)
+
+tab1_str = <<-EOS
+| Ref  | Date             | Code |  Price | G10 | QP10 | Shares |   LP |    QP |   IPLP |   IPQP |
+|------+------------------+------+--------+-----+------+--------+------+-------+--------+--------|
+| T001 | [2016-11-01 Tue] | P    | 7.7000 | T   | F    |    100 |   14 |    86 | 0.2453 | 0.1924 |
+| T002 | [2016-11-01 Tue] | P    | 7.7500 | T   | F    |    200 |   28 |   172 | 0.2453 | 0.1924 |
+| T003 | [2016-11-01 Tue] | P    | 7.5000 | F   | T    |    800 |  112 |   688 | 0.2453 | 0.1924 |
+| T003 | [2016-11-01 Tue] | P    | 7.5000 | F   | T    |    800 |  112 |   688 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+------+-------+--------+--------|
+| T004 | [2016-11-01 Tue] | S    | 7.5500 | T   | F    |   6811 |  966 |  5845 | 0.2453 | 0.1924 |
+| T005 | [2016-11-01 Tue] | S    | 7.5000 | F   | F    |   4000 |  572 |  3428 | 0.2453 | 0.1924 |
+| T006 | [2016-11-01 Tue] | S    | 7.6000 | F   | T    |   1000 |  143 |   857 | 0.2453 | 0.1924 |
+| T006 | [2016-11-01 Tue] | S    | 7.6000 | F   | T    |   1000 |  143 |   857 | 0.2453 | 0.1924 |
+| T007 | [2016-11-01 Tue] | S    | 7.6500 | T   | F    |    200 |   28 |   172 | 0.2453 | 0.1924 |
+| T008 | [2016-11-01 Tue] | P    | 7.6500 | F   | F    |   2771 |  393 |  2378 | 0.2453 | 0.1924 |
+| T009 | [2016-11-01 Tue] | P    | 7.6000 | F   | F    |   9550 | 1363 |  8187 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+------+-------+--------+--------|
+| T010 | [2016-11-01 Tue] | P    | 7.5500 | F   | T    |   3175 |  451 |  2724 | 0.2453 | 0.1924 |
+| T011 | [2016-11-02 Wed] | P    | 7.4250 | T   | F    |    100 |   14 |    86 | 0.2453 | 0.1924 |
+| T012 | [2016-11-02 Wed] | P    | 7.5500 | F   | F    |   4700 |  677 |  4023 | 0.2453 | 0.1924 |
+| T012 | [2016-11-02 Wed] | P    | 7.5500 | F   | F    |   4700 |  677 |  4023 | 0.2453 | 0.1924 |
+| T013 | [2016-11-02 Wed] | P    | 7.3500 | T   | T    |  53100 | 7656 | 45444 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+------+-------+--------+--------|
+| T014 | [2016-11-02 Wed] | P    | 7.4500 | F   | T    |   5847 |  835 |  5012 | 0.2453 | 0.1924 |
+| T015 | [2016-11-02 Wed] | P    | 7.7500 | F   | F    |    500 |   72 |   428 | 0.2453 | 0.1924 |
+| T016 | [2016-11-02 Wed] | P    | 8.2500 | T   | T    |    100 |   14 |    86 | 0.2453 | 0.1924 |
+EOS
+
+tab2_str = <<-EOS
+| Ref  | Date             | Code |  Price | G10 | QP10 | Shares |    LP |   QP |   IPLP |   IPQP |
+|------+------------------+------+--------+-----+------+--------+-------+------+--------+--------|
+| T003 | [2016-11-01 Tue] | P    | 7.5000 | F   | T    |    800 |   112 |  688 | 0.2453 | 0.1924 |
+| T003 | [2016-11-01 Tue] | P    | 7.5000 | F   | T    |    800 |   112 |  688 | 0.2453 | 0.1924 |
+| T017 | [2016-11-01 Tue] | P    |    8.3 | F   | T    |   1801 |  1201 |  600 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+-------+------+--------+--------|
+| T018 | [2016-11-01 Tue] | S    |  7.152 | T   | F    |   2516 |  2400 |  116 | 0.2453 | 0.1924 |
+| T018 | [2016-11-01 Tue] | S    |  7.152 | T   | F    |   2516 |  2400 |  116 | 0.2453 | 0.1924 |
+| T006 | [2016-11-01 Tue] | S    | 7.6000 | F   | T    |   1000 |   143 |  857 | 0.2453 | 0.1924 |
+| T007 | [2016-11-01 Tue] | S    | 7.6500 | T   | F    |    200 |    28 |  172 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+-------+------+--------+--------|
+| T014 | [2016-11-02 Wed] | P    | 7.4500 | F   | T    |   5847 |   835 | 5012 | 0.2453 | 0.1924 |
+| T015 | [2016-11-02 Wed] | P    | 7.7500 | F   | F    |    500 |    72 |  428 | 0.2453 | 0.1924 |
+| T015 | [2016-11-02 Wed] | P    | 7.7500 | F   | F    |    500 |    72 |  428 | 0.2453 | 0.1924 |
+| T016 | [2016-11-02 Wed] | P    | 8.2500 | T   | T    |    100 |    14 |   86 | 0.2453 | 0.1924 |
+|------+------------------+------+--------+-----+------+--------+-------+------+--------+--------|
+| T019 | [2017-01-15 Sun] | S    |   8.75 | T   | F    |    300 |   175 |  125 | 0.2453 | 0.1924 |
+| T020 | [2017-01-19 Thu] | S    |   8.25 | F   | T    |    700 |   615 |   85 | 0.2453 | 0.1924 |
+| T021 | [2017-01-23 Mon] | P    |   7.16 | T   | T    |  12100 | 11050 | 1050 | 0.2453 | 0.1924 |
+| T021 | [2017-01-23 Mon] | P    |   7.16 | T   | T    |  12100 | 11050 | 1050 | 0.2453 | 0.1924 |
+EOS
+
+tab1 = FatTable.from_org_string(tab1_str)
+tab2 = FatTable.from_org_string(tab2_str)
+
+AOA = [['Ref', 'Date', 'Code', 'Raw', 'Shares', 'Price', 'Info', 'Bool'],
+       [1, '2013-05-02', 'P', 795_546.20, 795_546.2, 1.1850, 'YLPEF1', 'T'],
+       [2, '2013-05-02', 'P', 118_186.40, 118_186.4, 11.8500, 'YLPEF1', 'T'],
+       [7, '2013-05-20', 'S', 12_000.00, 5046.00, 28.2804, 'YLEAC', 'F'],
+       [8, '2013-05-20', 'S', 85_000.00, 35_742.50, 28.3224, 'YLEAC', 'T'],
+       [9, '2013-05-20', 'S', 33_302.00, 14_003.49, 28.6383, 'YLEAC', 'T'],
+       [10, '2013-05-23', 'S', 8000.00, 3364.00, 27.1083, 'YLEAC', 'T'],
+       [11, '2013-05-23', 'S', 23_054.00, 9694.21, 26.8015, 'YLEAC', 'F'],
+       [12, '2013-05-23', 'S', 39_906.00, 16_780.47, 25.1749, 'YLEAC', 'T'],
+       [13, '2013-05-29', 'S', 13_459.00, 5659.51, 24.7464, 'YLEAC', 'T'],
+       [14, '2013-05-29', 'S', 15_700.00, 6601.85, 24.7790, 'YLEAC', 'F'],
+       [15, '2013-05-29', 'S', 15_900.00, 6685.95, 24.5802, 'YLEAC', 'T'],
+       [16, '2013-05-30', 'S', 6_679.00, 2808.52, 25.0471, 'YLEAC', 'T']]
+tt = FatTable.from_aoa(AOA)
+
+binding.pry
+instr <<-EOS
+FatTable console sets up some sample tables you can play with (see ls)
+
+  For example, try 'puts tab1.to_term'
+EOS

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/fat_table.gemspec

@@ -0,0 +1,80 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fat_table/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fat_table"
+  spec.version       = FatTable::VERSION
+  spec.authors       = ["Daniel E. Doherty"]
+  spec.email         = ["ded-law@ddoherty.net"]
+
+  spec.summary       = %q{Provides tools for working with tables as a data type.}
+  spec.description   = %q{
+~FatTable~ is a gem that treats tables as a data type. It provides methods for
+constructing tables from a variety of sources, building them row-by-row,
+extracting rows, columns, and cells, and performing aggregate operations on
+columns. It also provides as set of SQL-esque methods for manipulating table
+objects: ~select~ for filtering by columns or for creating new columns, ~where~
+for filtering by rows, ~order_by~ for sorting rows, ~distinct~ for eliminating
+duplicate rows, ~group_by~ for aggregating multiple rows into single rows and
+applying column aggregate methods to ungrouped columns, a collection of ~join~
+methods for combining tables, and more.
+
+Furthermore, ~FatTable~ provides methods for formatting tables and producing
+output that targets various output media: text, ANSI terminals, ruby data
+structures, LaTeX tables, Emacs org-mode tables, and more. The formatting
+methods can specify cell formatting in a way that is uniform across all the
+output methods and can also decorate the output with any number of footers,
+including group footers. ~FatTable~ applies formatting directives to the extent
+they makes sense for the output medium and treats other formatting directives as
+no-ops.
+
+~FatTable~ can be used to perform operations on data that are naturally best
+conceived of as tables, which in my experience is quite often. It can also serve
+as a foundation for providing reporting functions where flexibility about the
+output medium can be quite useful. Finally ~FatTable~ can be used within Emacs
+~org-mode~ files in code blocks targeting the Ruby language. Org mode tables are
+presented to a ruby code block as an array of arrays, so ~FatTable~ can read
+them in with its ~.from_aoa~ constructor. A ~FatTable~ table can output as an
+array of arrays with its ~.to_aoa~ output function and will be rendered in an
+org-mode buffer as an org-table, ready for processing by other code blocks.
+}
+
+  spec.homepage      = 'https://github.com/ddoherty03/fat_table'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the
+  # 'allowed_push_host' to allow pushing to a single host or delete this section
+  # to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'bin'
+  spec.executables   = ['ft_console']
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'bundler', '~> 1.14'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'pry-doc'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'rcodetools'
+
+  spec.add_runtime_dependency 'fat_core', '~> 2.0', '>= 2.0.1'
+  spec.add_runtime_dependency 'activesupport'
+  spec.add_runtime_dependency 'rainbow'
+  spec.add_runtime_dependency 'dbi'
+  spec.add_runtime_dependency 'dbd-pg'
+  spec.add_runtime_dependency 'dbd-mysql'
+  spec.add_runtime_dependency 'dbd-sqlite3'
+end

data/lib/fat_table.rb

@@ -0,0 +1,225 @@
+require "fat_table/version"
+
+# This module provides objects for treating tables as a data type on which you
+# can (1) perform operations, such as select, where, join, and others and (2)
+# output the tables in several formats, including text, ANSI terminal, LaTeX,
+# and others.  It also provides several constructors for building tables from a
+# variety of input sources.  See, e.g., .from_csv_file,
+# FatTable.from_org_file, and FatTable.from_sql, for more details.
+module FatTable
+  require 'fat_core'
+  require 'dbi'
+  require 'active_support'
+  require 'active_support/core_ext'
+  require 'active_support/number_helper'
+
+  require 'fat_table/evaluator'
+  require 'fat_table/column'
+  require 'fat_table/table'
+  require 'fat_table/formatters'
+  require 'fat_table/db_handle'
+  require 'fat_table/errors'
+
+  # Valid output formats as symbols.
+  FORMATS = [:psv, :aoa, :aoh, :latex, :org, :term, :text].freeze
+
+  class << self
+    # Set a default output format to use when FatTable.to_format is invoked.
+    # Valid formats are +:psv+, +:aoa+, +:aoh+, +:latex+, +:org+, +:term+, and
+    # +:text+, or their string equivalents. By default, +FatTable.format+ is
+    # +:text+.
+    attr_accessor :format
+
+    # Default value to use to indicate currency in a Numeric column.  By default
+    # this is set to '$'.
+    attr_accessor :currency_symbol
+  end
+  self.format = :text
+  self.currency_symbol = '$'
+
+  ###########################################################################
+  # Table Constructors
+  ###########################################################################
+
+  # Return an empty FatTable::Table object. You can use FatTable::Table#add_row
+  # or FatTable::Table#add_column to populate the table with data.
+  def self.new
+    Table.new
+  end
+
+  # Construct a FatTable::Table from the contents of a CSV file given by the
+  # file name +fname+. Headers will be taken from the first row and converted to
+  # symbols.
+  def self.from_csv_file(fname)
+    Table.from_csv_file(fname)
+  end
+
+  # Construct a FatTable::Table from the string +str+, treated in the same
+  # manner as if read the input from a CSV file. Headers will be taken from the
+  # first row and converted to symbols.
+  def self.from_csv_string(str)
+    Table.from_csv_string(str)
+  end
+
+  # Construct a FatTable::Table from the first table found in the Emacs org-mode
+  # file names +fname+. Headers are taken from the first row if the second row
+  # is an hline. Otherwise, synthetic headers of the form +:col_1+, +:col_2+,
+  # etc. are created. Any other hlines will be treated as marking a boundary in
+  # the table.
+  def self.from_org_file(fname)
+    Table.from_org_file(fname)
+  end
+
+  # Construct a FatTable::Table from the first table found in the string +str+,
+  # treated in the same manner as if read from an Emacs org-mode file. Headers
+  # are taken from the first row if the second row is an hrule. Otherwise,
+  # synthetic headers of the form :col_1, :col_2, etc. are created. Any other
+  # hlines will be treated as marking a boundary in the table.
+  def self.from_org_string(str)
+    Table.from_org_string(str)
+  end
+
+  # Construct a FatTable::Table from the array of arrays +aoa+. By default, with
+  # +hlines+ false, do not look for nil separators, just treat the first row as
+  # headers. With +hlines+ true, expect separators to mark the header row and
+  # any boundaries. If the second element of the array is a nil, interpret the
+  # first element of the array as a row of headers. Otherwise, synthesize
+  # headers of the form +:col_1+, +:col_2+, ... and so forth. The remaining
+  # elements are taken as the body of the table, except that if an element of
+  # the outer array is a nil, mark the preceding row as a boundary. In Emacs
+  # org-mode code blocks, by default (+:hlines no+) all hlines are stripped from
+  # the table, otherwise (+:hlines yes+) they are indicated with nil elements in
+  # the outer array.
+  def self.from_aoa(aoa, hlines: false)
+    Table.from_aoa(aoa, hlines: hlines)
+  end
+
+  # Construct a FatTable::Table from the array of hashes +aoh+, which can be an
+  # array of any objects that respond to the #to_h method. With +hlines+ true,
+  # interpret nil separators as marking boundaries in the new Table. All hashes
+  # must have the same keys, which, converted to symbols, become the headers for
+  # the new Table.
+  def self.from_aoh(aoh, hlines: false)
+    Table.from_aoh(aoh, hlines: hlines)
+  end
+
+  # Construct a FatTable::Table from another FatTable::Table. Inherit any group
+  # boundaries from the input table.
+  def self.from_table(table)
+    Table.from_table(table)
+  end
+
+  # Construct a Table by running a SQL query against the database set up with
+  # FatTable.set_db. Return the Table with the query results as rows and the
+  # headers from the query, converted to symbols, as headers.
+  def self.from_sql(query)
+    Table.from_sql(query)
+  end
+
+  ########################################################################
+  # Formatter
+  ########################################################################
+
+  # Return a string or ruby object formatting +table+ according to the format
+  # specified in +FatTable.format+. If a block is given, it will yield a
+  # +FatTable::Formatter+ of the appropriate type on which formatting and footer
+  # methods can be called. If no block is given, the default format for the type
+  # will be used. The +options+ are passed along to the FatTable::Formatter
+  # created to process the output.
+  def self.to_format(table, options = {}) # :yields: formatter
+    if block_given?
+      to_any(format, table, options, &Proc.new)
+    else
+      to_any(format, table, options)
+    end
+  end
+
+  # Return a string or ruby object according to the format given in the +fmt+
+  # argument. Valid formats are :psv, :aoa, :aoh, :latex, :org, :term, :text, or
+  # their string equivalents. If a block is given, it will yield a
+  # +FatTable::Formatter+ of the appropriate type on which formatting and footer
+  # methods can be called. If no block is given, the default format for the
+  # +fmt+ type will be used.
+  def self.to_any(fmt, table, options = {})
+    fmt = fmt.as_sym
+    raise UserError, "unknown format '#{fmt}'" unless FORMATS.include?(fmt)
+    method = "to_#{fmt}"
+    if block_given?
+      send method, table, options, &Proc.new
+    else
+      send method, table, options
+    end
+  end
+
+  # Return the +table+ as a string formatted as pipe-separated values, passing
+  # the +options+ to a new +FatTable::Formatter+ object. If no block is given,
+  # default formatting is applied to the +table+'s cells. If a block is given,
+  # it yields the +FatTable::Formatter+ to the block on which formatting
+  # and footer methods can be called.
+  def self.to_psv(table, options = {})
+    fmt = Formatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as an Array of Array of strings. If no block is given,
+  # default formatting is applies to the table's cells. If a block is given, it
+  # yields an AoaFormatter to the block to which formatting instructions and
+  # footers can be added by calling methods on it.
+  def self.to_aoa(table, options = {})
+    fmt = AoaFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as an Array of Hashes. Each inner hash uses the Table's
+  # columns as keys and it values are strings representing the cells of the
+  # table. If no block is given, default formatting is applies to the table's
+  # cells. If a block is given, it yields an AohFormatter to the block to which
+  # formatting instructions and footers can be added by calling methods on it.
+  def self.to_aoh(table, options = {})
+    fmt = AohFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as a string containing a LaTeX table. If no block is given,
+  # default formatting applies to the table's cells. If a block is given, it
+  # yields a LaTeXFormatter to the block to which formatting instructions and
+  # footers can be added by calling methods on it.
+  def self.to_latex(table, options = {})
+    fmt = LaTeXFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as a string containing an Emacs org-mode table. If no block
+  # is given, default formatting applies to the table's cells. If a block is
+  # given, it yields a OrgFormatter to the block to which formatting
+  # instructions and footers can be added by calling methods on it.
+  def self.to_org(table, options = {})
+    fmt = OrgFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as a string containing ANSI terminal text representing
+  # table. If no block is given, default formatting applies to the table's
+  # cells. If a block is given, it yields a TermFormatter to the block to which
+  # formatting instructions and footers can be added by calling methods on it.
+  def self.to_term(table, options = {})
+    fmt = TermFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+
+  # Return the table as a string containing ordinary text representing table. If
+  # no block is given, default formatting applies to the table's cells. If a
+  # block is given, it yields a TextFormatter to the block to which formatting
+  # instructions and footers can be added by calling methods on it.
+  def self.to_text(table, options = {})
+    fmt = TextFormatter.new(table, options)
+    yield fmt if block_given?
+    fmt.output
+  end
+end