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.
- data/History.txt +4 -0
- data/Manifest.txt +2 -0
- data/README.txt +0 -1
- data/Rakefile +12 -2
- data/examples/write_me.rb +33 -0
- data/lib/roo.rb +1 -0
- data/lib/roo/excel.rb +53 -94
- data/lib/roo/generic_spreadsheet.rb +303 -0
- data/lib/roo/google.rb +667 -152
- data/lib/roo/openoffice.rb +13 -259
- data/lib/roo/version.rb +1 -1
- data/test/test_roo.rb +898 -453
- data/website/index.html +74 -11
- data/website/index.txt +52 -9
- metadata +6 -4
data/website/index.html
CHANGED
@@ -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.
|
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
|
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
|
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,’A’) (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
|
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
|
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 – please load these files and save it as an “OpenDocument Spreadsheet (.ods)”.</p>
|
289
324
|
|
290
325
|
|
326
|
+
<p>Instead of a filename the Google#new method needs the ‘key’ 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 ‘GOOGLE_MAIL’ and ‘GOOGLE_PASSWORD’ 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’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
|
-
|
424
|
+
<strike>
|
425
|
+
Only the Openoffice- and Excel-parts of this gem are currently working – the Google-Spreadheets are experimental and are currently <span class="caps">NOT</span> working. Don’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
|
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ürs Testen unter Windows</li>
|
421
484
|
</ul>
|
422
485
|
<p class="coda">
|
423
|
-
<a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>,
|
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>
|
data/website/index.txt
CHANGED
@@ -2,15 +2,20 @@ h1. roo
|
|
2
2
|
|
3
3
|
h2. What
|
4
4
|
|
5
|
-
This gem allows you to access the content of
|
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
|
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
|
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.
|
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-
|
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-
|
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-
|
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
|