roo 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -33,23 +33,31 @@
33
33
  <h1>roo</h1>
34
34
  <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/roo"; return false'>
35
35
  Get Version
36
- <a href="http://rubyforge.org/projects/roo" class="numbers">0.7.0</a>
36
+ <a href="http://rubyforge.org/projects/roo" class="numbers">0.8.0</a>
37
37
  </div>
38
38
  <h2>What</h2>
39
39
 
40
40
 
41
- <p>This gem allows you to access the content of open-office and Excel spreadsheets (.ods/.xls).</p>
41
+ <p>This gem allows you to access the content of</p>
42
+
43
+
44
+ <ul>
45
+ <li>Open-office spreadsheets (.ods)</li>
46
+ <li>Excel spreadsheets (.xls) and</li>
47
+ <li>Google (online) spreadsheets</li>
48
+ </ul>
42
49
 
43
50
 
44
51
  <h2>Installing</h2>
45
52
 
46
53
 
47
- <pre syntax="ruby">gem install roo</pre>
54
+ <pre syntax="ruby">[sudo] gem install roo</pre>
48
55
 
49
56
  <h2>The basics</h2>
50
57
 
51
58
 
52
- <p>Currently only read-access is implemented.</p>
59
+ <p>Currently only read-access is implemented.
60
+ Google spreadsheets can be read and written.</p>
53
61
 
54
62
 
55
63
  <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>
153
161
  </ul>
154
162
 
155
163
 
164
+ <h3>Write access</h3>
165
+
166
+
167
+ <p>Cells in a google spreadsheet can be read or written.</p>
168
+
169
+
170
+ <p>To write to a cell use the method call:</p>
171
+
172
+
173
+ <pre>
174
+ <code>
175
+ oo.set_value(row, col, value)
176
+ </code>
177
+ </pre>
178
+
179
+ <p>There is an example in the examples folder which illustrates write access.</p>
180
+
181
+
156
182
  <h3>Formulas</h3>
157
183
 
158
184
 
159
- <p>Formulas in Openoffice-Spreadsheets can be handled.</p>
185
+ <p>Formulas in Openoffice- and Google-Spreadsheets can be handled.</p>
160
186
 
161
187
 
162
188
  <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
250
276
  </code>
251
277
  </pre>
252
278
 
253
- All methode are the same for OpenOffice and Excel-objects.
279
+ All methode are the same for OpenOffice-, Excel- and Google-objects.
254
280
  <strike> The only difference
255
281
  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,..).
256
282
  </strike>
257
283
 
258
- <p>Formulas can only be handled in OpenOffice-spreadsheets.</p>
284
+ <p>Formulas can only be handled in OpenOffice- and Google-spreadsheets.</p>
259
285
 
260
286
 
261
- <p>Features in OpenOffice and Excel:</p>
287
+ <p>Features in OpenOffice/Excel/Google:</p>
262
288
 
263
289
 
264
290
  <table class="border:1px solid black">
@@ -266,16 +292,25 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
266
292
  <td>feature</td>
267
293
  <td>Open Office</td>
268
294
  <td>Excel</td>
295
+ <td>Google</td>
269
296
  </tr>
270
297
  <tr>
271
298
  <td>formulas</td>
272
299
  <td>yes</td>
273
300
  <td>no</td>
301
+ <td>yes</td>
274
302
  </tr>
275
303
  <tr>
276
304
  <td>celltype</td>
277
305
  <td>:percentage</td>
278
306
  <td>:float</td>
307
+ <td>:percentage</td>
308
+ </tr>
309
+ <tr>
310
+ <td>access</td>
311
+ <td>read-only</td>
312
+ <td>read-only</td>
313
+ <td>read and write</td>
279
314
  </tr>
280
315
  </table>
281
316
 
@@ -288,6 +323,25 @@ is the setting of the default-worksheet. OpenOffice uses the name of the workshe
288
323
  <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>
289
324
 
290
325
 
326
+ <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>
327
+
328
+
329
+ <p>If you want to use Google spreadsheets you must either have set the
330
+ environment variables &#8216;GOOGLE_MAIL&#8217; and &#8216;GOOGLE_PASSWORD&#8217; or you pass
331
+ the Google-name and -password to the Google#new method.</p>
332
+
333
+
334
+ <p>Setting these variables can be done if you add these lines to your
335
+ ~/.bashrc (or similar setup file within other shells):</p>
336
+
337
+
338
+ <pre><code>export GOOGLE_MAIL="yourname@gmail.com"
339
+ export GOOGLE_PASSWORD="mysecretpassword"</code></pre>
340
+
341
+
342
+ <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>
343
+
344
+
291
345
  <h3>Accessing Spreadsheet over the Web</h3>
292
346
 
293
347
 
@@ -367,7 +421,11 @@ Remote access with <span class="caps">SOAP</span> is nothing specific to roo, yo
367
421
  <p><a href="rdoc/index.html">rdoc</a></p>
368
422
 
369
423
 
370
- <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>
424
+ <strike>
425
+ 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!
426
+ </strike>
427
+
428
+ <p>Google spreadsheet can now be used.</p>
371
429
 
372
430
 
373
431
  <h2>Feature Requests / Bugs</h2>
@@ -379,7 +437,12 @@ Remote access with <span class="caps">SOAP</span> is nothing specific to roo, yo
379
437
  <h2>Forum</h2>
380
438
 
381
439
 
382
- <p><a href="http://groups.google.com/group/ruby-roo">http://groups.google.com/group/ruby-roo</a></p>
440
+ <p>International Group:
441
+ <a href="http://groups.google.com/group/ruby-roo">http://groups.google.com/group/ruby-roo</a></p>
442
+
443
+
444
+ <p>Deutschsprachige Group:
445
+ <a href="http://groups.google.com/group/ruby-roo-de">http://groups.google.com/group/ruby-roo-de</a></p>
383
446
 
384
447
 
385
448
  <h2>Wiki</h2>
@@ -420,7 +483,7 @@ The trunk repository is <code>svn://rubyforge.org/var/svn/gorank/trunk</code> fo
420
483
  <li>Dirk Huth f&uuml;rs Testen unter Windows</li>
421
484
  </ul>
422
485
  <p class="coda">
423
- <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 26th October 2007<br>
486
+ <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 16th December 2007<br>
424
487
  Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
425
488
  </p>
426
489
  </div>
@@ -2,15 +2,20 @@ h1. roo
2
2
 
3
3
  h2. What
4
4
 
5
- This gem allows you to access the content of open-office and Excel spreadsheets (.ods/.xls).
5
+ This gem allows you to access the content of
6
+
7
+ * Open-office spreadsheets (.ods)
8
+ * Excel spreadsheets (.xls) and
9
+ * Google (online) spreadsheets
6
10
 
7
11
  h2. Installing
8
12
 
9
- <pre syntax="ruby">gem install roo</pre>
13
+ <pre syntax="ruby">[sudo] gem install roo</pre>
10
14
 
11
15
  h2. The basics
12
16
 
13
17
  Currently only read-access is implemented.
18
+ Google spreadsheets can be read and written.
14
19
 
15
20
  Please note that the upper left cell of a table is numbered (1,1) or (1,'A') (not 0,0).
16
21
 
@@ -98,9 +103,23 @@ returned:
98
103
  * :percentage
99
104
  * :formula
100
105
 
106
+ h3. Write access
107
+
108
+ Cells in a google spreadsheet can be read or written.
109
+
110
+ To write to a cell use the method call:
111
+
112
+ <pre>
113
+ <code>
114
+ oo.set_value(row, col, value)
115
+ </code>
116
+ </pre>
117
+
118
+ There is an example in the examples folder which illustrates write access.
119
+
101
120
  h3. Formulas
102
121
 
103
- Formulas in Openoffice-Spreadsheets can be handled.
122
+ Formulas in Openoffice- and Google-Spreadsheets can be handled.
104
123
 
105
124
  oo.*celltype*(row,col) returns :formula if there is a formula in this cell.
106
125
 
@@ -173,24 +192,40 @@ Replace Openoffice with
173
192
  </code>
174
193
  </pre>
175
194
 
176
- All methode are the same for OpenOffice and Excel-objects.
195
+ All methode are the same for OpenOffice-, Excel- and Google-objects.
177
196
  <strike> The only difference
178
197
  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,..).
179
198
  </strike>
180
199
 
181
- Formulas can only be handled in OpenOffice-spreadsheets.
200
+ Formulas can only be handled in OpenOffice- and Google-spreadsheets.
182
201
 
183
- Features in OpenOffice and Excel:
202
+ Features in OpenOffice/Excel/Google:
184
203
 
185
204
  table(border:1px solid black).
186
- |feature|Open Office|Excel|
187
- |formulas|yes|no|
188
- |celltype|:percentage|:float|
205
+ |feature|Open Office|Excel|Google|
206
+ |formulas|yes|no|yes|
207
+ |celltype|:percentage|:float|:percentage|
208
+ |access|read-only|read-only|read and write|
189
209
 
190
210
  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.
191
211
 
192
212
  Old .sxc OpenOffice files are currently not supported - please load these files and save it as an "OpenDocument Spreadsheet (.ods)".
193
213
 
214
+ 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.
215
+
216
+ If you want to use Google spreadsheets you must either have set the
217
+ environment variables 'GOOGLE_MAIL' and 'GOOGLE_PASSWORD' or you pass
218
+ the Google-name and -password to the Google#new method.
219
+
220
+ Setting these variables can be done if you add these lines to your
221
+ ~/.bashrc (or similar setup file within other shells):
222
+
223
+ export GOOGLE_MAIL="yourname@gmail.com"
224
+ export GOOGLE_PASSWORD="mysecretpassword"
225
+
226
+ 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 ;-) ).
227
+
228
+
194
229
  h3. Accessing Spreadsheet over the Web
195
230
 
196
231
  You can even read openoffice or excel-spreadsheets from a http-address:
@@ -253,7 +288,11 @@ h2. Documentation
253
288
 
254
289
  "rdoc":rdoc/index.html
255
290
 
291
+ <strike>
256
292
  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!
293
+ </strike>
294
+
295
+ Google spreadsheet can now be used.
257
296
 
258
297
  h2. Feature Requests / Bugs
259
298
 
@@ -261,8 +300,12 @@ Submit Feature Requests and bugs here: "http://rubyforge.org/tracker/?group_id=3
261
300
 
262
301
  h2. Forum
263
302
 
303
+ International Group:
264
304
  "http://groups.google.com/group/ruby-roo":http://groups.google.com/group/ruby-roo
265
305
 
306
+ Deutschsprachige Group:
307
+ "http://groups.google.com/group/ruby-roo-de":http://groups.google.com/group/ruby-roo-de
308
+
266
309
  h2. Wiki
267
310
 
268
311
  "http://roo.rubyforge.org/wiki/wiki.pl":http://roo.rubyforge.org/wiki/wiki.pl
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: roo
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.0
4
+ version: 0.8.0
5
5
  platform: ""
6
6
  authors:
7
7
  - Thomas Preymesser
@@ -9,7 +9,7 @@ autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
11
 
12
- date: 2007-11-23 00:00:00 +01:00
12
+ date: 2007-12-16 00:00:00 +01:00
13
13
  default_executable:
14
14
  dependencies:
15
15
  - !ruby/object:Gem::Dependency
@@ -48,7 +48,7 @@ dependencies:
48
48
  - !ruby/object:Gem::Version
49
49
  version: 0.0.3
50
50
  version:
51
- description: roo can access the contents of OpenOffice-Spreadsheets and Excel-Spreadsheets
51
+ description: roo can access the contents of OpenOffice-, Excel- or Google-Spreadsheets
52
52
  email: thopre@gmail.com
53
53
  executables: []
54
54
 
@@ -69,8 +69,10 @@ files:
69
69
  - base64include.rb
70
70
  - examples/roo_soap_server.rb
71
71
  - examples/roo_soap_client.rb
72
+ - examples/write_me.rb
72
73
  - lib/roo.rb
73
74
  - lib/roo/version.rb
75
+ - lib/roo/generic_spreadsheet.rb
74
76
  - lib/roo/openoffice.rb
75
77
  - lib/roo/excel.rb
76
78
  - lib/roo/google.rb
@@ -120,7 +122,7 @@ rubyforge_project: roo
120
122
  rubygems_version: 0.9.5
121
123
  signing_key:
122
124
  specification_version: 2
123
- summary: roo can access the contents of OpenOffice-Spreadsheets and Excel-Spreadsheets
125
+ summary: roo can access the contents of OpenOffice-, Excel- or Google-Spreadsheets
124
126
  test_files:
125
127
  - test/test_helper.rb
126
128
  - test/test_roo.rb