tabular 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a72f7305b34731c1fb2e479cfbb0a13039dfd840
-  data.tar.gz: 11cca1a77c8687abbe9f026edee0422239ff2937
+  metadata.gz: d85c0fe883103fa87b589ba84cfdd385ce914133
+  data.tar.gz: 38277554d2f6a15b6a2b937b4dac167306b58bad
 SHA512:
-  metadata.gz: 298c71843ce790a2f6db8ff682c6fed2665b598234e0703384805f40beb2273193dd280b90e979287635d61ce7e2c95b305fc4842ed1b9befbfc13da5ddbbc7e
-  data.tar.gz: c522ca24515089828157fffc266450d7b45fd5993f8439ee1df67d60e7e7706b5c51b837956652edbaddb7397313262f236456cab97a4eb7e24f83069638107e
+  metadata.gz: b8551d9980fbd71a1a720c39405d3f3ed93bb34d1fb3b2a963efafb6196f73c8179bbaa064460a57176583ca831c1dfcbf389ae172ee9bda62a829bb1e6a7a2d
+  data.tar.gz: 6ad55481d57a25b1f4d502bd96488d2fbd7e136423ec86ff1877b0c13dc75307afa48d4b9ddfbd4b01583c207e39d28252d417727b16ac4d7c0a06cda1f452bc

data/lib/tabular/column_mapper.rb

@@ -0,0 +1,26 @@
+module Tabular
+  class ColumnMapper
+    include Tabular::Blank
+
+    # Convert +key+ to normalized symbol. Subclass for more complex mapping.
+    def map(key)
+      return nil if is_blank?(key)
+      symbolize key
+    end
+
+    def symbolize(key)
+      begin
+        key.to_s.strip.gsub(/::/, '/').
+          gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+          gsub(/([a-z\d])([A-Z])/,'\1_\2').
+          tr("-", "_").
+          gsub(/ +/, "_").
+          gsub(";", "").
+          downcase.
+          to_sym
+      rescue
+        nil
+      end
+    end
+  end
+end

data/lib/tabular/tables/file_reading.rb

@@ -0,0 +1,92 @@
+module Tabular
+  module Tables
+    module FileReading
+      # +file+ : file path as String or File
+      # Assumes .txt = tab-delimited, .csv = CSV, .xls = Excel. Assumes first row is the header.
+      # Normalizes column names to lower-case with underscores.
+      # +format+ : :csv, :txt, or :xls
+      # Returns Array of Arrays
+      def read(file, format = nil)
+        file_path = to_file_path(file)
+        format ||= format_from(format, file_path)
+
+        self.rows = case format
+        when :xls, :xlsx
+          read_spreadsheet file_path, format
+        when :txt
+          read_txt file_path
+        when :csv
+          read_csv file_path
+        else
+          raise "Cannot read '#{format}' format. Expected :xls, :xlsx, :txt, or :csv"
+        end
+      end
+
+      def format_from(as_option, file_path)
+        if as_option
+          as_option
+        else
+          case File.extname(file_path)
+          when ".xls"
+            :xls
+          when ".xlsx"
+            :xlsx
+          when ".txt"
+            :txt
+          when ".csv"
+            :csv
+          end
+        end
+      end
+
+      def to_file_path(file)
+        file_path = case file
+        when File
+           file.path
+        else
+          file
+        end
+
+        raise "Could not find '#{file_path}'" unless File.exists?(file_path)
+
+        file_path
+      end
+
+      def read_spreadsheet(file_path, format)
+        require "roo"
+
+        if format == :xls
+          excel = ::Roo::Excel.new(file_path)
+        else
+          excel = ::Roo::Excelx.new(file_path)
+        end
+
+        # Row#to_a coerces Excel data to Strings, but we want Dates and Numbers
+        data = []
+        excel.sheet(0).each do |excel_row|
+          data << excel_row.inject([]) { |row, cell| row << cell; row }
+        end
+        data
+      end
+
+      def read_txt(file_path)
+        require "csv"
+        if RUBY_VERSION < "1.9"
+          ::CSV.open file_path, "r", "\t"
+        else
+          CSV.read file_path, col_sep: "\t"
+        end
+      end
+
+      def read_csv(file_path)
+        if RUBY_VERSION < "1.9"
+          require "fastercsv"
+          FasterCSV.read file_path
+        else
+          require "csv"
+          CSV.read file_path
+        end
+      end
+    end
+  end
+end

data/lib/tabular/version.rb

@@ -1,3 +1,3 @@
 module Tabular
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

data/tabular.gemspec

@@ -19,16 +19,18 @@ Gem::Specification.new do |s|
     "LICENSE",
     "README",
     "Rakefile",
+    "lib/tabular/tables/file_reading.rb",
     "lib/tabular.rb",
     "lib/tabular/blank.rb",
     "lib/tabular/column.rb",
+    "lib/tabular/column_mapper.rb",
     "lib/tabular/columns.rb",
     "lib/tabular/keys.rb",
     "lib/tabular/renderer.rb",
     "lib/tabular/row.rb",
     "lib/tabular/table.rb",
-    "lib/tabular/zero.rb",
     "lib/tabular/version.rb",
+    "lib/tabular/zero.rb",
     "tabular.gemspec"
   ]
   s.homepage = "http://github.com/scottwillson/tabular"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tabular
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Scott Willson
@@ -41,11 +41,13 @@ files:
 - lib/tabular.rb
 - lib/tabular/blank.rb
 - lib/tabular/column.rb
+- lib/tabular/column_mapper.rb
 - lib/tabular/columns.rb
 - lib/tabular/keys.rb
 - lib/tabular/renderer.rb
 - lib/tabular/row.rb
 - lib/tabular/table.rb
+- lib/tabular/tables/file_reading.rb
 - lib/tabular/version.rb
 - lib/tabular/zero.rb
 - tabular.gemspec