roo 1.3.11 → 1.9.0

data/History.txt

@@ -1,3 +1,12 @@
+== 1.9.0 2009-10-29
+
+* 4 enhancements
+  * Ruby 1.9 compatible
+  * oo.aa42 as a shortcut of oo.cell('aa',42)
+  * oo.aa42('sheet1') as a shortcut of oo.cell('aa',42,'sheet1')
+  * oo.anton as a reference to a cell labelled 'anton' (or any other label name)
+    (currently only for Openoffice spreadsheets)
+
 == 1.2.3 2009-01-04
 
 * bugfix
@@ -89,8 +98,8 @@
   * some methods common to more than one class were factored out to the GenericSpreadsheet (virtual) class
 == 0.7.0 2007-11-23
 * 6 enhancements:
-  * Openoffice/Excel: the most methods can be called with an option 'sheet' 
-    parameter which will be used instead of the default sheet 
+  * Openoffice/Excel: the most methods can be called with an option 'sheet'
+    parameter which will be used instead of the default sheet
   * Excel: improved the speed of CVS output
   * Openoffice/Excel: new method #column
   * Openoffice/Excel: new method #find
@@ -118,7 +127,7 @@
 == 0.5.1 2007-08-26
 * 4 enhancements:
   * Openoffice: Exception if an illegal sheet-name is selected
-  * Openoffice/Excel: no need to set a default_sheet if there is only one in 
+  * Openoffice/Excel: no need to set a default_sheet if there is only one in
     the document
   * Excel: can now read zip-ed files
   * Excel: can now read files from http://-URL over the net
@@ -136,7 +145,7 @@
 == 0.4.0 2007-06-27
 * 7 enhancements:
   * robustness: Exception if no default_sheet was set
-  * new method reload() implemented 
+  * new method reload() implemented
   * about 15 % more method documentation
   * optimization: huge increase of speed (no need to use fixed borders anymore)
   * added the method 'formulas' which gives you all formulas in a spreadsheet
@@ -158,7 +167,7 @@
 
 == 0.2.6 2007-06-19
 * 1 bugfix:
-  * Openoffice: two or more consecutive cells with string content failed 
+  * Openoffice: two or more consecutive cells with string content failed
 
 == 0.2.5 2007-06-17
 
@@ -188,7 +197,7 @@
 
 == 0.2.2 2007-06-01
 * 1 bugfix:
-  * incorrect dependencies fixed 
+  * incorrect dependencies fixed
 
 == 0.2.0 2007-06-01
 * 1 major enhancement:

data/Manifest.txt

@@ -0,0 +1,53 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+base64include.rb
+examples/roo_soap_server.rb
+examples/roo_soap_client.rb
+examples/write_me.rb
+lib/roo.rb
+lib/roo/version.rb
+lib/roo/generic_spreadsheet.rb
+lib/roo/openoffice.rb
+lib/roo/excel.rb
+lib/roo/google.rb
+lib/roo/roo_rails_helper.rb
+scripts/txt2html
+setup.rb
+test/false_encoding.xls
+test/Bibelbund1.ods
+test/Bibelbund.ods
+test/Bibelbund.xls
+test/Bibelbund.csv
+test/bbu.xls
+test/bbu.ods
+test/no_spreadsheet_file.txt
+test/simple_spreadsheet.ods
+test/simple_spreadsheet.xls
+test/simple_spreadsheet_from_italo.ods
+test/simple_spreadsheet_from_italo.xls
+test/test_helper.rb
+test/test_roo.rb
+test/time-test.ods
+test/time-test.xls
+test/time-test.csv
+test/numbers1.csv
+test/numbers1_excel.csv
+test/numbers1.ods
+test/numbers1.xls
+test/borders.ods
+test/borders.xls
+test/formula.ods
+test/formula.xls
+test/only_one_sheet.ods
+test/only_one_sheet.xls
+test/bode-v1.xls.zip
+test/bode-v1.ods.zip
+test/ric.ods
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.rhtml

data/README.txt

@@ -0,0 +1,97 @@
+roo
+    by Thomas Preymesser
+    http://thopre.wordpress.com
+
+== DESCRIPTION:
+
+Roo can access the contents of various spreadsheet files. It can handle
+* Openoffice
+* Excel
+* Google spreadsheets
+* Excelx
+
+
+== FEATURES/PROBLEMS:
+
+You don't need to have an installation of Openoffice or Excel. All you need is
+the spreadsheet file. It's platform independent so you can read an Excel file
+under Linux without having to install the MS office suite.
+
+Roo implements read access for all spreadsheet types and read/write access for
+Google spreadsheets.
+
+
+== SYNOPSIS:
+
+  require 'rubygems'
+  require 'roo'
+
+  s = Openoffice.new("myspreadsheet.ods")      # creates an Openoffice Spreadsheet instance
+  s = Excel.new("myspreadsheet.xls")           # creates an Excel Spreadsheet instance
+  s = Google.new("myspreadsheetkey_at_google") # creates an Google Spreadsheet instance
+  s = Excelx.new("myspreadsheet.xlsx")         # creates an Excel Spreadsheet instance for Excel .xlsx files
+
+  s.default_sheet = s.sheets.first  # first sheet in the spreadsheet file will be used
+
+  # s.sheet is an array which holds the names of the sheets within
+  # a spreadsheet.
+  # you can also write
+  # s.default_sheet = s.sheets[3] or
+  # s.default_sheet = 'Sheet 3'
+
+  s.cell(1,1)                                 # returns the content of the first row/first cell in the sheet
+  s.cell('A',1)                               # same cell
+  s.cell(1,'A')                               # same cell
+  s.cell(1,'A',s.sheets[0])                   # same cell
+
+  # almost all methods have an optional argument 'sheet'.
+  # If this parameter is omitted, the default_sheet will be used.
+
+  s.info                                      # prints infos about the spreadsheet file
+
+  s.first_row                                 # the number of the first row
+  s.last_row                                  # the number of the last row
+  s.first_column                              # the number of the first column
+  s.last_column                               # the number of the last column
+
+  # limited font information is available
+
+  s.font(1,1).bold?
+  s.font(1,1).italic?
+  s.font(1,1).underline?
+
+
+see http://roo.rubyforge.org for a more complete tutorial
+
+== REQUIREMENTS:
+
+All dependent gems will be automatically installed.
+
+== INSTALL:
+
+  sudo gem install roo
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME (different 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/Rakefile

@@ -0,0 +1,45 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  begin
+    load 'tasks/setup.rb'
+  rescue LoadError
+    raise RuntimeError, '### please install the "bones" gem ###'
+  end
+end
+
+ensure_in_path 'lib'
+module GData
+  class Base
+  end
+end
+require 'roo'
+
+task :default => 'spec:run'
+
+PROJ.name = 'roo'
+PROJ.authors = 'Thomas Preymesser'
+PROJ.email = 'thopre@gmail.com'
+PROJ.url = 'http://roo.rubyforge.org/'
+PROJ.version = Roo::VERSION
+PROJ.rubyforge.name = 'roo'
+PROJ.gem.dependencies = [
+  # ['xmlsimple', '>= 0.0.1'],
+  ['spreadsheet', '> 0.6.4'],
+  #--
+  # rel. 0.6.4 causes an invalid Date error if we
+  # have a datetime value of 2006-02-02 10:00:00
+  #++
+  ['nokogiri', '>= 0.0.1'],
+  ['builder', '>= 2.1.2'],
+  ['gimite-google-spreadsheet-ruby','>= 0.0.5'],
+]
+
+PROJ.spec.opts << '--color'
+
+# EOF

data/bin/roo

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib roo]))
+
+# Put your code here
+
+# EOF

data/lib/roo.rb

@@ -1,4 +1,48 @@
+
 module Roo
+
+  # :stopdoc:
+  VERSION = '1.9.0'
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+      ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+    Dir.glob(search_me).sort.each {|rb|
+      puts "DEBUG: require #{rb}"
+      require rb}
+  end
+
   class Spreadsheet
     class << self
       def open(file)
@@ -9,21 +53,23 @@ module Roo
           Excelx.new(file)
         when '.ods'
           Openoffice.new(file)
-        when ''
-          Google.new(file)
+          # when ''
         else
-          raise ArgumentError, "Don't know how to open file #{file}"
-        end      
+          Google.new(file)
+          # else
+          # raise ArgumentError, "Don't know how to open file #{file}"
+        end
       end
     end
   end
-end
+end  # module Roo
 
-require 'roo/version'
-# require 'roo/spreadsheetparser' TODO:
-require 'roo/generic_spreadsheet' 
+require 'roo/generic_spreadsheet'
 require 'roo/openoffice'
 require 'roo/excel'
 require 'roo/excelx'
 require 'roo/google'
-require 'roo/roo_rails_helper'
+
+#Roo.require_all_libs_relative_to(__FILE__)
+
+# EOF

data/lib/roo/excel.rb

@@ -1,4 +1,7 @@
+require 'rubygems'
 require 'spreadsheet'
+#require 'lib/roo/generic_spreadsheet'
+#require 'parseexcel'
 CHARGUESS = begin
   require 'charguess'
   true
@@ -9,6 +12,26 @@ end
 # The Spreadsheet library has a bug in handling Excel 
 # base dates so if the file is a 1904 base date then 
 # dates are off by a day. 1900 base dates work fine
+module Spreadsheet
+  module Excel
+    class Row < Spreadsheet::Row
+      def _date data # :nodoc:
+        return data if data.is_a?(Date)
+        date = @worksheet.date_base + data.to_i
+        if LEAP_ERROR > @worksheet.date_base
+          date -= 1
+        end
+        date
+      end
+      public :_datetime
+    end
+  end
+end
+
+#=====================================================================
+# TODO:
+# redefinition of this method, the method in the spreadsheet gem has a bug
+# redefinition can be removed, if spreadsheet does it in the correct way
 module Spreadsheet
   module Excel
     class Row < Spreadsheet::Row
@@ -38,45 +61,10 @@ module Spreadsheet
         end
         DateTime.new(date.year, date.month, date.day, hour, min, sec)
       end
-      public :_date
-      public :_datetime
-    end
-    # patch for ruby-spreadsheet parsing formulas
-    class Reader
-      def read_formula worksheet, addr, work
-        row, column, xf, rtype, rval, rcheck, opts = work.unpack 'v3CxCx3v2'
-        formula = Formula.new
-        formula.shared = (opts & 0x08) > 0
-        formula.data = work[20..-1]
-        if rcheck != 0xffff || rtype > 3 
-          value, = work.unpack 'x6E'
-          unless value
-            # on architectures where sizeof(double) > 8
-            value, = work.unpack 'x6e'
-          end
-          formula.value = value
-        elsif rtype == 0
-          pos, op, len, work = get_next_chunk
-          if op == :string
-            formula.value = client read_string(work, 2), @workbook.encoding
-          else
-            # This seems to work but I don't know why :). It at least
-            # seems to correct the case we saw but doubtful it's the right fix
-            formula.value = client read_string(work[10..-1], 2), @workbook.encoding
-          end
-        elsif rtype == 1
-          formula.value = rval > 0
-        elsif rtype == 2
-          formula.value = Error.new rval
-        else
-          # leave the Formula value blank
-        end
-        set_cell worksheet, row, column, xf, formula
-      end
     end
   end
 end
-
+#=====================================================================
 
 # ruby-spreadsheet has a font object so we're extending it 
 # with our own functionality but still providing full access
@@ -86,9 +74,9 @@ module ExcelFontExtensions
     #From ruby-spreadsheet doc: 100 <= weight <= 1000, bold => 700, normal => 400
     case weight
     when 700    
-     true
+      true
     else
-     false
+      false
     end   
   end
 
@@ -227,6 +215,22 @@ class Excel < GenericSpreadsheet
     @cell[sheet].inspect
   end
 
+   # returns the row,col values of the labelled cell
+  # (nil,nil) if label is not defined
+  # sheet parameter is not really needed because label names are global
+  # to the whole spreadsheet
+  def label(labelname,sheet=nil)
+    sheet = @default_sheet unless sheet
+    read_cells(sheet) unless @cells_read[sheet]
+    if @labels.has_key? labelname
+      return @labels[labelname][1].to_i,
+        GenericSpreadsheet.letter_to_number(@labels[labelname][2]),
+        @labels[labelname][0]
+    else
+      return nil,nil,nil
+    end
+  end
+
   private
 
   # converts name of a sheet to index (0,1,2,..)
@@ -414,8 +418,8 @@ class Excel < GenericSpreadsheet
         datetime = row.datetime(idx)
       end    
       if datetime.hour != 0 or
-         datetime.min != 0 or
-         datetime.sec != 0 
+          datetime.min != 0 or
+          datetime.sec != 0
         value_type = :datetime
         value = datetime
       else