table_display 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ba8622f69a321f9bf5642f544c08f8cec21c8173
-  data.tar.gz: 87a83652fd7ca20ed437b44bb2ce88c9235d5a94
+SHA256:
+  metadata.gz: c3013953f835a9c3948a8197eeebb9ffe9a53e8fb2ad14471a6802155205c03d
+  data.tar.gz: b569caed7b3c6b65327c6391b3fd63b68b0dd815b6068160fdfafed811fe76ed
 SHA512:
-  metadata.gz: bc1f6b943a1be7442744c1cdec0b484b10c45847391ab9e331c132bd9a242eac13f118f5bfd0b2d062e22482ed7862d68b25a70c637399a4fb610832aa7751af
-  data.tar.gz: 22de4f2301b19d812d54de2484df9f2856cc525a0c42f3943990904a93cc9ebeb1cb95f63caddc0622514b6a09a761ed80d06f7d37528aab30a0563edebe345c
+  metadata.gz: 3592665702f00ad8602e9a32a3c6e51fb8af848c302d2bd9220221cf116d315de2c3bbd705556266e3c4685055d1039f62f21a1479a2d22568aa6d1caabd0aec
+  data.tar.gz: f42df4ce0723ec6bdd8d4c18b323ca05b48c8c0579b6119edecb0117d41408ab1b856f19e5d4a7af44b3bbcb45ea74bb8c4cf71f7c156361c031f7a1553338e9

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Will Bryant, Sekuda Ltd
+Copyright (c) 2009-2018 Will Bryant, Sekuda Ltd
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,97 @@
+Table Display
+=============
+
+Adds support for displaying your ActiveRecord tables, named scopes, collections, or
+plain arrays in a table view when working in rails console, shell, or email template.
+
+`Enumerable#to_table_display` returns the printable strings; `Object#pt` calls `#to_table_display`
+on its first argument and puts out the result.
+
+Columns you haven't loaded (eg. from using `:select`) are omitted, and derived/calculated
+columns (eg. again, from using `:select`) are added.
+
+Both `#to_table_display` and `Object#pt` methods take `:only`, `:except`, and `:methods` which 
+change what attributes/methods are output, like they do on the `#to_xml` method.
+
+The normal output uses `#inspect` on the data values to make them printable, so you can
+see what type the values had.  When that's inconvenient or you'd prefer direct display,
+you can pass the option `:inspect => false` to disable inspection.
+
+
+Example
+-------
+
+You can call the `to_table_display` method:
+
+    >> puts Project.find(31).tasks.to_table_display
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+    | id | project_id | description            | due_on           | completed_at                   | created_at                     | updated_at                     |
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+    |  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | Tue Mar 24 23:17:05 +1300 2009 | Mon Mar 23 09:11:02 +1300 2009 | Tue Mar 24 23:17:05 +1300 2009 |
+    |  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                            | Mon Mar 23 09:11:46 +1300 2009 | Mon Mar 23 09:11:46 +1300 2009 |
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+
+Or equivalently, use `pt` (like `pp`, but in a table):
+
+    >> pt Customer.find(31).purchases
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+    | id | project_id | description            | due_on           | completed_at                   | created_at                     | updated_at                     |
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+    |  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | Tue Mar 24 23:17:05 +1300 2009 | Mon Mar 23 09:11:02 +1300 2009 | Tue Mar 24 23:17:05 +1300 2009 |
+    |  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                            | Mon Mar 23 09:11:46 +1300 2009 | Mon Mar 23 09:11:46 +1300 2009 |
+    +----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
+
+
+Like `to_xml`, you can pass a `:methods` option to add the output methods on your models, and you
+can pass `:only` or `:except` to (respectively) show only certain columns or show all except certain columns:
+
+    >> puts Customer.find(31).purchases.to_table_display(:only => [:id, :description], :methods => [:met_due_date?])
+    +----+------------------------+---------------+
+    | id | description            | met_due_date? |
+    +----+------------------------+---------------+
+    |  1 | "Write a handy plugin" | true          |
+    |  2 | "Blog the plugin"      | nil           |
+    +----+------------------------+---------------+
+
+`pt` accepts and passes on all options as well:
+
+    >> pt Customer.find(31).purchases, :only => [:id, :description], :methods => [:met_due_date?]
+    +----+------------------------+---------------+
+    | id | description            | met_due_date? |
+    +----+------------------------+---------------+
+    |  1 | "Write a handy plugin" | true          |
+    |  2 | "Blog the plugin"      | nil           |
+    +----+------------------------+---------------+
+
+There's a convenient equivalent syntax for displaying an ordered list of columns, like `:only` and `:methods`:
+
+    >> puts Customer.find(31).purchases.to_table_display :id, :description, :met_due_date?
+
+which provides:
+
+    >> pt Customer.find(31).purchases, :id, :description, :met_due_date?
+
+resulting in the same output as above.
+
+
+If `:inspect => false` is used, the values will be shown in `#to_s` form rather than `#inspect` form:
+
+    >> pt Customer.find(31).purchases, :only => [:id, :description, :due_on, :completed_at]
+    +----+----------------------+------------+--------------------------------+
+    | id | description          | due_on     | completed_at                   |
+    +----+----------------------+------------+--------------------------------+
+    |  1 | Write a handy plugin | 2009-03-25 | Tue Mar 24 23:17:05 +1300 2009 |
+    |  2 | Blog the plugin      | 2009-04-05 |                                |
+    +----+----------------------+------------+--------------------------------+
+
+It is possible to use objects that respond to `#call` -- such as methods or procs -- to set up columns. They will be
+passed the record as their sole argument. If these have names (as with methods), those will be used as the headers.
+Otherwise, the default `to_s` behaviour will be used.
+
+Note that in all cases, values whose class descends from `Numeric` are right-aligned, while all other values are left-aligned.
+
+Thanks
+------
+* Michael Fowler (@mkrfowler)
+
+Copyright (c) 2009-2018 Will Bryant, Sekuda Ltd, released under the MIT license

data/lib/table_display.rb

@@ -1,8 +1,8 @@
 module TableDisplay
   def to_table_display(*args)
     options = args.last.is_a?(Hash) ? args.pop : {}
-    extra_methods = args.length > 0 ? args.collect(&:to_s) : []
-    extra_methods += Array(options.delete(:methods)) if options[:methods]
+    extra_entries = args.collect { |arg| arg.respond_to?(:call) ? arg : arg.to_s }
+    extra_entries += Array(options.delete(:methods)) if options[:methods]
     only_attributes = Array(options.delete(:only)) if options[:only]
     only_attributes ||= [] if args.length > 0
     except_attributes = Array(options.delete(:except)) if options[:except]
@@ -12,7 +12,6 @@ module TableDisplay
     
     column_lengths = ActiveSupport::OrderedHash.new
     
-    data = []
     if only_attributes
       # we've been given an explicit list of attributes to display
       only_attributes.each {|attribute| column_lengths[attribute] = 0}
@@ -50,12 +49,18 @@ module TableDisplay
     end
 
     # also add any :methods given to the list
-    extra_methods.each {|name| column_lengths[name] = 0}
+    extra_entries.each {|name| column_lengths[name] = 0}
     
-    each do |record|
+    data = collect do |record|
       # add the values for all the columns in our list in order they are
-      data << column_lengths.collect do |attribute, max_width|
-        value = record.is_a?(Hash) ? record[attribute] : record.send(attribute)
+      column_lengths.collect do |attribute, max_width|
+        value = if attribute.respond_to?(:call)
+                  attribute.call(record)
+                elsif record.is_a?(Hash)
+                  record[attribute]
+                else
+                  record.send(attribute)
+                end
         string_value = display_inspect ? value.inspect : (value.is_a?(String) ? value : value.to_s)
         column_lengths[attribute] = string_value.mb_chars.length if string_value.mb_chars.length > max_width
         value.is_a?(Numeric) ? value : string_value # keep Numeric values as-is for now, so we can handle them specially in the output below
@@ -69,7 +74,7 @@ module TableDisplay
     heading_string   = "|"
     column_lengths.each do |attribute, max_width|
       next unless max_width > 0 # skip any columns we never actually saw
-      name = attribute.to_s
+      name = (attribute.respond_to?(:name) ? attribute.name : attribute).to_s
       
       # the column needs to fit the column header as well as the values
       if name.mb_chars.length > max_width
@@ -83,7 +88,7 @@ module TableDisplay
     rows = [separator_string, heading_string, separator_string]
     data.each do |data_row|
       data_string = "|"
-      column_lengths.each_with_index do |(attribute, max_width), index|
+      column_lengths.each_with_index do |(_attribute, max_width), index|
         next unless max_width > 0 # skip any columns we never actually saw
         value = data_row[index]
         if value.is_a?(Numeric)

data/lib/table_display/version.rb

@@ -1,3 +1,3 @@
 module TableDisplay
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/test/table_display_test.rb

@@ -21,7 +21,7 @@ end
 class Task < ActiveRecord::Base
   belongs_to :project
   
-  scope :completed, :conditions => 'completed_at IS NOT NULL'
+  scope :completed, -> { where('completed_at IS NOT NULL') }
   
   def completed?
     !completed_at.nil?
@@ -47,7 +47,7 @@ class TableDisplayTest < ActiveSupport::TestCase
   
   test "#to_table_display is available on ActiveRecord find results" do # which should be arrays, in fact
     assert_nothing_raised do
-      Task.find(:all).to_table_display
+      Task.all.to_table_display
     end
   end
   
@@ -76,36 +76,36 @@ class TableDisplayTest < ActiveSupport::TestCase
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
 | id | project_id | description            | due_on           | completed_at              | created_at                | updated_at                |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 23:17:05 +1300 | 2009-03-23 09:11:02 +1300 | 2009-03-24 23:17:05 +1300 |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-23 09:11:46 +1300 | 2009-03-23 09:11:46 +1300 |
+|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 10:17:05 +0000 | 2009-03-22 20:11:02 +0000 | 2009-03-24 10:17:05 +0000 |
+|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-22 20:11:46 +0000 | 2009-03-22 20:11:46 +0000 |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
 END
   end
   
   test "#to_table_display by default includes all the database columns in database order even when not called on a typeless array" do
-    assert_equal <<END.strip, @project.tasks.find(:all).to_table_display.join("\n")
+    assert_equal <<END.strip, @project.tasks.all.to_table_display.join("\n")
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
 | id | project_id | description            | due_on           | completed_at              | created_at                | updated_at                |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 23:17:05 +1300 | 2009-03-23 09:11:02 +1300 | 2009-03-24 23:17:05 +1300 |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-23 09:11:46 +1300 | 2009-03-23 09:11:46 +1300 |
+|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 10:17:05 +0000 | 2009-03-22 20:11:02 +0000 | 2009-03-24 10:17:05 +0000 |
+|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-22 20:11:46 +0000 | 2009-03-22 20:11:46 +0000 |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+
 END
   end
   
   test "#to_table_display leaves out any attributes not loaded" do
-    assert_equal <<END.strip, @project.tasks.find(:all, :select => "id, project_id, completed_at").to_table_display.join("\n")
+    assert_equal <<END.strip, @project.tasks.select("id, project_id, completed_at").to_table_display.join("\n")
 +----+------------+---------------------------+
 | id | project_id | completed_at              |
 +----+------------+---------------------------+
-|  1 |         31 | 2009-03-24 23:17:05 +1300 |
+|  1 |         31 | 2009-03-24 10:17:05 +0000 |
 |  2 |         31 | nil                       |
 +----+------------+---------------------------+
 END
   end
 
   test "#to_table_display also shows any attributes that are not columns on the underlying table" do
-    assert_equal <<END.strip, @project.tasks.find(:all, :joins => :project, :select => "tasks.id, project_id, projects.description AS BigProjectDescription").to_table_display.join("\n")
+    assert_equal <<END.strip, @project.tasks.joins(:project).select("tasks.id, project_id, projects.description AS BigProjectDescription").to_table_display.join("\n")
 +----+------------+-----------------------------------------------------------------------------------------------------+
 | id | project_id | BigProjectDescription                                                                               |
 +----+------------+-----------------------------------------------------------------------------------------------------+
@@ -120,8 +120,8 @@ END
 +----+------------+------------------------+------------------+---------------------------+
 | id | project_id | description            | due_on           | updated_at                |
 +----+------------+------------------------+------------------+---------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 23:17:05 +1300 |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | 2009-03-23 09:11:46 +1300 |
+|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 10:17:05 +0000 |
+|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | 2009-03-22 20:11:46 +0000 |
 +----+------------+------------------------+------------------+---------------------------+
 END
   end
@@ -183,19 +183,56 @@ END
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+------------+------------------------+
 | id | project_id | description            | due_on           | completed_at              | created_at                | updated_at                | completed? | project_name           |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+------------+------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 23:17:05 +1300 | 2009-03-23 09:11:02 +1300 | 2009-03-24 23:17:05 +1300 | true       | "table_display plugin" |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-23 09:11:46 +1300 | 2009-03-23 09:11:46 +1300 | false      | "table_display plugin" |
+|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | 2009-03-24 10:17:05 +0000 | 2009-03-22 20:11:02 +0000 | 2009-03-24 10:17:05 +0000 | true       | "table_display plugin" |
+|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                       | 2009-03-22 20:11:46 +0000 | 2009-03-22 20:11:46 +0000 | false      | "table_display plugin" |
 +----+------------+------------------------+------------------+---------------------------+---------------------------+---------------------------+------------+------------------------+
 END
   end
-  
+
+  test "#to_table_display also shows any named callables given as columns" do
+    named_callable = Object.new.tap do |object|
+      object.define_singleton_method(:name) { :sample }
+      object.define_singleton_method(:call) { |record| "(id #{record.id})" }
+    end
+
+    assert_equal <<END.strip, @project.tasks.to_table_display('id', :due_on, :completed?, named_callable).join("\n")
++----+------------------+------------+----------+
+| id | due_on           | completed? | sample   |
++----+------------------+------------+----------+
+|  1 | Wed, 25 Mar 2009 | true       | "(id 1)" |
+|  2 | Sun, 05 Apr 2009 | false      | "(id 2)" |
++----+------------------+------------+----------+
+END
+  end
+
+  test "#to_table_display shows multiple callables given as columns in the order provided" do
+    callable = Object.new.tap do |object|
+      object.define_singleton_method(:call) { |record| "(id #{record.id})" }
+      object.define_singleton_method(:to_s) { "arbitrary to_s" }
+    end
+
+    instrument = Object.new.tap { |o| o.define_singleton_method(:creation) { |record| "(#{record.created_at.to_date})" } }
+
+    due_on_proc = -> (record) { record.due_on }
+    due_on_proc.define_singleton_method(:to_s) { "due_on_proc" }
+
+    assert_equal <<END.strip, @project.tasks.to_table_display('id', due_on_proc, instrument.method(:creation), callable).join("\n")
++----+------------------+----------------+----------------+
+| id | due_on_proc      | creation       | arbitrary to_s |
++----+------------------+----------------+----------------+
+|  1 | Wed, 25 Mar 2009 | "(2009-03-22)" | "(id 1)"       |
+|  2 | Sun, 05 Apr 2009 | "(2009-03-22)" | "(id 2)"       |
++----+------------------+----------------+----------------+
+END
+  end
+
   test "#to_table_display shows the #to_s format rather than the #inspect format when :inspect => false is set" do
     assert_equal <<END.strip, @project.tasks.to_table_display(:inspect => false).join("\n")
 +----+------------+----------------------+------------+---------------------------+---------------------------+---------------------------+
 | id | project_id | description          | due_on     | completed_at              | created_at                | updated_at                |
 +----+------------+----------------------+------------+---------------------------+---------------------------+---------------------------+
-|  1 |         31 | Write a handy plugin | 2009-03-25 | 2009-03-24 23:17:05 +1300 | 2009-03-23 09:11:02 +1300 | 2009-03-24 23:17:05 +1300 |
-|  2 |         31 | Blog the plugin      | 2009-04-05 |                           | 2009-03-23 09:11:46 +1300 | 2009-03-23 09:11:46 +1300 |
+|  1 |         31 | Write a handy plugin | 2009-03-25 | 2009-03-24 10:17:05 +0000 | 2009-03-22 20:11:02 +0000 | 2009-03-24 10:17:05 +0000 |
+|  2 |         31 | Blog the plugin      | 2009-04-05 |                           | 2009-03-22 20:11:46 +0000 | 2009-03-22 20:11:46 +0000 |
 +----+------------+----------------------+------------+---------------------------+---------------------------+---------------------------+
 END
     # note the strings no longer have quotes, the nil is not shown, and the date format happens to be different

data/test/test_helper.rb

@@ -1,21 +1,12 @@
 require 'rubygems'
 require "../../../config/boot.rb" if File.exist?("../../../config/boot.rb")
 
-$KCODE = 'u' if RUBY_VERSION < '1.9' # as per railties initializer.rb: set unicode mode for Ruby 1.8 (Ruby 1.9 just works)
-
-require 'test/unit'
+require 'minitest/autorun'
 require 'active_support'
 require 'active_support/test_case'
 require 'active_record'
 require 'active_record/fixtures'
 
-begin
-  require 'ruby-debug'
-  Debugger.start
-rescue LoadError
-  # ruby-debug not installed, no debugging for you
-end
-
 ENV['RAILS_ENV'] ||= 'test'
 FileUtils.mkdir File.join(File.dirname(__FILE__), "log") rescue nil
 RAILS_DEFAULT_LOGGER = ActiveRecord::Base.logger = Logger.new(File.join(File.dirname(__FILE__), "log", "#{ENV['RAILS_ENV']}.log"))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: table_display
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Will Bryant
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-04 00:00:00.000000000 Z
+date: 2018-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -90,7 +90,7 @@ files:
 - ".gitignore"
 - Gemfile
 - MIT-LICENSE
-- README
+- README.md
 - Rakefile
 - init.rb
 - lib/table_display.rb
@@ -121,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Adds support for displaying your ActiveRecord tables, named scopes, collections,

data/README

@@ -1,82 +0,0 @@
-Table Display
-=============
-
-Adds support for displaying your ActiveRecord tables, named scopes, collections, or
-plain arrays in a table view when working in rails console, shell, or email template.
-
-Enumerable#to_table_display returns the printable strings; Object#pt calls #to_table_display on its
-first argument and puts out the result.
-
-Columns you haven't loaded (eg. from using :select) are omitted, and derived/calculated
-columns (eg. again, from using :select) are added.
-
-Both #to_table_display and Object#pt methods take :only, :except, and :methods which work like
-the #to_xml method to change what attributes/methods are output.
-
-The normal output uses #inspect on the data values to make them printable, so you can
-see what type the values had.  When that's inconvenient or you'd prefer direct display,
-you can pass the option :inspect => false to disable inspection.
-
-
-Example
-=======
-
-# You can call the to_table_display method:
->> puts Project.find(31).tasks.to_table_display
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-| id | project_id | description            | due_on           | completed_at                   | created_at                     | updated_at                     |
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | Tue Mar 24 23:17:05 +1300 2009 | Mon Mar 23 09:11:02 +1300 2009 | Tue Mar 24 23:17:05 +1300 2009 |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                            | Mon Mar 23 09:11:46 +1300 2009 | Mon Mar 23 09:11:46 +1300 2009 |
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-
-# Or equivalently, use "pt" (like pp, but in a table):
->> pt Customer.find(31).purchases
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-| id | project_id | description            | due_on           | completed_at                   | created_at                     | updated_at                     |
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-|  1 |         31 | "Write a handy plugin" | Wed, 25 Mar 2009 | Tue Mar 24 23:17:05 +1300 2009 | Mon Mar 23 09:11:02 +1300 2009 | Tue Mar 24 23:17:05 +1300 2009 |
-|  2 |         31 | "Blog the plugin"      | Sun, 05 Apr 2009 | nil                            | Mon Mar 23 09:11:46 +1300 2009 | Mon Mar 23 09:11:46 +1300 2009 |
-+----+------------+------------------------+------------------+--------------------------------+--------------------------------+--------------------------------+
-
-
-# Like to_xml, you can pass a :methods option to add the output methods on your models, and you can pass :only or :except
-# to (respectively) show only certain columns or show all except certain columns:
->> puts Customer.find(31).purchases.to_table_display(:only => [:id, :description], :methods => [:met_due_date?])
-+----+------------------------+---------------+
-| id | description            | met_due_date? |
-+----+------------------------+---------------+
-|  1 | "Write a handy plugin" | true          |
-|  2 | "Blog the plugin"      | nil           |
-+----+------------------------+---------------+
-
-# pt accepts and passes on all options as well:
->> pt Customer.find(31).purchases, :only => [:id, :description], :methods => [:met_due_date?]
-+----+------------------------+---------------+
-| id | description            | met_due_date? |
-+----+------------------------+---------------+
-|  1 | "Write a handy plugin" | true          |
-|  2 | "Blog the plugin"      | nil           |
-+----+------------------------+---------------+
-
-# There's a convenient equivalent syntax for displaying an ordered list of columns, like :only and :methods:
->> puts Customer.find(31).purchases.to_table_display :id, :description, :met_due_date?
-# which provides:
->> pt Customer.find(31).purchases, :id, :description, :met_due_date?
-# resulting in the same output as above.
-
-
-# If :inspect => false is used, the values will be shown in #to_s form rather than #inspect form:
->> pt Customer.find(31).purchases, :only => [:id, :description, :due_on, :completed_at]
-+----+----------------------+------------+--------------------------------+
-| id | description          | due_on     | completed_at                   |
-+----+----------------------+------------+--------------------------------+
-|  1 | Write a handy plugin | 2009-03-25 | Tue Mar 24 23:17:05 +1300 2009 |
-|  2 | Blog the plugin      | 2009-04-05 |                                |
-+----+----------------------+------------+--------------------------------+
-
-
-# Note that in all cases, values descending from Numeric are right-aligned, while all other values are left-aligned.
-
-
-Copyright (c) 2009 Will Bryant, Sekuda Ltd, released under the MIT license