robust_excel_ole 1.17 → 1.18.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c268eff75271d48aae54af54c03c138e8a965a6c6965b6fc9b5fd330a346888d
-  data.tar.gz: '0921d96d9d20546523acb5ea5e419d8e2351307c23d25abe8b8d96010364b643'
+  metadata.gz: cf35f3fb5a6a208f408a41bfb4dd72424030458ecbbf51590e457ce63cdaef55
+  data.tar.gz: 04357d405ae6d393480457ffb4d2e21fde6cd8b87a123be6467f1389c83d6727
 SHA512:
-  metadata.gz: c98669d651a2ff192bab0767ea16085a08cab8e0c656c3123b684080b96b62899967f3c4998637002dddf72eb1dbbd635f2ef102153d53842977adeba11d32c6
-  data.tar.gz: 1ac22fd73f4dae16142c1dc1d81bd9d9f8eeb5fbf95f85b4bcf26d99293b474c544aae863af4d40cc64052535ab40541956b69db8301274aade5afcacea37534
+  metadata.gz: 8702bb3c42465b1c3c04ccb248fdc6d17f415193fba5ef12d05820517420970b8da04f042de4a562390e21ee8b1f90325eb5826bd012d3aeea0ca3a8640292e5
+  data.tar.gz: 84ce7e871aeb7005441832c97ef68e67da3ef46e20c024ae3c7a51dcef946de13d89902e6a40c8173bd486d9c2a44a9db2e3f8139c2ed0501133b503066821af

data/Changelog

@@ -1,6 +1,29 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+
+## [1.19] 2020-30-5
+
+### Added
+  - Workheet#values, each_rowvalue
+
+
+## [1.18] 2020-30-4
+
+### Added
+  - Workbook#worksheets, worksheets_count
+  - Worksheet#each_value
+  - Range#value, value=
+  - Range#initialize: optional paramter worksheet
+
+## [1.17]
+
+### Added
+  - Excel#active_workbook
+
+### Changed
+  - Excel#namevalue, set_namevalue, namevalue_glob, set_namevalue_glob are being removed
+
 ## [1.16]
 
 ### Added

data/README.rdoc

@@ -14,6 +14,23 @@ Library references are supported.
 RobustExcelOle works by sending VBA methods via Win32OLE. 
 Therefore, it runs on Windows only.
 
+== Feature list
+
+- opening and processing workbooks across various Excel instances
+- reading and writing workbooks (cells and ranges)
+- reopening and unobtrusively opening workbooks
+- convenient methods for standard tasks (like opening, reading, writing, closing, saving workbooks, naming, adding, and copying ranges and worksheets)
+- dealing with various cases of Excel and user behaviour, e.g. managing conflicts when opening workbooks (e.g. blocking or unsaved workbooks),
+  even with simultanously happening user interactions
+- workarounds for Excel bugs and JRuby bugs
+- various workbook formats, e.g. .xlsx, .xls, .xlsm are supported
+- library references are supported
+- console for convenient usage
+
+== What's new?
+
+  - removing methods to operate on ranges directly from an Excel instance. However, you can use the method Excel.active_workbook to do so.
+  See ChangeLogs.
 
 == Requirements
 

data/benchmarking/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'rubyXL'
+gem 'roo'
+gem 'creek'
+gem 'spreadsheet'
+gem 'simple_xlsx_reader'

data/benchmarking/README.md

@@ -0,0 +1,131 @@
+# ruby-excel-library-examples
+This project contains sample code for reading Excel files with different Ruby libraries.
+
+## `.xlsx` File Examples
+Below are code samples for reading current OOXML Excel files using [**rubyXL**](https://github.com/weshatheleopard/rubyXL), [**roo**](https://github.com/roo-rb/roo), [**creek**](https://github.com/pythonicrubyist/creek), and [**simple_xlsx_reader**](https://github.com/woahdae/simple_xlsx_reader).
+
+### [rubyXL](https://github.com/weshatheleopard/rubyXL)
+```ruby
+require 'rubyXL'
+
+workbook = RubyXL::Parser.parse './sample_excel_files/xlsx_500_rows.xlsx'
+worksheets = workbook.worksheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.sheet_name}"
+  num_rows = 0
+
+  worksheet.each do |row|
+    row_cells = row.cells.map{ |cell| cell.value }
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+end
+
+puts 'Done'
+```
+### [roo](https://github.com/roo-rb/roo)
+```ruby
+require 'roo'
+
+workbook = Roo::Spreadsheet.open './sample_excel_files/xlsx_500_rows.xlsx'
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet}"
+  num_rows = 0
+
+  workbook.sheet(worksheet).each_row_streaming do |row|
+    row_cells = row.map { |cell| cell.value }
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join ' '
+  end
+  puts "Read #{num_rows} rows"
+end
+
+puts 'Done'
+```
+### [creek](https://github.com/pythonicrubyist/creek)
+```ruby
+require 'creek'
+
+workbook = Creek::Book.new './sample_excel_files/xlsx_500_rows.xlsx'
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.rows.each do |row|
+    row_cells = row.values
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+end
+
+puts 'Done'
+```
+### [simple_xlsx_reader](https://github.com/woahdae/simple_xlsx_reader)
+```ruby
+require 'simple_xlsx_reader'
+
+workbook = SimpleXlsxReader.open './sample_excel_files/xlsx_500000_rows.xlsx'
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.rows.each do |row|
+    row_cells = row
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join ' '
+  end
+  puts "Read #{num_rows} rows"
+end
+
+puts 'Done'
+```
+
+## Legacy `.xls` Files
+Below are code samples for reading legacy Excel files using [**spreadsheet**](https://github.com/zdavatz/spreadsheet)
+
+### [spreadsheet](https://github.com/zdavatz/spreadsheet)
+```ruby
+require 'spreadsheet'
+
+# Note: spreadsheet only supports .xls files (not .xlsx)
+workbook = Spreadsheet.open './sample_excel_files/xls_500_rows.xls'
+worksheets = workbook.worksheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.rows.each do |row|
+    row_cells = row.to_a.map{ |v| v.methods.include?(:value) ? v.value : v }
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+end
+
+puts 'Done'
+```

data/benchmarking/creek_example.rb

@@ -0,0 +1,33 @@
+
+require 'creek'
+
+start_time = Time.now 
+
+# ============================================
+# ===========   Read Example   ===============
+# ============================================
+
+workbook = Creek::Book.new './sample_excel_files/xlsx_500_rows.xlsx'
+
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+  
+  worksheet.rows.each do |row|
+    row_cells = row.values
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'

data/benchmarking/generating_excel_files.rb

@@ -0,0 +1,28 @@
+require_relative '../lib/robust_excel_ole'
+
+include RobustExcelOle
+
+begin
+
+  filename = './large_excel_files/xlsx_10_rows.xlsx'
+  Excel.kill_all
+ 
+  Workbook.open(filename, :if_absent => :create) do |workbook|
+    # default: 3 worksheets
+    num_worksheets = 1
+    workbook.each do |worksheet|
+      puts "worksheet-number #{num_worksheets}"
+      num_rows = 1
+      (1..10).each do |row|
+        puts "row-number: #{num_rows}"
+        (1..10).each do |column|
+          worksheet[num_rows,column].value = (num_rows-1)*10+column
+        end
+        num_rows += 1
+      end
+      num_worksheets += 1
+    end
+    workbook.save
+  end
+
+end

data/benchmarking/reo_example.rb

@@ -0,0 +1,26 @@
+require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+
+start_time = Time.now 
+
+workbook = RobustExcelOle::Workbook.open './sample_excel_files/xlsx_500_rows.xlsx'
+
+puts "Found #{workbook.worksheets_count} worksheets"
+
+workbook.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.values.each do |row_vals|
+    row_cells = row_vals
+    num_rows += 1
+  end
+
+  puts "Read #{num_rows} rows"
+
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'

data/benchmarking/reo_example1.rb

@@ -0,0 +1,31 @@
+#require 'robust_excel_ole'
+require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+
+start_time = Time.now 
+
+workbook = RobustExcelOle::Workbook.open './sample_excel_files/xlsx_500_rows.xlsx'
+
+puts "Found #{workbook.Worksheets.Count} worksheets"
+
+workbook.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.each_row do |row|
+    row_cells = row.map{ |cell| cell.value }
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+
+end
+
+
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'

data/benchmarking/reo_example2.rb

@@ -0,0 +1,26 @@
+require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+
+start_time = Time.now 
+
+workbook = RobustExcelOle::Workbook.open './sample_excel_files/xlsx_500_rows.xlsx'
+
+puts "Found #{workbook.worksheets_count} worksheets"
+
+workbook.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.each_rowvalue do |row_vals|
+    row_cells = row_vals
+    num_rows += 1
+  end
+
+  puts "Read #{num_rows} rows"
+
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'

data/benchmarking/roo_example.rb

@@ -0,0 +1,33 @@
+require 'roo'
+
+# ============================================
+# ===========   Read Example   ===============
+# ============================================
+
+start_time = Time.now
+
+workbook = Roo::Spreadsheet.open './sample_excel_files/xlsx_500_rows.xlsx'
+
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet}"
+  num_rows = 0
+
+  workbook.sheet(worksheet).each_row_streaming do |row|
+    row_cells = row.map { |cell| cell.value }
+    #puts row_cells.inspect
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join ' '
+  end
+  puts "Read #{num_rows} rows"
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'

data/benchmarking/ruby_xl_example.rb

@@ -0,0 +1,36 @@
+
+require 'rubyXL'
+
+start_time = Time.now 
+
+# ============================================
+# ===========   Read Example   ===============
+# ============================================
+
+workbook = RubyXL::Parser.parse './sample_excel_files/xlsx_500_rows.xlsx'
+
+worksheets = workbook.worksheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.sheet_name}"
+  num_rows = 0
+
+  worksheet.each do |row|
+    row_cells = row.cells.map{ |cell| cell.value }
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join " "
+  end
+  puts "Read #{num_rows} rows"
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'
+
+
+puts 'Done'

data/benchmarking/simple_xlsx_reader_example.rb

@@ -0,0 +1,33 @@
+
+require 'simple_xlsx_reader'
+
+start_time = Time.now 
+
+# ============================================
+# ===========   Read Example   ==============
+# ============================================
+
+workbook = SimpleXlsxReader.open './sample_excel_files/xlsx_500_rows.xlsx'
+
+worksheets = workbook.sheets
+puts "Found #{worksheets.count} worksheets"
+
+worksheets.each do |worksheet|
+  puts "Reading: #{worksheet.name}"
+  num_rows = 0
+
+  worksheet.rows.each do |row|
+    row_cells = row
+    num_rows += 1
+
+    # uncomment to print out row values
+    # puts row_cells.join ' '
+  end
+  puts "Read #{num_rows} rows"
+end
+
+end_time = Time.now
+running_time = end_time - start_time
+puts "time: #{running_time} sec."
+
+puts 'Done'