tablestakes 0.8.3 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e42269b7b60a12332a7934b8511db2fc5c60cb59
-  data.tar.gz: d77bdc6de2bc013ba696eef36876e20e46b1d718
+  metadata.gz: 2c4827f9fe7583ab475c276cb8930937e51e7c42
+  data.tar.gz: f27a3196f816a096c8d311e3288d4ab3126005dd
 SHA512:
-  metadata.gz: 947e1aa780b245619afbba79907e1c7a16b135b93c519e596c9649874f2e689c8d6b8f30bd184b248a17ecfe8e7ed57ee10a120261e01a611fbf17c78f4c67b1
-  data.tar.gz: 54b58e9bfcaa18f8848a58d0c3fbc98d837e96c098a6633145b899f107ac744415584a41fcbc8ea3732d334d4801da5d09f37742fc9a10728d66c51dd31a4c20
+  metadata.gz: f3539e569ca9534174250d0f0a697443e3bbc2e8fa3baf19d6d4ea4787f06504b4150b8bdaf0145daf33d1ce77e5b34b0e1b4de25c312852a0b4d22e94e88206
+  data.tar.gz: 6513f7ef2d5ef1dbb3a696b57dae6915ce018f0a6d274b4b1572cd51192df67fd0e92e5cea0e3519339a8e97dccce068207a448d2402283d1f8890af69328990

data/README.md

@@ -7,7 +7,7 @@ Tablestakes
 Tablestakes is a gem for processing tabular data.  It is for people who would rather not meddle with
 a spreadsheet, or load their data into a SQL database.  You get the instant gratification of being
 able to read a tab-delimited file, with header values, and then do field counts, field modifications, 
-selections, joins, and sorts to your heart's content. Tablestakes operates only in memory, so it
+selections, joins to your heart's content. Tablestakes operates only in memory, so it
 is fast.  Of course that also means that there are some size limitations -- very large tables
 should be processed with another library.
 
@@ -25,8 +25,6 @@ Contents
 How to Install
 --------------
 
-Tablestakes also does well in the IRB interactive shell, you can make use of:
-
 1.  Install the gem
 
     ```shell
@@ -45,14 +43,13 @@ Now you're ready to start slicing and dicing your data tables!
 Philosophy and Conventions
 --------------------------
 
-Tablestakes is meant to be fast and easy for manipulating your data. It maintains ruby
-conventions, like use of Enumerators, method chaining, and mostly non-destructive methods.
+Tablestakes is meant to be fast and easy for manipulating your data. It maintains Ruby
+conventions, like method chaining and mostly non-destructive methods.
 
 Tablestakes tables also maintain some conventions for simplicity:
 
 * Table column names are always the values in the first row of your data file.
-* Fields in the table are always strings (although you can treat them as numbers or dates
-when needed).
+* Fields in the table are always strings (conversion to numbers or dates is a potential enhancement).
 * Methods only modify one dimension at a time.  So, for instance, `Table#select` only selects
 columns and `Table#where` only selects rows. Chain them together for the desired effect.
 * Tables are ordered, both columns and rows, until modified.
@@ -216,3 +213,13 @@ file.
 Some methods, such as `Table#row` and `Table#column` return Arrays, and of course these are
 readily modified using their own native methods.
 
+Future Enhancements
+-------------------
+
+Some future enhancements that would make this gem better include:
+
+1.  Implement Ruby Enumerators
+
+2.  Include some concept of data type ... at least FixedNum and Date. 
+
+3.  `Table#sort` method -- probably requires enumerators and data types to be effective.

data/lib/tablestakes.rb

@@ -67,6 +67,54 @@ class Table
     Array(get_row(index))
   end
   
+  # Add a column to the Table. Returns nil if the column name is already taken 
+  # or there are not the correct number of values.
+  #
+  # +colname+:: +String+ to identify the name of the column
+  # +column_vals+:: +Array+ to hold the column values
+  def add_column(colname, column_vals)
+    # check arguments
+    return nil if @table.has_key?(colname)
+    return nil unless column_vals.length == @table[@headers.first].length
+
+    @headers << colname
+    @table[colname] = Array.new(column_vals)
+  end
+
+  # Add a row to the Table, appending it to the end. Returns nil if 
+  # there are not the correct number of values.
+  #
+  # +row_vals+:: +Array+ to hold the row values
+  def add_row(row_vals)
+    add_rows([row_vals])
+  end
+
+  # Delete a column from the Table. Returns nil if the column name does not exist. 
+  #
+  # +colname+:: +String+ to identify the name of the column
+  def del_column(colname)
+    # check arguments
+    return nil unless @table.has_key?(colname)
+    
+    @headers.delete(colname)
+    @table.delete(colname)
+  end
+
+  # Delete a row from the Table. Returns nil if 
+  # the row number is not found.
+  #
+  # +rownum+:: +FixNum+ to hold the row number
+  def del_row(rownum)
+    # check arguments
+    return nil unless rownum <= @table[@headers.first].length
+
+    @headers.each do |col|
+      @table[col].delete_at(rownum)
+    end
+
+  end
+
+
   # Converts a +Table+ object to a tab-delimited string.
   # 
   # none
@@ -139,7 +187,7 @@ class Table
   # +num+:: OPTIONAL +String+ number of values to return
   def top(colname, num=1)
     freq = tally(colname).to_a[1..-1].sort_by {|k,v| v }.reverse
-    return Table.new(freq[0..num-1].unshift(["State","Count"]))
+    return Table.new(freq[0..num-1].unshift([colname,"Count"]))
   end
 
 
@@ -151,7 +199,7 @@ class Table
   # +num+:: OPTIONAL +String+ number of values to return
   def bottom(colname, num=1)
     freq = tally(colname).to_a[1..-1].sort_by {|k,v| v }
-    return Table.new(freq[0..num-1].unshift(["State","Count"]))
+    return Table.new(freq[0..num-1].unshift([colname,"Count"]))
   end
 
 
@@ -216,7 +264,7 @@ class Table
     result << @headers
     @table[colname].each_index do |index|
       if condition
-        eval("'#{@table[colname][index]}' #{condition}") ? result << get_row(index) : nil
+        eval(%q["#{@table[colname][index]}"] << "#{condition}") ? result << get_row(index) : nil
       else
         result << get_row(index)
       end
@@ -343,7 +391,9 @@ class Table
     @headers.each {|col| @table.store(col, []) }
     file.each_line do |line|    
       fields = line.chomp.split("\t")
-      if fields.length != @headers.length
+      if fields.length < @headers.length
+        (@headers.length - fields.length).times { fields << "" } 
+      elsif fields.length > @headers.length
         $stderr.write "INVALID NUMBER OF FIELDS: #{fields.join(';')}\n"
       else    
         @headers.each { |col|  @table[col] << fields.shift }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tablestakes
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.8.4
 platform: ruby
 authors:
 - J.B. Folkerts