cft_smartcloud 0.2.2 → 0.3.0

data/lib/terminal-table-1.4.4/History.rdoc

@@ -0,0 +1,53 @@
+1.4.4 / 2011-11-07
+==================
+
+  * Add support for multi-line rows, table titles, and colors
+
+1.4.3 / 2011-10-13
+==================
+
+  * Optimize for faster table output.
+
+1.4.2 / 2010-01-14
+==================
+
+  * Fixed some bugs with colspan
+
+=== 1.4.1 / 2009-12-18
+
+* Fix column alignment with separators.
+
+=== 1.4.0 / 2009-12-18
+
+* Can now add :seperator arbitrarily in a table [thanks splattael]
+* Fix common typo: seperator -> separator [thanks splattael]
+
+=== 1.3.0 / 2009-10-16
+
+* Major refactoring (functionality remains the same)
+
+=== 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/lib/terminal-table-1.4.4/Manifest

@@ -0,0 +1,24 @@
+History.rdoc
+Manifest
+README.rdoc
+Rakefile
+Todo.rdoc
+examples/examples.rb
+lib/terminal-table.rb
+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
+spec/cell_spec.rb
+spec/core_ext_spec.rb
+spec/import_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/table_spec.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake
+terminal-table.gemspec

data/lib/terminal-table-1.4.4/README.rdoc

@@ -0,0 +1,240 @@
+= Terminal Table
+
+== Description
+
+Terminal Table is a fast and simple, yet feature rich ASCII table generator written in Ruby.
+
+== Installation
+
+Install http://gemcutter.org and execute:
+  
+  $ gem install terminal-table
+
+== Usage
+
+=== Basics
+
+To use Terminal Table:
+
+  require 'terminal-table'
+
+To generate a table, provide an array of arrays (which are interpreted as rows):
+
+  rows = []
+  rows << ['One', 1]
+  rows << ['Two', 2]
+  rows << ['Three', 3]
+  table = Terminal::Table.new :rows => rows
+  
+  # > puts table
+  #
+  # +-------+---+
+  # | One   | 1 |
+  # | Two   | 2 |
+  # | Three | 3 |
+  # +-------+---+
+
+
+The constructor can also be given a block which is either yielded the Table object or instance evaluated:
+
+  table = Terminal::Table.new do |t|
+    t.rows = rows
+  end
+
+  table = Terminal::Table.new do
+    self.rows = rows
+  end
+
+Adding rows one by one:
+
+  table = Terminal::Table.new do |t|
+    t << ['One', 1]
+    t.add_row ['Two', 2]
+  end
+
+To add separators between rows:
+  
+  table = Terminal::Table.new do |t|
+    t << ['One', 1]
+    t << :separator
+    t.add_row ['Two', 2]
+    t.add_separator
+    t.add_row ['Three', 3]
+  end
+  
+  # > puts table
+  #
+  # +-------+---+
+  # | One   | 1 |
+  # +-------+---+
+  # | Two   | 2 |
+  # +-------+---+
+  # | Three | 3 |
+  # +-------+---+
+
+Cells can handle multiline content:
+  
+  table = Terminal::Table.new do |t|
+    t << ['One', 1]
+    t << :separator
+    t.add_row ["Two\nDouble", 2]
+    t.add_separator
+    t.add_row ['Three', 3]
+  end
+  
+  # > puts table
+  #
+  # +--------+---+
+  # | One    | 1 |
+  # +--------+---+
+  # | Two    | 2 |
+  # | Double |   |
+  # +--------+---+
+  # | Three  | 3 |
+  # +--------+---+
+
+=== Head
+
+To add a head to the table:
+
+  table = Terminal::Table.new :headings => ['Word', 'Number'], :rows => rows
+  
+  # > puts table
+  #
+  # +-------+--------+
+  # | Word  | Number |
+  # +-------+--------+
+  # | One   | 1      |
+  # | Two   | 2      |
+  # | Three | 3      |
+  # +-------+--------+
+
+=== Title
+
+To add a title to the table:
+
+  table = Terminal::Table.new :title => "Cheatsheet", :headings => ['Word', 'Number'], :rows => rows
+  
+  # > puts table
+  #
+  # +------------+--------+
+  # |     Cheatsheet      |
+  # +------------+--------+
+  # | Word       | Number |
+  # +------------+--------+
+  # | One        | 1      |
+  # | Two        | 2      |
+  # | Three      | 3      |
+  # +------------+--------+
+
+=== Alignment
+
+To align the second column to the right:
+
+  table.align_column(1, :right)
+  
+  # > puts table
+  #
+  # +-------+--------+
+  # | Word  | Number |
+  # +-------+--------+
+  # | One   |      1 |
+  # | Two   |      2 |
+  # | Three |      3 |
+  # +-------+--------+
+
+To align an individual cell, you specify the cell value in a hash along the alignment:
+
+  table << ["Four", {:value => 4.0, :alignment => :center}]
+  
+  # > puts table
+  #
+  # +-------+--------+
+  # | Word  | Number |
+  # +-------+--------+
+  # | One   |      1 |
+  # | Two   |      2 |
+  # | Three |      3 |
+  # | Four  |  4.0   |
+  # +-------+--------+
+  
+=== Style
+
+To specifify style options:
+  
+  table = Terminal::Table.new :headings => ['Word', 'Number'], :rows => rows, :style => {:width => 80}
+  
+  # > puts table
+  #
+  # +--------------------------------------+---------------------------------------+
+  # | Word                                 | Number                                |
+  # +--------------------------------------+---------------------------------------+
+  # | One                                  | 1                                     |
+  # | Two                                  | 2                                     |
+  # | Three                                | 3                                     |
+  # +--------------------------------------+---------------------------------------+
+
+And change styles on the fly:
+  
+  table.style = {:width => 40, :padding_left => 3, :border_x => "=", :border_i => "x"}
+  
+  # > puts table
+  #
+  # x====================x=================x
+  # |               Cheatsheet             |
+  # x====================x=================x
+  # |   Word             |   Number        |
+  # x====================x=================x
+  # |   One              |   1             |
+  # |   Two              |   2             |
+  # |   Three            |   3             |
+  # x====================x=================x
+  
+To change the default style options:
+
+  Terminal::Style.defaults = {:width => 80}
+
+All Table objects created afterwards will inherit these defaults.
+
+=== Constructor options and setter methods
+
+Valid options for the constructor are :rows, :headings, :style and :title - and all options can also be set on the created table object by their setter method:
+
+  table = Terminal::Table.new
+  table.title = "Cheatsheet"
+  table.headings = ['Word', 'Number']
+  table.rows = rows
+  table.style = {:width => 40}
+
+== More examples
+
+For more examples, please see the examples/examples.rb file included in the source distribution.
+
+== Author
+
+TJ Holowaychuk <tj@vision-media.ca>
+
+== 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/lib/terminal-table-1.4.4/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/lib/terminal-table-1.4.4/Todo.rdoc

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

data/lib/terminal-table-1.4.4/examples/examples.rb

@@ -0,0 +1,80 @@
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'terminal-table/import'
+
+puts
+puts table(['a', 'b'], [1, 2], [3, 4])
+
+puts
+t = table ['a', 'b']
+t.style = {:padding_left => 2, :width => 80}
+t << [1, 2]
+t << [3, 4]
+t << :separator
+t << [4, 6]
+puts t
+
+puts
+user_table = table do |v|
+  v.title = "Contact Information"
+  v.headings = 'First Name', 'Last Name', 'Email'
+  v << %w( TJ Holowaychuk tj@vision-media.ca )
+  v << %w( Bob Someone bob@vision-media.ca )
+  v << %w( Joe Whatever bob@vision-media.ca )
+end
+puts user_table
+
+puts
+user_table = table do |v|
+  v.style.width = 80
+  v.headings = 'First Name', 'Last Name', 'Email'
+  v << %w( TJ Holowaychuk tj@vision-media.ca )
+  v << %w( Bob Someone bob@vision-media.ca )
+  v << %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']
+  add_row ['Bob', 'Someone',     'bob@vision-media.ca']
+  add_row ['Joe', 'Whatever',    'joe@vision-media.ca']
+  add_separator
+  add_row ['Total', { :value => '3', :colspan => 2, :alignment => :right }]
+  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 :separator
+  add_row ['TJ',  'Holowaychuk', {:value => "No phones\navaiable", :colspan => 2, :alignment => :center}]
+  add_row :separator
+  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)
+
+rows = []
+rows << ['Lines',      100]
+rows << ['Comments',   20]
+rows << ['Ruby',       70]
+rows << ['JavaScript', 30]
+table = table([{ :value => 'Stats', :colspan => 2, :alignment => :center }], *rows)
+table.align_column 1, :right
+puts table

data/lib/terminal-table-1.4.4/lib/terminal-table/cell.rb

@@ -0,0 +1,88 @@
+
+module Terminal
+  class Table
+    class Cell
+      
+      ##
+      # Cell width.
+      
+      attr_reader :width
+      
+      ##
+      # Cell value.
+      
+      attr_reader :value
+      
+      ##
+      # Column span.
+      
+      attr_reader :colspan
+      
+      ##
+      # Initialize with _options_.
+      
+      def initialize options = nil
+        @value, options = options, {} unless Hash === options
+        @value = options.fetch :value, value
+        @alignment = options.fetch :alignment, nil
+        @colspan = options.fetch :colspan, 1
+        @width = options.fetch :width, @value.to_s.size
+        @index = options.fetch :index
+        @table = options.fetch :table
+      end
+      
+      def alignment?
+        !@alignment.nil?
+      end
+      
+      def alignment
+        @alignment || :left
+      end
+      
+      def alignment=(val)
+        supported = %w(left center right)
+        if supported.include?(val.to_s)
+          @alignment = val
+        else
+          raise "Aligment must be one of: #{supported.join(' ')}"
+        end
+      end
+      
+      def lines
+        @value.to_s.split(/\n/)
+      end
+      
+      ##
+      # Render the cell.
+      
+      def render(line = 0)
+        left = " " * @table.style.padding_left
+        right = " " * @table.style.padding_right
+        "#{left}#{lines[line]}#{right}".align(alignment, width + @table.cell_padding)
+      end
+      alias :to_s :render
+      
+      ##
+      # Returns the longest line in the cell and
+      # removes all ANSI escape sequences (e.g. color)
+      
+      def value_for_column_width_recalc
+        str = lines.sort_by { |s| s.size }.last.to_s
+        str = str.gsub(/\x1b(\[|\(|\))[;?0-9]*[0-9A-Za-z]/, '')
+        str = str.gsub(/\x1b(\[|\(|\))[;?0-9]*[0-9A-Za-z]/, '')
+        str.gsub(/[\x03|\x1a]/, '')
+      end
+      
+      ##
+      # Returns the width of this cell
+      
+      def width
+        padding = (colspan - 1) * @table.cell_spacing
+        inner_width = (1..@colspan).to_a.inject(0) do |w, counter|
+          w + @table.column_width(@index + counter - 1)
+        end
+        inner_width + padding
+      end
+    end
+  end
+end

data/lib/terminal-table-1.4.4/lib/terminal-table/core_ext.rb

@@ -0,0 +1,8 @@
+
+class String
+  def align position, length
+    self.__send__ position, length
+  end
+  alias_method :left, :ljust
+  alias_method :right, :rjust
+end

data/lib/terminal-table-1.4.4/lib/terminal-table/import.rb

@@ -0,0 +1,4 @@
+
+require 'terminal-table'
+
+include Terminal::Table::TableHelper

data/lib/terminal-table-1.4.4/lib/terminal-table/row.rb

@@ -0,0 +1,48 @@
+module Terminal
+  class Table
+    class Row
+      
+      ##
+      # Row cells
+      
+      attr_reader :cells
+      
+      attr_reader :table
+      
+      ##
+      # Initialize with _width_ and _options_.
+      
+      def initialize table, array = []
+        @cell_index = 0
+        @table = table
+        @cells = []
+        array.each { |item| self << item }
+      end
+      
+      def add_cell item
+        options = item.is_a?(Hash) ? item : {:value => item}
+        cell = Cell.new(options.merge(:index => @cell_index, :table => @table))
+        @cell_index += cell.colspan
+        @cells << cell
+      end
+      alias << add_cell
+      
+      def [] index
+        cells[index]
+      end
+      
+      def height
+        cells.map { |c| c.lines.count }.max
+      end
+      
+      def render
+        y = @table.style.border_y
+        (0...height).to_a.map do |line|
+          y + cells.map do |cell|
+            cell.render(line)
+          end.join(y) + y
+        end.join("\n")
+      end
+    end
+  end
+end

data/lib/terminal-table-1.4.4/lib/terminal-table/separator.rb

@@ -0,0 +1,14 @@
+module Terminal
+  class Table
+    class Separator < Row
+      
+      def render
+        arr_x = (0...@table.number_of_columns).to_a.map do |i|
+          @table.style.border_x * (@table.column_width(i) + @table.cell_padding) 
+        end
+        border_i = @table.style.border_i
+        border_i + arr_x.join(border_i) + border_i
+      end
+    end
+  end
+end

data/lib/terminal-table-1.4.4/lib/terminal-table/style.rb

@@ -0,0 +1,61 @@
+
+module Terminal
+  class Table
+    # A Style object holds all the formatting information for a Table object
+    # 
+    # To create a table with a certain style, use either the constructor 
+    # option <tt>:style</tt>, the Table#style object or the Table#style= method
+    #
+    # All these examples have the same effect:
+    # 
+    #     # by constructor
+    #     @table = Table.new(:style => {:padding_left => 2, :width => 40})
+    #
+    #     # by object
+    #     @table.style.padding_left = 2
+    #     @table.style.width = 40
+    #
+    #     # by method
+    #     @table.style = {:padding_left => 2, :width => 40}
+    # 
+    # To set a default style for all tables created afterwards use Style.defaults=
+    # 
+    #     Terminal::Table::Style.defaults = {:width => 80}
+    #
+    class Style
+      @@defaults = {
+        :border_x => "-", :border_y => "|", :border_i => "+",
+        :padding_left => 1, :padding_right => 1,
+        :width => nil
+      }
+      
+      attr_accessor :border_x
+      attr_accessor :border_y
+      attr_accessor :border_i
+      
+      attr_accessor :padding_left
+      attr_accessor :padding_right
+      
+      attr_accessor :width
+      
+      
+      def initialize options = {}
+        apply self.class.defaults.merge(options)
+      end
+      
+      def apply options
+        options.each { |m, v| __send__ "#{m}=", v }
+      end
+      
+      class << self
+        def defaults
+          @@defaults
+        end
+        
+        def defaults= options
+          @@defaults = defaults.merge(options)
+        end
+      end
+    end
+  end
+end