tabulate 0.1.0

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 / 2011-04-24
+
+* 1 major enhancement
+  * Birthday!

data/README.md

@@ -0,0 +1,53 @@
+tabulate
+===========
+
+Create fancy command line tables with ease.
+
+Builtin styles: 
+
+"simple", "plain", "fancy", "sqlite", "plain2", "plain\_alt", "legacy". 
+
+PLEASE BE AWARE this is my first gem :) .
+
+Features
+--------
+
+* Builtin styles
+* Colored data input support
+* Double width east Asian character support with ruby 1.9
+
+Examples
+--------
+
+    source = [["\e[31maht\e[m",3],[4,"\e[33msomething\e[m"],['s',['abc','de']]]
+    labels = ["a",'b']
+    puts tabulate(labels, source, :indent => 4, :style => 'legacy')
+
+will produce a table like the following, with "aht" colored in red and
+"something" in yellow.
+
+    +-----+-----------+
+    | a   | b         |
+    +=====+===========+
+    | aht | 3         |
+    | 4   | something |
+    | s   | abc       |
+    |     | de        |
+    +-----+-----------+
+
+Requirements
+------------
+
+Nil.
+East Asian character support requires ruby 1.9 and above.
+
+Install
+-------
+
+    gem install tabulate
+
+License
+-------
+
+MIT
+

data/Rakefile

@@ -0,0 +1,17 @@
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  name     'tabulate'
+  authors  'Roy Zuo (aka roylez)'
+  email    'roylzuo AT gmail DOT com'
+  url      'http://tabulate.rubygems.org'
+}
+

data/bin/tabulate

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib tabulate]))
+
+# Put your code here
+

data/lib/tabulate.rb

@@ -0,0 +1,157 @@
+#!/usr/bin/env ruby
+# coding: utf-8
+# author: Roy Zuo ( roylzuo AT gmail DOT com )
+
+$template = { 
+    "simple" => { 
+        :rs => '', :fs => ' | ',  :cross => '+',
+        :lframe => '', :rframe => '' ,
+        :hlframe => "\e[1;2m", :hrframe => "\e[m" ,
+        :padding => 0,
+    },
+    "legacy" => {
+        :rs => '', :fs => '|', :cross => '+',
+        :lframe => '|', :rframe => '|',
+        :hlframe => "|", :hrframe => "|",
+        :tframe => "-", :bframe => "-",
+        :hs => "=", :padding => 1,
+    },
+    'plain' => {
+        :rs => '', :fs => ' ', :cross => '+',
+        :lframe => '', :rframe => '',
+        :hlframe => "", :hrframe => "",
+        :padding => 0, 
+    },
+    'sqlite' => {
+        :rs => '', :fs => '  ', :cross => '  ',
+        :lframe => '', :rframe => '',
+        :hlframe => "", :hrframe => "",
+        :padding => 0, :hs => '-'
+    },
+    'plain2' => {
+        :rs => '', :fs => ':', :cross => '+',
+        :lframe => '', :rframe => '',
+        :hlframe => "", :hrframe => "",
+        :hs => "-", :padding => 1,
+    },
+    'plain_alt' => {
+        :rs => '', :fs => ' ', :cross => '+',
+        :lframe => '', :rframe => '',
+        :hlframe => "", :hrframe => "",
+        :hs => "-", :padding => 1,
+    },
+    'fancy' => {
+        :rs => '', :fs => '|', :cross => '+',
+        :lframe => '', :rframe => '',
+        :hlframe => "\e[1;7m", :hrframe => "\e[m",
+        :padding => 1,
+    },
+}
+            
+# tabulate arrays, styles can be simple/legacy
+# data may come in in a format like
+#   +labels+    table heading, an array
+#   +data+      an array of data to be tabulated, one element for one row
+#   +opts+      optional arguments, :indent => 0, :style => 'fancy'
+# 
+# return a String
+#
+#   [   [a, b, c],  [d, e, [f, g]] .... ]
+#   [ a, b, c] will be used as a single row
+#   and [d, e,[f,g]] will be used as two rows
+def tabulate(labels, data, opts = { } )
+    raise 'Label and data do not have equal columns!' unless labels.size == data.transpose.size
+
+    opts = { :indent => 0, :style => 'fancy'}.merge opts
+    indent = opts[:indent]
+    style = opts[:style]
+    raise "Invalid table style!"    unless  $template.keys.include? style
+
+    data = data.inject([]){|rs, r| rs += r.to_rows }
+    data = data.unshift(labels).transpose
+    padding = $template[style][:padding] 
+    data = data.collect {|c| 
+        c.collect {|e|  ' ' * padding + e.to_s + ' ' * padding } 
+    }
+    widths = data.collect {|c| c.collect {|a| a.width}.max } 
+    newdata = []
+    data.each_with_index {|c,i|
+        newdata << c.collect { |e| e + ' '*(widths[i] - e.width) }
+    }
+    data = newdata
+    data = data.transpose
+    data = [ $template[style][:hlframe] + data[0].join($template[style][:fs]) + $template[style][:hrframe] ] + \
+        data[1..-1].collect {|l| $template[style][:lframe] + l.join($template[style][:fs]) + $template[style][:rframe] }
+    lines = []
+
+    #add top frame
+    if !$template[style][:tframe].to_s.empty?
+        lines << $template[style][:cross] + widths.collect{|n| $template[style][:tframe] *n }.join($template[style][:cross]) + $template[style][:cross]
+    end
+
+    #add title 
+    lines << data[0]
+
+    #add title ruler
+    if !$template[style][:hs].to_s.empty? and !$template[style][:lframe].to_s.empty?
+        lines << $template[style][:cross] + widths.collect{|n| $template[style][:hs] *n }.join($template[style][:cross]) + $template[style][:cross]
+    elsif !$template[style][:hs].to_s.empty?
+        lines << widths.collect{|n| $template[style][:hs] *n }.join($template[style][:cross])
+    end
+
+    #add data
+    data[1..-2].each{ |line|
+        lines << line
+        if !$template[style][:rs].to_s.empty?
+            lines << $template[style][:cross] + widths.collect{|n| $template[style][:rs] *n }.join($template[style][:cross]) + $template[style][:cross]
+        end
+    }
+
+    #add last record and bottom frame
+    lines << data[-1]
+    if !$template[style][:bframe].to_s.empty?
+        lines << $template[style][:cross] + widths.collect{|n| $template[style][:bframe] *n }.join($template[style][:cross]) + $template[style][:cross]
+    end
+
+    #add indent
+    lines.collect {|l| ' '*indent + l}.join("\n")
+end
+
+class Array
+    def to_rows
+        a = collect{|i| i.is_a?(Array) ? i : [ i ]}
+        nr = a.collect{|i| i.size}.max
+        rows = []
+        0.upto( nr-1 ) {|j| rows << a.collect{|i| i[j] ? i[j] : ''} }
+        rows 
+    end
+end
+
+class String
+    if RUBY_VERSION >= '1.9'
+        def contains_cjk?               # Oniguruma regex !!!
+            (self =~ /\p{Han}|\p{Katakana}|\p{Hiragana}\p{Hangul}/)
+        end
+        def width
+            gsub(/(\e|\033|\33)\[[;0-9]*\D/,'').split(//).inject( 0 ) do |s, i|
+                s += i.contains_cjk? ? 2 : 1
+                s 
+            end
+        end
+    else
+        def width
+            gsub(/(\e|\033|\33)\[[;0-9]*\D/,'').size
+        end
+    end
+end
+
+if __FILE__ == $0
+    source = [["\e[31maht\e[m",3],[4,"\e[33msomething\e[m"],['s',['abc','de']]]
+    labels = ["a",'b']
+    puts "Available themes: #{$template.keys.inspect}"
+    $template.keys.each do |k|
+        puts "#{k} :"
+        puts tabulate(labels, source, :indent => 4, :style => k)
+        puts 
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib tabulate]))
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+end
+

data/spec/tabulate_spec.rb

@@ -0,0 +1,6 @@
+
+require File.join(File.dirname(__FILE__), %w[spec_helper])
+
+describe Tabulate do
+end
+

data/version.txt

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

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: tabulate
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Roy Zuo (aka roylez)
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-25 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bones
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 3
+        - 6
+        - 5
+        version: 3.6.5
+  type: :development
+  version_requirements: *id001
+description: Create fancy command line tables with ease.
+email: roylzuo AT gmail DOT com
+executables: 
+- tabulate
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- bin/tabulate
+files: 
+- History.txt
+- README.md
+- Rakefile
+- bin/tabulate
+- lib/tabulate.rb
+- spec/spec_helper.rb
+- spec/tabulate_spec.rb
+- test/test_tabulate.rb
+- version.txt
+homepage: http://tabulate.rubygems.org
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: tabulate
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: Create fancy command line tables with ease.
+test_files: 
+- test/test_tabulate.rb