robust_excel_ole 1.26 → 1.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2553a7622f9092b5067ad3f7e945d57a1dbfa6e540716b326c6b684a351cf79
-  data.tar.gz: e623c4a2f3e22ef1da88b6475d7f6dc277c9f3f4581db27427fd9ca6aa400f24
+  metadata.gz: 304ee26bf15359eec5e54ac846203b60f3d7419e54779ced816182f76f6e9b46
+  data.tar.gz: 0ea8a4d763d10b286cd29610261b815ca51308cb364483935c5c396fa31e2c67
 SHA512:
-  metadata.gz: 9056cec7af1bf9c6c04ab2df83dd080bb63308f5c5a7d6af13286090d357441928d7dcb2dde2371940e36729fafb26460098d2063254f8809796a9dde87ddc85
-  data.tar.gz: d036c741ef593695e0fecfd8f1e34b1db5bec0e7e2430b5a88f1e16a297a804b1a9d95c8bc847bc993f0a1ea4b666cd56db200cc9cdfec38078dab6c5b4ef59b
+  metadata.gz: ae94a7357c87e0069e15e279a0eb420df939840192fc2e674f8e3c1890bebdaa7c49d37e0d8a888939f8009109fc7fabf0105e7b76f6b75f168431cb58d2e0e1
+  data.tar.gz: 450ebbad0840bd557c652cc2fa9027dee4a45114a6d3b8ea0065fd5120e9b916ad26ad63a1f97088bb148f1dc07cff7fd9cdf8c9b956e6a0ee2295be4434dec2

data/Changelog

@@ -1,6 +1,23 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## [1.31] 2021-14-01
+
+### Added
+  - Worksheet#table
+
+## [1.30] 2020-18-11
+
+## [1.29] 2020-05-11
+
+### Added
+  - Workbook.open can also take a Pathname object
+  - General#init_reo_for_win32ole
+
+## [1.28] 2020-23-10
+
+## [1.27] 2020-16-10
+
 ## [1.26] 2020-09-10
 
 ### Added

data/README.rdoc

@@ -320,7 +320,11 @@ For more details about reading and writing contents of cells and ranges see {REA
 
 === More features
 
-The ruby shell 'pry' allows, among other useful things, to change the value of 'self' in the console. For example,
+1. The method +General.change_current_binding+ allows to change the value of self within the current binding, while preserving the local variables, without starting another repl. Assume, +object+ shall be the self, then you would put
+
+  General.change_current_binding(object)
+
+Without this method, the ruby shell 'pry' allows to change the value of 'self' in the console as well, e.g. 
 
   object.pry
 
@@ -328,13 +332,16 @@ or
 
   cd object
 
-will set +object+ to self. However, this command also starts another pry repl (with another binding). Moreover, local variables in the previous binding are forgotten.
+However, this command also starts another pry repl (with another binding). Moreover, local variables in the previous binding are forgotten.
+
+
+2. The class Win32Ole is being extended such that RobustExcelOle methods can be applied to Win32Ole objects. As mentioned above, the RobustExcelOle objects are wrapper of corresponding WIN32OLE objects. So the RobustExcelOle objects and their wrapped Win32Ole objects are interchangeable. One example would be
 
-The method +General.change_current_binding+ allows to change the value of self within the current binding, while preserving the local variables, without starting another repl. 
+  range.ole_range.copy([4,3])
 
-  General.change_current_binding
+Likewise it is possible to convert ("type-lift") Win32Ole objects into the corresponding RobustExcelOle object, using the method +to_reo+. It is a refinement of the class WIN32OLE. So you can write
 
-You can convert some Win32Ole objects into a RobustExcelOle object.
+  using ToReoRefinement
 
   range = sheet.Names.Item("firstcell").to_reo
 

data/benchmarking/reo_example.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+require_relative '../lib/robust_excel_ole'
 
 start_time = Time.now 
 

data/benchmarking/reo_example1.rb

@@ -1,5 +1,5 @@
 #require 'robust_excel_ole'
-require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+require_relative '../lib/robust_excel_ole'
 
 start_time = Time.now 
 

data/benchmarking/reo_example2.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), '../lib/robust_excel_ole')
+require_relative '../lib/robust_excel_ole'
 
 start_time = Time.now 
 

data/bin/jreo

@@ -2,7 +2,7 @@
 # -*- jruby -*-
 
 require 'pry'
-require '../robust_excel_ole/lib/robust_excel_ole'
+require_relative '../lib/robust_excel_ole'
 
 include REO
 include General
@@ -15,10 +15,29 @@ Pry.config.prompt_name = "REO "
 #Pry.config.history_save = true
 #Pry.editor = 'notepad'  # 'subl', 'vi'
 
+prompt_proc1 = proc { |target_self, nest_level, pry|
+   "[#{pry.input_ring.count}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
+ }
+
+prompt_proc2 =  proc { |target_self, nest_level, pry|
+  "[#{pry.input_ring.count}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self.inspect.gsub(/\"/, ''))})})#{":#{nest_level}" unless nest_level.zero?}* "
+ }
+
+Pry.config.prompt = if RUBY_PLATFORM =~ /java/
+  [prompt_proc1, prompt_proc2]
+else
+  Pry::Prompt.new(
+    "REO",
+    "The RobustExcelOle Prompt. Besides the standard information it puts the current object",
+    [prompt_proc1, prompt_proc2]
+    )
+end
+
 hooks = Pry::Hooks.new
 
 hooks.add_hook :when_started, :hook12 do
 puts 'REO console started'
 puts
 end
+
 Pry.start(nil, hooks: hooks)

data/bin/reo

@@ -2,7 +2,7 @@
 # -*- ruby -*-
 
 require 'pry'
-require '../robust_excel_ole/lib/robust_excel_ole'
+require_relative '../lib/robust_excel_ole'
 
 include REO
 include General
@@ -15,10 +15,29 @@ Pry.config.prompt_name = "REO "
 #Pry.config.history_save = true
 #Pry.editor = 'notepad'  # 'subl', 'vi'
 
+prompt_proc1 = proc { |target_self, nest_level, pry|
+  "[#{pry.input_ring.count}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
+ }
+
+prompt_proc2 =  proc { |target_self, nest_level, pry|
+  "[#{pry.input_ring.count}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}* "
+ }
+
+Pry.config.prompt = if RUBY_PLATFORM =~ /java/
+  [prompt_proc1, prompt_proc2]
+else
+  Pry::Prompt.new(
+    "REO",
+    "The RobustExcelOle Prompt. Besides the standard information it puts the current object",
+    [prompt_proc1, prompt_proc2]
+    )
+end
+
 hooks = Pry::Hooks.new
 
 hooks.add_hook :when_started, :hook12 do
 puts 'REO console started'
 puts
 end
+
 Pry.start(nil, hooks: hooks)

data/docs/README_open.rdoc

@@ -17,6 +17,11 @@ The semantics is similar to, e.g.,  +File.open+.
     # do something
   end
 
+You can provide the filename as a string (as above) or as Pathname object.
+
+  pathname = Pathname('spec/data/workbook.xls')
+  workbook = Workbook.open(pathname)
+
 The options are the following:
 
 +:default+:: if the workbook was already open, then use the properties of this workbook.otherwise use the properties stated in +:default+
@@ -195,12 +200,11 @@ The method +unobtrusively+ enables the user to read or modify a workbook, no mat
 
 Options are the following:
 
-+:if_closed+:: the Excel instance in which to open the workbook, if it was closed (default: +:current+). (Note: this option works workbooks opened via RobustExcelOle only.)
-
 +:read_only+:: Whether the workbook shall be forced to be open in ReadOnly mode
-+:writable+::  Whether changes in the workbook shall be saved
-
++:writable+::  Whether changes in the workbook shall be saved and the workbook shall be opened in ReadOnly mode by default (i.e., when the workbook was not open before) (default: true)
 +:keep_open+:: Whether the workbook shall be open after unobtrusively opening (default: false)
++:if_closed+:: the Excel instance in which to open the workbook, if it was closed (default: +:current+). 
+(Note: this option works workbooks opened via RobustExcelOle only.)
 
 There are the class method and the instance method of +unobtrusively+. Here is an example of the class method:
 

data/docs/README_sheet.rdoc

@@ -92,17 +92,11 @@ The methods Worksheet#each, Worksheet#each_row and Worksheet#each_column enable
     # do something with column
   end
 
-The method Worksheet#values yields all cell values of the used range of the worksheet into a 2-dimensional array. For example:
+The method Worksheet#values yields a 2-dimensional array that contains the values in each row, e.g.
 
   worksheet.values
   => [["foo", "workbook", "sheet1"], ["foo", nil, "foobaaa"], ["matz", "is", "nice"]]
 
-The method Worksheet#each_rowvalue enables to access the values of each row.
-
-  worksheet.each_rowvalue do |row_values|
-    # do something with the row_values
-  end
-
 You access a range of a row by giving the number of the row, and optionally, the range of the cell numbers.
 
   worksheet.row_range(1)  # => first row

data/examples/introductory_examples/example_open.rb

@@ -18,7 +18,18 @@ puts "open a workbook"
 book = Workbook.open(simple_file) 
 puts "make it visible"
 book.visible = true
+
+ole_workbook = book.ole_workbook
+puts "ole_workbook: #{ole_workbook}"
+sheet = ole_workbook.sheet(1)
+puts "sheet: #{sheet}"
+
+using ToReoRefinement
 puts "book: #{book}"
+ole_workbook = book.ole_workbook
+puts "ole_workbook: #{ole_workbook.inspect}"
+upliftet_ole_workbook = ole_workbook.to_reo
+puts "upliftet_ole_workbook: #{upliftet_ole_workbook.inspect}"
 # open a workbook in a new Excel instance
 puts "open the workbook in a new Excel instance and make it visible"
 book2 = Workbook.open(another_simple_file, :default => {:excel => :new}, :visible => true)

data/lib/robust_excel_ole.rb

@@ -1,22 +1,25 @@
+# -*- coding: utf-8 -*-
+
 if RUBY_PLATFORM =~ /java/
   require 'jruby-win32ole'
 else
   require 'win32ole'
 end
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/base')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/general')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/vba_objects')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/range_owners')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/address_tool')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/excel')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/bookstore')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/workbook')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/worksheet')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/cell')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/range')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/list_object')
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/cygwin') if RUBY_PLATFORM =~ /cygwin/
-require File.join(File.dirname(__FILE__), 'robust_excel_ole/version')
 
-#include RobustExcelOle
-include General
+require_relative 'robust_excel_ole/general'
+require_relative 'robust_excel_ole/base'
+require_relative 'robust_excel_ole/vba_objects'
+require_relative 'robust_excel_ole/range_owners'
+require_relative 'robust_excel_ole/address_tool'
+require_relative 'robust_excel_ole/excel'
+require_relative 'robust_excel_ole/bookstore'
+require_relative 'robust_excel_ole/workbook'
+require_relative 'robust_excel_ole/worksheet'
+require_relative 'robust_excel_ole/cell'
+require_relative 'robust_excel_ole/range'
+require_relative 'robust_excel_ole/list_row'
+require_relative 'robust_excel_ole/list_object'
+require_relative 'robust_excel_ole/cygwin' if RUBY_PLATFORM =~ /cygwin/
+require_relative 'robust_excel_ole/version'
+
+General.init_reo_for_win32ole

data/lib/robust_excel_ole/base.rb

@@ -65,6 +65,8 @@ module RobustExcelOle
 
   class Base
 
+    include General
+
     # @private
     def own_methods
       (self.methods - Object.methods).sort
@@ -110,3 +112,6 @@ module RobustExcelOle
   end
 
 end
+
+REO = RobustExcelOle
+

data/lib/robust_excel_ole/bookstore.rb

@@ -4,7 +4,7 @@ module RobustExcelOle
 
   # @private
   class Bookstore < Base
-    
+
     def initialize
       @filename2books ||= Hash.new { |hash, key| hash[key] = [] }
       @hidden_excel_instance = nil

data/lib/robust_excel_ole/cell.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 
-require File.join(File.dirname(__FILE__), './range')
+require_relative 'range'
 
 module RobustExcelOle
 

data/lib/robust_excel_ole/cygwin.rb

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+
 module RobustExcelOle
   module Cygwin
     require 'Win32API'

data/lib/robust_excel_ole/excel.rb

@@ -15,6 +15,7 @@ module RobustExcelOle
   # See https://docs.microsoft.com/en-us/office/vba/api/excel.application(object)#methods
 
   class Excel < VbaObjects
+
     attr_reader :ole_excel
     attr_reader :properties
     attr_reader :address_tool
@@ -370,7 +371,7 @@ module RobustExcelOle
       number = 0
       WIN32OLE.connect('winmgmts:\\\\.').InstancesOf('win32_process').each do |p|
         begin
-          if p.name == 'EXCEL.EXE'
+          if p.Name == 'EXCEL.EXE'
             Process.kill('KILL', p.processid)
             number += 1
           end
@@ -384,7 +385,7 @@ module RobustExcelOle
 
     def self.excels_number
       processes = WIN32OLE.connect('winmgmts:\\\\.').InstancesOf('win32_process')
-      processes.select { |p| p.name == 'EXCEL.EXE' }.size
+      processes.select { |p| p.Name == 'EXCEL.EXE' }.size
     end
 
     def self.known_excels_number
@@ -417,7 +418,7 @@ module RobustExcelOle
           result.Visible # send any method, just to see if it responds
         rescue
           trace 'dead excel ' + (begin
-                                 "Window-handle = #{result.HWnd}"
+                                 "Window-handle = #{result.Hwnd}"
                                  rescue
                                  'without window handle'
                                  end)
@@ -471,13 +472,13 @@ module RobustExcelOle
         pid2excel[pid] = excel
       end
       processes = WIN32OLE.connect('winmgmts:\\\\.').InstancesOf('win32_process')
-      processes.select { |p| Excel.new(pid2excel[p.processid]) if p.name == 'EXCEL.EXE' && pid2excel.include?(p.processid) }
+      processes.select { |p| Excel.new(pid2excel[p.ProcessId]) if p.Name == 'EXCEL.EXE' && pid2excel.include?(p.ProcessId) }
       result = []
       processes.each do |p|
-        next unless p.name == 'EXCEL.EXE'
+        next unless p.Name == 'EXCEL.EXE'
 
-        if pid2excel.include?(p.processid)
-          excel = pid2excel[p.processid]
+        if pid2excel.include?(p.ProcessId)
+          excel = pid2excel[p.ProcessId]
           result << excel
         end
         # how to connect to an (interactively opened) Excel instance and get a WIN32OLE object?
@@ -684,21 +685,7 @@ module RobustExcelOle
       # Win32API.new("user32","SetForegroundWindow","","I").call
       # end
     end
-
-    # returns the value of a range
-    # @param [String] name the name of a range
-    # @returns [Variant] the value of the range
-    def [] name
-      namevalue_glob(name)
-    end
-
-    # sets the value of a range
-    # @param [String]  name  the name of the range
-    # @param [Variant] value the contents of the range
-    def []=(name, value)
-      set_namevalue_glob(name, value)
-    end
-
+    
     # @private
     # returns active workbook
     def workbook
@@ -717,6 +704,9 @@ module RobustExcelOle
       to_s
     end
 
+    using ParentRefinement
+    using StringRefinement
+
     # @private
     def self.workbook_class  
       @workbook_class ||= begin

data/lib/robust_excel_ole/general.rb

@@ -1,78 +1,163 @@
 # -*- coding: utf-8 -*-
+require 'pathname'
 
-module General
+# @private
+#class WIN32OLE
+module ToReoRefinement
 
-  IS_JRUBY_PLATFORM = (RUBY_PLATFORM =~ /java/)
-  ::EXPANDPATH_JRUBY_BUG   = IS_JRUBY_PLATFORM && true
-  ::CONNECT_JRUBY_BUG      = IS_JRUBY_PLATFORM && true
-  ::COPYSHEETS_JRUBY_BUG   = IS_JRUBY_PLATFORM && true
-  ::ERRORMESSAGE_JRUBY_BUG = IS_JRUBY_PLATFORM && true
-  ::CONNECT_EXCEL_JRUBY_BUG      = IS_JRUBY_PLATFORM && true
-  ::RANGES_JRUBY_BUG       = IS_JRUBY_PLATFORM && true
-
-  @private
-  NetworkDrive = Struct.new(:drive_letter, :network_name) do
+  refine WIN32OLE do
 
-    def self.get_all(drives)
-      ndrives = []
-      count = drives.Count
-      (0..(count - 1)).step(2) do |i|
-        ndrives << NetworkDrive.new( drives.Item(i), drives.Item(i + 1).tr('\\','/'))
+    # type-lifting WIN32OLE objects to RobustExcelOle objects
+    def to_reo
+      General.class2method.each do |element|
+        classname = element.first.first
+        method = element.first.last
+        begin
+          self.send(method)
+          if classname == RobustExcelOle::Range && self.Rows.Count == 1 && self.Columns.Count == 1
+            return Cell.new(self, self.Parent)
+          else
+            return classname.new(self)
+          end
+        rescue
+          next
+        end
       end
-      ndrives
+      raise TypeREOError, "given object cannot be type-lifted to a RobustExcelOle object"
     end
 
   end
 
-  @private
-  def hostnameshare2networkpath(filename)
-    return filename unless filename[0,2] == "//"
-    network = WIN32OLE.new('WScript.Network')
-    drives = network.enumnetworkdrives
-    network_drives = NetworkDrive.get_all(drives)
-    f_c = filename.dup
-    network_drive = network_drives.find do |d| 
-      e = f_c.sub!(d.network_name,d.drive_letter)
-      return e if e
-    end    
-    filename 
-  end  
+end
 
-  # @private
-  def absolute_path(file)    
-    return file if file[0,2] == "//" 
-    file[0,2] = './' if ::EXPANDPATH_JRUBY_BUG && file  =~ /[A-Z]:[^\/]/
-    file = File.expand_path(file)
-    file = RobustExcelOle::Cygwin.cygpath('-w', file) if RUBY_PLATFORM =~ /cygwin/
-    WIN32OLE.new('Scripting.FileSystemObject').GetAbsolutePathName(file) #.tr('/','\\')
-  end
+# @private
+class WIN32OLE
 
-  # @private
-  def canonize(filename)
-    raise TypeREOError, "No string given to canonize, but #{filename.inspect}" unless filename.is_a?(String)
-    filename = hostnameshare2networkpath(filename)
-    normalize(filename) if filename
-  end
+  include Enumerable
 
-  # @private
-  def normalize(path)  
-    return unless path    
-    path = path.gsub('/./', '/') + '/'
-    path = path.gsub(/[\/\\]+/, '/')
-    nil while path.gsub!(/(\/|^)(?!\.\.?)([^\/]+)\/\.\.\//, '\1')
-    path = path.chomp('/')
-    path
-  end
+end
+
+# @private
+module FindAllIndicesRefinement
+
+  refine Array do
+
+    def find_all_indices elem
+      found, index, result = -1, -1, []
+      while found
+        found = self[index+1..-1].index(elem)
+        if found
+          index = index + found + 1
+          result << index
+        end
+      end
+      result
+    end
 
-  def change_current_binding(current_object)
-    Pry.change_current_binding(current_object)
   end
 
-  module_function :absolute_path, :canonize, :normalize, :change_current_binding
+end
+
+# @private
+module StringRefinement
+
+  refine String do
+
+    def / path_part
+      if empty?
+        path_part
+      else
+        if path_part.nil? || path_part.empty?
+          self
+        else
+          begin
+            path_part = path_part.strip
+            (path_part  =~ /^(\/|([A-Z]:\/))/i) ? path_part : (self.chomp('/') + '/' + path_part)
+          rescue TypeError
+            raise TypeError, "Only strings can be parts of paths (given: #{path_part.inspect} of class #{path_part.class})"
+          end
+        end
+      end
+    end
+
+    def replace_umlauts
+      word = self.force_encoding('iso-8859-1').encode('utf-8')
+      #word = self.encode("UTF-8")
+      #word = self.encode("UTF-8", "Windows-1252")    
+      word.gsub('ä','ae').gsub('Ä','Ae').gsub('ö','oe').gsub('Ö','Oe').gsub('ü','ue').gsub('Ü','Ue')
+      word.gsub('ß','ss').gsub('²','2').gsub('³','3')      
+      #word.gsub("\x84",'ae').gsub("\x8E",'Ae').gsub("\x94",'oe').gsub("\x99",'Oe').gsub("\x81",'ue').gsub("\x9A",'Ue')
+      #word.gsub("\xE1",'ss').gsub("\xFD",'2').gsub("\xFC",'3')
+      word
+    end
+
+    # taken from http://apidock.com/rails/ActiveSupport/Inflector/underscore
+    def underscore
+      word = gsub('::', '/')
+      word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
+      word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+      word.tr!('-', '_')
+      word.downcase!
+      word
+    end
 
+    # taken from http://apidock.com/rails/ActiveSupport/Inflector/constantize
+    # File activesupport/lib/active_support/inflector/methods.rb, line 226
+    def constantize # (camel_cased_word)
+      names = split('::')
+
+      # Trigger a builtin NameError exception including the ill-formed constant in the message.
+      Object.const_get(self) if names.empty?
+
+      # Remove the first blank element in case of '::ClassName' notation.
+      names.shift if names.size > 1 && names.first.empty?
+
+      names.inject(Object) do |constant, name|
+        if constant == Object
+          constant.const_get(name)
+        else
+          candidate = constant.const_get(name)
+          next candidate if constant.const_defined?(name)
+          next candidate unless Object.const_defined?(name)
+
+          # Go down the ancestors to check it it's owned
+          # directly before we reach Object or the end of ancestors.
+          constant = constant.ancestors.inject do |const, ancestor|
+            break const    if ancestor == Object
+            break ancestor if ancestor.const_defined?(name)
+
+            const
+          end
+
+          # owner is in Object, so raise
+          constant.const_get(name)
+        end
+      end
+    end
+  end
 end
 
 # @private
+module ParentRefinement
+
+  using StringRefinement
+
+  # taken from http://api.rubyonrails.org/v2.3.8/classes/ActiveSupport/CoreExtensions/Module.html#M000806
+  refine Module do
+
+    def parent_name
+      unless defined? @parent_name
+        @parent_name = name =~ /::[^:]+\Z/ ? $`.freeze : nil
+      end
+      @parent_name
+    end
+
+    def parent
+      parent_name ? parent_name.constantize : Object
+    end
+  end
+end
+
 class Integer
 
   alias old_spaceship <=>
@@ -102,183 +187,164 @@ class Array
     end
   end
 
-  def find_each_index find
-    found, index, q = -1, -1, []
-    while found
-      found = self[index+1..-1].index(find)
-      if found
-        index = index + found + 1
-        q << index
-      end
-    end
-    q
-  end
 end
 
-# @private
-class WIN32OLE
 
-  include Enumerable
-  
-  # type-lifting WIN32OLE objects to RobustExcelOle objects
-  def to_reo
-    class2method = [
-      {Excel => :Hwnd},
-      {Workbook => :FullName},
-      {Worksheet => :UsedRange},
-      {RobustExcelOle::Range => :Row},
-      {ListObject => :ListRows}
-    ]
-    class2method.each do |element|
-      classname = element.first.first
-      method = element.first.last
-      begin
-        self.send(method)
-        if classname == RobustExcelOle::Range && self.Rows.Count == 1 && self.Columns.Count == 1
-          return Cell.new(self, self.Parent)
-        else
-          return classname.new(self)
-        end
-      rescue
-        next
+module General
+
+  using ToReoRefinement
+
+  IS_JRUBY_PLATFORM = (RUBY_PLATFORM =~ /java/)
+  ::EXPANDPATH_JRUBY_BUG    = IS_JRUBY_PLATFORM && true
+  ::CONNECT_JRUBY_BUG       = IS_JRUBY_PLATFORM && true
+  ::COPYSHEETS_JRUBY_BUG    = IS_JRUBY_PLATFORM && true
+  ::ERRORMESSAGE_JRUBY_BUG  = IS_JRUBY_PLATFORM && true
+  ::CONNECT_EXCEL_JRUBY_BUG = IS_JRUBY_PLATFORM && true
+  ::RANGES_JRUBY_BUG        = IS_JRUBY_PLATFORM && true
+
+  # @private
+  NetworkDrive = Struct.new(:drive_letter, :network_name) do
+
+    def self.get_all_drives
+      network = WIN32OLE.new('WScript.Network')
+      drives = network.enumnetworkdrives
+      ndrives = []
+      count = drives.Count
+      (0..(count - 1)).step(2) do |i|
+        ndrives << NetworkDrive.new( drives.Item(i), drives.Item(i + 1).tr('\\','/'))
       end
+      ndrives
     end
-    raise TypeREOError, "given object cannot be type-lifted to a RobustExcelOle object"
   end
 
-=begin
-  def to_reo
-    case ole_type.name
-    when 'Range' then RobustExcelOle::Range.new(self)
-    when '_Worksheet' then RobustExcelOle::Worksheet.new(self)
-    when '_Workbook' then RobustExcelOle::Workbook.new(self)
-    when '_Application' then RobustExcelOle::Excel.new(self)
-    else
-      self
-    end
-  end
-=end
-
-=begin
-  alias method_missing_before_implicit_typelift method_missing 
-  
-  def method_missing(name, *args, &blk)
-    puts "method_missing:"
-    puts "name: #{name.inspect}"
-    #raise NoMethodError if name.to_s == "Hwnd" or name.to_s == "FullName" or name.to_s == "UsedRange" or name.to_s == "Row" or name.to_s == "ListRows"
-    begin
-      reo_obj = self.to_reo
-      puts "reo_obj: #{reo_obj.inspect}"
-    rescue
-      puts "$!.message: #{$!.message}"
-      method_missing_before_implicit_typelift(name, *args, &blk)
-    end
-    reo_obj.send(name, *args, &blk)
+  # @private
+  def hostnameshare2networkpath(filename)
+    return filename unless filename[0,2] == "//"
+    NetworkDrive.get_all_drives.inject(filename) do |fn_modified, d| 
+      fn_modified.sub(/#{(Regexp.escape(d.network_name))}/i,d.drive_letter)
+    end    
+  end  
+
+  # @private
+  def absolute_path(file)
+    file = file.to_path if file.respond_to?(:to_path)
+    return file if file[0,2] == "//" 
+    file[0,2] = './' if ::EXPANDPATH_JRUBY_BUG && file  =~ /[A-Z]:[^\/]/
+    file = File.expand_path(file)
+    file = RobustExcelOle::Cygwin.cygpath('-w', file) if RUBY_PLATFORM =~ /cygwin/
+    WIN32OLE.new('Scripting.FileSystemObject').GetAbsolutePathName(file) #.tr('/','\\')
   end
-=end
 
-end
+  # @private
+  def canonize(filename)
+    raise TypeREOError, "No string given to canonize, but #{filename.inspect}" unless filename.is_a?(String)
+    filename = hostnameshare2networkpath(filename)
+    normalize(filename) if filename
+  end
 
-# @private
-class ::String 
-  def / path_part
-    if empty?
-      path_part
-    else
-      if path_part.nil? || path_part.empty?
-        self
-      else
-        begin
-          File.join self, path_part
-        rescue TypeError
-          raise TypeError, "Only strings can be parts of paths (given: #{path_part.inspect} of class #{path_part.class})"
-        end
-      end
-    end
+  # @private
+  def normalize(path)  
+    return unless path    
+    path = path.gsub('/./', '/') + '/'
+    path = path.gsub(/[\/\\]+/, '/')
+    nil while path.gsub!(/(\/|^)(?!\.\.?)([^\/]+)\/\.\.\//, '\1')
+    path = path.chomp('/')
+    path
   end
 
-  # taken from http://apidock.com/rails/ActiveSupport/Inflector/underscore
-  def underscore
-    word = gsub('::', '/')
-    word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
-    word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
-    word.tr!('-', '_')
-    word.downcase!
-    word
+  # @private
+  def change_current_binding(current_object)
+    Pry.change_current_binding(current_object)
   end
 
-  def delete_multiple_underscores
-    word = self
-    while word.index('__') do
-      word.gsub!('__','_')
-    end    
-    word
+  # @private
+  def class2method
+    [{RobustExcelOle::Excel => :Hwnd},
+     {RobustExcelOle::Workbook => :FullName},
+     {RobustExcelOle::Worksheet => :UsedRange},
+     {RobustExcelOle::Range => :Row},
+     {RobustExcelOle::ListObject => :ListRows}]
   end
 
-  def replace_umlauts
-    word = self
-    word.gsub!('ä','ae')
-    word.gsub!('Ä','Ae')
-    word.gsub!('ö','oe')
-    word.gsub!('Ö','Oe')
-    word.gsub!('ü','ue')
-    word.gsub!('Ü','Ue')
-    #word.gsub!(/\x84/,'ae')
-    #word.gsub!(/\x8E/,'Ae')
-    #word.gsub!(/\x94/,'oe')
-    #word.gsub!(/\x99/,'Oe')
-    #word.gsub!(/\x81/,'ue')
-    #word.gsub!(/\x9A/,'Ue')
-    word
+  # @private
+  # enable RobustExcelOle methods to Win32Ole objects
+  def init_reo_for_win32ole
+    class2method.each do |element|
+      classname = element.first.first
+      meths = (classname.instance_methods(false) - WIN32OLE.instance_methods(false) - Object.methods - Enumerable.instance_methods(false) - [:Calculation=])
+      meths.each do |inst_method|
+        WIN32OLE.send(:define_method, inst_method) do |*args, &blk|  
+          self.to_reo.send(inst_method, *args, &blk) 
+        end
+      end
+    end
+    nil
   end
 
-  # taken from http://apidock.com/rails/ActiveSupport/Inflector/constantize
-  # File activesupport/lib/active_support/inflector/methods.rb, line 226
-  def constantize # (camel_cased_word)
-    names = split('::')
+  module_function :absolute_path, :canonize, :normalize, :change_current_binding, :class2method, 
+                  :init_reo_for_win32ole, :hostnameshare2networkpath, :test
 
-    # Trigger a builtin NameError exception including the ill-formed constant in the message.
-    Object.const_get(self) if names.empty?
+end
 
-    # Remove the first blank element in case of '::ClassName' notation.
-    names.shift if names.size > 1 && names.first.empty?
 
-    names.inject(Object) do |constant, name|
-      if constant == Object
-        constant.const_get(name)
-      else
-        candidate = constant.const_get(name)
-        next candidate if constant.const_defined?(name)
-        next candidate unless Object.const_defined?(name)
+# @private
+class Pry
 
-        # Go down the ancestors to check it it's owned
-        # directly before we reach Object or the end of ancestors.
-        constant = constant.ancestors.inject do |const, ancestor|
-          break const    if ancestor == Object
-          break ancestor if ancestor.const_defined?(name)
+  # change the current binding such that self is the current object in the pry-instance, 
+  # preserve the local variables
 
-          const
-        end
+  class << self
+    attr_accessor :pry_instance
+  end
 
-        # owner is in Object, so raise
-        constant.const_get(name)
-      end
+  def self.change_current_binding(current_object)
+    pry_instance = self.pry_instance
+    old_binding = pry_instance.binding_stack.pop
+    pry_instance.push_binding(current_object.__binding__)
+    exclude_vars = [:__, :_, :_dir, :_dir_, :_file, :_file_, :_in_, :_out_, :_ex, :_ex_, :pry_instance]
+    old_binding.local_variables.each do |var|
+      pry_instance.add_sticky_local(var) {old_binding.local_variable_get(var)} unless exclude_vars.include?(var)
     end
+    self.pry_instance = pry_instance
+    nil
   end
-end
 
-# taken from http://api.rubyonrails.org/v2.3.8/classes/ActiveSupport/CoreExtensions/Module.html#M000806
-# @private
-class Module
-  def parent_name
-    unless defined? @parent_name
-      @parent_name = name =~ /::[^:]+\Z/ ? $`.freeze : nil
-    end
-    @parent_name
+  def push_initial_binding(target = nil)
+    # memorize the current pry instance
+    self.class.pry_instance = self 
+    push_binding(target || Pry.toplevel_binding)
   end
 
-  def parent
-    parent_name ? parent_name.constantize : Object
+  class REPL
+
+    def read
+      @indent.reset if pry.eval_string.empty?
+      current_prompt = pry.select_prompt
+      indentation = pry.config.auto_indent ? @indent.current_prefix : ''
+      val = read_line("#{current_prompt}#{indentation}")
+      # Return nil for EOF, :no_more_input for error, or :control_c for <Ctrl-C>
+      return val unless val.is_a?(String)
+      if pry.config.auto_indent
+        original_val = "#{indentation}#{val}"
+        indented_val = @indent.indent(val)
+
+        if output.tty? &&
+           pry.config.correct_indent &&
+           Pry::Helpers::BaseHelpers.use_ansi_codes?
+          # avoid repeating read line
+
+          #output.print @indent.correct_indentation(
+          #  current_prompt,
+          #  indented_val,
+          #  calculate_overhang(current_prompt, original_val, indented_val)
+          #)
+          output.flush
+        end
+      else
+        indented_val = val
+      end
+      indented_val
+    end
   end
 end
 
@@ -302,5 +368,3 @@ module MethodHelpers
     end
   end
 end
-
-REO = RobustExcelOle