roo 1.13.2 → 2.0.0beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2469a06f8110bdaa52d7a0aa1b9c5c870034b3d8
-  data.tar.gz: 5211e3ae85961fc29376156120569220cbfbbe7b
+  metadata.gz: c1ec41909edd94071bbd39eb8c39ad1a610f8f59
+  data.tar.gz: 1482e4b7d1de2ce8966f7627d3c3dd2b2f638337
 SHA512:
-  metadata.gz: bbae1e0e681f369f4ec0ee8c71a880c3b6fe24cc815cde0b337bd63e77a0103edf04b77de320a212e772a8ac1a68ad9ee5f5be3b52672806fbc18592536db83d
-  data.tar.gz: 91a54b399f41ee9d459b9bb3868c5cd2990963297c274f4dc5f4a78034137a8c617f9ac34db75418e8f0989683219637cb9a096536259e9cb76fe9cca780b132
+  metadata.gz: c46ede35b0e40c86cd0a9329ec15d1fd55147aaaf1433ad5ff6f0fa6881d3f8a4148791b960c6c2f801f301f34f134ad911a10e006361959a468cd8ef03428bd
+  data.tar.gz: f9f3c660aa13985bc7138a236b84b79491d21b8159cd27d71e793e643d05db4ae80c44d08142c8d2fc73d68f2de82f4428991ff2e14e52cc3e3e7d1eafeb7b19

data/.gitignore

@@ -0,0 +1,7 @@
+/pkg/
+/log/
+/coverage/
+.ruby-version
+.project
+*.lock
+.idea

data/.simplecov

@@ -0,0 +1,4 @@
+SimpleCov.start do
+  add_filter 'spec'
+  add_filter 'test'
+end

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1
+  - 2.2.0
+  - ruby-head
+  - jruby-19mode # JRuby in 1.9 mode
+  - rbx-2
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-19mode
+bundler_args: --without local_development

data/CHANGELOG

@@ -1,3 +1,24 @@
+== unreleased
+
+* enhancements
+  * Extend Roo::Spreadsheet.open to accept Tempfiles and other arguments responding to #path. Note they require an :extension option to be declared, as the tempfile mangles the extension. #84.
+  * Remove deprecated code.
+  * Remove the Roo::ZipFile abstraction. Roo now depends on rubyzip 1.0.0+
+  * Extract Roo::Excel and Roo::Excel2003XML to roo-xls
+  * Extract Roo::Google to roo-google
+  * Accept the tmpdir_root option in Roo::Excelx
+  * Change the tmpdir prefix from oo_ to roo_
+  * In Excelx, load styles, shared strings and the workbook lazily. Leave the tmpdir open so that reading may take place after initialize. The OS will be responsible for cleaning it up.
+  * In OpenOffice / LibreOffice, load the content xml lazily. Leave the tmpdir open so that reading may take place after initialize. The OS will be responsible for cleaning it up.
+  * Lazily initialize @default_sheet, to avoid reading the sheets earlier than necessary. Use the #default_sheet accessor instead.
+
+* bugfixes
+  * Fix that paths with spaces in them would fail with
+    URI::InvalidURIError. #121.
+  # Fix that #parse-ing with a hash of columns not in the document
+    would fail mysteriously. #129
+  * Fix that Roo::Excelx#celltype would not return :link when appropriate.
+
 == 1.13.2 2013-12-23
 
 * bugfixes

data/Gemfile

@@ -1,18 +1,24 @@
-source 'http://rubygems.org'
+source 'https://rubygems.org'
 
-gem 'spreadsheet', '> 0.6.4'
-gem 'nokogiri'
-gem 'rubyzip'
-
-group :development do
-  gem 'google_drive'
-  gem 'jeweler'
-end
+gemspec
 
 group :test do
   # additional testing libs
   gem 'webmock'
   gem 'shoulda'
-  gem 'rspec'
+  gem 'rspec', '>= 3.0.0'
   gem 'vcr'
+  gem 'simplecov', '>= 0.9.0', require: false
+  gem 'coveralls', require: false
+end
+
+group :local_development do
+  gem 'terminal-notifier-guard', require: false if RUBY_PLATFORM.downcase.include?('darwin')
+  gem 'guard-rspec', '>= 4.3.1', require: false
+  gem 'guard-minitest', require: false
+  gem 'guard-bundler', require: false
+  gem 'guard-preek', require: false
+  gem 'guard-rubocop', require: false
+  gem 'guard-reek', github: 'pericles/guard-reek', require: false
+  gem 'pry'
 end

data/Guardfile

@@ -0,0 +1,24 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :minitest, test_folders: ['test'] do
+  watch(%r{^test/(.*)\/?test_(.*)\.rb$})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb$})     { |m| "test/#{m[1]}test_#{m[2]}.rb" }
+  watch(%r{^test/test_helper\.rb$})      { 'test' }
+end
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rsspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separetly)
+#  * 'just' rspec: 'rspec'
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+end
+

data/LICENSE

@@ -1,4 +1,6 @@
-Copyright (c) 2008-2013 Thomas Preymesser, Ben Woosley
+Copyright (c) 2008-2014 Thomas Preymesser, Ben Woosley
+
+MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,254 @@
+# Roo
+
+[![Build Status](https://img.shields.io/travis/roo-rb/roo.svg?style=flat-square)](https://travis-ci.org/roo-rb/roo) [![Code Climate](https://img.shields.io/codeclimate/github/roo-rb/roo.svg?style=flat-square)](https://codeclimate.com/github/roo-rb/roo) [![Coverage Status](https://img.shields.io/coveralls/roo-rb/roo.svg?style=flat-square)](https://coveralls.io/r/roo-rb/roo) [![Gem Version](https://img.shields.io/gem/v/roo.svg?style=flat-square)](https://rubygems.org/gems/roo)
+
+Roo implements read access for all common spreadsheet types. It can handle:
+
+* Excelx
+* OpenOffice / LibreOffice
+* CSV
+
+## Additional Libraries
+
+In addition, the [roo-xls](https://github.com/roo-rb/roo-xls) and [roo-google](https://github.com/roo-rb/roo-google) gems exist to extend Roo to support reading classic Excel formats (i.e. `.xls` and ``Excel2003XML``) and read/write access for Google spreadsheets.
+
+# #Installation
+
+Install as a gem
+
+    $ gem install roo
+
+Or add it to your Gemfile
+
+```ruby
+gem 'roo', '2.0.0-beta'
+```
+## Usage
+
+Opening a spreadsheet
+
+```ruby
+require 'roo'
+
+xlsx = Roo::Spreadsheet.open('./new_prices.xlsx')
+xlsx = Roo::Excelx("./new_prices.xlsx")
+
+# Use the extension option if the extension is ambiguous.
+xlsx = Roo::Spreadsheet.open('./rails_temp_upload', extension: :xlsx)
+
+xlsx.info
+# => Returns basic info about the spreadsheet file
+```
+
+``Roo::Spreadsheet.open`` can accept both paths and ``File`` instances.
+
+### Working with sheets
+
+```ruby
+ods.sheets
+# => ['Info', 'Sheet 2', 'Sheet 3']   # an Array of sheet names in the workbook
+
+ods.sheet('Info').row(1)
+ods.sheet(0).row(1)
+
+# Set the last sheet as the default sheet.
+ods.default_sheet = ods.sheets.last
+ods.default_sheet = s.sheets[3]
+ods.default_sheet = 'Sheet 3'
+
+# Iterate through each sheet
+ods.each_with_pagename do |name, sheet|
+  p sheet.row(1)
+end
+```
+
+### Accessing rows and columns
+
+Roo uses Excel's numbering for rows, columns and cells, so `1` is the first index, not `0` as it is in an ``Array``
+
+```ruby
+sheet.row(1)
+# returns the first row of the spreadsheet.
+
+sheet.column(1)
+# returns the first column of the spreadsheet.
+```
+
+Almost all methods have an optional argument `sheet`. If this parameter is omitted, the default_sheet will be used.
+
+```ruby
+sheet.first_row(sheet.sheets[0])
+# => 1             # the number of the first row
+sheet.last_row
+# => 42            # the number of the last row
+sheet.first_column
+# => 1             # the number of the first column
+sheet.last_column
+# => 10            # the number of the last column
+```
+
+#### Accessing cells
+
+You can access the top-left cell in the following ways
+
+```ruby
+s.cell(1,1)
+s.cell('A',1)
+s.cell(1,'A')
+s.a1
+
+# Access the second sheet's top-left cell.
+s.cell(1,'A',s.sheets[1])
+```
+
+#### Querying a spreadsheet
+Use ``each`` with a ``block`` to iterate over each row.
+
+If each is given a hash with the names of some columns, then each will generate a hash with the columns supplied for each row.
+
+```ruby
+sheet.each(id: 'ID', name: 'FULL_NAME') do |hash|
+  puts hash.inspect
+  # => { id: 1, name: 'John Smith' }
+end
+```
+
+Use ``sheet.parse`` to return an array of rows. Column names can be a ``String`` or a ``Regexp``.
+
+```ruby
+sheet.parse(:id => /UPC|SKU/,:qty => /ATS*\sATP\s*QTY\z/)
+# => [{:upc => 727880013358, :qty => 12}, ...]
+```
+
+Use the ``:header_search`` option to locate the header row and assign the header names.
+
+```ruby
+sheet.parse(header_search: [/UPC*SKU/,/ATS*\sATP\s*QTY\z/])
+```
+
+Use the ``:clean`` option to strip out control characters and surrounding white space.
+
+```ruby
+sheet.parse(:clean => true)
+```
+
+### Exporting spreadsheets
+Roo has the ability to export sheets using the following formats. It
+will only export the ``default_sheet``.
+
+```ruby
+sheet.to_csv
+sheet.to_matrix
+sheet.to_xml
+sheet.to_yaml
+```
+
+### Excel (xlsx) Support
+
+Stream rows from an Excelx spreadsheet.
+
+```ruby
+xlsx = Roo::Excelx.new("./test_data/test_small.xlsx")
+xlsx.each_row_streaming do |row|
+  puts row.inspect # Array of Excelx::Cell objects
+end
+```
+
+Iterate over each row
+
+```ruby
+xlsx.each_row do |row|
+  ...
+end
+```
+
+``Roo::Excelx`` also provides these helpful methods.
+
+```ruby
+xlsx.excelx_type(3, 'C')
+# => :numeric_or_formula
+
+xlsx.cell(3, 'C')
+# => 600000383.0
+
+xlsx.excelx_value(row,col)
+# => '0600000383'
+```
+
+``Roo::Excelx`` can access celltype, comments, font information, formulas, hyperlinks and labels.
+
+```ruby
+xlsx.comment(1,1, ods.sheets[-1])
+xlsx.font(1,1).bold?
+xlsx.formula('A', 2)
+```
+
+### OpenOffice / LibreOffice Support
+
+Roo::OpenOffice supports for encrypted OpenOffice spreadsheets.
+
+```ruby
+# Load an encrypted OpenOffice Spreadsheet
+ods = Roo::OpenOffice.new("myspreadsheet.ods", :password => "password")
+```
+
+``Roo::OpenOffice`` can access celltype, comments, font information, formulas and labels.
+
+```ruby
+ods.celltype
+# => :percentage
+
+ods.comment(1,1, ods.sheets[-1])
+
+ods.font(1,1).italic?
+# => false
+
+ods.formula('A', 2)
+```
+
+### CSV Support
+
+```ruby
+# Load a CSV file
+s = Roo::CSV.new("mycsv.csv")
+```
+
+Because Roo uses the [standard CSV library](), and you can use options available to that library to parse csv files. You can pass options using the ``csv_options`` key.
+
+For instance, you can load tab-delimited files (``.tsv``), and you can use a particular encoding when opening the file.
+
+
+```ruby
+# Load a tab-delimited csv
+s = Roo::CSV.new("mytsv.tsv", csv_options: {col_sep: "\t"})
+
+# Load a csv with an explicit encoding
+s = Roo::CSV.new("mycsv.csv", csv_options: {encoding: Encoding::ISO_8859_1})
+```
+
+## Upgrading from Roo 1.13.x
+If you use ``.xls`` or Google spreadsheets, you will need to install ``roo-xls`` or ``roo-google`` to continue using that functionality.
+
+Roo's public methods have stayed relatively consistent between 1.13.x and 2.0.0, but please check the [Changelog](https://github.com/roo-rb/roo/blob/master/CHANGELOG) to better understand the changes made since 1.13.x.
+
+
+
+## Contributing
+### Features
+1. Fork it ( https://github.com/[my-github-username]/roo/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'My new feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+### Issues
+
+If you find an issue, please create a gist and refer to it in an issue ([sample gist](https://gist.github.com/stevendaniels/98a05849036e99bb8b3c)). Here are some instructions for creating such a gist.
+
+1. [Create a gist](https://gist.github.com) with code that creates the error.
+2. Clone the gist repo locally, add a stripped down version of the offending spreadsheet to the gist repo, and push the gist's changes master.
+3. Paste the gist url here.
+
+
+## License
+[Roo uses an MIT License](https://github.com/roo-rb/roo/blob/master/LICENSE)

data/Rakefile

@@ -1,23 +1,23 @@
-require 'jeweler'
-
-Jeweler::Tasks.new do |gem|
-  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
-  gem.name = "roo"
-  gem.summary = "Roo can access the contents of various spreadsheet files."
-  gem.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"
-  gem.email = "ruby.ruby.ruby.roo@gmail.com"
-  gem.homepage = "http://github.com/Empact/roo"
-  gem.authors = ['Thomas Preymesser', 'Hugh McGowan', 'Ben Woosley']
-
-  gem.license = 'MIT'
-  gem.required_ruby_version = '>= 1.9.0'
-
-  gem.test_files = FileList["{spec,test}/**/*.*"]
-end
-
-require 'rake/testtask'
-Rake::TestTask.new do |t|
-  t.libs << "test"
-  t.test_files = FileList['test/test*.rb']
-  t.verbose = true
-end
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+require 'rspec/core/rake_task'
+require 'coveralls/rake/task'
+
+# Test unit
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/test*.rb']
+  t.verbose = true
+end
+
+# RSpec
+RSpec::Core::RakeTask.new(:spec)
+
+# Coveralls
+Coveralls::RakeTask.new
+
+default_task = [:test, :spec]
+default_task << 'coveralls:push' if ENV['TRAVIS']
+
+task default: default_task

data/examples/roo_soap_client.rb

@@ -1,38 +1,38 @@
 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
+def ferien_fuer_region(proxy, region, year = nil)
+  proxy.first_row.upto(proxy.last_row) do |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
-      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
+end
 
-proxy = SOAP::RPC::Driver.new("http://localhost:12321","spreadsheetserver")
-proxy.add_method('cell','row','col')
+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('set_default_sheet', 's')
 proxy.add_method('ferien_fuer_region', 'region')
 
 sheets = proxy.sheets
@@ -42,12 +42,9 @@ 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 "cell: #{proxy.cell('C', 8)}"
+puts "cell: #{proxy.cell('F', 12)}"
 puts "officeversion: #{proxy.officeversion}"
-puts "Berlin:"
-
-ferien_fuer_region(proxy, "Berlin")
-
-
+puts 'Berlin:'
 
+ferien_fuer_region(proxy, 'Berlin')