roo 1.10.1 → 1.10.2

data/.gitignore

@@ -0,0 +1,2 @@
+pkg/
+test/log/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# pull reqs from gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,38 @@
+PATH
+  remote: .
+  specs:
+    roo (1.10.1)
+      nokogiri (>= 1.5.2)
+      rubyzip (>= 0.9.6.1)
+      spreadsheet (> 0.6.4)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    bones (3.8.0)
+      little-plugger (~> 1.1.3)
+      loquacious (~> 1.9.1)
+      rake (>= 0.8.7)
+    little-plugger (1.1.3)
+    loquacious (1.9.1)
+    nokogiri (1.5.5)
+    nokogiri (1.5.5-java)
+    rake (0.9.2.2)
+    ruby-ole (1.2.11.4)
+    rubyzip (0.9.9)
+    shoulda (3.0.1)
+      shoulda-context (~> 1.0.0)
+      shoulda-matchers (~> 1.0.0)
+    shoulda-context (1.0.0)
+    shoulda-matchers (1.0.0)
+    spreadsheet (0.7.3)
+      ruby-ole (>= 1.0)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  bones (>= 3.8.0)
+  roo!
+  shoulda (~> 3.0)

data/History.txt

@@ -2,7 +2,7 @@
 
 * 2 bugfixes
   * forgot dependency 'rubyzip'
-  * at least one external application does create xlsx-files with different internal file names which differ from the original file names of Excel. Solution: ignore lower-/upper case in file names. 
+  * at least one external application does create xlsx-files with different internal file names which differ from the original file names of Excel. Solution: ignore lower-/upper case in file names.
 
 == 1.10.0 2011-10-10
 
@@ -11,7 +11,7 @@
   * Openoffice, Libreoffice: new method 'labels'
   * Excelx: implemented all methods concerning labels
   * Openoffice, Excelx: new methods concerning comments (comment, comment? and comments)
-  
+
 * 2 bugfixes
   * XLSX: some cells were not recognized correctly from a spreadsheet file from a windows mobile phone.
   * labels: Moved to a separate methode. There were problems if there was an access to a label before read_cells were called.
@@ -51,11 +51,11 @@
 * 1 enhancement
   * removed gem 'builder'. Functionality goes to gem 'nokogiri'.
 * 3 bugfixes
-  * Excel: remove temporary files if spreadsheed-file is not an excel file 
+  * Excel: remove temporary files if spreadsheed-file is not an excel file
     and an exception was raised
   * Excelx: a referenced cell with a string had the content 0.0 not the
     correct string
-  * Fixed a problem with a date cell which was not recognized as a Date 
+  * Fixed a problem with a date cell which was not recognized as a Date
     object (see 2011-05-21 in excelx.rb)
 
 == 1.9.3 2010-02-12

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2011 Thomas Preymesser
+
+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/Manifest.txt

@@ -0,0 +1,68 @@
+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/excelx.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.xlsx
+test/Bibelbund.csv
+test/bbu.xls
+test/bbu.xlsx
+test/bbu.ods
+test/no_spreadsheet_file.txt
+test/simple_spreadsheet.ods
+test/simple_spreadsheet.xls
+test/simple_spreadsheet.xlsx
+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.xlsx
+test/time-test.csv
+test/numbers1.csv
+test/numbers1_excel.csv
+test/numbers1.ods
+test/numbers1.xls
+test/numbers1.xlsx
+test/borders.ods
+test/borders.xls
+test/borders.xlsx
+test/formula.ods
+test/formula.xls
+test/formula.xlsx
+test/only_one_sheet.ods
+test/only_one_sheet.xls
+test/only_one_sheet.xlsx
+test/bode-v1.xls.zip
+test/bode-v1.ods.zip
+test/ric.ods
+test/bug-row-column-fixnum-float.xls
+test/emptysheets.ods
+test/emptysheets.xls
+test/datetime.ods
+test/datetime.xls
+test/datetime.xlsx
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.rhtml

data/README.markdown

@@ -0,0 +1,109 @@
+# README for Roo
+
+Roo implements read access for all spreadsheet types and read/write access for
+Google spreadsheets. It can handle
+* Openoffice
+* Excel
+* Google spreadsheets
+* Excelx
+* Libreoffice
+* CSV
+
+Using Roo to access Google spreadsheets requires you install the 'google-spreadsheet-ruby' gem separately.
+
+Unless the underlying 'spreadsheet' gem supports formulas there is no support
+for formulas in Roo for .xls files (you get the result of a formula in such a
+file but not the formula itself)
+
+## Usage:
+
+    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
+
+# Fork Changelog / New Features
+
+    # Spreadsheet.open can accept both files and paths
+
+    xls = Roo::Spreadsheet.open('./new_prices.xls')
+
+    # no more setting xls.default_sheet, just use this
+
+    xls.sheet('Info').row_count
+    xls.sheet(0).row_count
+
+    # excel likes to create random "Data01" sheets for macros
+    # use this to find the sheet with the most data to parse
+
+    xls.longest_sheet
+
+    # this excel file has multiple worksheets, let's iterate through each of them and process
+
+    xls.each_with_pagename do |name,sheet|
+    puts sheet.row_count
+    end
+
+    # pull out a hash of exclusive column data (get rid of useless columns and save memory)
+
+    xls.each(:id => 'UPC',:qty => 'ATS') {|hash| arr << hash}
+    #=> hash will appear like {:upc=>727880013358, :qty => 12}
+
+    # NOTE: .parse does the same as .each, except it returns an array (similar to each vs. map)
+
+    # not sure exactly what a column will be named? try a wildcard search with the character *
+    # regex characters are allowed ('^price\s')
+    # case insensitive
+
+    xls.parse(:id => 'UPC*SKU',:qty => 'ATS*\sATP\s*QTY$')
+
+    # if you need to locate the header row and assign the header names themselves,
+    # use the :header_search option
+
+    xls.parse(:header_search => ['UPC*SKU','ATS*\sATP\s*QTY$'])
+    #=> each element will appear in this fashion:
+    #=> {"UPC" => 123456789012, "STYLE" => "987B0", "COLOR" => "blue", "QTY" => 78}
+
+    # want to strip out annoying unicode characters and surrounding white space?
+
+    xls.parse(:clean => true)
+
+    # another bonus feature is a patch to prevent the Spreadsheet gem from parsing
+    # thousands and thousands of blank lines. i got fed up after watching my computer
+    # nearly catch fire for 4 hours for a spreadsheet with only 200 ACTUAL lines
+    # - located in lib/roo/worksheet.rb
+

data/Rakefile

@@ -12,8 +12,10 @@ task :default => 'test:run'
 
 Bones {
   name  'roo'
-  authors  'Thomas Preymesser'
+  authors  'Thomas Preymesser', 'Hugh McGowan', 'Ben Woosley'
   email  'thopre@gmail.com'
+  summary "Roo can access the contents of various spreadsheet files."
+  description "Roo can access the contents of various spreadsheet files. It can handle\n* Openoffice\n* Excel\n* Google spreadsheets\n* Excelx\n* Libreoffice\n* CSV"
   url  'http://roo.rubyforge.org/'
   version  Roo::VERSION
   depend_on 'spreadsheet', '> 0.6.4'
@@ -26,9 +28,8 @@ Bones {
   #depend_on 'febeling-rubyzip','>= 0.9.2' # meine aktuelle Version
   #TODO: warum brauchen wir das? es lief doch auch vorher ohne dieses spezielle gem
   depend_on 'rubyzip' # rubyzip wird benoetigt
-  depend_on 'google-spreadsheet-ruby'
-  depend_on 'choice'
-  depend_on 'todonotes'
+  # depend_on 'google-spreadsheet-ruby'
+  # depend_on 'choice'
 }
 
 # EOF

data/examples/roo_soap_client.rb

@@ -0,0 +1,53 @@
+require 'soap/rpc/driver'
+
+  def ferien_fuer_region(proxy, region, year=nil)
+    proxy.first_row.upto(proxy.last_row) { |row|
+      if proxy.cell(row, 2) == region
+        jahr = proxy.cell(row,1).to_i
+        if year == nil || jahr == year
+          bis_datum = proxy.cell(row,5)
+          if DateTime.now > bis_datum
+            print '('
+          end
+          print jahr.to_s+" "
+          print proxy.cell(row,2)+" "
+          print proxy.cell(row,3)+" "
+          print proxy.cell(row,4).to_s+" "
+          print bis_datum.to_s+" "
+          print (proxy.cell(row,6) || '')+" "
+          if DateTime.now > bis_datum
+            print ')'
+          end
+          puts
+        end
+      end 
+    } 
+  end
+
+proxy = SOAP::RPC::Driver.new("http://localhost:12321","spreadsheetserver")
+proxy.add_method('cell','row','col')
+proxy.add_method('officeversion')
+proxy.add_method('last_row')
+proxy.add_method('last_column')
+proxy.add_method('first_row')
+proxy.add_method('first_column')
+proxy.add_method('sheets')
+proxy.add_method('set_default_sheet','s')
+proxy.add_method('ferien_fuer_region', 'region')
+
+sheets = proxy.sheets
+proxy.set_default_sheet(sheets.first)
+
+puts "first row: #{proxy.first_row}"
+puts "first column: #{proxy.first_column}"
+puts "last row: #{proxy.last_row}"
+puts "last column: #{proxy.last_column}"
+puts "cell: #{proxy.cell('C',8)}"
+puts "cell: #{proxy.cell('F',12)}"
+puts "officeversion: #{proxy.officeversion}"
+puts "Berlin:"
+
+ferien_fuer_region(proxy, "Berlin")
+
+
+

data/examples/roo_soap_server.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'roo'
+require 'soap/rpc/standaloneServer'
+
+NS = "spreadsheetserver" # name of your service = namespace
+class Server2 < SOAP::RPC::StandaloneServer
+
+  def on_init
+    spreadsheet = Openoffice.new("./Ferien-de.ods")
+    add_method(spreadsheet, 'cell', 'row', 'col')
+    add_method(spreadsheet, 'officeversion')
+    add_method(spreadsheet, 'first_row')
+    add_method(spreadsheet, 'last_row')
+    add_method(spreadsheet, 'first_column')
+    add_method(spreadsheet, 'last_column')
+    add_method(spreadsheet, 'sheets')
+    #add_method(spreadsheet, 'default_sheet=', 's')
+    # method with '...=' did not work? alias method 'set_default_sheet' created
+    add_method(spreadsheet, 'set_default_sheet', 's')
+  end
+
+end
+
+PORT = 12321
+puts "serving at port #{PORT}"
+svr = Server2.new('Roo', NS, '0.0.0.0', PORT)
+
+trap('INT') { svr.shutdown }
+svr.start

data/examples/write_me.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'roo'
+
+#-- create a new spreadsheet within your google-spreadsheets and paste
+#-- the 'key' parameter in the spreadsheet URL 
+MAXTRIES = 1000
+print "what's your name? "
+my_name = gets.chomp
+print "where do you live? "
+my_location = gets.chomp
+print "your message? (if left blank, only your name and location will be inserted) "
+my_message = gets.chomp
+spreadsheet = Google.new('ptu6bbahNZpY0N0RrxQbWdw')
+spreadsheet.default_sheet = 'Sheet1'
+success = false
+MAXTRIES.times do
+  col = rand(10)+1
+  row = rand(10)+1
+  if spreadsheet.empty?(row,col)
+    if my_message.empty?
+      text = Time.now.to_s+" "+"Greetings from #{my_name} (#{my_location})"
+    else
+      text = Time.now.to_s+" "+"#{my_message} from #{my_name} (#{my_location})"
+    end
+    spreadsheet.set_value(row,col,text)
+    puts "message written to row #{row}, column #{col}"
+    success = true
+    break
+  end
+  puts "Row #{row}, column #{col} already occupied, trying again..."
+end
+puts "no empty cell found within #{MAXTRIES} tries" if !success
+

data/lib/roo.rb

@@ -1,79 +1,38 @@
-# require 'todo_gem'
-
 module Roo
 
-  # :stopdoc:
-  VERSION = '1.10.1'
-  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
+  VERSION = '1.10.2'
 
   class Spreadsheet
     class << self
       def open(file)
+        file = File === file ? file.path : file
         case File.extname(file)
         when '.xls'
-          Excel.new(file)
+          Roo::Excel.new(file)
         when '.xlsx'
-          Excelx.new(file)
+          Roo::Excelx.new(file)
         when '.ods'
-          Openoffice.new(file)
+          Roo::Openoffice.new(file)
+        when '.xml'
+          Roo::Excel2003XML.new(file)
+        when ''
+          Roo::Google.new(file)
         when '.csv'
-          Csv.new(file)
-          # when ''
+          Roo::Csv.new(file)
         else
-          Google.new(file)
-          # else
-          # raise ArgumentError, "Don't know how to open file #{file}"
+          raise ArgumentError, "Don't know how to open file #{file}"
         end
       end
     end
   end
-end  # module Roo
-
-require 'roo/generic_spreadsheet'
-require 'roo/openoffice'
-require 'roo/excel'
-require 'roo/excelx'
-require 'roo/google'
-require 'roo/csv'
 
-#Roo.require_all_libs_relative_to(__FILE__)
+  autoload :GenericSpreadsheet, 'roo/generic_spreadsheet'
+  autoload :Openoffice,         'roo/openoffice'
+  autoload :Excel,              'roo/excel'
+  autoload :Excelx,             'roo/excelx'
+  autoload :Google,             'roo/google'
+  autoload :Csv,                'roo/csv'
 
-# EOF
+  autoload :Excel2003XML,       'roo/excel2003xml'
+  autoload :RooRailsHelper,     'roo/roo_rails_helper'
+end