surpass 0.0.3

data/README.txt

@@ -0,0 +1,133 @@
+surpass
+    by Ana Nelson, based on original Python code by Roman V. Kiseliov
+    http://launchpad.net/surpass
+
+== DESCRIPTION:
+
+Surpass is writing (and eventually reading) excel workbooks in pure Ruby. Surpass is based on xlwt (and pyExcelerator).
+
+== REQUIREMENTS:
+
+Ruby 1.8.6 (C or JRuby)
+
+== INSTALL:
+
+bones installation:
+sudo rake gem:install
+
+== Documentation
+
+See surpass-manual.pdf
+
+== LICENSE:
+
+Portions Copyright (c) 2008-9, Ana Nelson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+
+Surpass is a Ruby port of Python projects xlwt and pyExcelerator, whose
+licenses are below.
+
+
+
+Portions copyright © 2007, Stephen John Machin, Lingfo Pty Ltd
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer. 
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution. 
+
+3. None of the names of Stephen John Machin, Lingfo Pty Ltd and any
+contributors may be used to endorse or promote products derived from this
+software without specific prior written permission. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Copyright (C) 2005 Roman V. Kiseliov
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+
+3. All advertising materials mentioning features or use of this
+ software must display the following acknowledgment:
+ "This product includes software developed by
+  Roman V. Kiseliov <roman@kiseliov.ru>."
+
+4. Redistributions of any form whatsoever must retain the following
+ acknowledgment:
+ "This product includes software developed by
+  Roman V. Kiseliov <roman@kiseliov.ru>."
+
+THIS SOFTWARE IS PROVIDED BY Roman V. Kiseliov ``AS IS'' AND ANY
+EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL Roman V. Kiseliov OR
+ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Roman V. Kiseliov
+Russia
+Kursk
+Libknecht St., 4
+
++7(0712)56-09-83
+
+<roman@kiseliov.ru>
+Subject: pyExcelerator

data/Rakefile

@@ -0,0 +1,35 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  begin
+    load 'tasks/setup.rb'
+  rescue LoadError
+    raise RuntimeError, '### please install the "bones" gem ###'
+  end
+end
+
+ensure_in_path 'lib'
+require 'surpass'
+
+task :default => 'spec:run'
+
+PROJ.name = 'surpass'
+PROJ.authors = 'Ana Nelson'
+PROJ.email = 'ana@ananelson.com'
+PROJ.url = 'https://surpass.rubyforge.org'
+PROJ.version = Surpass::VERSION
+PROJ.rubyforge.name = 'surpass'
+
+PROJ.ignore_file = '.bzrignore'
+
+PROJ.spec.opts << '--color'
+
+PROJ.exclude = %w{.bzr webby}
+
+
+PROJ.rdoc.format = 'darkfish'

data/examples/big-16mb.rb

@@ -0,0 +1,25 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+s = book.add_sheet('0')
+
+colcount = 200 + 1
+rowcount = 6000 + 1
+
+start = Time.now
+puts "starting at #{start.to_s}"
+
+colcount.times do |c|
+  rowcount.times do |r|
+    s.write(r, c, "BIG")
+  end
+end
+
+t = Time.now - start
+puts "time elapsed (writing data to workbook) #{t.to_s}"
+
+book.save(__FILE__.gsub(/rb$/, "xls"))
+
+t = Time.now - start
+puts "time elapsed (writing workbook to file) #{t.to_s}"

data/examples/big-random-strings.rb

@@ -0,0 +1,28 @@
+require "rubygems"
+require "surpass"
+
+strings = File.read("spec/data/random-strings.txt").split("\n")
+
+book = Workbook.new
+s = book.add_sheet('0')
+
+colcount = 100 + 1
+rowcount = 100 + 1
+
+start = Time.now
+puts "starting at #{start.to_s}"
+
+colcount.times do |c|
+  rowcount.times do |r|
+    i = c * rowcount + r
+    s.write(r, c, strings[i])
+  end
+end
+
+t = Time.now - start
+puts "time elapsed (writing data to workbook) #{t.to_s}"
+
+book.save(__FILE__.gsub(/rb$/, "xls"))
+
+t = Time.now - start
+puts "time elapsed (writing workbook to file) #{t.to_s}"

data/examples/blanks.rb

@@ -0,0 +1,34 @@
+require "rubygems"
+require "surpass"
+
+font0 = Font.new
+font0.name = 'Times New Roman'
+font0.struck_out = true
+font0.bold = true
+
+style0 = StyleFormat.new
+style0.font = font0
+
+
+book = Workbook.new
+ws0 = book.add_sheet('0')
+
+ws0.write(1, 1, 'Test', style0)
+
+0.upto(0x53) do |i|
+    borders = Borders.new
+    borders.left = i
+    borders.right = i
+    borders.top = i
+    borders.bottom = i
+
+    style = StyleFormat.new
+    style.borders = borders
+
+    ws0.write(i, 2, '', style)
+    ws0.write(i, 3, hex(i), style0)
+end
+
+ws0.write_merge(5, 8, 6, 10, "")
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/col_width.rb

@@ -0,0 +1,16 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws = book.add_sheet('Hey, Dude')
+
+(6...80).each do |i|
+    fnt = Font.new
+    fnt.height = i*20
+    style = StyleFormat.new
+    style.font = fnt
+    ws.write(1, i, 'Test')
+    ws.set_column_width(i, i)
+end
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/dates.rb

@@ -0,0 +1,31 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws = book.add_sheet('Hey, Dude')
+
+formats = [
+    'M/D/YY',
+    'D-MMM-YY',
+    'D-MMM',
+    'MMM-YY',
+    'h:mm AM/PM',
+    'h:mm:ss AM/PM',
+    'h:mm',
+    'h:mm:ss',
+    'M/D/YY h:mm',
+    'mm:ss',
+    '[h]:mm:ss',
+    'mm:ss.0',
+]
+
+formats.each_with_index do |f, i|
+  ws.write(i, 0, f)
+  
+  style = StyleFormat.new
+  style.number_format_string = f
+  
+  ws.write(i, 4, Time.now, style)
+end
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/format.rb

@@ -0,0 +1,23 @@
+require "rubygems"
+require "surpass"
+
+style0 = StyleFormat.new(:font_name => 'Times New Roman', :font_struck_out => true, :font_bold => true)
+
+book = Workbook.new
+ws0 = book.add_sheet('0')
+
+ws0.write(1, 1, 'Test', style0)
+
+(0...0x53).each do |i|
+  style = StyleFormat.new(:font_name => 'Arial', :font_color_index => i, :font_outline => true)
+
+  borders = Borders.new
+  borders.left = i
+
+  style.borders = borders
+
+  ws0.write(i, 2, 'colour', style)
+  ws0.write(i, 3, hex(i), style0)
+end
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/hello-world.rb

@@ -0,0 +1,9 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws = book.add_sheet
+
+ws.write(0, 0, "Hello World")
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/image.rb

@@ -0,0 +1,10 @@
+require "rubygems"
+require "surpass"
+
+
+book = Workbook.new
+ws = book.add_sheet('Image')
+ws.insert_bitmap('examples/python.bmp', 2, 2)
+ws.insert_bitmap('examples/python.bmp', 15, 2)
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/merged.rb

@@ -0,0 +1,36 @@
+require "rubygems"
+require "surpass"
+
+fnt = Font.new
+fnt.name = 'Arial'
+fnt.colour_index = 4
+fnt.bold = true
+
+borders = Borders.new
+borders.left = 6
+borders.right = 6
+borders.top = 6
+borders.bottom = 6
+
+al = Alignment.new
+al.horz = Alignment::HORZ_CENTER
+al.vert = Alignment::VERT_CENTER
+
+style = StyleFormat.new
+style.font = fnt
+style.borders = borders
+style.alignment = al
+
+
+book = Workbook.new
+ws0 = book.add_sheet
+ws1 = book.add_sheet
+ws2 = book.add_sheet
+
+(0...0x200).step(2) do |i|
+  ws0.write_merge(i, i+1, 1, 5, "test #{i}", style)
+  ws1.write_merge(i, i, 1, 7, "test #{i}", style)
+  ws2.write_merge(i, i+1, 1, 7 + (i%10), "test #{i}", style)
+end
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/merged0.rb

@@ -0,0 +1,27 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws0 = book.add_sheet
+
+
+fnt = Font.new
+fnt.name = 'Arial'
+fnt.colour_index = 4
+fnt.bold = true
+
+borders = Borders.new
+borders.left = 6
+borders.right = 6
+borders.top = 6
+borders.bottom = 6
+
+style = StyleFormat.new
+style.font = fnt
+style.borders = borders
+
+ws0.write_merge(3, 3, 1, 5, 'test1', style)
+ws0.write_merge(4, 10, 1, 5, 'test2', style)
+ws0.set_column_width(1, 0x0d00)
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/merged1.rb

@@ -0,0 +1,99 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws0 = book.add_sheet
+
+fnt1 = Font.new
+fnt1.name = 'Verdana'
+fnt1.bold = true
+fnt1.height = 18*0x14
+
+pat1 = Pattern.new
+pat1.pattern = Pattern::SOLID_PATTERN
+pat1.pattern_fore_colour = 0x16
+
+brd1 = Borders.new
+brd1.left = 0x06
+brd1.right = 0x06
+brd1.top = 0x06
+brd1.bottom = 0x06
+
+fnt2 = Font.new
+fnt2.name = 'Verdana'
+fnt2.bold = true
+fnt2.height = 14*0x14
+
+brd2 = Borders.new
+brd2.left = 0x01
+brd2.right = 0x01
+brd2.top = 0x01
+brd2.bottom = 0x01
+
+pat2 = Pattern.new
+pat2.pattern = Pattern::SOLID_PATTERN
+pat2.pattern_fore_colour = 0x01F
+
+fnt3 = Font.new
+fnt3.name = 'Verdana'
+fnt3.bold = true
+fnt3.italic = true
+fnt3.height = 12*0x14
+
+brd3 = Borders.new
+brd3.left = 0x07
+brd3.right = 0x07
+brd3.top = 0x07
+brd3.bottom = 0x07
+
+fnt4 = Font.new
+
+al1 = Alignment.new
+al1.horz = Alignment::HORZ_CENTER
+al1.vert = Alignment::VERT_CENTER
+
+al2 = Alignment.new
+al2.horz = Alignment::HORZ_RIGHT
+al2.vert = Alignment::VERT_CENTER
+
+al3 = Alignment.new
+al3.horz = Alignment::HORZ_LEFT
+al3.vert = Alignment::VERT_CENTER
+
+style1 = StyleFormat.new
+style1.font = fnt1
+style1.alignment = al1
+style1.pattern = pat1
+style1.borders = brd1
+
+style2 = StyleFormat.new
+style2.font = fnt2
+style2.alignment = al1
+style2.pattern = pat2
+style2.borders = brd2
+
+style3 = StyleFormat.new
+style3.font = fnt3
+style3.alignment = al1
+style3.pattern = pat2
+style3.borders = brd3
+
+price_style = StyleFormat.new
+price_style.font = fnt4
+price_style.alignment = al2
+price_style.borders = brd3
+price_style.number_format_string = '_(#,##0.00_) "money"'
+
+ware_style = StyleFormat.new
+ware_style.font = fnt4
+ware_style.alignment = al3
+ware_style.borders = brd3
+
+
+ws0.merge(3, 3, 1, 5, style1)
+ws0.merge(4, 10, 1, 6, style2)
+ws0.merge(14, 16, 1, 7, style3)
+ws0.set_column_width(1, 0x0d00)
+
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/num_formats.rb

@@ -0,0 +1,55 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws = book.add_sheet
+
+fmts = [
+    'General',
+    '0',
+    '0.00',
+    '#,##0',
+    '#,##0.00',
+    '"$"#,##0_);("$"#,##',
+    '"$"#,##0_);[Red]("$"#,##',
+    '"$"#,##0.00_);("$"#,##',
+    '"$"#,##0.00_);[Red]("$"#,##',
+    '0%',
+    '0.00%',
+    '0.00E+00',
+    '# ?/?',
+    '# ??/??',
+    'M/D/YY',
+    'D-MMM-YY',
+    'D-MMM',
+    'MMM-YY',
+    'h:mm AM/PM',
+    'h:mm:ss AM/PM',
+    'h:mm',
+    'h:mm:ss',
+    'M/D/YY h:mm',
+    '_(#,##0_);(#,##0)',
+    '_(#,##0_);[Red](#,##0)',
+    '_(#,##0.00_);(#,##0.00)',
+    '_(#,##0.00_);[Red](#,##0.00)',
+    '_("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_)',
+    '_(* #,##0_);_(* (#,##0);_(* "-"_);_(@_)',
+    '_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)',
+    '_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)',
+    'mm:ss',
+    '[h]:mm:ss',
+    'mm:ss.0',
+    '##0.0E+0',
+    '@'   
+]
+
+fmts.each_with_index do |fmt, i|
+    ws.write(i, 0, fmt)
+
+    style = StyleFormat.new
+    style.number_format_string = fmt
+
+    ws.write(i, 4, -1278.9078, style)
+end
+
+book.save(__FILE__.gsub(/rb$/, "xls"))

data/examples/numbers.rb

@@ -0,0 +1,24 @@
+require "rubygems"
+require "surpass"
+
+book = Workbook.new
+ws = book.add_sheet
+
+ws.write(0, 0, 1)
+ws.write(1, 0, 1.23)
+ws.write(2, 0, 12345678)
+ws.write(3, 0, 123456.78)
+
+ws.write(0, 1, -1)
+ws.write(1, 1, -1.23)
+ws.write(2, 1, -12345678)
+ws.write(3, 1, -123456.78)
+
+ws.write(0, 2, -17867868678687.0)
+ws.write(1, 2, -1.23e-5)
+ws.write(2, 2, -12345678.90780980)
+ws.write(3, 2, -123456.78)
+
+ws.write(0, 4, true)
+
+book.save(__FILE__.gsub(/rb$/, "xls"))