terminal-table 1.2.0

data/History.rdoc

@@ -0,0 +1,26 @@
+
+=== 1.2.0 / 2009-08-06
+
+* Added colspan support to table
+
+=== 1.1.0 / 2009-08-06
+
+* Added colspan support to table
+
+=== 1.1.0 / 2009-07-13
+
+* Added Table#==
+
+=== 1.0.5 / 2009-03-14
+
+* Allowing nil to be passed to table for headings
+* Revised doc to show that rows can be splatted now
+* Misc refactoring
+
+=== 1.0.3 / 2009-01-15
+
+* Moved yield or eval to Terminal::Table initialize where it belongs
+
+=== 1.0.0 / 2009-01-13
+
+* Initial release

data/Manifest

@@ -0,0 +1,25 @@
+examples/examples.rb
+History.rdoc
+lib/terminal-table/cell.rb
+lib/terminal-table/core_ext.rb
+lib/terminal-table/heading.rb
+lib/terminal-table/import.rb
+lib/terminal-table/table.rb
+lib/terminal-table/table_helper.rb
+lib/terminal-table/version.rb
+lib/terminal-table.rb
+Manifest
+Rakefile
+README.rdoc
+spec/cell_spec.rb
+spec/core_ext_spec.rb
+spec/import_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/table_helper_spec.rb
+spec/table_spec.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake
+terminal-table.gemspec
+Todo.rdoc

data/README.rdoc

@@ -0,0 +1,151 @@
+
+= Terminal Table
+
+Simple, feature rich ASCII table generator.
+
+== Installation:
+
+  Install [Gemcutter](http://gemcutter.org) then execute:
+  $ sudo gem install terminal-table
+
+== Features:
+
+* Fast
+* Simple
+* Optional headings
+* Alignment of columns, headings, or cells
+* Supports column span
+* Easy modification of table strings (+, -, |)
+
+== Examples:
+
+  require 'rubygems'
+  require 'terminal-table/import'
+   
+  puts table(['a', 'b'], [1, 2], [3, 4])
+   
+  t = table ['a', 'b']
+  t << [1, 2]
+  t << [3, 4]
+  puts t
+   
+  user_table = table do |t|
+    t.headings = 'First Name', 'Last Name', 'Email'
+    t << ['TJ',  'Holowaychuk', 'tj@vision-media.ca']
+    t << ['Bob', 'Someone',     'bob@vision-media.ca']
+    t << ['Joe', 'Whatever',    'joe@vision-media.ca']
+  end
+  puts user_table
+   
+  user_table = table do
+    self.headings = 'First Name', 'Last Name', 'Email'
+    add_row ['TJ',  'Holowaychuk', { :value => 'tj@vision-media.ca', :align => :right }]
+    add_row ['Bob', 'Someone',     'bob@vision-media.ca']
+    add_row ['Joe', 'Whatever',    'joe@vision-media.ca']
+    align_column 1, :center
+  end
+  puts user_table
+
+  puts
+  user_table = table do
+    self.headings = ['First Name', 'Last Name', {:value => 'Phones', :colspan => 2, :alignment => :center}]
+    add_row ['Bob', 'Someone',     '123', '456']
+    add_row ['TJ',  'Holowaychuk', {:value => "No phones", :colspan => 2, :alignment => :center}]
+    add_row ['Joe', 'Whatever',    '4324', '343242']
+  end
+  puts user_table
+   
+  rows = []
+  rows << ['Lines',      100]
+  rows << ['Comments',   20]
+  rows << ['Ruby',       70]
+  rows << ['JavaScript', 30]
+  puts table([nil, 'Lines'], *rows)
+   
+  rows = []
+  rows << ['Lines',      100]
+  rows << ['Comments',   20]
+  rows << ['Ruby',       70]
+  rows << ['JavaScript', 30]
+  puts table(nil, *rows)
+
+== Results:
+
+  +---+---+
+  | a | b |
+  +---+---+
+  | 1 | 2 |
+  | 3 | 4 |
+  +---+---+
+   
+  +---+---+
+  | a | b |
+  +---+---+
+  | 1 | 2 |
+  | 3 | 4 |
+  +---+---+
+   
+  +------------+-------------+---------------------+
+  | First Name | Last Name   | Email               |
+  +------------+-------------+---------------------+
+  | TJ         | Holowaychuk | tj@vision-media.ca  |
+  | Bob        | Someone     | bob@vision-media.ca |
+  | Joe        | Whatever    | joe@vision-media.ca |
+  +------------+-------------+---------------------+
+   
+  +------------+-----------------------------+---------------------+
+  | First Name | Last Name                   | Email               |
+  +------------+-----------------------------+---------------------+
+  | TJ         |         Holowaychuk         |  tj@vision-media.ca |
+  | Bob        |           Someone           | bob@vision-media.ca |
+  | Joe        |          Whatever           | joe@vision-media.ca |
+  +------------+-----------------------------+---------------------+
+
+  +------------+-------------+-----------+--------+
+  | First Name | Last Name   |       Phones       |
+  +------------+-------------+-----------+--------+
+  | Bob        | Someone     | 123       | 456    |
+  | TJ         | Holowaychuk |     No phones      |
+  | Joe        | Whatever    | 4324      | 343242 |
+  +------------+-------------+-----------+--------+
+
+  +------------+-------+
+  |            | Lines |
+  +------------+-------+
+  | Lines      | 100   |
+  | Comments   | 20    |
+  | Ruby       | 70    |
+  | JavaScript | 30    |
+  +------------+-------+
+
+  +------------+-----+
+  | Lines      | 100 |
+  | Comments   | 20  |
+  | Ruby       | 70  |
+  | JavaScript | 30  |
+  +------------+-----+
+
+== License:
+
+(The MIT License)
+
+Copyright (c) 2008-2009 TJ Holowaychuk <tj@vision-media.ca>
+
+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, an d/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/Rakefile

@@ -0,0 +1,15 @@
+
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require './lib/terminal-table.rb'
+
+Echoe.new("terminal-table", Terminal::Table::VERSION) do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "Simple, feature rich ascii table generation library"
+  p.url = "http://github.com/visionmedia/terminal-table"
+  p.runtime_dependencies = []
+end
+
+Dir['tasks/**/*.rake'].sort.each { |lib| load lib }

data/Todo.rdoc

@@ -0,0 +1,15 @@
+
+== Major:
+
+* Nothing
+
+== Minor:
+
+* Programmatically add seperator rows
+* Arbitrary dimensions
+* Add multi-column sorting
+* Change; pre-create Cell and Heading objects to clean up Table a bit
+
+== Brainstorming:
+
+* Nothing

data/examples/examples.rb

@@ -0,0 +1,66 @@
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'terminal-table/import'
+
+puts
+puts table(['a', 'b'], [1, 2], [3, 4])
+
+puts
+t = table ['a', 'b']
+t << [1, 2]
+t << [3, 4]
+puts t
+
+puts
+user_table = table do |t|
+  t.headings = 'First Name', 'Last Name', 'Email'
+  t << %w( TJ Holowaychuk tj@vision-media.ca )
+  t << %w( Bob Someone bob@vision-media.ca )
+  t << %w( Joe Whatever bob@vision-media.ca )
+end
+puts user_table
+
+puts
+user_table = table do
+  self.headings = 'First Name', 'Last Name', 'Email'
+  add_row ['TJ',  'Holowaychuk', ['tj@vision-media.ca', :right]]
+  add_row ['Bob', 'Someone',     'bob@vision-media.ca']
+  add_row ['Joe', 'Whatever',    'joe@vision-media.ca']
+  align_column 1, :center
+end
+puts user_table
+
+puts
+user_table = table do
+  self.headings = ['First Name', 'Last Name', {:value => 'Phones', :colspan => 2, :alignment => :center}]
+  add_row ['Bob', 'Someone',     '123', '456']
+  add_row ['TJ',  'Holowaychuk', {:value => "No phones", :colspan => 2, :alignment => :center}]
+  add_row ['Joe', 'Whatever',    '4324', '343242']
+end
+puts user_table
+
+rows = []
+rows << ['Lines',      100]
+rows << ['Comments',   20]
+rows << ['Ruby',       70]
+rows << ['JavaScript', 30]
+puts table([nil, 'Lines'], *rows)
+
+rows = []
+rows << ['Lines',      100]
+rows << ['Comments',   20]
+rows << ['Ruby',       70]
+rows << ['JavaScript', 30]
+puts table(nil, *rows)
+
+
+Terminal::Table::X = '='
+Terminal::Table::Y = '!'
+Terminal::Table::I = '*'
+
+rows = []
+rows << [nil,  nil, nil]
+rows << [nil, ':)', nil]
+rows << [nil,  nil, nil]
+puts table(nil, *rows)
+

data/lib/terminal-table.rb

@@ -0,0 +1,31 @@
+#--
+# Copyright (c) 2008-2009 TJ Holowaychuk <tj@vision-media.ca>
+#
+# 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.
+#++
+
+$:.unshift File.dirname(__FILE__)
+
+require 'terminal-table/version'
+require 'terminal-table/core_ext'
+require 'terminal-table/table'
+require 'terminal-table/cell'
+require 'terminal-table/heading'
+require 'terminal-table/table_helper'

data/lib/terminal-table/cell.rb

@@ -0,0 +1,32 @@
+
+module Terminal
+  class Table
+    class Cell
+      
+      attr_accessor :value, :alignment, :colspan
+      
+      def initialize width, params
+        @width = width
+        @alignment = :left
+        @colspan = 1
+
+        if params.is_a? Hash
+          @value = params[:value]
+          @alignment = params[:alignment] unless params[:alignment].nil?
+          @colspan = params[:colspan] unless params[:colspan].nil?
+        else
+          @value = params
+        end
+      end
+      
+      def render
+        " #{value.to_s} ".align alignment, @width + 2
+      end
+      alias :to_s :render
+      
+      def length
+        @value.to_s.length + 2
+      end
+    end
+  end
+end

data/lib/terminal-table/core_ext.rb

@@ -0,0 +1,39 @@
+
+class String
+  
+  ##
+  # Align to +position+, which may be :left, :right, or :center.
+  
+  def align position, length
+    send position, length
+  end
+  alias_method :left, :ljust
+  alias_method :right, :rjust
+  
+end
+
+module Enumerable
+  def map_with_index &block
+    result = []
+    each_with_index { |v, i| result << yield(v, i) } 
+    result
+  end
+  alias :collect_with_index :map_with_index
+end
+
+class Object
+  
+  ##
+  # Yields or instance_eval's a +block+ depending on the arity of a block
+  # in order to support both types of block syntax for DSL's.
+  
+  def yield_or_eval &block
+    return unless block
+    if block.arity > 0
+      yield self
+    else
+      self.instance_eval &block
+    end
+  end
+  
+end

data/lib/terminal-table/heading.rb

@@ -0,0 +1,10 @@
+
+module Terminal
+  class Table
+    class Heading < Cell
+      def initialize width, params
+        super
+      end
+    end
+  end
+end

data/lib/terminal-table/import.rb

@@ -0,0 +1,5 @@
+require 'terminal-table'
+
+class Object
+  include Terminal::Table::TableHelper
+end

data/lib/terminal-table/table.rb

@@ -0,0 +1,191 @@
+
+module Terminal
+  
+  ##
+  # Generates an ASCII table for terminal usage.
+  #
+  # This class can be used in many ways, however ultimately you should
+  # require 'terminal-table/import' (which requires terminal-table itself) to use
+  # the Kernel helper method which is easier, and cleaner to use. View Object#table
+  # for examples.
+  #
+  # === Examples:
+  #
+  #    table = Terminal::Table.new
+  #    table.headings = ['Characters', { :value => 'Nums', :align => :right }]
+  #    table << [{ :value => 'a', :align => :center }, 1]
+  #    table << ['b', 222222222222222]
+  #    table << ['c', 3]
+  #    puts table.render     # or simply puts table
+  #
+  #    +------------+-----------------+
+  #    | Characters |            Nums |
+  #    +------------+-----------------+
+  #    |     a      | 1               |
+  #    | b          | 222222222222222 |
+  #    | c          | 3               |
+  #    +------------+-----------------+
+  #    
+  
+  class Table
+    
+    #--
+    # Exceptions
+    #++
+    
+    class Error < StandardError; end
+    
+    ##
+    # Table characters, x axis, y axis, and intersection.
+    
+    X, Y, I = '-', '|', '+'
+    
+    attr_accessor :headings, :rows
+    
+    ##
+    # Generates a ASCII table.
+  
+    def initialize options = {}, &block
+      @headings = options.fetch :headings, []
+      @rows = options.fetch :rows, []
+      yield_or_eval &block if block_given?
+    end
+    
+    ##
+    # Render the table. Often you will simply call _puts_ with an
+    # instance in order to output it to the terminal.
+  
+    def render
+      buffer = seperator << "\n" 
+      if has_headings?
+        buffer << Y + headings.map_with_index do |heading, i|
+          width = 0
+          if heading.is_a?(Hash) and !heading[:colspan].nil?
+            i.upto(i + heading[:colspan] - 1) do |col|
+              width += length_of_column(col)
+            end
+            width += (heading[:colspan] - 1) * (Y.length + 2)
+          else
+            width = length_of_column(i)
+          end
+          Heading.new( width, heading).render
+        end.join(Y) + Y
+        buffer << "\n#{seperator}\n"
+      end
+      buffer << rows.map do |row| 
+        Y + row.map_with_index do |cell, i|
+          width = 0
+          if cell.is_a?(Hash) and !cell[:colspan].nil?
+            i.upto(i + cell[:colspan] - 1) do |col|
+              width += length_of_column(col)
+            end
+            width += (cell[:colspan] - 1) * (Y.length + 2)
+          else
+            width = length_of_column(i)
+          end
+          Cell.new(width, cell).render
+        end.join(Y) + Y 
+      end.join("\n")
+      buffer << "\n#{seperator}\n"
+    end
+    alias :to_s :render
+    
+    ##
+    # Create a seperator based on colum lengths.
+    
+    def seperator
+      I + columns.collect_with_index do |col, i| 
+        X * (length_of_column(i) + 2) 
+      end.join(I) + I 
+    end
+    
+    ##
+    # Add a row. 
+    
+    def add_row row
+      rows << row
+    end
+    alias :<< :add_row
+
+    ##
+    # Weither or not any headings are present, since they are optional.
+    
+    def has_headings?
+      !headings.empty?
+    end
+    
+    ##
+    # Return +n+ column.
+    
+    def column n
+      rows.map { |row| row[n] }.compact 
+    end
+    
+    ##
+    # Return +n+ column including headings.
+    
+    def column_with_headings n
+      headings_with_rows.map { |row| row[n] }.compact  
+    end
+    
+    ##
+    # Return columns.
+    
+    def columns 
+      (0..number_of_columns-1).map { |n| column n } 
+    end
+    
+    ##
+    # Return the largest cell found within column +n+.
+    
+    def largest_cell_in_column n
+      column_with_headings(n).sort_by { |cell| Cell.new(0, cell).length }.last
+    end
+    
+    ##
+    # Return length of column +n+.
+    
+    def length_of_column n
+      largest_cell = largest_cell_in_column(n)
+      if largest_cell.is_a? Hash
+        largest_cell[:value].length# - 2
+      else
+        largest_cell.to_s.length
+      end
+    end
+    
+    ##
+    # Return total number of columns available.
+     
+    def number_of_columns
+      return rows.first.length unless rows.empty?
+      raise Error, 'your table needs some rows.'
+    end
+    
+    ##
+    # Align column +n+ to +alignment+ of :center, :left, or :right.
+    
+    def align_column n, alignment
+      column(n).each_with_index do |col, i|
+        @rows[i][n] = {:value => col, :alignment => alignment} unless col.is_a? Hash
+      end
+    end
+    
+    ##
+    # Return headings combined with rows.
+    
+    def headings_with_rows
+      [headings] + rows
+    end
+    
+    ##
+    # Check if +other+ is equal to self. +other+ is considered equal
+    # if it contains the same headings and rows.
+
+    def == other
+      if other.respond_to?(:headings) && other.respond_to?(:rows)
+        headings == other.headings && rows == other.rows
+      end
+    end
+  end
+end

data/lib/terminal-table/table_helper.rb

@@ -0,0 +1,53 @@
+module Terminal
+  class Table
+    module TableHelper
+      ##
+      # Generates a Terminal::Table object.
+      #
+      # === Examples:
+      #    
+      #    puts table(['a', 'b'], [1, 2], [3, 4])
+      #    
+      #    # OR
+      #
+      #    t = table ['a', 'b']
+      #    t << [1, 2]
+      #    t << [3, 4]
+      #    puts t
+      #    
+      #    # OR
+      #
+      #    user_table = table do |t|
+      #      t.headings = 'First Name', 'Last Name', 'Email'
+      #      t << ['TJ',  'Holowaychuk', 'tj@vision-media.ca']
+      #      t << ['Bob', 'Someone',     'bob@vision-media.ca']
+      #      t << ['Joe', 'Whatever',    'joe@vision-media.ca']
+      #    end
+      #    puts user_table
+      #    
+      #    # OR
+      #
+      #    user_table = table do
+      #      self.headings = 'First Name', 'Last Name', 'Email'
+      #      add_row ['TJ',  'Holowaychuk', 'tj@vision-media.ca']
+      #      add_row ['Bob', 'Someone',     'bob@vision-media.ca']
+      #      add_row ['Joe', 'Whatever',    'joe@vision-media.ca']
+      #    end
+      #    puts user_table
+      #
+      #   # OR
+      #
+      #   rows = []
+      #   rows << ['Lines',      100]
+      #   rows << ['Comments',   20]
+      #   rows << ['Ruby',       70]
+      #   rows << ['JavaScript', 30]
+      #   puts table(nil, *rows)
+      #
+      
+      def table headings = [], *rows, &block
+        Terminal::Table.new :headings => headings.to_a, :rows => rows, &block
+      end
+    end
+  end
+end

data/lib/terminal-table/version.rb

@@ -0,0 +1,6 @@
+
+module Terminal
+  class Table
+    VERSION = '1.2.0'
+  end
+end

data/spec/cell_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe Terminal::Table do
+  
+  Cell = Terminal::Table::Cell
+  
+  it "should default alignment to the left" do
+    cell = Cell.new 0, 'foo'
+    cell.value.should == 'foo'
+    cell.alignment.should == :left
+  end
+
+  it "should override alignment" do
+    cell = Cell.new 0, {:value => 'foo', :alignment => :center}
+    cell.value.should == 'foo'
+    cell.alignment.should == :center
+  end
+  
+end

data/spec/core_ext_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe String do
+  
+  describe "#align" do
+    it "should center" do
+      'foo'.align(:center, 10).should == '   foo    '
+    end
+    
+    it "should align left" do
+      'foo'.align(:left, 10).should == 'foo       '
+    end
+  
+    it "should align right" do
+      'foo'.align(:right, 10).should == '       foo'
+    end
+  end
+  
+end

data/spec/import_spec.rb

@@ -0,0 +1,11 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+require "terminal-table/import"
+
+describe Object do
+  describe "#table" do
+    it "should allow creation of a terminal table" do
+      table(['foo', 'bar'], ['a', 'b'], [1, 2]).
+      should be_instance_of(Terminal::Table)
+    end
+  end
+end

data/spec/spec.opts

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

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+
+require File.expand_path(File.dirname(__FILE__) + "/../lib/terminal-table")
+
+class String
+  def deindent
+    gsub /^ */, ''
+  end
+end

data/spec/table_helper_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+module Terminal
+  describe Table::TableHelper do
+    before do
+      @obj = Class.new do
+        include Table::TableHelper
+      end.new
+    end
+
+    describe "#table" do
+      it "should allow creation of a terminal table" do
+        table = @obj.table(['foo', 'bar'], ['a', 'b'], [1, 2])
+        table.should be_instance_of(Terminal::Table)
+      end
+    end
+  end
+end

data/spec/table_spec.rb

@@ -0,0 +1,296 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+module Terminal
+  describe Table do
+    before :each do
+      @table = Table.new
+    end
+    
+    it "should select columns" do
+      @table << ['foo', 'bar']
+      @table << ['big foo', 'big foo bar']
+      @table.column(1).should == ['bar', 'big foo bar']
+    end
+
+    it "should count columns" do
+      @table << [1, 2, 3]
+      @table.number_of_columns.should == 3
+    end
+
+    it "should iterate columns" do
+      @table << [1, 2, 3]
+      @table << [4, 5, 6]
+      @table.columns.should == [[1, 4], [2, 5], [3, 6]]
+    end
+
+    it "should select columns" do
+      @table.headings = ['one', 'two']
+      @table << ['foo', 'bar']
+      @table << ['big foo', 'big foo bar']
+      @table.column(1).should == ['bar', 'big foo bar']
+    end
+
+    it "should select columns when using hashes" do
+      @table.headings = ['one', 'two']
+      @table.rows = [[{ :value => 'a', :align => :left }, 1], ['b', 2], ['c', 3]]
+      @table.column(0).should == [{ :value => 'a', :align => :left }, 'b', 'c']
+    end
+
+    it "should select largest cell in a column" do
+      @table << ['foo', 'bar']
+      @table << ['big foo', 'big foo bar']
+      @table.largest_cell_in_column(1).should == 'big foo bar'
+    end
+
+    it "should find column length" do
+      @table << ['foo', 'bar', 'a']
+      @table << ['big foo', 'big foo bar']
+      @table.length_of_column(1).should == 11
+    end
+
+    it "should find column length with headings" do
+      @table.headings = ['one', 'super long heading']
+      @table << ['foo', 'bar', 'a']
+      @table << ['big foo', 'big foo bar']
+      @table.length_of_column(1).should == 18
+    end
+
+    it "should render seperators" do
+      @table.headings = ['Char', 'Num']
+      @table << ['a', 1]
+      @table.seperator.should == '+------+-----+'
+    end
+
+    it "should bitch and complain when you have no rows" do
+      lambda { @table.render }.should raise_error(Terminal::Table::Error)
+    end
+
+    it "should render properly" do
+      @table.headings = ['Char', 'Num']
+      @table << ['a', 1]
+      @table << ['b', 2]
+      @table << ['c', 3]
+      @table.render.should == <<-EOF.deindent
+        +------+-----+
+        | Char | Num |
+        +------+-----+
+        | a    | 1   |
+        | b    | 2   |
+        | c    | 3   |
+        +------+-----+
+      EOF
+    end
+
+    it "should render properly without headings" do
+      @table << ['a', 1]
+      @table << ['b', 2]
+      @table << ['c', 3]
+      @table.render.should == <<-EOF.deindent
+        +---+---+
+        | a | 1 |
+        | b | 2 |
+        | c | 3 |
+        +---+---+
+      EOF
+    end
+
+    it "should render properly using block syntax" do
+      table = Terminal::Table.new do |t|
+        t << ['a', 1]
+        t << ['b', 2]
+        t << ['c', 3]
+      end
+      table.render.should == <<-EOF.deindent
+        +---+---+
+        | a | 1 |
+        | b | 2 |
+        | c | 3 |
+        +---+---+
+      EOF
+    end
+
+    it "should render properly using instance_eval block syntax" do
+      table = Terminal::Table.new do
+        add_row ['a', 1]
+        add_row ['b', 2]
+        add_row ['c', 3]
+      end
+      table.render.should == <<-EOF.deindent
+        +---+---+
+        | a | 1 |
+        | b | 2 |
+        | c | 3 |
+        +---+---+
+      EOF
+    end
+
+    it "should allows a hash of options for creation" do
+      headings = ['Char', 'Num']
+      rows = [['a', 1], ['b', 2], ['c', 3]]
+      Terminal::Table.new(:rows => rows, :headings => headings).render.should == <<-EOF.deindent
+        +------+-----+
+        | Char | Num |
+        +------+-----+
+        | a    | 1   |
+        | b    | 2   |
+        | c    | 3   |
+        +------+-----+
+      EOF
+    end
+
+    it "should flex for large cells" do
+      @table.headings = ['Just some characters', 'Num']
+      @table.rows = [['a', 1], ['b', 2], ['c', 3]]
+      @table.render.should == <<-EOF.deindent
+        +----------------------+-----+
+        | Just some characters | Num |
+        +----------------------+-----+
+        | a                    | 1   |
+        | b                    | 2   |
+        | c                    | 3   |
+        +----------------------+-----+
+      EOF
+    end
+
+    it "should allow alignment of headings and cells" do
+      @table.headings = ['Characters', {:value => 'Nums', :alignment => :right} ]
+      @table << [{:value => 'a', :alignment => :center}, 1]
+      @table << ['b', 222222222222222]
+      @table << ['c', 3]
+      @table.render.should == <<-EOF.deindent
+        +------------+-----------------+
+        | Characters |            Nums |
+        +------------+-----------------+
+        |     a      | 1               |
+        | b          | 222222222222222 |
+        | c          | 3               |
+        +------------+-----------------+
+      EOF
+
+    end
+
+    it "should align columns, but allow specifics to remain" do
+      @table.headings = ['Just some characters', 'Num']
+      @table.rows = [[{:value => 'a', :alignment => :left}, 1], ['b', 2], ['c', 3]]
+      @table.align_column 0, :center
+      @table.align_column 1, :right
+      @table.render.should == <<-EOF.deindent
+        +----------------------+-----+
+        | Just some characters | Num |
+        +----------------------+-----+
+        | a                    |   1 |
+        |          b           |   2 |
+        |          c           |   3 |
+        +----------------------+-----+
+      EOF
+    end
+
+    describe "#==" do
+      it "should be equal to itself" do
+        t = Table.new
+        t.should == t
+      end
+
+      it "should be equal with two empty tables" do
+        table_one = Table.new
+        table_two = Table.new
+
+        table_one.should == table_two
+        table_two.should == table_one
+      end
+
+      it "should not be equal with different headings" do
+        table_one = Table.new
+        table_two = Table.new
+
+        table_one.headings << "a"
+
+        table_one.should_not == table_two
+        table_two.should_not == table_one
+      end
+
+      it "should not be equal with different rows" do
+        table_one = Table.new
+        table_two = Table.new
+
+        table_one.rows << "a"
+
+        table_one.should_not == table_two
+        table_two.should_not == table_one
+      end
+
+      it "should not be equal if the other object does not respond_to? :headings" do
+        table_one = Table.new
+        table_two = Object.new
+        table_two.stub!(:rows).and_return([])
+        table_one.should_not == table_two
+      end
+
+      it "should not be equal if the other object does not respond_to? :rows" do
+        table_one = Table.new
+        table_two = Object.new
+        table_two.stub!(:rows).and_return([])
+        table_one.should_not == table_two
+      end
+    end
+
+    it "should handle colspan inside heading" do
+      @table.headings = ['one', { :value => 'two', :alignment => :center, :colspan => 2}]
+      @table.rows = [['a', 1, 2], ['b', 3, 4], ['c', 3, 4]]
+      @table.render.should == <<-EOF.deindent
+        +-----+-----+---+
+        | one |   two   |
+        +-----+-----+---+
+        | a   | 1   | 2 |
+        | b   | 3   | 4 |
+        | c   | 3   | 4 |
+        +-----+-----+---+
+      EOF
+    end
+
+    it "should handle colspan inside cells" do
+      @table.headings = ['one', 'two', 'three']
+      @table.rows = [['a', 1, 2], ['b', 3, 4], ['c', {:value => "joined", :colspan => 2,:alignment => :center}]]
+      @table.render.should == <<-EOF.deindent
+        +-----+--------+-------+
+        | one | two    | three |
+        +-----+--------+-------+
+        | a   | 1      | 2     |
+        | b   | 3      | 4     |
+        | c   |     joined     |
+        +-----+--------+-------+
+      EOF
+    end
+
+
+    it "should handle colspan 1" do
+      @table.headings = ['name', { :value => 'values', :colspan => 1}]
+      @table.rows = [['a', 1], ['b', 4], ['c', 7]]
+      @table.render.should == <<-EOF.deindent
+        +------+--------+
+        | name | values |
+        +------+--------+
+        | a    | 1      |
+        | b    | 4      |
+        | c    | 7      |
+        +------+--------+
+      EOF
+    end
+
+    it "should handle big colspan" do
+      @table.headings = ['name', { :value => 'values', :alignment => :right, :colspan => 3}]
+      @table.headings = ['name', { :value => 'values', :colspan => 3}]
+      @table.rows = [['a', 1, 2, 3], ['b', 4, 5, 6], ['c', 7, 8, 9]]
+      
+      @table.render.should == <<-EOF.deindent
+        +------+--------+---+---+
+        | name | values         |
+        +------+--------+---+---+
+        | a    | 1      | 2 | 3 |
+        | b    | 4      | 5 | 6 |
+        | c    | 7      | 8 | 9 |
+        +------+--------+---+---+
+      EOF
+    end
+  end
+end

data/tasks/docs.rake

@@ -0,0 +1,13 @@
+
+namespace :docs do
+  
+  desc 'Remove rdoc products'
+  task :remove => [:clobber_docs]
+  
+  desc 'Build docs, and open in browser for viewing (specify BROWSER)'
+  task :open => [:docs] do
+    browser = ENV["BROWSER"] || "safari"
+    sh "open -a #{browser} doc/index.html"
+  end
+  
+end

data/tasks/gemspec.rake

@@ -0,0 +1,3 @@
+
+desc 'Build gemspec file'
+task :gemspec => [:build_gemspec]

data/tasks/spec.rake

@@ -0,0 +1,25 @@
+
+require 'spec/rake/spectask'
+  
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << "lib"
+  t.spec_opts = ["--color", "--require", "spec/spec_helper.rb"]
+end
+  
+namespace :spec do
+
+  desc "Run all specifications verbosely"
+  Spec::Rake::SpecTask.new(:verbose) do |t|
+    t.libs << "lib"
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+  desc "Run specific specification verbosely (specify SPEC)"
+  Spec::Rake::SpecTask.new(:select) do |t|
+    t.libs << "lib"
+    t.spec_files = [ENV["SPEC"]]
+    t.spec_opts = ["--color", "--format", "specdoc", "--require", "spec/spec_helper.rb"]
+  end
+  
+end

data/terminal-table.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{terminal-table}
+  s.version = "1.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-10-10}
+  s.description = %q{Simple, feature rich ascii table generation library}
+  s.email = %q{tj@vision-media.ca}
+  s.extra_rdoc_files = ["lib/terminal-table/cell.rb", "lib/terminal-table/core_ext.rb", "lib/terminal-table/heading.rb", "lib/terminal-table/import.rb", "lib/terminal-table/table.rb", "lib/terminal-table/table_helper.rb", "lib/terminal-table/version.rb", "lib/terminal-table.rb", "README.rdoc", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["examples/examples.rb", "History.rdoc", "lib/terminal-table/cell.rb", "lib/terminal-table/core_ext.rb", "lib/terminal-table/heading.rb", "lib/terminal-table/import.rb", "lib/terminal-table/table.rb", "lib/terminal-table/table_helper.rb", "lib/terminal-table/version.rb", "lib/terminal-table.rb", "Manifest", "Rakefile", "README.rdoc", "spec/cell_spec.rb", "spec/core_ext_spec.rb", "spec/import_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "spec/table_helper_spec.rb", "spec/table_spec.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake", "terminal-table.gemspec", "Todo.rdoc"]
+  s.homepage = %q{http://github.com/visionmedia/terminal-table}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Terminal-table", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{terminal-table}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Simple, feature rich ascii table generation library}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: terminal-table
+version: !ruby/object:Gem::Version 
+  version: 1.2.0
+platform: ruby
+authors: 
+- TJ Holowaychuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-10 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Simple, feature rich ascii table generation library
+email: tj@vision-media.ca
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/terminal-table/cell.rb
+- lib/terminal-table/core_ext.rb
+- lib/terminal-table/heading.rb
+- lib/terminal-table/import.rb
+- lib/terminal-table/table.rb
+- lib/terminal-table/table_helper.rb
+- lib/terminal-table/version.rb
+- lib/terminal-table.rb
+- README.rdoc
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+files: 
+- examples/examples.rb
+- History.rdoc
+- lib/terminal-table/cell.rb
+- lib/terminal-table/core_ext.rb
+- lib/terminal-table/heading.rb
+- lib/terminal-table/import.rb
+- lib/terminal-table/table.rb
+- lib/terminal-table/table_helper.rb
+- lib/terminal-table/version.rb
+- lib/terminal-table.rb
+- Manifest
+- Rakefile
+- README.rdoc
+- spec/cell_spec.rb
+- spec/core_ext_spec.rb
+- spec/import_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/table_helper_spec.rb
+- spec/table_spec.rb
+- tasks/docs.rake
+- tasks/gemspec.rake
+- tasks/spec.rake
+- terminal-table.gemspec
+- Todo.rdoc
+has_rdoc: true
+homepage: http://github.com/visionmedia/terminal-table
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Terminal-table
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: terminal-table
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Simple, feature rich ascii table generation library
+test_files: []
+