goodsheet 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 176ca490a132450e22497d73f364833ab25d20b2
+  data.tar.gz: adae5acdbcd029f8568633694f9461735978b4ab
+SHA512:
+  metadata.gz: f94f54370420e381699a918c4ac19fab8842296a5c1dbfde3851f7906ef5d760f22f528525feef61a4ade1eec51eeb16399cf0fd0a2a2aac7a9ef2dfc4fd0d2d
+  data.tar.gz: 404ce30742bf7d5745b45e37515f8fc6a74f4a4f44a394ca3466166f806552dfc60e1e36f650918f13a8a053f12d3bf5a5b271e8cef93327fb6c7bf64721db14

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+lib/goodsheet/spreadsheet_v1.rb
+notex.txt

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in goodsheet.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Iwan Buetti
+
+MIT License
+
+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/README.md

@@ -0,0 +1,64 @@
+# Goodsheet
+
+Read and validate the content of a spreadsheet.
+The gem take advantage of wonderful validation methods available in Rails ActiveModel library and the methods of Roo gem to read and validate a spreadsheet.
+Refer to the [official guide](http://guides.rubyonrails.org/active_record_validations.html) for the validation rules.
+Thanks to [Roo gem](https://github.com/Empact/roo) Goodsheet can handle OpenOffice, LibreOffice, Excel (both '.xls' and '.xlsx') and Google spreadsheets.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'goodsheet'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install goodsheet
+
+## Usage
+
+### Getting started
+
+```ruby
+ss = Goodsheet::Spreadsheet.new("my_data.xlsx")
+res = ss.read do
+  column_names :a => 0, :b => 1
+  validates :a, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 10 }
+  validates :b, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 100 }
+end
+
+res.valid? # => true
+res.values # => {:a => [1.0, 1.0, 1.4], :b => []}
+```
+
+By default:
+* the first sheet is selected
+* one line (the first) is skipped (i'm expeting that is the header line)
+
+Pass your validation rules into the block passed to the read method, together with the column_names method that define the position (or index) and the name of the columns you want to read.
+
+### Advanced usage
+
+to do
+
+
+
+Warning:
+* integer numbers are converted to float numbers. Also don't pretend to obtain an integer in validation. This undesired behaviour depend on Roo gem
+* if you import data from a CSV spreadsheet keep in mind that numbers are readed as strings
+
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/goodsheet.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'goodsheet/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "goodsheet"
+  spec.version       = Goodsheet::VERSION
+  spec.authors       = ["Iwan Buetti"]
+  spec.email         = ["iwan.buetti@gmail.com"]
+  spec.description   = "Little gem that take advantage of Roo gem and Rails ActiveModel validation methods to read and validate the content of a spreadsheet"
+  spec.summary       = "Extract and validate data from a spreadsheet"
+  spec.homepage      = "https://github.com/iwan/goodsheet"
+  spec.license       = "MIT"
+  spec.date          = '2013-07-19'
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", ">= 1.3.5"
+  # spec.add_development_dependency "bundler", "~> 1.4"
+  spec.add_development_dependency "rake"
+
+  spec.add_dependency('roo', '>= 1.12.1') # https://github.com/Empact/roo
+  spec.add_dependency('activemodel', '>= 3.2.14')
+  spec.add_dependency('google_drive')
+end

data/lib/goodsheet/exceptions.rb

@@ -0,0 +1,5 @@
+module Goodsheet
+  
+  class SheetNotFoundError < StandardError; end
+
+end

data/lib/goodsheet/read_result.rb

@@ -0,0 +1,28 @@
+module Goodsheet
+  
+  class ReadResult
+    attr_reader :values
+
+    def initialize(errors=ValidationErrors.new)
+      @errors = errors
+      @values = {}
+    end
+
+    def valid?
+      @errors.empty?
+    end
+
+    def invalid?
+      !valid?
+    end
+
+    def add(attribute, row, force_nil=nil)
+      attribute = attribute.to_sym
+      (@values[attribute] ||= []) << (row.send(attribute) || force_nil)
+    end
+
+    def errors
+      @errors.array
+    end
+  end
+end

data/lib/goodsheet/row.rb

@@ -0,0 +1,76 @@
+require 'active_model'
+
+module Goodsheet
+  
+  class Row
+    include ActiveModel::Validations
+    include ActiveModel::Conversion
+    extend ActiveModel::Naming
+
+    class << self
+      attr_accessor :keys
+    end
+    @keys = {} # idx => key
+
+    def initialize(arr)
+      arr.each_with_index do |v, idx|
+        if k = self.class.keys[idx]
+          send("#{k}=", v)       
+        end
+      end
+      super()
+    end
+
+    def self.inherit(block)
+      c = Class.new(self) do
+        @keys = {} # idx => key
+      end
+      c.class_eval(&block)
+      c
+    end
+
+    # Define the position (or index) and the name of columns.
+    # There are available three mode to define them:
+    # using an hash index to name (like { 0 => :year, 2 => :day }) 
+    # or name to index (like { :year => 0, :day => 2 }) or using an array
+    # with the names at desired positions (like [:year, nil, :day]), put a nil
+    # at the position 
+    # The positions are 0-based.
+    def self.column_names(param)
+      @keys = {}
+      if param.is_a? Hash
+        if param.first[0].is_a? Integer
+          param.each do |idx, name|
+            self.keys[idx] = name
+            attr_accessor name
+          end
+        else
+          param.each do |name, idx|
+            self.keys[idx] = name
+            attr_accessor name
+          end
+        end
+      elsif param.is_a? Array
+        param.each_with_index do |name, idx|
+          if name
+            self.keys[idx] = name
+            attr_accessor name        
+          end
+        end
+
+      else
+        raise "parameter non valid"
+      end
+    end
+
+
+    def persisted?
+      false
+    end
+
+    # Get the list of attributes (the columns to import)
+    def self.row_attributes
+      @keys.values
+    end
+  end
+end

data/lib/goodsheet/spreadsheet.rb

@@ -0,0 +1,130 @@
+require 'roo'
+
+module Goodsheet
+
+  class Spreadsheet < Roo::Spreadsheet
+    attr_reader :time_zone, :skip, :header_row, :max_errors, :row_limit
+
+    # Valid options:
+    #    :skip       : number of rows to skip (default: 1)
+    #    :header_row : header's row index (0 based, default: 0)
+    #    :time_zone  : time zone string
+    def initialize(filename, options={})
+      set_options(options)
+      @filename = filename
+      @ss = Roo::Spreadsheet.open(filename, options)
+    end
+    
+
+    # idx can be a number or a string
+    def sheet(idx, options={})
+      set_options(options)
+      @ss.sheet(idx)
+      check_sheet_exists
+    end
+
+    def sheets
+      @ss.sheets
+    end
+
+
+    def get_header
+      @ss.row(@header_row+1) # because roo in 1-based
+    end
+
+    # Get the currently selected sheet's name
+    def name
+      @ss.default_sheet
+    end
+
+    def total_rows
+      @ss.parse.size
+    end
+
+    def rows_wo_header
+      @ss.parse.size - @skip
+    end
+    alias :rows :rows_wo_header
+
+    # Valid options:
+    #    :max_errors   : The validation will be stopped if the number of errors exceed max_errors (default: 0 or don't stop)
+    #    :limit        : Max number of rows to validate (default: 0 or validate all rows)
+
+    # 
+    def validate(options={}, &block)
+      skip = options[:skip] || @skip
+      header_row = options[:header_row] || @header_row
+      max_errors = options[:max_errors] || @max_errors
+      row_limit = options[:row_limit] || @row_limit
+
+      validation_errors = ValidationErrors.new
+
+      my_class = options[:my_custom_row_class] || build_my_class(block)
+
+      line = skip # 0-based, from the top
+      @ss.parse[skip..-1].each do |row| # row is an array of elements
+        validation_errors.add(line, my_class.new(row))
+        break if max_errors>0 && validation_errors.size >= max_errors
+        break if row_limit && row_limit>0 && line>=(row_limit+skip-1)
+        line +=1
+      end
+      validation_errors
+    end
+
+
+    # Columns must be an hash: labe for values and the column index like {:price => 5}
+    def read(options={}, &block)
+      skip = options[:skip] || @skip
+      header_row = options[:header_row] || @header_row
+      max_errors = options[:max_errors] || @max_errors
+      row_limit = options[:row_limit] || @row_limit
+      force_nil = options[:force_nil]
+
+      my_class = build_my_class(block)
+      options[:my_custom_row_class] = my_class
+      read_result = ReadResult.new(validate(options){ block })
+      return read_result if read_result.invalid?
+        
+      line = skip # 0-based, from the top
+      @ss.parse[skip..-1].each do |row| # row is an array of elements
+        my_class.row_attributes.each do |attribute|
+          read_result.add(attribute, my_class.new(row), force_nil)
+        end
+        break if row_limit && row_limit>0 && line>=(row_limit + skip - 1)
+        line +=1
+      end
+      read_result
+    end   
+
+
+    private
+
+    def build_my_class(block)
+      Object.const_set get_custom_row_class_name, Row.inherit(block)
+    end
+
+    def check_sheet_exists
+      begin
+        @ss.cell(1,1)
+      rescue ArgumentError => e
+        raise Goodsheet::SheetNotFoundError
+      rescue RangeError => e
+        raise Goodsheet::SheetNotFoundError
+      end
+    end
+
+    def get_custom_row_class_name
+      "CustRow_#{(Time.now.to_f*(10**10)).to_i}"
+    end
+
+    def set_options(options)
+      @time_zone = options.delete(:zone) || "Rome"
+      @skip = options.delete(:skip) || 1
+      @header_row = options.delete(:header_row) || 0
+      @max_errors = options.delete(:max_errors) || 0
+      @row_limit = options.delete(:row_limit) || 0      
+    end
+  end
+end
+
+

data/lib/goodsheet/validation_error.rb

@@ -0,0 +1,13 @@
+module Goodsheet
+
+  class ValidationError
+    def initialize(line, val_err)
+      @line = line
+      @val_err = val_err
+    end
+    
+    def to_s
+      "line #{@line} is invalid for the following reason(s): #{@val_err.full_messages.join(', ')}"
+    end
+  end
+end

data/lib/goodsheet/validation_errors.rb

@@ -0,0 +1,26 @@
+module Goodsheet
+
+  class ValidationErrors
+    attr_reader :array
+
+    def initialize
+      @array = []
+    end
+
+    def add(line_number, row)
+      @array << ValidationError.new(line_number+1, row.errors) if row.invalid?
+    end
+
+    def empty?
+      @array.empty?
+    end
+
+    def size
+      @array.size
+    end
+
+    def to_s
+      @array.to_s
+    end
+  end
+end

data/lib/goodsheet/version.rb

@@ -0,0 +1,3 @@
+module Goodsheet
+  VERSION = "0.2.1"
+end

data/lib/goodsheet.rb

@@ -0,0 +1,12 @@
+require "goodsheet/version"
+
+module Goodsheet
+  autoload :Row,                'goodsheet/row'
+  autoload :SheetNotFoundError, 'goodsheet/exceptions'
+  autoload :ReadResult,         'goodsheet/read_result'
+  autoload :Row,                'goodsheet/row'
+  autoload :Spreadsheet,        'goodsheet/spreadsheet'
+  autoload :ValidationError,    'goodsheet/validation_error'
+  autoload :ValidationErrors,   'goodsheet/validation_errors'
+  autoload :Version,            'goodsheet/version'
+end

data/notes.txt

@@ -0,0 +1,68 @@
+
+Usage:
+
+ss = Goodsheet::Spreadsheet.new("data.xls")
+ss.sheet(0) # selecting the first sheet
+result = ss.read(:skip => 1) do
+  column_at 0, :year, :presence => true, :numericality => { :only_integer => false, :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2100 }
+end
+result.values # => { :year => [2012, 2012, 2012, 2013] }
+
+# when the validation fails:
+ss.sheet(1) # selecting the second sheet
+result = ss.read(:skip => 1) do
+  column_at 0, :year, :presence => true, :numericality => { :only_integer => false, :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2100 }
+end
+
+result.values # => {}
+result.valid? # => false
+result.errors # => return an array of ValidationError objects
+
+# --------------------
+
+ss = Goodsheet::Spreadsheet.new("data.xls")
+ss.sheets # => ["Sheet1", "Sheet2"]
+ss.sheet(0) # selecting the first sheet
+ss.name # => "Sheet1"
+ss.sheet("Sheet1") # alternative way to select a sheet (by name)
+ss.sheet("Sheet1", :header_row => 1) # you can specify the row index (0-based) used for header
+
+
+Validation
+
+
+class MyRow < Row
+  attr_accessor :year
+  validates :year, :presence => true, :numericality => { :only_integer => false, :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2100 }
+end
+
+The validation method will return an array of validation errors:
+validation_errors = ss.validate do |row|
+  MyRow.new(:year => row[0])
+end
+
+You can limit the validation errors using :max_errors option:
+ss.validate(:max_errors => 100) do |row|
+  # ...
+end
+
+or limit the numbers of rows to read:
+ss.validate(:limit => 50) do |row|
+  # ...
+end
+
+
+Reading 
+
+The read method allow to validate and put the content in an hash:
+values = @ss.read do |row|
+  MyRow.new(:year => row[0])
+end
+
+# => 
+
+The :force_nil option allow to force empties cells to a value, and the :skip to skip a desired number of rows:
+values = @ss.read(:force_nil => 0.0, :skip => 6) do |row|
+  MyRow.new(:year => row[0])
+end
+

data/test/fixtures/ss_02.csv

@@ -0,0 +1 @@
+year,month,day,wday,1 or 2 or 3,value

data/test/test_row.rb

@@ -0,0 +1,23 @@
+require 'test/unit'
+require 'goodsheet'
+
+class TestRow < Test::Unit::TestCase
+
+  def test_column_names
+    assert_raise RuntimeError do
+      Goodsheet::Row.column_names(6)
+    end
+
+    Goodsheet::Row.column_names([:a, nil, :b, :c])
+    assert_equal(Goodsheet::Row.keys, {0 => :a, 2 => :b, 3 => :c})
+
+    Goodsheet::Row.column_names(:a => 0, :b => 2, :c => 3)
+    assert_equal(Goodsheet::Row.keys, {0 => :a, 2 => :b, 3 => :c})
+
+
+    Goodsheet::Row.column_names(0 => :a, 2 => :b, 3 => :c)
+    assert_equal(Goodsheet::Row.keys, {0 => :a, 2 => :b, 3 => :c})
+  end
+
+
+end

data/test/test_spreadsheet_01.rb

@@ -0,0 +1,150 @@
+require 'test/unit'
+require 'goodsheet'
+
+class TestSpreadsheet_01 < Test::Unit::TestCase
+
+  def setup
+    filepath = File.dirname(__FILE__) + "/fixtures/ss_01.xls"
+    @ss = Goodsheet::Spreadsheet.new(filepath)
+  end
+
+  def test_sheets
+    assert_equal(%w(Sheet1 Sheet2 Sheet3 Sheet4), @ss.sheets)
+  end
+
+  def test_failed_sheet_selection
+    assert_raise Goodsheet::SheetNotFoundError do
+      @ss.sheet(4)
+    end
+    assert_raise Goodsheet::SheetNotFoundError do
+      @ss.sheet("Sheet999")
+    end
+  end
+
+  def test_sheet_selection_and_name
+    # by default the first sheet will be selected
+    assert_equal("Sheet1", @ss.name)    
+
+    @ss.sheet(0)
+    assert_equal("Sheet1", @ss.name)    
+
+    @ss.sheet(1)
+    assert_equal("Sheet2", @ss.name)    
+
+    @ss.sheet(2)
+    assert_equal("Sheet3", @ss.name)    
+
+    @ss.sheet(3)
+    assert_equal("Sheet4", @ss.name)    
+  end
+
+  def test_get_header_wo_options
+    @ss.sheet(0)
+    assert_equal(%w(A B C D), @ss.get_header)
+  end
+
+  def test_get_header_w_options
+    @ss.sheet("Sheet3", :header_row => 1)
+    assert_equal(%w(K J), @ss.get_header)    
+  end
+
+  def test_rows
+    assert_equal(5, @ss.total_rows)
+    assert_equal(4, @ss.rows)
+
+    @ss.sheet(0, :skip => 0)
+    assert_equal(5, @ss.total_rows)
+    assert_equal(5, @ss.rows)
+
+    @ss.sheet(0, :skip => 1)
+    assert_equal(5, @ss.total_rows)
+    assert_equal(4, @ss.rows)
+  end
+
+  def test_validate_no_errors
+    validation_errors = @ss.validate do
+      column_names :year => 0
+      validates :year, :presence => true, :numericality => { :only_integer => false, :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2100 }
+    end
+    assert(validation_errors.empty?)
+  end
+
+
+  def test_validate_four_errors
+    @ss.sheet(1)
+    validation_errors = @ss.validate do
+      column_names 0 => :a1, 1 => :a2, 2 => :sum, 3 => :str
+      validates :a1, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :a2, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :sum, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :str, :presence => true, :inclusion => { :in => %w(A B D) }
+    end
+    assert_equal(4, validation_errors.size) 
+
+
+    # limit the validation errors to 2
+    validation_errors = @ss.validate(:max_errors => 2) do
+      column_names 0 => :a1, 1 => :a2, 2 => :sum, 3 => :str
+      validates :a1, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :a2, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :sum, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :str, :presence => true, :inclusion => { :in => %w(A B D) }
+    end
+    assert_equal(2, validation_errors.size) 
+
+
+    # read only 3 rows
+    validation_errors = @ss.validate(:max_errors => 0, :row_limit => 3) do
+      column_names 0 => :a1, 1 => :a2, 2 => :sum, 3 => :str
+      validates :a1, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :a2, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :sum, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 6.0 }
+      validates :str, :presence => true, :inclusion => { :in => %w(A B D) }
+    end
+    assert_equal(3, validation_errors.size) 
+  end
+
+
+  def test_read_sheet4
+    @ss.sheet(3)
+
+    result = @ss.read(:row_limit => 5) do
+      column_names 0 => :qty, 1 => :price, 2 => :tot
+      validates :qty, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :price, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :tot, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0 }      
+    end
+    assert_equal(3, result.values.size)
+    result.values.each do |k, vv|
+      assert_equal(5, vv.size)
+    end
+    assert_equal([:qty, :price, :tot], result.values.keys)
+
+
+
+    result = @ss.read(:force_nil => 0.0) do
+      column_names 0 => :qty, 1 => :price, 2 => :tot
+      validates :qty, :allow_nil => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :price, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :tot, :allow_nil => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+    end
+    assert_equal(3, result.values.size)
+    result.values.each do |k, vv|
+      assert_equal(6, vv.size)
+    end
+
+    result = @ss.read(:force_nil => 0.0, :skip => 6) do
+      column_names 0 => :qty, 1 => :price, 2 => :tot
+      validates :qty, :allow_nil => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :price, :presence => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+      validates :tot, :allow_nil => true, :numericality => { :greater_than_or_equal_to => 0.0 }
+    end
+    assert_equal(3, result.values.size)
+    result.values.each do |k, vv|
+      assert_equal(1, vv.size)
+    end
+
+
+  end
+
+end

data/test/test_spreadsheet_02.rb

@@ -0,0 +1,111 @@
+require 'test/unit'
+require 'goodsheet'
+
+class TestSpreadsheet_02 < Test::Unit::TestCase
+
+  def get_filepath(filename)
+    File.dirname(__FILE__) + "/fixtures/#{filename}"
+  end
+
+  def test_xls_validation
+    validate(get_filepath("ss_02.xls"))
+  end
+
+  def test_xls_reading
+    read(get_filepath("ss_02.xls"))
+  end
+
+  def test_xlsx_validation
+    validate(get_filepath("ss_02.xlsx"))
+  end
+
+  def test_xlsx_reading
+    read(get_filepath("ss_02.xlsx"))
+  end
+
+  # in CSV files all numbers are converted to strings, so the validation will not pass...
+  # def test_csv_validation
+  #   validate(get_filepath("ss_02.csv"))
+  # end
+
+  # def test_csv_reading
+  #   read(get_filepath("ss_02.csv"))
+  # end
+
+  # parsing of '.ods' file is very slow for "large" files  (a spredsheet with 366 lines take 65'' to be parsing on my computer...)
+  # def test_ods_validation
+  #   validate(get_filepath("ss_02.ods"))
+  # end
+
+  # parsing of '.ods' file is very slow for "large" files  (a spredsheet with 366 lines take 65'' to be parsing on my computer...)
+  # def test_ods_reading
+  #   read(get_filepath("ss_02.ods"))
+  # end
+
+  # def test_google_ss_validation
+  #   validate("0Ao3aUE9UFTaPdHBsYVhpU1FCaEVKMndkN1AzOVFYUUE")
+  # end
+
+  # def test_google_ss_reading
+  #   read("0Ao3aUE9UFTaPdHBsYVhpU1FCaEVKMndkN1AzOVFYUUE")
+  # end
+
+
+  def validate(filepath)
+    ss = Goodsheet::Spreadsheet.new(filepath)
+    ss.sheet(0)
+    errors = ss.validate(:skip => 1) do
+      column_names 0 => :year, 1 => :month, 2 => :day, 3 => :wday, 4 => :num, 5 => :v
+      validates :year, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2020 }
+      validates :month, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 1, :less_than_or_equal_to => 12 }
+      validates :day, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 1, :less_than_or_equal_to => 31 }
+      validates :wday, inclusion: { in:  %w(Mon Tue Wed Thu Fri Sat Sun) }
+      validates :num, inclusion: { in:  [1, 2, 3] }
+      validates :v, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 100.0 }
+    end
+
+    assert_equal(0, errors.size)  
+  end
+
+  def read(filepath)
+    ss = Goodsheet::Spreadsheet.new(filepath)
+    ss.sheet(0)
+    result = ss.read(:skip => 1) do
+      column_names 0 => :year, 1 => :month, 2 => :day, 3 => :wday, 4 => :num, 5 => :v
+      validates :year, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 2000, :less_than_or_equal_to => 2020 }
+      validates :month, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 1, :less_than_or_equal_to => 12 }
+      validates :day, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 1, :less_than_or_equal_to => 31 }
+      validates :wday, inclusion: { in:  %w(Mon Tue Wed Thu Fri Sat Sun) }
+      validates :num, inclusion: { in:  [1, 2, 3] }
+      validates :v, :allow_nil => false, :numericality => { :greater_than_or_equal_to => 0.0, :less_than_or_equal_to => 100.0 }
+    end
+
+    assert_equal(0, result.errors.size) 
+    assert_equal(6, result.values.size)
+    result.values.each do |k, v|
+      assert_equal(365, v.size)
+    end
+
+    result.values[:year].each do |y|
+      assert_equal(2013, y) # y is 2013.0
+    end
+    result.values[:month].each do |v|
+      assert(v.between?(1,12))
+    end
+    result.values[:day].each do |v|
+      assert(v.between?(1,31))
+    end
+    wdays = %w(Mon Tue Wed Thu Fri Sat Sun)
+    result.values[:wday].each do |v|
+      assert wdays.include? v
+    end
+    result.values[:num].each do |v|
+      assert [1,2,3].include? v
+    end
+    result.values[:v].each do |v|
+      assert(v.between?(0, 100.0))
+    end
+  end
+
+
+end

data/test/test_spreadsheet_03.rb

@@ -0,0 +1,9 @@
+# test_spreadsheet_01.rb
+
+require 'test/unit'
+require 'goodsheet'
+
+class TestSpreadsheet_03 < Test::Unit::TestCase
+
+
+end

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: goodsheet
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Iwan Buetti
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: roo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.12.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.12.1
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.14
+- !ruby/object:Gem::Dependency
+  name: google_drive
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Little gem that take advantage of Roo gem and Rails ActiveModel validation
+  methods to read and validate the content of a spreadsheet
+email:
+- iwan.buetti@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- goodsheet.gemspec
+- lib/goodsheet.rb
+- lib/goodsheet/exceptions.rb
+- lib/goodsheet/read_result.rb
+- lib/goodsheet/row.rb
+- lib/goodsheet/spreadsheet.rb
+- lib/goodsheet/validation_error.rb
+- lib/goodsheet/validation_errors.rb
+- lib/goodsheet/version.rb
+- notes.txt
+- test/fixtures/fixtures_template.xlsx
+- test/fixtures/ss_01.xls
+- test/fixtures/ss_02.csv
+- test/fixtures/ss_02.ods
+- test/fixtures/ss_02.xls
+- test/fixtures/ss_02.xlsx
+- test/fixtures/ss_04.xlsx
+- test/test_row.rb
+- test/test_spreadsheet_01.rb
+- test/test_spreadsheet_02.rb
+- test/test_spreadsheet_03.rb
+homepage: https://github.com/iwan/goodsheet
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Extract and validate data from a spreadsheet
+test_files:
+- test/fixtures/fixtures_template.xlsx
+- test/fixtures/ss_01.xls
+- test/fixtures/ss_02.csv
+- test/fixtures/ss_02.ods
+- test/fixtures/ss_02.xls
+- test/fixtures/ss_02.xlsx
+- test/fixtures/ss_04.xlsx
+- test/test_row.rb
+- test/test_spreadsheet_01.rb
+- test/test_spreadsheet_02.rb
+- test/test_spreadsheet_03.rb
+has_rdoc: