roo 0.4.1 → 0.5.0

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>roo</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/roo"; return false'>
       Get Version
-      <a href="http://rubyforge.org/projects/roo" class="numbers">0.4.1</a>
+      <a href="http://rubyforge.org/projects/roo" class="numbers">0.5.0</a>
     </div>
     <h2>What</h2>
 
@@ -137,32 +137,56 @@
 </code>
 </pre>
 
+	<h3>Cell Types</h3>
+
+
+	<p>oo.<strong>celltype</strong>(row,col) returns the type of a cell. Currently these types will be
+returned:</p>
+
+
+	<ul>
+	<li>:float</li>
+		<li>:string</li>
+		<li>:date</li>
+		<li>:percentage</li>
+		<li>:formula</li>
+	</ul>
+
+
 	<h3>Formulas</h3>
 
 
 	<p>Formulas in Openoffice-Spreadsheets can be handled.</p>
 
 
-	<p>oo.celltype(row,col) returns :formula if there is a formula in this cell.</p>
+	<p>oo.<strong>celltype</strong>(row,col) returns :formula if there is a formula in this cell.</p>
 
 
-	<p>oo.formula?(row,col) returns true if there is a formula</p>
+	<p>oo.<strong>formula?</strong>(row,col) returns true if there is a formula</p>
 
 
-	<p>oo.formula(row,col) returns the formula in this cell in a string variable (like &#8221;=<acronym title="[.A1:.M13]">SUM</acronym>&#8221;). You can do whatever you want with this expression.
+	<p>oo.<strong>formula</strong>(row,col) returns the formula in this cell in a string variable (like &#8221;=<acronym title="[.A1:.M13]">SUM</acronym>&#8221;). You can do whatever you want with this expression.
 If there is no formula in this cell nil is returned.</p>
 
 
-	<p>oo.cell(row,col) returns the computed result of the formula (as it was saved in the file, no recalculation is done in this Gem).</p>
+	<p>oo.<strong>cell</strong>(row,col) returns the computed result of the formula (as it was saved in the file, no recalculation is done in this Gem).</p>
+
 
+	<p>oo.<strong>formulas</strong> returns all formulas in the selected spreadsheet in an array like this:</p>
 
-	<p>oo.formulas returns all formulas in the selected spreadsheet in an array like this:</p>
 
+<pre>
+<code>
+  [[1,2,"=SUM(.A1:.B1)"],
+   [1,3,"=SIN(.C3)"],
+   [1,4,"=COS(.D4)"]]
+</code>
+</pre>
 
-	<p>Each entry consists of the elements row, col, formual.</p>
+	<p>Each entry consists of the elements row, col, formula.</p>
 
 
-	<p>Note: oo.cell(row,col) is the same for ordinary cells and formulas. So you can use the computated value of a formula. If you have to distinguish if a cell is a formula use #formula?</p>
+	<p>Note: oo.<strong>cell</strong>(row,col) is the same for ordinary cells and formulas. So you can use the computated value of a formula. If you have to distinguish if a cell is a formula use #<strong>formula</strong>?</p>
 
 
 	<p>Please note: formulas in Excel-Spreadsheets cannot be handled (this is another gem, see: &#8220;Thanks&#8221;)</p>
@@ -206,6 +230,9 @@ Replace Openoffice with
 is the setting of the default-worksheet. OpenOffice uses the name of the worksheet whereas Excel needs the index of the worksheet (1,2,3,..).</p>
 
 
+	<p><span class="caps">EDIT</span>: since the release 0.4.2, default_sheet in Excel-object can be handled with names like the Openoffice-sheet.</p>
+
+
 	<p>Formulas can only be handled in OpenOffice-spreadsheets.</p>
 
 
@@ -221,7 +248,7 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
 		<tr>
 			<td>default_sheet</td>
 			<td>as name</td>
-			<td>as number</td>
+			<td>as number or name (&gt;=0.4.2)</td>
 		</tr>
 		<tr>
 			<td>formulas</td>
@@ -238,7 +265,14 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
 
 
 
-	<p>Old .sxc OpenOffice files are currently not supported &#8211; please load these files and save as an &#8220;OpenDocument Spreadsheet (.ods)&#8221;.</p>
+	<p>Old .sxc OpenOffice files are currently not supported &#8211; please load these files and save it as an &#8220;OpenDocument Spreadsheet (.ods)&#8221;.</p>
+
+
+	<h3>Remote Access</h3>
+
+
+	<p>You can even access your spreadsheet data from a remote machine via <span class="caps">SOAP</span>. The examples directory shows a little example how to do this. If you like, you can extend these functions or restrict the access to certain cells. 
+Remote access with <span class="caps">SOAP</span> is nothing specific to roo, you can do this with every Rub object, but i thought it would nice to give an example what could be done with roo.</p>
 
 
 	<h2>Where is it used?</h2>
@@ -285,6 +319,15 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
 	<p><a href="http://roo.rubyforge.org/wiki/wiki.pl">http://roo.rubyforge.org/wiki/wiki.pl</a></p>
 
 
+	<h2>How to submit patches</h2>
+
+
+	<p>Read the <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/">8 steps for fixing other people&#8217;s code</a> and for section <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups">8b: Submit patch to Google Groups</a>, use the Google Group above.</p>
+
+
+	<p>The trunk repository is <code>svn://rubyforge.org/var/svn/gorank/trunk</code> for anonymous access.</p>
+
+
 	<h2>License</h2>
 
 
@@ -302,11 +345,11 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
 
 	<ul>
 	<li><a href="http://rubyforge.org/users/nicwilliams/">Dr Nic Williams</a> for his wonderful gem &#8216;<a href="http://rubyforge.org/projects/newgem/">newgem</a>&#8217; which makes it very convenient to create, manage and publish Ruby gems</li>
-		<li>for the Excel-part the &#8220;spreadsheet&#8217;:http://rubyforge.org/projects/spreadsheet/ gem is used. My functions are a convenient wrapper around the functions of this gem</li>
+		<li>for the Excel-part the <a href="http://rubyforge.org/projects/spreadsheet/">spreadsheet</a> gem is used. My functions are a convenient wrapper around the functions of this gem</li>
 		<li>Dirk Huth f&uuml;rs Testen unter Windows</li>
 	</ul>
     <p class="coda">
-      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 27th June 2007<br>
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 20th July 2007<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -87,28 +87,43 @@ to
 </code>
 </pre>
 
+h3. Cell Types
+
+oo.*celltype*(row,col) returns the type of a cell. Currently these types will be
+returned:
+
+* :float
+* :string
+* :date
+* :percentage
+* :formula
+
 h3. Formulas
 
 Formulas in Openoffice-Spreadsheets can be handled. 
 
-oo.celltype(row,col) returns :formula if there is a formula in this cell.
+oo.*celltype*(row,col) returns :formula if there is a formula in this cell.
 
-oo.formula?(row,col) returns true if there is a formula
+oo.*formula?*(row,col) returns true if there is a formula
 
-oo.formula(row,col) returns the formula in this cell in a string variable (like "=SUM([.A1:.M13])"). You can do whatever you want with this expression.
+oo.*formula*(row,col) returns the formula in this cell in a string variable (like "=SUM([.A1:.M13])"). You can do whatever you want with this expression.
 If there is no formula in this cell nil is returned.
 
-oo.cell(row,col) returns the computed result of the formula (as it was saved in the file, no recalculation is done in this Gem).
+oo.*cell*(row,col) returns the computed result of the formula (as it was saved in the file, no recalculation is done in this Gem).
 
-oo.formulas returns all formulas in the selected spreadsheet in an array like this:
+oo.*formulas* returns all formulas in the selected spreadsheet in an array like this:
 
+<pre>
+<code>
   [[1,2,"=SUM(.A1:.B1)"],
    [1,3,"=SIN(.C3)"],
    [1,4,"=COS(.D4)"]]
+</code>
+</pre>
 
-Each entry consists of the elements row, col, formual.
+Each entry consists of the elements row, col, formula.
 
-Note: oo.cell(row,col) is the same for ordinary cells and formulas. So you can use the computated value of a formula. If you have to distinguish if a cell is a formula use #formula? 
+Note: oo.*cell*(row,col) is the same for ordinary cells and formulas. So you can use the computated value of a formula. If you have to distinguish if a cell is a formula use #*formula*? 
 
 Please note: formulas in Excel-Spreadsheets cannot be handled (this is another gem, see: "Thanks")
 
@@ -141,17 +156,24 @@ Replace Openoffice with
 All methode are the same for OpenOffice and Excel-objects. The only difference
 is the setting of the default-worksheet. OpenOffice uses the name of the worksheet whereas Excel needs the index of the worksheet (1,2,3,..).
 
+EDIT: since the release 0.4.2, default_sheet in Excel-object can be handled with names like the Openoffice-sheet.
+
 Formulas can only be handled in OpenOffice-spreadsheets.
 
 Features in OpenOffice and Excel:
 
 table(border:1px solid black).
 |feature|Open Office|Excel|
-|default_sheet|as name|as number|
+|default_sheet|as name|as number or name (>=0.4.2)|
 |formulas|yes|no|
 |to_yaml|yes|yes|
 
-Old .sxc OpenOffice files are currently not supported - please load these files and save as an "OpenDocument Spreadsheet (.ods)".
+Old .sxc OpenOffice files are currently not supported - please load these files and save it as an "OpenDocument Spreadsheet (.ods)".
+
+h3. Remote Access
+
+You can even access your spreadsheet data from a remote machine via SOAP. The examples directory shows a little example how to do this. If you like, you can extend these functions or restrict the access to certain cells. 
+Remote access with SOAP is nothing specific to roo, you can do this with every Rub object, but i thought it would nice to give an example what could be done with roo.
 
 h2. Where is it used?
 
@@ -183,6 +205,12 @@ h2. Wiki
 
 "http://roo.rubyforge.org/wiki/wiki.pl":http://roo.rubyforge.org/wiki/wiki.pl
 
+h2. How to submit patches
+
+Read the "8 steps for fixing other people's code":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/ and for section "8b: Submit patch to Google Groups":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups, use the Google Group above.
+
+The trunk repository is <code>svn://rubyforge.org/var/svn/gorank/trunk</code> for anonymous access.
+
 h2. License
 
 This code is free to use under the terms of Ruby
@@ -194,5 +222,5 @@ Comments are welcome. Send an email to "Thomas Preymesser":mailto:thopre@gmail.c
 h2. Thanks
 
 * "Dr Nic Williams":http://rubyforge.org/users/nicwilliams/ for his wonderful gem '"newgem":http://rubyforge.org/projects/newgem/' which makes it very convenient to create, manage and publish Ruby gems
-* for the Excel-part the "spreadsheet':http://rubyforge.org/projects/spreadsheet/ gem is used. My functions are a convenient wrapper around the functions of this gem
+* for the Excel-part the "spreadsheet":http://rubyforge.org/projects/spreadsheet/ gem is used. My functions are a convenient wrapper around the functions of this gem
 * Dirk Huth f&uuml;rs Testen unter Windows

data/website/stylesheets/screen.css

@@ -1,5 +1,6 @@
 body {
-  background-color: #E1D1F1;
+  /*background-color: #E1D1F1;*/
+  background-image: url(../spreadsheetbackground.png);
   font-family: "Georgia", sans-serif;
   font-size: 16px;
   line-height: 1.6em;

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: roo
 version: !ruby/object:Gem::Version 
-  version: 0.4.1
-date: 2007-06-27 00:00:00 +02:00
+  version: 0.5.0
+date: 2007-07-20 00:00:00 +02:00
 summary: roo can access the contents of OpenOffice-Spreadsheets
 require_paths: 
 - lib
@@ -34,18 +34,24 @@ files:
 - Manifest.txt
 - README.txt
 - Rakefile
+- base64include.rb
+- examples/roo_soap_server.rb
+- examples/roo_soap_client.rb
 - lib/roo.rb
 - lib/roo/version.rb
 - lib/roo/openoffice.rb
 - lib/roo/excel.rb
 - lib/roo/google.rb
-- lib/roo/spreadsheetparser.rb
 - scripts/txt2html
 - setup.rb
 - test/test_helper.rb
 - test/test_roo.rb
 - test/numbers1.ods
 - test/numbers1.xls
+- test/borders.ods
+- test/borders.xls
+- test/formula.ods
+- test/formula.xls
 - website/index.html
 - website/index.txt
 - website/javascripts/rounded_corners_lite.inc.js
@@ -77,7 +83,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.5.1.1
+        version: 0.5.2
     version: 
 - !ruby/object:Gem::Dependency 
   name: rubyzip
@@ -97,12 +103,3 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: "0.5"
     version: 
-- !ruby/object:Gem::Dependency 
-  name: llip
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.0.1
-    version: 

data/lib/roo/spreadsheetparser.rb

@@ -1,92 +0,0 @@
-=begin
-This is experimental. Please do not use it. IT WILL NOT WORK
-I don't know if i will extend the work on the evaluation of formulas. 
-You can access all formulas as a string and do whatever you want with this.
-=end
-
-require 'rubygems'
-require 'llip'
-require 'llip/visitable'
-
-class Formula
-  include LLIP::Visitable
-
-  attr_accessor :name
-  attr_accessor :params
-end
-
-class Param
-  include LLIP::Visitable
-
-  attr_accessor :column_name
-end
-
-class Visitor
-  def visit_formula(formula)
-    puts " -- " + formula.name
-    formula.params.each { |p| p.accept(self) }
-  end
-
-  def visit_param(param)
-    puts " |-- " + param.column_name
-  end
-end
-
-class SpreadsheetParser < LLIP::Parser
-  letters = ("A".."Z").to_a.join("|")
-
-  token :id, "(#{letters})+"
-
-  token :"(", '\('
-
-  token :")", '\)'
-
-  token :"[", '['
-  token :"]", ']'
-  token :".", '.'
-
-  num = (1..9).to_a.join("|")
-  token :num , "(#{num})(#{num}|0)*"
-
-  token :sep, ":"
-
-  scope :formula
-
-  production :formula do |p|
-    p.token(:id) do |result,scanner,parser|
-      result = Formula.new
-      result.name = scanner.current
-puts "<"+result.name+">"
-      raise unless scanner.next == :"("
-      raise unless scanner.next == :"["
-      scanner.next
-      result.params = parser.parse_params
-      raise unless scanner.current == :"]"
-      raise unless scanner.current == :")"
-      scanner.next
-      result
-    end
-  end
-
-  production :params, :recursive do |p|
-    p.default do |scanner, parser|
-      []
-    end
-
-    p.token(:id) do |result, scanner, parser|
-      param = Param.new
-      param.column_name = scanner.current.to_s
-      raise unless scanner.next == :"."
-      raise unless scanner.next == :num
-      param.column_name += scanner.current.to_s
-      scanner.next
-      result << param
-    end
-
-    p.token(:sep) do |result,scanner,parser|
-      scanner.next
-      result
-    end
-  end
-
-end