roo 0.7.0 → 0.8.0

data/website/index.html

@@ -33,23 +33,31 @@
     <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.7.0</a>
+      <a href="http://rubyforge.org/projects/roo" class="numbers">0.8.0</a>
     </div>
     <h2>What</h2>
 
 
-	<p>This gem allows you to access the content of open-office and Excel spreadsheets (.ods/.xls).</p>
+	<p>This gem allows you to access the content of</p>
+
+
+	<ul>
+	<li>Open-office spreadsheets (.ods)</li>
+		<li>Excel spreadsheets (.xls) and</li>
+		<li>Google (online) spreadsheets</li>
+	</ul>
 
 
 	<h2>Installing</h2>
 
 
-<pre syntax="ruby">gem install roo</pre>
+<pre syntax="ruby">[sudo] gem install roo</pre>
 
 	<h2>The basics</h2>
 
 
-	<p>Currently only read-access is implemented.</p>
+	<p>Currently only read-access is implemented.
+Google spreadsheets can be read and written.</p>
 
 
 	<p>Please note that the upper left cell of a table is numbered (1,1) or (1,&#8217;A&#8217;) (not 0,0).</p>
@@ -153,10 +161,28 @@ returned:</p>
 	</ul>
 
 
+	<h3>Write access</h3>
+
+
+	<p>Cells in a google spreadsheet can be read or written.</p>
+
+
+	<p>To write to a cell use the method call:</p>
+
+
+<pre>
+<code>
+oo.set_value(row, col, value)
+</code>
+</pre>
+
+	<p>There is an example in the examples folder which illustrates write access.</p>
+
+
 	<h3>Formulas</h3>
 
 
-	<p>Formulas in Openoffice-Spreadsheets can be handled.</p>
+	<p>Formulas in Openoffice- and Google-Spreadsheets can be handled.</p>
 
 
 	<p>oo.<strong>celltype</strong>(row,col) returns :formula if there is a formula in this cell.</p>
@@ -250,15 +276,15 @@ Replace Openoffice with
 </code>
 </pre>
 
-All methode are the same for OpenOffice and Excel-objects.
+All methode are the same for OpenOffice-, Excel- and Google-objects.
 <strike> 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,..).
 </strike>
 
-	<p>Formulas can only be handled in OpenOffice-spreadsheets.</p>
+	<p>Formulas can only be handled in OpenOffice- and Google-spreadsheets.</p>
 
 
-	<p>Features in OpenOffice and Excel:</p>
+	<p>Features in OpenOffice/Excel/Google:</p>
 
 
 	<table class="border:1px solid black">
@@ -266,16 +292,25 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
 			<td>feature</td>
 			<td>Open Office</td>
 			<td>Excel</td>
+			<td>Google</td>
 		</tr>
 		<tr>
 			<td>formulas</td>
 			<td>yes</td>
 			<td>no</td>
+			<td>yes</td>
 		</tr>
 		<tr>
 			<td>celltype</td>
 			<td>:percentage</td>
 			<td>:float</td>
+			<td>:percentage</td>
+		</tr>
+		<tr>
+			<td>access</td>
+			<td>read-only</td>
+			<td>read-only</td>
+			<td>read and write</td>
 		</tr>
 	</table>
 
@@ -288,6 +323,25 @@ 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 it as an &#8220;OpenDocument Spreadsheet (.ods)&#8221;.</p>
 
 
+	<p>Instead of a filename the Google#new method needs the &#8216;key&#8217; of a Google-Spreadsheet. This key can be copied from the <span class="caps">URL</span> when you display a google spreadsheet with your browser.</p>
+
+
+	<p>If you want to use Google spreadsheets you must either have set the
+environment variables &#8216;GOOGLE_MAIL&#8217; and &#8216;GOOGLE_PASSWORD&#8217; or you pass
+the Google-name and -password to the Google#new method.</p>
+
+
+	<p>Setting these variables can be done if you add these lines to your
+~/.bashrc (or similar setup file within other shells):</p>
+
+
+	<pre><code>export GOOGLE_MAIL="yourname@gmail.com" 
+export GOOGLE_PASSWORD="mysecretpassword"</code></pre>
+
+
+	<p>This gem does not check if you are allowed to access a specific google spreadsheet. If it&#8217;s not your own spreadsheet or you are not allowed to read or wwrite to a spreadsheet the behaviour is not defined (but it will not work ;-) ).</p>
+
+
 	<h3>Accessing Spreadsheet over the Web</h3>
 
 
@@ -367,7 +421,11 @@ Remote access with <span class="caps">SOAP</span> is nothing specific to roo, yo
 	<p><a href="rdoc/index.html">rdoc</a></p>
 
 
-	<p>Only the Openoffice- and Excel-parts of this gem are currently working &#8211; the Google-Spreadheets are experimental and are currently <span class="caps">NOT</span> working. Don&#8217;t use this!</p>
+<strike>
+Only the Openoffice- and Excel-parts of this gem are currently working &#8211; the Google-Spreadheets are experimental and are currently <span class="caps">NOT</span> working. Don&#8217;t use this!
+</strike>
+
+	<p>Google spreadsheet can now be used.</p>
 
 
 	<h2>Feature Requests / Bugs</h2>
@@ -379,7 +437,12 @@ Remote access with <span class="caps">SOAP</span> is nothing specific to roo, yo
 	<h2>Forum</h2>
 
 
-	<p><a href="http://groups.google.com/group/ruby-roo">http://groups.google.com/group/ruby-roo</a></p>
+	<p>International Group:
+<a href="http://groups.google.com/group/ruby-roo">http://groups.google.com/group/ruby-roo</a></p>
+
+
+	<p>Deutschsprachige Group:
+<a href="http://groups.google.com/group/ruby-roo-de">http://groups.google.com/group/ruby-roo-de</a></p>
 
 
 	<h2>Wiki</h2>
@@ -420,7 +483,7 @@ The trunk repository is <code>svn://rubyforge.org/var/svn/gorank/trunk</code> fo
 		<li>Dirk Huth f&uuml;rs Testen unter Windows</li>
 	</ul>
     <p class="coda">
-      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 26th October 2007<br>
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 16th December 2007<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -2,15 +2,20 @@ h1. roo
 
 h2. What
 
-This gem allows you to access the content of open-office and Excel spreadsheets (.ods/.xls).
+This gem allows you to access the content of 
+
+* Open-office spreadsheets (.ods)
+* Excel spreadsheets (.xls) and
+* Google (online) spreadsheets
 
 h2. Installing
 
-<pre syntax="ruby">gem install roo</pre>
+<pre syntax="ruby">[sudo] gem install roo</pre>
 
 h2. The basics
 
 Currently only read-access is implemented.
+Google spreadsheets can be read and written.
 
 Please note that the upper left cell of a table is numbered (1,1) or (1,'A') (not 0,0).
 
@@ -98,9 +103,23 @@ returned:
 * :percentage
 * :formula
 
+h3. Write access
+
+Cells in a google spreadsheet can be read or written.
+
+To write to a cell use the method call:
+
+<pre>
+<code>
+oo.set_value(row, col, value)
+</code>
+</pre>
+
+There is an example in the examples folder which illustrates write access. 
+
 h3. Formulas
 
-Formulas in Openoffice-Spreadsheets can be handled. 
+Formulas in Openoffice- and Google-Spreadsheets can be handled. 
 
 oo.*celltype*(row,col) returns :formula if there is a formula in this cell.
 
@@ -173,24 +192,40 @@ Replace Openoffice with
 </code>
 </pre>
 
-All methode are the same for OpenOffice and Excel-objects.
+All methode are the same for OpenOffice-, Excel- and Google-objects.
 <strike> 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,..).
 </strike>
 
-Formulas can only be handled in OpenOffice-spreadsheets.
+Formulas can only be handled in OpenOffice- and Google-spreadsheets.
 
-Features in OpenOffice and Excel:
+Features in OpenOffice/Excel/Google:
 
 table(border:1px solid black).
-|feature|Open Office|Excel|
-|formulas|yes|no|
-|celltype|:percentage|:float|
+|feature|Open Office|Excel|Google|
+|formulas|yes|no|yes|
+|celltype|:percentage|:float|:percentage|
+|access|read-only|read-only|read and write|
 
 The parseexcel-gem does not support the celltype 'percentage' but uses 'float' instead. This is not a big deal as you can also use 'float' to do calculations with these cells.
 
 Old .sxc OpenOffice files are currently not supported - please load these files and save it as an "OpenDocument Spreadsheet (.ods)".
 
+Instead of a filename the Google#new method needs the 'key' of a Google-Spreadsheet. This key can be copied from the URL when you display a google spreadsheet with your browser.
+
+If you want to use Google spreadsheets you must either have set the
+environment variables 'GOOGLE_MAIL' and 'GOOGLE_PASSWORD' or you pass
+the Google-name and -password to the Google#new method.
+
+Setting these variables can be done if you add these lines to your
+~/.bashrc (or similar setup file within other shells):
+
+  export GOOGLE_MAIL="yourname@gmail.com"
+  export GOOGLE_PASSWORD="mysecretpassword"
+ 
+This gem does not check if you are allowed to access a specific google spreadsheet. If it's not your own spreadsheet or you are not allowed to read or wwrite to a spreadsheet the behaviour is not defined (but it will not work ;-) ).
+
+
 h3. Accessing Spreadsheet over the Web
 
 You can even read openoffice or excel-spreadsheets from a http-address:
@@ -253,7 +288,11 @@ h2. Documentation
 
 "rdoc":rdoc/index.html
 
+<strike>
 Only the Openoffice- and Excel-parts of this gem are currently working - the Google-Spreadheets are experimental and are currently NOT working. Don't use this!
+</strike>
+
+Google spreadsheet can now be used.
 
 h2. Feature Requests / Bugs
 
@@ -261,8 +300,12 @@ Submit Feature Requests and bugs here: "http://rubyforge.org/tracker/?group_id=3
 
 h2. Forum
 
+International Group:
 "http://groups.google.com/group/ruby-roo":http://groups.google.com/group/ruby-roo
 
+Deutschsprachige Group:
+"http://groups.google.com/group/ruby-roo-de":http://groups.google.com/group/ruby-roo-de
+
 h2. Wiki
 
 "http://roo.rubyforge.org/wiki/wiki.pl":http://roo.rubyforge.org/wiki/wiki.pl

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: roo
 version: !ruby/object:Gem::Version 
-  version: 0.7.0
+  version: 0.8.0
 platform: ""
 authors: 
 - Thomas Preymesser
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2007-11-23 00:00:00 +01:00
+date: 2007-12-16 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -48,7 +48,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.0.3
     version: 
-description: roo can access the contents of OpenOffice-Spreadsheets and Excel-Spreadsheets
+description: roo can access the contents of OpenOffice-, Excel- or Google-Spreadsheets
 email: thopre@gmail.com
 executables: []
 
@@ -69,8 +69,10 @@ files:
 - base64include.rb
 - examples/roo_soap_server.rb
 - examples/roo_soap_client.rb
+- examples/write_me.rb
 - lib/roo.rb
 - lib/roo/version.rb
+- lib/roo/generic_spreadsheet.rb
 - lib/roo/openoffice.rb
 - lib/roo/excel.rb
 - lib/roo/google.rb
@@ -120,7 +122,7 @@ rubyforge_project: roo
 rubygems_version: 0.9.5
 signing_key: 
 specification_version: 2
-summary: roo can access the contents of OpenOffice-Spreadsheets and Excel-Spreadsheets
+summary: roo can access the contents of OpenOffice-, Excel- or Google-Spreadsheets
 test_files: 
 - test/test_helper.rb
 - test/test_roo.rb