rubyXL 1.1.4 → 1.1.5

data/README.rdoc

@@ -19,6 +19,9 @@
   workbook.worksheets[0] #returns first worksheet
   workbook[0] #returns first worksheet
 
+==== Accessing Only the Values
+  workbook.worksheets[0].extract_data #produces a 2d array which consists only of the values (instead of the Cell objects which include other variables)
+
 ==== Accessing a Row (Array of Cells)
   workbook[0].sheet_data[0] #returns first row in first worksheet
   workbook[0][0] #returns first row in first worksheet
@@ -60,7 +63,18 @@
   workbook[0].get_column_border_right(0) #returns weight of right border of first column (nil if none exists), other directions have the same syntax
 
 ==== Table identification
-  #get table
+  workbook[0].get_table(["NAME", "AGE", "HEIGHT"]) #returns hash of a table in the first worksheet, with the specified strings as headers, accessible by row and column
+  #it returns the following structure
+  {
+   :Name=>["John", "Jane", "Joe"], 
+   :Height=>[70, 65, 68], 
+   :Age=>[30, 25, 35]
+   :table=>[
+    {:Name=>"John", :Height=>70, :Age=>30},
+    {:Name=>"Jane", :Height=>65, :Age=>25}, 
+    {:Name=>"Joe", :Height=>68, :Age=>35}
+   ]
+  }
 
 === Modifying
 
@@ -73,6 +87,8 @@
  
   workbook.worksheets[0].add_cell_obj(Cell.new(1,0,'blah')) #sets A2 to 'blah'
 
+==== Changing Cells
+  workbook.worksheets[0][0][0].change_contents("", workbook.worksheets[0][0][0].formula) #sets A1 to empty string, preserves formula
 
 ==== Changing Fonts
   workbook.worksheets[0].sheet_data[0][0].change_font_bold(true) #sets A1 to bold
@@ -114,17 +130,44 @@ bottom, center, distributed, top
   workbook.worksheets[0].merge_cells(0,0,1,1) #merges A1:B2
 
 ==== Insert Row
-  #insert row
+This method will insert a row at specified index, pushing all rows below it down. It also copies styles from row above.
+
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted rows
+  workbook.worksheets[0].insert_row(1)
 
 ==== Insert Column
-  #insert column
+This method will insert a column at specified index, pushing all columns to the right of it one to the right. It also copies styles from column to the left
+
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted columns
+  workbook.worksheets[0].insert_column(1)
 
 ==== Delete Row
-  #delete row
+This method will delete a row at specified index, pushing all rows below it up.
+
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted rows
+  workbook.worksheets[0].delete_row(1)
 
 ==== Delete Column
-  #delete column
+This method will delete a column at specified index, pushing all columns to the right of it left.
+
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted columns
+ workbook.worksheets[0].delete_column(1)
+
+==== Insert Cell
+This method will insert a cell at specified position. It takes a :right or :down option, to shift cells either left or down upon inserting (nil means replacing the cell)
+
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted cells
+  workbook.worksheets[0].insert_cell(0,0,"blah",formula=nil,:right) #inserts cell at A1, shifts cells in first row right
+  workbook.worksheets[0].insert_cell(0,0,"blah",formula=nil,:down) #inserts cell at A1, shifts cells in first column down
+  workbook.worksheets[0].insert_cell(0,0,"blah") #inserts cell at A1, shifts nothing
+
+==== Delete Cell
+This method will delete a cell at specified position. It takes a :left or :up option, to shift cells either up or left upon deletion (nil means simply deleting the cell contents)
 
+WARNING: Use of this method WILL break formulas referencing cells which have been moved, as the formulas do not adapt to the shifted cells
+  workbook.worksheets[0].delete_cell(0,0,:left) #deletes A1, shifts contents of first row left
+  workbook.worksheets[0].delete_cell(0,0,:up) #deletes A1, shifts contents of first column up
+  workbook.worksheets[0].delete_cell(0,0) #deletes A1, does not shift cells
 
 === Writing
   workbook.write("path/to/desired/Excel/file.xlsx")

data/VERSION

@@ -1 +1 @@
-1.1.4
+1.1.5

data/lib/rubyXL.rb

@@ -1,10 +1,10 @@
 $: << File.expand_path(File.dirname(__FILE__))
-require File.expand_path(File.join(File.dirname(__FILE__),'workbook'))
-require File.expand_path(File.join(File.dirname(__FILE__), 'private_class'))
-require File.expand_path(File.join(File.dirname(__FILE__),'worksheet'))
-require File.expand_path(File.join(File.dirname(__FILE__),'cell'))
-require File.expand_path(File.join(File.dirname(__FILE__),'parser'))
-require File.expand_path(File.join(File.dirname(__FILE__),'color'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','workbook'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','private_class'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','worksheet'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','cell'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','parser'))
+require File.expand_path(File.join(File.dirname(__FILE__),'rubyXL','color'))
 
 module RubyXL
 end

data/lib/{parser.rb → rubyXL/parser.rb}

@@ -49,13 +49,13 @@ module RubyXL
             node << "<t xml:space=\"preserve\">#{text}</t>"
           end
         end
-        
 
-        shared_strings = files['sharedString'].css('si t').children
+        string_nodes = files['sharedString'].css('si t')
         wb.shared_strings = {}
-        shared_strings.each_with_index do |string,i|
-          wb.shared_strings[i] = string.to_s
-          wb.shared_strings[string.to_s] = i
+        string_nodes.each_with_index do |node,i|
+          string = node.children.to_s
+          wb.shared_strings[i] = string
+          wb.shared_strings[string] = i
         end
       end
 
@@ -77,7 +77,7 @@ module RubyXL
       #2. Fill in the matrix with data from worksheet/shared_string files
       #3. Apply styles
       wb.worksheets.each_index do |i|
-        Parser.fill_worksheet(wb,i,files,shared_strings)
+        Parser.fill_worksheet(wb,i,files,wb.shared_strings)
       end
 
       return wb
@@ -225,7 +225,7 @@ module RubyXL
             style_index = nil
 
             data_type = value.attribute('t').to_s
-            
+
             if (value.css('v').to_s == "") || (value.css('v').children.to_s == "") #no data
               cell_data = nil
             elsif data_type == 's' #shared string
@@ -239,7 +239,7 @@ module RubyXL
               data_type = ''
               if(value.css('v').children.to_s =~ /\./) #is float
                 cell_data = Float(value.css('v').children.to_s)
-              else           
+              else
                 cell_data = Integer(value.css('v').children.to_s)
               end
             end

data/lib/{workbook.rb → rubyXL/workbook.rb}

@@ -8,7 +8,7 @@ require File.expand_path(File.join(File.dirname(__FILE__),'writer','workbook_wri
 require File.expand_path(File.join(File.dirname(__FILE__),'writer','styles_writer'))
 require File.expand_path(File.join(File.dirname(__FILE__),'writer','shared_strings_writer'))
 require File.expand_path(File.join(File.dirname(__FILE__),'writer','worksheet_writer'))
-require 'zip'
+require 'rubyXL/zip'
 
 module RubyXL
   class Workbook

data/rubyXL.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rubyXL}
-  s.version = "1.1.4"
+  s.version = "1.1.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Vivek Bhagwat"]
-  s.date = %q{2011-08-12}
+  s.date = %q{2011-09-08}
   s.description = %q{rubyXL is a gem which allows the parsing, creation, and manipulation of Microsoft Excel (.xlsx/.xlsm) Documents}
   s.email = %q{bhagwat.vivek@gmail.com}
   s.extra_rdoc_files = [
@@ -24,26 +24,26 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "lib/.DS_Store",
-    "lib/Hash.rb",
-    "lib/cell.rb",
-    "lib/color.rb",
-    "lib/parser.rb",
-    "lib/private_class.rb",
     "lib/rubyXL.rb",
-    "lib/workbook.rb",
-    "lib/worksheet.rb",
-    "lib/writer/app_writer.rb",
-    "lib/writer/calc_chain_writer.rb",
-    "lib/writer/content_types_writer.rb",
-    "lib/writer/core_writer.rb",
-    "lib/writer/root_rels_writer.rb",
-    "lib/writer/shared_strings_writer.rb",
-    "lib/writer/styles_writer.rb",
-    "lib/writer/theme_writer.rb",
-    "lib/writer/workbook_rels_writer.rb",
-    "lib/writer/workbook_writer.rb",
-    "lib/writer/worksheet_writer.rb",
-    "lib/zip.rb",
+    "lib/rubyXL/Hash.rb",
+    "lib/rubyXL/cell.rb",
+    "lib/rubyXL/color.rb",
+    "lib/rubyXL/parser.rb",
+    "lib/rubyXL/private_class.rb",
+    "lib/rubyXL/workbook.rb",
+    "lib/rubyXL/worksheet.rb",
+    "lib/rubyXL/writer/app_writer.rb",
+    "lib/rubyXL/writer/calc_chain_writer.rb",
+    "lib/rubyXL/writer/content_types_writer.rb",
+    "lib/rubyXL/writer/core_writer.rb",
+    "lib/rubyXL/writer/root_rels_writer.rb",
+    "lib/rubyXL/writer/shared_strings_writer.rb",
+    "lib/rubyXL/writer/styles_writer.rb",
+    "lib/rubyXL/writer/theme_writer.rb",
+    "lib/rubyXL/writer/workbook_rels_writer.rb",
+    "lib/rubyXL/writer/workbook_writer.rb",
+    "lib/rubyXL/writer/worksheet_writer.rb",
+    "lib/rubyXL/zip.rb",
     "rubyXL.gemspec",
     "spec/lib/cell_spec.rb",
     "spec/lib/color_spec.rb",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rubyXL
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 1
   - 1
-  - 4
-  version: 1.1.4
+  - 5
+  version: 1.1.5
 platform: ruby
 authors: 
 - Vivek Bhagwat
@@ -15,11 +15,13 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-12 00:00:00 -04:00
+date: 2011-09-08 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: shoulda
   version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -29,11 +31,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: shoulda
   requirement: *id001
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: bundler
   version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -45,11 +47,11 @@ dependencies:
         - 0
         - 0
         version: 1.0.0
-  name: bundler
   requirement: *id002
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: jeweler
   version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -61,11 +63,11 @@ dependencies:
         - 6
         - 0
         version: 1.6.0
-  name: jeweler
   requirement: *id003
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: rcov
   version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -75,11 +77,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  name: rcov
   requirement: *id004
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: nokogiri
   version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -91,11 +93,11 @@ dependencies:
         - 4
         - 4
         version: 1.4.4
-  name: nokogiri
   requirement: *id005
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: rubyzip
   version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -107,11 +109,11 @@ dependencies:
         - 9
         - 4
         version: 0.9.4
-  name: rubyzip
   requirement: *id006
-  type: :development
 - !ruby/object:Gem::Dependency 
+  type: :development
   prerelease: false
+  name: rspec
   version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -123,9 +125,7 @@ dependencies:
         - 3
         - 4
         version: 1.3.4
-  name: rspec
   requirement: *id007
-  type: :development
 description: rubyXL is a gem which allows the parsing, creation, and manipulation of Microsoft Excel (.xlsx/.xlsm) Documents
 email: bhagwat.vivek@gmail.com
 executables: []
@@ -143,26 +143,26 @@ files:
 - Rakefile
 - VERSION
 - lib/.DS_Store
-- lib/Hash.rb
-- lib/cell.rb
-- lib/color.rb
-- lib/parser.rb
-- lib/private_class.rb
 - lib/rubyXL.rb
-- lib/workbook.rb
-- lib/worksheet.rb
-- lib/writer/app_writer.rb
-- lib/writer/calc_chain_writer.rb
-- lib/writer/content_types_writer.rb
-- lib/writer/core_writer.rb
-- lib/writer/root_rels_writer.rb
-- lib/writer/shared_strings_writer.rb
-- lib/writer/styles_writer.rb
-- lib/writer/theme_writer.rb
-- lib/writer/workbook_rels_writer.rb
-- lib/writer/workbook_writer.rb
-- lib/writer/worksheet_writer.rb
-- lib/zip.rb
+- lib/rubyXL/Hash.rb
+- lib/rubyXL/cell.rb
+- lib/rubyXL/color.rb
+- lib/rubyXL/parser.rb
+- lib/rubyXL/private_class.rb
+- lib/rubyXL/workbook.rb
+- lib/rubyXL/worksheet.rb
+- lib/rubyXL/writer/app_writer.rb
+- lib/rubyXL/writer/calc_chain_writer.rb
+- lib/rubyXL/writer/content_types_writer.rb
+- lib/rubyXL/writer/core_writer.rb
+- lib/rubyXL/writer/root_rels_writer.rb
+- lib/rubyXL/writer/shared_strings_writer.rb
+- lib/rubyXL/writer/styles_writer.rb
+- lib/rubyXL/writer/theme_writer.rb
+- lib/rubyXL/writer/workbook_rels_writer.rb
+- lib/rubyXL/writer/workbook_writer.rb
+- lib/rubyXL/writer/worksheet_writer.rb
+- lib/rubyXL/zip.rb
 - rubyXL.gemspec
 - spec/lib/cell_spec.rb
 - spec/lib/color_spec.rb