text-table 1.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,24 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## NETBEANS
+nbproject
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Aaron Tinio
+
+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.rdoc

@@ -0,0 +1,171 @@
+= text-table
+
+A feature-rich, easy-to-use plain text table formatter.
+
+
+== Introduction
+
+Allows you to easily create and format plain text tables,
+useful when working with the terminal
+or when you want to quickly print formatted tables to a dot-matrix printer.
+
+This project was heavily inspired by visionmedia's terminal-table, and to a lesser-extent, by prawn, ruport and hirb.
+I initially wanted to add more features to terminal-table (footer, separators between rows, etc)
+and to fix a then alignment issue with spanned columns.
+Instead of forking terminal-table, I've decided to start a new project primarily as an exercise,
+and to be able to model-out the classes differently.
+
+
+== Install
+
+If you haven't yet,
+
+    gem install gemcutter
+    gem tubmle
+
+Then,
+
+    gem install text-table
+
+
+== Calling the <tt>to_text_table</tt> Method
+
+Just call the <tt>to_text_table</tt> method on Arrays (and other Enumerables).
+
+    require 'rubygems'
+    require 'text-table'
+
+    array = [
+      ['Student', 'Mid-Terms', 'Finals'],
+      ['Sam', 94, 93],
+      ['Jane', 92, 99],
+      ['Average', 93, 96]
+    ]
+
+    puts array.to_text_table
+
+    #    +---------+-----------+--------+
+    #    | Student | Mid-Terms | Finals |
+    #    | Sam     | 94        | 93     |
+    #    | Jane    | 92        | 99     |
+    #    | Average | 93        | 96     |
+    #    +---------+-----------+--------+
+
+You could specify that the first row is the table heading.
+
+    puts array.to_text_table(:first_row_is_head => true)
+
+    #    +---------+-----------+--------+
+    #    | Student | Mid-Terms | Finals |
+    #    +---------+-----------+--------+
+    #    | Sam     | 94        | 93     |
+    #    | Jane    | 92        | 99     |
+    #    | Average | 93        | 96     |
+    #    +---------+-----------+--------+
+
+You could also specify that the last row is the table footer.
+
+    puts array.to_text_table(:first_row_is_head => true, :last_row_is_foot => true)
+
+    #    +---------+-----------+--------+
+    #    | Student | Mid-Terms | Finals |
+    #    +---------+-----------+--------+
+    #    | Sam     | 94        | 93     |
+    #    | Jane    | 92        | 99     |
+    #    +---------+-----------+--------+
+    #    | Average | 93        | 96     |
+    #    +---------+-----------+--------+
+
+
+== Creating a New Text::Table Object
+
+You could create a Text::Table object by passing an options hash:
+
+    table = Text::Table.new(:head => ['A', 'B'], :rows => [['a1', 'b1'], ['a2', 'b2']])
+
+Or by passing a block:
+
+    table = Text::Table.new do |t|
+      t.head = ['A', 'B']
+      t.rows = [['a1', 'b1']]
+      t.rows << ['a2', 'b2']
+    end
+
+    table.to_s
+
+    #    +----+----+
+    #    | A  | B  |
+    #    +----+----+
+    #    | a1 | b1 |
+    #    | a2 | b2 |
+    #    +----+----+
+
+
+== Aligning Cells and Spanning Columns
+
+Alignment and column span can be specified by passing a cell as a Hash object.
+The acceptable aligments are <tt>:left</tt> (default), <tt>:center</tt> and <tt>:right</tt>.
+
+    table = Text::Table.new do |t|
+      t.head = ['Heading A', 'Heading B']
+      t.rows = []
+      t.rows << ['a1', 'b1']
+      t.rows << ['a2', {:value => 'b2', :align => :right}]
+      t.rows << ['a3', 'b3']
+      t.rows << [{:value => 'a4', :colspan => 2, :align => :center}]
+    end
+
+    puts table
+
+    #    +-----------+-----------+
+    #    | Heading A | Heading B |
+    #    +-----------+-----------+
+    #    | a1        | b1        |
+    #    | a2        |        b2 |
+    #    | a3        | b3        |
+    #    |          a4           |
+    #    +-----------+-----------+
+
+
+== Adding a Separator
+
+You can add a separator by inserting <tt>:separator</tt> symbols between the rows.
+
+    Text::Table.new :rows => [
+      ['a', 'b'],
+      ['c', 'd'],
+      :separator,
+      ['e', 'f'],
+      :separator,
+      ['g', 'h']
+    ]
+
+    #    +---+---+
+    #    | a | b |
+    #    | c | d |
+    #    +---+---+
+    #    | e | f |
+    #    +---+---+
+    #    | g | h |
+    #    +---+---+
+
+
+== Other Options
+
+Cell padding and table boundaries can be modified.
+
+    Text::Table.new :rows => [['a', 'b'], ['c', 'd']],
+                    :horizontal_padding    => 3,
+                    :vertical_boundary     => '=',
+                    :horizontal_boundary   => ':',
+                    :boundary_intersection => 'O'
+
+    #    O=======O=======O
+    #    :   a   :   b   :
+    #    :   c   :   d   :
+    #    O=======O=======O
+
+
+== Copyright
+
+Copyright (c) 2009 Aaron Tinio. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "text-table"
+    gem.summary = %Q{A feature-rich, easy-to-use plain text table formatter.}
+    gem.description = %Q{Allows you to easily create and format plain text tables, useful when working with the terminal or when you want to quickly print formatted tables to a dot-matrix printer.}
+    gem.email = "aptinio@yahoo.com"
+    gem.homepage = "http://github.com/aptinio/text-table"
+    gem.authors = ["Aaron Tinio"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "text-table #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/text-table.rb

@@ -0,0 +1,3 @@
+%w(table row cell enumerable).each do |lib|
+  require File.join(File.dirname(__FILE__), 'text-table', lib)
+end

data/lib/text-table/cell.rb

@@ -0,0 +1,51 @@
+module Text #:nodoc:
+  class Table
+    class Cell
+
+      # The object whose <tt>to_s</tt> method is called when rendering the cell.
+      #
+      attr_accessor :value
+      
+      # Text alignment.  Acceptable values are <tt>:left</tt> (default),
+      # <tt>:center</tt> and <tt>:right</tt>
+      #
+      attr_accessor :align
+
+      # Positive integer specifying the number of columns spanned
+      #
+      attr_accessor :colspan
+      attr_reader :row #:nodoc:
+
+      def initialize(options = {}) #:nodoc:
+        @value  = options[:value].to_s
+        @row     = options[:row]
+        @align   = options[:align  ] || :left
+        @colspan = options[:colspan] || 1
+      end
+
+      def to_s #:nodoc:
+      ([' ' * table.horizontal_padding]*2).join case align
+        when :left
+          value.ljust cell_width
+        when :right
+          value.rjust cell_width
+        when :center
+          value.center cell_width
+        end
+      end
+
+      def table #:nodoc:
+        row.table
+      end
+
+      def column_index #:nodoc:
+        row.cells[0...row.cells.index(self)].map(&:colspan).reduce(0, :+)
+      end
+
+      def cell_width #:nodoc:
+        colspan.times.map {|i| table.column_widths[column_index + i]}.reduce(:+) + (colspan - 1)*(2*table.horizontal_padding + table.horizontal_boundary.length)
+      end
+
+    end
+  end
+end

data/lib/text-table/enumerable.rb

@@ -0,0 +1,58 @@
+module Enumerable
+
+  # Returns a new Text::Table object with the elements as the rows.
+  #
+  # ==== Options
+  # <tt>:first_row_is_head</tt>:: when set to <tt>true</tt>, the first row becomes the table heading
+  # <tt>:last_row_is_foot</tt>:: when set to <tt>true</tt>, the last row becomes the table footer
+  #
+  # ==== Examples
+  #
+  #      require 'rubygems'
+  #      require 'text-table'
+  #
+  #      array = [
+  #        ['Student', 'Mid-Terms', 'Finals'],
+  #        ['Sam', 94, 93],
+  #        ['Jane', 92, 99],
+  #        ['Average', 93, 96]
+  #      ]
+  #
+  #      puts array.to_text_table
+  #
+  #      #    +---------+-----------+--------+
+  #      #    | Student | Mid-Terms | Finals |
+  #      #    | Sam     | 94        | 93     |
+  #      #    | Jane    | 92        | 99     |
+  #      #    | Average | 93        | 96     |
+  #      #    +---------+-----------+--------+
+  #
+  #      puts array.to_text_table(:first_row_is_head => true)
+  #
+  #      #    +---------+-----------+--------+
+  #      #    | Student | Mid-Terms | Finals |
+  #      #    +---------+-----------+--------+
+  #      #    | Sam     | 94        | 93     |
+  #      #    | Jane    | 92        | 99     |
+  #      #    | Average | 93        | 96     |
+  #      #    +---------+-----------+--------+
+  #
+  #      puts array.to_text_table(:first_row_is_head => true, :last_row_is_foot => true)
+  #
+  #      #    +---------+-----------+--------+
+  #      #    | Student | Mid-Terms | Finals |
+  #      #    +---------+-----------+--------+
+  #      #    | Sam     | 94        | 93     |
+  #      #    | Jane    | 92        | 99     |
+  #      #    +---------+-----------+--------+
+  #      #    | Average | 93        | 96     |
+  #      #    +---------+-----------+--------+
+  #
+  def to_text_table(options = {})
+    table = Text::Table.new :rows => self.to_a.dup
+    table.head = table.rows.shift if options[:first_row_is_head]
+    table.foot = table.rows.pop   if options[:last_row_is_foot]
+    table
+  end
+  alias_method :to_table, :to_text_table unless method_defined? :to_table
+end

data/lib/text-table/row.rb

@@ -0,0 +1,31 @@
+module Text #:nodoc:
+  class Table
+
+    # A Text::Table::Row belongs to a Text::Table object and can have many Text::Table::Cell objects.
+    # It handles the rendering of rows and inserted separators.
+    #
+    class Row
+      attr_reader :table #:nodoc:
+      attr_reader :cells #:nodoc:
+
+      def initialize(row_input, table) #:nodoc:
+        @table = table
+        row_input = [row_input].flatten
+        @cells = row_input.first == :separator ? :separator : row_input.map do |cell_input|
+          Cell.new(cell_input.is_a?(Hash) ? cell_input.merge(:row => self) : {:value => cell_input}.merge(:row => self))
+        end
+      end
+
+      def to_s #:nodoc:
+        if cells == :separator
+          table.separator
+        else
+          ([table.horizontal_boundary] * 2).join(
+            cells.map(&:to_s).join table.horizontal_boundary
+          ) + "\n"
+        end
+      end
+
+    end
+  end
+end

data/lib/text-table/table.rb

@@ -0,0 +1,170 @@
+module Text #:nodoc:
+  class Table
+
+    # An array of table headers
+    #
+    attr_accessor :head
+
+    # An array of arrays (rows or separators)
+    #
+    attr_accessor :rows
+
+    # An array representing the foot of the table
+
+    attr_accessor :foot
+
+    # The vertical boundary.  Default is "<tt>-</tt>"
+    #
+    attr_accessor :vertical_boundary
+
+    # The horizontal boundary.  Default is "<tt>|</tt>"
+    #
+    attr_accessor :horizontal_boundary
+
+    # The boundary intersection.  Default is "<tt>+</tt>"
+    #
+    attr_accessor :boundary_intersection
+
+    # The amount of padding (spaces) added to the left and right of cell contents.  Default is <tt>1</tt>
+    #
+    attr_accessor :horizontal_padding
+
+    #  You could create a Text::Table object by passing an options hash:
+    #
+    #      table = Text::Table.new(:head => ['A', 'B'], :rows => [['a1', 'b1'], ['a2', 'b2']])
+    #
+    #  Or by passing a block:
+    #
+    #      table = Text::Table.new do |t|
+    #        t.head = ['A', 'B']
+    #        t.rows = [['a1', 'b1']]
+    #        t.rows << ['a2', 'b2']
+    #      end
+    #
+    #      table.to_s
+    #
+    #      #    +----+----+
+    #      #    | A  | B  |
+    #      #    +----+----+
+    #      #    | a1 | b1 |
+    #      #    | a2 | b2 |
+    #      #    +----+----+
+    #
+    #
+    #  ==== Aligning Cells and Spanning Columns
+    #
+    #  Alignment and column span can be specified by passing a cell as a Hash object.
+    #  The acceptable aligments are <tt>:left</tt> (default), <tt>:center</tt> and <tt>:right</tt>.
+    #
+    #      table = Text::Table.new do |t|
+    #        t.head = ['Heading A', 'Heading B']
+    #        t.rows = []
+    #        t.rows << ['a1', 'b1']
+    #        t.rows << ['a2', {:value => 'b2', :align => :right}]
+    #        t.rows << ['a3', 'b3']
+    #        t.rows << [{:value => 'a4', :colspan => 2, :align => :center}]
+    #      end
+    #
+    #      puts table
+    #
+    #      #    +-----------+-----------+
+    #      #    | Heading A | Heading B |
+    #      #    +-----------+-----------+
+    #      #    | a1        | b1        |
+    #      #    | a2        |        b2 |
+    #      #    | a3        | b3        |
+    #      #    |          a4           |
+    #      #    +-----------+-----------+
+    #
+    #
+    #  ==== Adding a Separator
+    #
+    #  You can add a separator by inserting <tt>:separator</tt> symbols between the rows.
+    #
+    #      Text::Table.new :rows => [
+    #        ['a', 'b'],
+    #        ['c', 'd'],
+    #        :separator,
+    #        ['e', 'f'],
+    #        :separator,
+    #        ['g', 'h']
+    #      ]
+    #
+    #      #    +---+---+
+    #      #    | a | b |
+    #      #    | c | d |
+    #      #    +---+---+
+    #      #    | e | f |
+    #      #    +---+---+
+    #      #    | g | h |
+    #      #    +---+---+
+    #
+    #
+    #  ==== Other Options
+    #
+    #  Cell padding and table boundaries can be modified.
+    #
+    #      Text::Table.new :rows => [['a', 'b'], ['c', 'd']],
+    #                      :horizontal_padding    => 3,
+    #                      :vertical_boundary     => '=',
+    #                      :horizontal_boundary   => ':',
+    #                      :boundary_intersection => 'O'
+    #
+    #      #    O=======O=======O
+    #      #    :   a   :   b   :
+    #      #    :   c   :   d   :
+    #      #    O=======O=======O
+    #
+    def initialize(options = {})
+      @vertical_boundary     = options[:vertical_boundary    ] || '-'
+      @horizontal_boundary   = options[:horizontal_boundary  ] || '|'
+      @boundary_intersection = options[:boundary_intersection] || '+'
+      @horizontal_padding    = options[:horizontal_padding   ] || 1
+      @head = options[:head]
+      @rows = options[:rows]
+      @foot = options[:foot]
+      yield self if block_given?
+    end
+
+    def text_table_rows #:nodoc:
+      rows.to_a.map {|row_input| Row.new(row_input, self)}
+    end
+
+    def text_table_head #:nodoc:
+      Row.new(head, self) if head
+    end
+
+    def text_table_foot #:nodoc:
+      Row.new(foot, self) if foot
+    end
+
+    def all_text_table_rows #:nodoc:
+      all = text_table_rows
+      all.unshift text_table_head if head
+      all << text_table_foot if foot
+      all
+    end
+
+    def column_widths #:nodoc:
+      all_text_table_rows.reject {|row| row.cells == :separator}.map do |row|
+        row.cells.map {|cell| [(cell.value.length/cell.colspan.to_f).ceil] * cell.colspan}.flatten
+      end.transpose.map(&:max)
+    end
+
+    def separator #:nodoc:
+      ([@boundary_intersection] * 2).join(
+        column_widths.map {|column_width| @vertical_boundary * (column_width + 2*@horizontal_padding)}.join @boundary_intersection
+      ) + "\n"
+    end
+
+    # Renders a pretty plain-text table.
+    #
+    def to_s
+      rendered_rows = [separator] + text_table_rows.map(&:to_s) + [separator]
+      rendered_rows.unshift [separator, text_table_head.to_s] if head
+      rendered_rows << [text_table_foot.to_s, separator] if foot
+      rendered_rows.join
+    end
+
+  end
+end

data/spec/cell_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Text::Table::Cell do
+  before(:each) do
+    @table = Text::Table.new :rows => [[1, {:value => 2, :colspan => 2}, 3]]
+    @cell = @table.text_table_rows.first.cells.first
+  end
+
+  it "should be left justified by default" do
+    @cell.align.should == :left
+  end
+
+  it "should span 1 column by default" do
+    @cell.colspan == 1
+  end
+
+  it "should return correct column index" do
+    @table.text_table_rows.first.cells[0].column_index.should == 0
+    @table.text_table_rows.first.cells[1].column_index.should == 1
+    @table.text_table_rows.first.cells[2].column_index.should == 3
+  end
+
+end
+

data/spec/enumerable_spec.rb

@@ -0,0 +1,95 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Enumerable do
+  before(:each) do
+    @arr = [
+      [11, 2, 3333],
+      [44, 56, 6],
+      [7, 888, 99],
+    ]
+    @hsh = {
+      :k  => 'vv',
+      :kk =>  'v',
+      'k' =>  :vv
+    }
+  end
+
+  describe Array do
+    it "to Text::Table" do
+      @arr.to_text_table.to_s.should == <<-EOS.deindent
+        +----+-----+------+
+        | 11 | 2   | 3333 |
+        | 44 | 56  | 6    |
+        | 7  | 888 | 99   |
+        +----+-----+------+
+      EOS
+    end
+
+    it "to Text::Table using flat array" do
+      [11, 44, 7].to_text_table.to_s.should == <<-EOS.deindent
+        +----+
+        | 11 |
+        | 44 |
+        | 7  |
+        +----+
+      EOS
+    end
+
+    it "to Text::Table, setting first row as head" do
+      @arr.to_text_table(:first_row_is_head => true).to_s.should == <<-EOS.deindent
+        +----+-----+------+
+        | 11 | 2   | 3333 |
+        +----+-----+------+
+        | 44 | 56  | 6    |
+        | 7  | 888 | 99   |
+        +----+-----+------+
+      EOS
+    end
+
+    it "to Text::Table, setting last row as foot" do
+      @arr.to_text_table(:last_row_is_foot => true).to_s.should == <<-EOS.deindent
+        +----+-----+------+
+        | 11 | 2   | 3333 |
+        | 44 | 56  | 6    |
+        +----+-----+------+
+        | 7  | 888 | 99   |
+        +----+-----+------+
+      EOS
+    end
+  end
+
+  describe Hash do
+    it "to Text::Table" do
+      @hsh.to_text_table.to_s.should == <<-EOS.deindent
+        +----+----+
+        | k  | vv |
+        | kk | v  |
+        | k  | vv |
+        +----+----+
+      EOS
+    end
+
+    it "to Text::Table, setting first row as head" do
+      @hsh.to_text_table(:first_row_is_head => true).to_s.should == <<-EOS.deindent
+        +----+----+
+        | k  | vv |
+        +----+----+
+        | kk | v  |
+        | k  | vv |
+        +----+----+
+      EOS
+    end
+
+    it "to Text::Table, setting last row as foot" do
+      @hsh.to_text_table(:last_row_is_foot => true).to_s.should == <<-EOS.deindent
+      +----+----+
+      | k  | vv |
+      | kk | v  |
+      +----+----+
+      | k  | vv |
+      +----+----+
+      EOS
+    end
+  end
+end
+

data/spec/spec.opts

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

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'text-table'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end
+
+class String
+  def deindent
+    gsub /^[ \t]*/, ''
+  end
+end

data/spec/table_spec.rb

@@ -0,0 +1,349 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Text::Table do
+  before(:each) do
+    @rows = [
+      [11, 2, 3333],
+      [44, 56, 6],
+      [7, 888, 99],
+    ]
+    @head = %w( a b c )
+    @foot = %w( x y z )
+    @table = Text::Table.new :rows => @rows, :head => @head
+  end
+
+  it "should accept rows" do
+    @table = Text::Table.new :rows => @rows
+    @table.rows.should == @rows
+  end
+
+  it 'should allow setting of rows inside a block' do
+    @table = Text::Table.new do |t|
+      t.rows = @rows
+    end
+    @table.rows.should == @rows
+  end
+
+  it 'should accept rows with options' do
+    @table = Text::Table.new :rows => @rows, :horizontal_padding => 2
+    @table.rows.should == @rows
+    @table.horizontal_padding.should == 2
+  end
+
+  it 'should allow setting of options inside a block' do
+    @table = Text::Table.new do |t|
+      t.horizontal_padding = 2
+    end
+    @table.horizontal_padding.should == 2
+  end
+
+  it 'should determine the proper column widths' do
+    @table.column_widths.should == [2, 3, 4]
+  end
+
+  it 'should render tables with no headings properly' do
+    @table = Text::Table.new :rows => @rows
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with headings properly' do
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | a  | b   | c    |
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with footers properly' do
+    @table.foot = @foot
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | a  | b   | c    |
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+      | x  | y   | z    |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with centered headings properly' do
+    @table = Text::Table.new :rows => @rows, :head => [
+      {:value => 'a', :align => :center},
+      {:value => 'b', :align => :center},
+      {:value => 'c', :align => :center},
+    ]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | a  |  b  |  c   |
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with right-justified headings properly' do
+    @table = Text::Table.new :rows => @rows, :head => [
+      {:value => 'a', :align => :right},
+      {:value => 'b', :align => :right},
+      {:value => 'c', :align => :right},
+    ]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      |  a |   b |    c |
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with centered cells properly' do
+    @table = Text::Table.new :head => @head, :rows => @rows.map{|row| row.map{|cell| {:value => cell, :align => :center}}}
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | a  | b   | c    |
+      +----+-----+------+
+      | 11 |  2  | 3333 |
+      | 44 | 56  |  6   |
+      | 7  | 888 |  99  |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render tables with right-justified cells properly' do
+    @table = Text::Table.new :head => @head, :rows => @rows.map{|row| row.map{|cell| {:value => cell, :align => :right}}}
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | a  | b   | c    |
+      +----+-----+------+
+      | 11 |   2 | 3333 |
+      | 44 |  56 |    6 |
+      |  7 | 888 |   99 |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with cells spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [1, {:value => 2, :colspan => 2}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      | 1  | 2          |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with 1st cell spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 2}, 1]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      | 333      | 1    |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with cells spanning 3 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 3}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      | 333             |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with centered cells spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [1, {:value => 2, :colspan => 2, :align => :center}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      | 1  |     2      |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with 1st cell spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 2, :align => :center}, 1]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      |   333    | 1    |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with centered cells spanning 3 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 3, :align => :center}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      |       333       |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with right-justified cells spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [1, {:value => 2, :colspan => 2, :align => :right}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      | 1  |          2 |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with 1st cell spanning 2 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 2, :align => :right}, 1]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      |      333 | 1    |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render rows with right-justified cells spanning 3 columns' do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << [{:value => 333, :colspan => 3, :align => :right}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      |             333 |
+      +----+-----+------+
+    EOS
+  end
+
+  it "should allow adding of separators between rows" do
+    @table = Text::Table.new :rows => @rows
+    @table.rows << :separator
+    @table.rows << [1, 2, 3]
+    @table.rows << :separator
+    @table.rows << [{:value => 5, :colspan => 3, :align => :right}]
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +----+-----+------+
+      | 1  | 2   | 3    |
+      +----+-----+------+
+      |               5 |
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render horizontal boundaries correctly' do
+    @table.horizontal_boundary = ':'
+    @table.to_s.should == <<-EOS.deindent
+      +----+-----+------+
+      : a  : b   : c    :
+      +----+-----+------+
+      : 11 : 2   : 3333 :
+      : 44 : 56  : 6    :
+      : 7  : 888 : 99   :
+      +----+-----+------+
+    EOS
+  end
+
+  it 'should render vertical boundaries correctly' do
+    @table.vertical_boundary = '='
+    @table.to_s.should == <<-EOS.deindent
+      +====+=====+======+
+      | a  | b   | c    |
+      +====+=====+======+
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      +====+=====+======+
+    EOS
+  end
+
+  it 'should render boundary interserctions properly' do
+    @table.boundary_intersection = '*'
+    @table.to_s.should == <<-EOS.deindent
+      *----*-----*------*
+      | a  | b   | c    |
+      *----*-----*------*
+      | 11 | 2   | 3333 |
+      | 44 | 56  | 6    |
+      | 7  | 888 | 99   |
+      *----*-----*------*
+    EOS
+  end
+
+  it 'should render double horizontal boundaries properly' do
+    @table.horizontal_boundary = '||'
+    @table.boundary_intersection = '**'
+    @table.to_s.should == <<-EOS.deindent
+      **----**-----**------**
+      || a  || b   || c    ||
+      **----**-----**------**
+      || 11 || 2   || 3333 ||
+      || 44 || 56  || 6    ||
+      || 7  || 888 || 99   ||
+      **----**-----**------**
+    EOS
+  end
+
+  it 'should render double horizontal boundaries with spanned cells properly' do
+    @table.horizontal_boundary = '||'
+    @table.boundary_intersection = '**'
+    @table.rows << :separator
+    @table.rows << [{:value => 2, :colspan => 2, :align => :right}, 1]
+    @table.to_s.should == <<-EOS.deindent
+      **----**-----**------**
+      || a  || b   || c    ||
+      **----**-----**------**
+      || 11 || 2   || 3333 ||
+      || 44 || 56  || 6    ||
+      || 7  || 888 || 99   ||
+      **----**-----**------**
+      ||         2 || 1    ||
+      **----**-----**------**
+    EOS
+  end
+
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: text-table
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Aaron Tinio
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-21 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: Allows you to easily create and format plain text tables, useful when working with the terminal or when you want to quickly print formatted tables to a dot-matrix printer.
+email: aptinio@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/text-table.rb
+- lib/text-table/cell.rb
+- lib/text-table/enumerable.rb
+- lib/text-table/row.rb
+- lib/text-table/table.rb
+- spec/cell_spec.rb
+- spec/enumerable_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/table_spec.rb
+has_rdoc: true
+homepage: http://github.com/aptinio/text-table
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A feature-rich, easy-to-use plain text table formatter.
+test_files: 
+- spec/spec_helper.rb
+- spec/cell_spec.rb
+- spec/table_spec.rb
+- spec/enumerable_spec.rb