princess 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Robert Scott Reis
+
+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, and/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/ext_string.rb

@@ -0,0 +1,13 @@
+class String
+
+  def to_excel_col
+    alphabet = ('A'..'Z').to_a
+    col = 0
+    letters = self.split(//).reverse
+    letters.each_index do |power|
+      col += (26 ** power) * (alphabet.index(letters[power]) + 1)
+    end
+    col
+  end
+
+end

data/lib/princess/excel_reader.rb

@@ -0,0 +1,34 @@
+module Princess
+  class ExcelReader
+
+    def initialize(filename)
+      @book = Spreadsheet.open(filename)
+      @sheet = @book.worksheet(0)
+    end
+
+    # load a sheet for reading
+    def active_sheet(sheet_num)
+      raise 'invalid argument' if !sheet_num.is_a?(Integer)
+      @sheet = @book.worksheet(sheet_num)
+    end
+
+    # iterate through the spreadsheet rows
+    def each
+      @sheet.each do |row|
+        yield Row.new(row.inject([]){|vals, cell|vals<<cell})
+      end
+    end
+
+    # return the specified row
+    def row(num)
+      raise 'invalid argument' if !num.is_a?(Integer)
+      Row.new(@sheet.row(num - 1).inject([]){|vals, cell|vals<<cell})
+    end
+
+    # return the specified cell content
+    def cell(coord)
+      row(coord.scan(/\d+/).first.to_i).cell(coord.scan(/\D+/).first)
+    end
+
+  end
+end

data/lib/princess/excelx_reader.rb

@@ -0,0 +1,94 @@
+module Princess
+  class ExcelxReader
+
+    def initialize(filename)
+      @filename = filename
+      active_sheet(1)
+    end
+
+    # load a sheet for reading
+    def active_sheet(sheet_num)
+      raise 'invalid argument' if !sheet_num.is_a?(Integer)
+
+      Zip::ZipFile.open(@filename) do |zipfile|
+
+        # grab shared strings
+        noko_shared_strings = Nokogiri::XML(zipfile.read('xl/sharedStrings.xml'))
+        noko_shared_strings.remove_namespaces!
+        @shared_strings = noko_shared_strings.xpath('//sst/si/t').map(&:content)
+
+        # grab spreadsheet content
+        doc = Nokogiri::XML(zipfile.read("xl/worksheets/sheet#{sheet_num}.xml"))
+        doc.remove_namespaces!
+        ref = doc.xpath('//dimension').first.attr('ref')
+        @rows = Array.new(ref.split(':').last.scan(/\d+/).first.to_i)
+        doc.xpath('//sheetData/row').each do |row|
+          row_num = row.attr('r').to_i - 1
+          @rows[row_num] = row
+        end
+
+      end
+    end
+
+    # iterate through the spreadsheet rows
+    def each
+      @rows.each do |noko_row|
+        if noko_row.nil?
+          yield nil
+        else
+          yield Row.new(extract_row_values(noko_row))
+        end
+      end
+    end
+
+    # return the specified row
+    def row(num)
+      raise 'invalid argument' if !num.is_a?(Integer)
+      return nil if @rows[num - 1].nil?
+      Row.new(extract_row_values(@rows[num - 1]))
+    end
+
+    # return the specified cell content
+    def cell(coord)
+      row(coord.scan(/\d+/).first.to_i).cell(coord.scan(/\D+/).first)
+    end
+
+    private
+
+    # turn a row into translated content in a row object
+    def extract_row_values(noko_row)
+
+      # create new array with number of columns in row
+      values = Array.new(noko_row.attr('spans').split(':').last.to_i)
+
+      # iterate through the cells with content
+      noko_row.xpath('.//c').each do |cell|
+        col = cell.attr('r').scan(/\D+/).first.to_excel_col - 1
+        values[col] = extract_cell_value(cell)
+      end
+
+      values
+    end
+
+    # turn a nokogiri cell into translated content
+    def extract_cell_value(noko_cell)
+
+      # grab cell value
+      cell_value = noko_cell.xpath('.//v').first.content
+
+      # handle string cells
+      if noko_cell.attr('t') == 's'
+        @shared_strings[cell_value.to_i]
+
+      # handle date cells
+      elsif noko_cell.attr('s') == '2'
+        Date.new(1899,12,30) + cell_value.to_i
+
+      # handle numeric cells
+      else
+        cell_value.to_f
+      end
+    end
+
+  end
+end

data/lib/princess/row.rb

@@ -0,0 +1,26 @@
+module Princess
+  class Row
+
+    attr_accessor :values
+
+    def initialize(values)
+      raise 'invalid argument' if !values.is_a?(Array)
+      @values = values
+    end
+
+    def to_s
+      @values.to_s
+    end
+
+    def cell(num)
+      if num.is_a?(String)
+        @values[num.to_excel_col - 1]
+      elsif num.is_a?(Integer)
+        @values[num]
+      else
+        raise 'invalid argument'
+      end
+    end
+
+  end
+end

data/lib/princess.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'nokogiri'
+require 'spreadsheet'
+require 'zip/zipfilesystem'
+require 'date'
+
+require File.join(File.dirname(__FILE__),'ext_string.rb')
+require File.join(File.dirname(__FILE__),'princess','excelx_reader.rb')
+require File.join(File.dirname(__FILE__),'princess','excel_reader.rb')
+require File.join(File.dirname(__FILE__),'princess','row.rb')

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: princess
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- R. Scott Reis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-04 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- lib/ext_string.rb
+- lib/princess/excelx_reader.rb
+- lib/princess/excel_reader.rb
+- lib/princess/row.rb
+- lib/princess.rb
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Princess is an Excel and Excelx spreadsheet reader
+test_files: []
+