parseexcel 0.5.1 → 0.5.1.1

Sign up to get free protection for your applications and to get access to all the features.
data/COPYING ADDED
@@ -0,0 +1,515 @@
1
+
2
+ GNU LESSER GENERAL PUBLIC LICENSE
3
+ Version 2.1, February 1999
4
+
5
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
6
+ 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
7
+ Everyone is permitted to copy and distribute verbatim copies
8
+ of this license document, but changing it is not allowed.
9
+
10
+ [This is the first released version of the Lesser GPL. It also counts
11
+ as the successor of the GNU Library Public License, version 2, hence
12
+ the version number 2.1.]
13
+
14
+ Preamble
15
+
16
+ The licenses for most software are designed to take away your
17
+ freedom to share and change it. By contrast, the GNU General Public
18
+ Licenses are intended to guarantee your freedom to share and change
19
+ free software--to make sure the software is free for all its users.
20
+
21
+ This license, the Lesser General Public License, applies to some
22
+ specially designated software packages--typically libraries--of the
23
+ Free Software Foundation and other authors who decide to use it. You
24
+ can use it too, but we suggest you first think carefully about whether
25
+ this license or the ordinary General Public License is the better
26
+ strategy to use in any particular case, based on the explanations
27
+ below.
28
+
29
+ When we speak of free software, we are referring to freedom of use,
30
+ not price. Our General Public Licenses are designed to make sure that
31
+ you have the freedom to distribute copies of free software (and charge
32
+ for this service if you wish); that you receive source code or can get
33
+ it if you want it; that you can change the software and use pieces of
34
+ it in new free programs; and that you are informed that you can do
35
+ these things.
36
+
37
+ To protect your rights, we need to make restrictions that forbid
38
+ distributors to deny you these rights or to ask you to surrender these
39
+ rights. These restrictions translate to certain responsibilities for
40
+ you if you distribute copies of the library or if you modify it.
41
+
42
+ For example, if you distribute copies of the library, whether gratis
43
+ or for a fee, you must give the recipients all the rights that we gave
44
+ you. You must make sure that they, too, receive or can get the source
45
+ code. If you link other code with the library, you must provide
46
+ complete object files to the recipients, so that they can relink them
47
+ with the library after making changes to the library and recompiling
48
+ it. And you must show them these terms so they know their rights.
49
+
50
+ We protect your rights with a two-step method: (1) we copyright the
51
+ library, and (2) we offer you this license, which gives you legal
52
+ permission to copy, distribute and/or modify the library.
53
+
54
+ To protect each distributor, we want to make it very clear that
55
+ there is no warranty for the free library. Also, if the library is
56
+ modified by someone else and passed on, the recipients should know
57
+ that what they have is not the original version, so that the original
58
+ author's reputation will not be affected by problems that might be
59
+ introduced by others.
60
+ ^L
61
+ Finally, software patents pose a constant threat to the existence of
62
+ any free program. We wish to make sure that a company cannot
63
+ effectively restrict the users of a free program by obtaining a
64
+ restrictive license from a patent holder. Therefore, we insist that
65
+ any patent license obtained for a version of the library must be
66
+ consistent with the full freedom of use specified in this license.
67
+
68
+ Most GNU software, including some libraries, is covered by the
69
+ ordinary GNU General Public License. This license, the GNU Lesser
70
+ General Public License, applies to certain designated libraries, and
71
+ is quite different from the ordinary General Public License. We use
72
+ this license for certain libraries in order to permit linking those
73
+ libraries into non-free programs.
74
+
75
+ When a program is linked with a library, whether statically or using
76
+ a shared library, the combination of the two is legally speaking a
77
+ combined work, a derivative of the original library. The ordinary
78
+ General Public License therefore permits such linking only if the
79
+ entire combination fits its criteria of freedom. The Lesser General
80
+ Public License permits more lax criteria for linking other code with
81
+ the library.
82
+
83
+ We call this license the "Lesser" General Public License because it
84
+ does Less to protect the user's freedom than the ordinary General
85
+ Public License. It also provides other free software developers Less
86
+ of an advantage over competing non-free programs. These disadvantages
87
+ are the reason we use the ordinary General Public License for many
88
+ libraries. However, the Lesser license provides advantages in certain
89
+ special circumstances.
90
+
91
+ For example, on rare occasions, there may be a special need to
92
+ encourage the widest possible use of a certain library, so that it
93
+ becomes
94
+ a de-facto standard. To achieve this, non-free programs must be
95
+ allowed to use the library. A more frequent case is that a free
96
+ library does the same job as widely used non-free libraries. In this
97
+ case, there is little to gain by limiting the free library to free
98
+ software only, so we use the Lesser General Public License.
99
+
100
+ In other cases, permission to use a particular library in non-free
101
+ programs enables a greater number of people to use a large body of
102
+ free software. For example, permission to use the GNU C Library in
103
+ non-free programs enables many more people to use the whole GNU
104
+ operating system, as well as its variant, the GNU/Linux operating
105
+ system.
106
+
107
+ Although the Lesser General Public License is Less protective of the
108
+ users' freedom, it does ensure that the user of a program that is
109
+ linked with the Library has the freedom and the wherewithal to run
110
+ that program using a modified version of the Library.
111
+
112
+ The precise terms and conditions for copying, distribution and
113
+ modification follow. Pay close attention to the difference between a
114
+ "work based on the library" and a "work that uses the library". The
115
+ former contains code derived from the library, whereas the latter must
116
+ be combined with the library in order to run.
117
+ ^L
118
+ GNU LESSER GENERAL PUBLIC LICENSE
119
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
120
+
121
+ 0. This License Agreement applies to any software library or other
122
+ program which contains a notice placed by the copyright holder or
123
+ other authorized party saying it may be distributed under the terms of
124
+ this Lesser General Public License (also called "this License").
125
+ Each licensee is addressed as "you".
126
+
127
+ A "library" means a collection of software functions and/or data
128
+ prepared so as to be conveniently linked with application programs
129
+ (which use some of those functions and data) to form executables.
130
+
131
+ The "Library", below, refers to any such software library or work
132
+ which has been distributed under these terms. A "work based on the
133
+ Library" means either the Library or any derivative work under
134
+ copyright law: that is to say, a work containing the Library or a
135
+ portion of it, either verbatim or with modifications and/or translated
136
+ straightforwardly into another language. (Hereinafter, translation is
137
+ included without limitation in the term "modification".)
138
+
139
+ "Source code" for a work means the preferred form of the work for
140
+ making modifications to it. For a library, complete source code means
141
+ all the source code for all modules it contains, plus any associated
142
+ interface definition files, plus the scripts used to control
143
+ compilation
144
+ and installation of the library.
145
+
146
+ Activities other than copying, distribution and modification are not
147
+ covered by this License; they are outside its scope. The act of
148
+ running a program using the Library is not restricted, and output from
149
+ such a program is covered only if its contents constitute a work based
150
+ on the Library (independent of the use of the Library in a tool for
151
+ writing it). Whether that is true depends on what the Library does
152
+ and what the program that uses the Library does.
153
+
154
+ 1. You may copy and distribute verbatim copies of the Library's
155
+ complete source code as you receive it, in any medium, provided that
156
+ you conspicuously and appropriately publish on each copy an
157
+ appropriate copyright notice and disclaimer of warranty; keep intact
158
+ all the notices that refer to this License and to the absence of any
159
+ warranty; and distribute a copy of this License along with the
160
+ Library.
161
+
162
+ You may charge a fee for the physical act of transferring a copy,
163
+ and you may at your option offer warranty protection in exchange for a
164
+ fee.
165
+
166
+ 2. You may modify your copy or copies of the Library or any portion
167
+ of it, thus forming a work based on the Library, and copy and
168
+ distribute such modifications or work under the terms of Section 1
169
+ above, provided that you also meet all of these conditions:
170
+
171
+ a) The modified work must itself be a software library.
172
+
173
+ b) You must cause the files modified to carry prominent notices
174
+ stating that you changed the files and the date of any change.
175
+
176
+ c) You must cause the whole of the work to be licensed at no
177
+ charge to all third parties under the terms of this License.
178
+
179
+ d) If a facility in the modified Library refers to a function or a
180
+ table of data to be supplied by an application program that uses
181
+ the facility, other than as an argument passed when the facility
182
+ is invoked, then you must make a good faith effort to ensure that,
183
+ in the event an application does not supply such function or
184
+ table, the facility still operates, and performs whatever part of
185
+ its purpose remains meaningful.
186
+
187
+ (For example, a function in a library to compute square roots has
188
+ a purpose that is entirely well-defined independent of the
189
+ application. Therefore, Subsection 2d requires that any
190
+ application-supplied function or table used by this function must
191
+ be optional: if the application does not supply it, the square
192
+ root function must still compute square roots.)
193
+
194
+ These requirements apply to the modified work as a whole. If
195
+ identifiable sections of that work are not derived from the Library,
196
+ and can be reasonably considered independent and separate works in
197
+ themselves, then this License, and its terms, do not apply to those
198
+ sections when you distribute them as separate works. But when you
199
+ distribute the same sections as part of a whole which is a work based
200
+ on the Library, the distribution of the whole must be on the terms of
201
+ this License, whose permissions for other licensees extend to the
202
+ entire whole, and thus to each and every part regardless of who wrote
203
+ it.
204
+
205
+ Thus, it is not the intent of this section to claim rights or contest
206
+ your rights to work written entirely by you; rather, the intent is to
207
+ exercise the right to control the distribution of derivative or
208
+ collective works based on the Library.
209
+
210
+ In addition, mere aggregation of another work not based on the Library
211
+ with the Library (or with a work based on the Library) on a volume of
212
+ a storage or distribution medium does not bring the other work under
213
+ the scope of this License.
214
+
215
+ 3. You may opt to apply the terms of the ordinary GNU General Public
216
+ License instead of this License to a given copy of the Library. To do
217
+ this, you must alter all the notices that refer to this License, so
218
+ that they refer to the ordinary GNU General Public License, version 2,
219
+ instead of to this License. (If a newer version than version 2 of the
220
+ ordinary GNU General Public License has appeared, then you can specify
221
+ that version instead if you wish.) Do not make any other change in
222
+ these notices.
223
+ ^L
224
+ Once this change is made in a given copy, it is irreversible for
225
+ that copy, so the ordinary GNU General Public License applies to all
226
+ subsequent copies and derivative works made from that copy.
227
+
228
+ This option is useful when you wish to copy part of the code of
229
+ the Library into a program that is not a library.
230
+
231
+ 4. You may copy and distribute the Library (or a portion or
232
+ derivative of it, under Section 2) in object code or executable form
233
+ under the terms of Sections 1 and 2 above provided that you accompany
234
+ it with the complete corresponding machine-readable source code, which
235
+ must be distributed under the terms of Sections 1 and 2 above on a
236
+ medium customarily used for software interchange.
237
+
238
+ If distribution of object code is made by offering access to copy
239
+ from a designated place, then offering equivalent access to copy the
240
+ source code from the same place satisfies the requirement to
241
+ distribute the source code, even though third parties are not
242
+ compelled to copy the source along with the object code.
243
+
244
+ 5. A program that contains no derivative of any portion of the
245
+ Library, but is designed to work with the Library by being compiled or
246
+ linked with it, is called a "work that uses the Library". Such a
247
+ work, in isolation, is not a derivative work of the Library, and
248
+ therefore falls outside the scope of this License.
249
+
250
+ However, linking a "work that uses the Library" with the Library
251
+ creates an executable that is a derivative of the Library (because it
252
+ contains portions of the Library), rather than a "work that uses the
253
+ library". The executable is therefore covered by this License.
254
+ Section 6 states terms for distribution of such executables.
255
+
256
+ When a "work that uses the Library" uses material from a header file
257
+ that is part of the Library, the object code for the work may be a
258
+ derivative work of the Library even though the source code is not.
259
+ Whether this is true is especially significant if the work can be
260
+ linked without the Library, or if the work is itself a library. The
261
+ threshold for this to be true is not precisely defined by law.
262
+
263
+ If such an object file uses only numerical parameters, data
264
+ structure layouts and accessors, and small macros and small inline
265
+ functions (ten lines or less in length), then the use of the object
266
+ file is unrestricted, regardless of whether it is legally a derivative
267
+ work. (Executables containing this object code plus portions of the
268
+ Library will still fall under Section 6.)
269
+
270
+ Otherwise, if the work is a derivative of the Library, you may
271
+ distribute the object code for the work under the terms of Section 6.
272
+ Any executables containing that work also fall under Section 6,
273
+ whether or not they are linked directly with the Library itself.
274
+ ^L
275
+ 6. As an exception to the Sections above, you may also combine or
276
+ link a "work that uses the Library" with the Library to produce a
277
+ work containing portions of the Library, and distribute that work
278
+ under terms of your choice, provided that the terms permit
279
+ modification of the work for the customer's own use and reverse
280
+ engineering for debugging such modifications.
281
+
282
+ You must give prominent notice with each copy of the work that the
283
+ Library is used in it and that the Library and its use are covered by
284
+ this License. You must supply a copy of this License. If the work
285
+ during execution displays copyright notices, you must include the
286
+ copyright notice for the Library among them, as well as a reference
287
+ directing the user to the copy of this License. Also, you must do one
288
+ of these things:
289
+
290
+ a) Accompany the work with the complete corresponding
291
+ machine-readable source code for the Library including whatever
292
+ changes were used in the work (which must be distributed under
293
+ Sections 1 and 2 above); and, if the work is an executable linked
294
+ with the Library, with the complete machine-readable "work that
295
+ uses the Library", as object code and/or source code, so that the
296
+ user can modify the Library and then relink to produce a modified
297
+ executable containing the modified Library. (It is understood
298
+ that the user who changes the contents of definitions files in the
299
+ Library will not necessarily be able to recompile the application
300
+ to use the modified definitions.)
301
+
302
+ b) Use a suitable shared library mechanism for linking with the
303
+ Library. A suitable mechanism is one that (1) uses at run time a
304
+ copy of the library already present on the user's computer system,
305
+ rather than copying library functions into the executable, and (2)
306
+ will operate properly with a modified version of the library, if
307
+ the user installs one, as long as the modified version is
308
+ interface-compatible with the version that the work was made with.
309
+
310
+ c) Accompany the work with a written offer, valid for at
311
+ least three years, to give the same user the materials
312
+ specified in Subsection 6a, above, for a charge no more
313
+ than the cost of performing this distribution.
314
+
315
+ d) If distribution of the work is made by offering access to copy
316
+ from a designated place, offer equivalent access to copy the above
317
+ specified materials from the same place.
318
+
319
+ e) Verify that the user has already received a copy of these
320
+ materials or that you have already sent this user a copy.
321
+
322
+ For an executable, the required form of the "work that uses the
323
+ Library" must include any data and utility programs needed for
324
+ reproducing the executable from it. However, as a special exception,
325
+ the materials to be distributed need not include anything that is
326
+ normally distributed (in either source or binary form) with the major
327
+ components (compiler, kernel, and so on) of the operating system on
328
+ which the executable runs, unless that component itself accompanies
329
+ the executable.
330
+
331
+ It may happen that this requirement contradicts the license
332
+ restrictions of other proprietary libraries that do not normally
333
+ accompany the operating system. Such a contradiction means you cannot
334
+ use both them and the Library together in an executable that you
335
+ distribute.
336
+ ^L
337
+ 7. You may place library facilities that are a work based on the
338
+ Library side-by-side in a single library together with other library
339
+ facilities not covered by this License, and distribute such a combined
340
+ library, provided that the separate distribution of the work based on
341
+ the Library and of the other library facilities is otherwise
342
+ permitted, and provided that you do these two things:
343
+
344
+ a) Accompany the combined library with a copy of the same work
345
+ based on the Library, uncombined with any other library
346
+ facilities. This must be distributed under the terms of the
347
+ Sections above.
348
+
349
+ b) Give prominent notice with the combined library of the fact
350
+ that part of it is a work based on the Library, and explaining
351
+ where to find the accompanying uncombined form of the same work.
352
+
353
+ 8. You may not copy, modify, sublicense, link with, or distribute
354
+ the Library except as expressly provided under this License. Any
355
+ attempt otherwise to copy, modify, sublicense, link with, or
356
+ distribute the Library is void, and will automatically terminate your
357
+ rights under this License. However, parties who have received copies,
358
+ or rights, from you under this License will not have their licenses
359
+ terminated so long as such parties remain in full compliance.
360
+
361
+ 9. You are not required to accept this License, since you have not
362
+ signed it. However, nothing else grants you permission to modify or
363
+ distribute the Library or its derivative works. These actions are
364
+ prohibited by law if you do not accept this License. Therefore, by
365
+ modifying or distributing the Library (or any work based on the
366
+ Library), you indicate your acceptance of this License to do so, and
367
+ all its terms and conditions for copying, distributing or modifying
368
+ the Library or works based on it.
369
+
370
+ 10. Each time you redistribute the Library (or any work based on the
371
+ Library), the recipient automatically receives a license from the
372
+ original licensor to copy, distribute, link with or modify the Library
373
+ subject to these terms and conditions. You may not impose any further
374
+ restrictions on the recipients' exercise of the rights granted herein.
375
+ You are not responsible for enforcing compliance by third parties with
376
+ this License.
377
+ ^L
378
+ 11. If, as a consequence of a court judgment or allegation of patent
379
+ infringement or for any other reason (not limited to patent issues),
380
+ conditions are imposed on you (whether by court order, agreement or
381
+ otherwise) that contradict the conditions of this License, they do not
382
+ excuse you from the conditions of this License. If you cannot
383
+ distribute so as to satisfy simultaneously your obligations under this
384
+ License and any other pertinent obligations, then as a consequence you
385
+ may not distribute the Library at all. For example, if a patent
386
+ license would not permit royalty-free redistribution of the Library by
387
+ all those who receive copies directly or indirectly through you, then
388
+ the only way you could satisfy both it and this License would be to
389
+ refrain entirely from distribution of the Library.
390
+
391
+ If any portion of this section is held invalid or unenforceable under
392
+ any particular circumstance, the balance of the section is intended to
393
+ apply, and the section as a whole is intended to apply in other
394
+ circumstances.
395
+
396
+ It is not the purpose of this section to induce you to infringe any
397
+ patents or other property right claims or to contest validity of any
398
+ such claims; this section has the sole purpose of protecting the
399
+ integrity of the free software distribution system which is
400
+ implemented by public license practices. Many people have made
401
+ generous contributions to the wide range of software distributed
402
+ through that system in reliance on consistent application of that
403
+ system; it is up to the author/donor to decide if he or she is willing
404
+ to distribute software through any other system and a licensee cannot
405
+ impose that choice.
406
+
407
+ This section is intended to make thoroughly clear what is believed to
408
+ be a consequence of the rest of this License.
409
+
410
+ 12. If the distribution and/or use of the Library is restricted in
411
+ certain countries either by patents or by copyrighted interfaces, the
412
+ original copyright holder who places the Library under this License
413
+ may add an explicit geographical distribution limitation excluding those
414
+ countries, so that distribution is permitted only in or among
415
+ countries not thus excluded. In such case, this License incorporates
416
+ the limitation as if written in the body of this License.
417
+
418
+ 13. The Free Software Foundation may publish revised and/or new
419
+ versions of the Lesser General Public License from time to time.
420
+ Such new versions will be similar in spirit to the present version,
421
+ but may differ in detail to address new problems or concerns.
422
+
423
+ Each version is given a distinguishing version number. If the Library
424
+ specifies a version number of this License which applies to it and
425
+ "any later version", you have the option of following the terms and
426
+ conditions either of that version or of any later version published by
427
+ the Free Software Foundation. If the Library does not specify a
428
+ license version number, you may choose any version ever published by
429
+ the Free Software Foundation.
430
+ ^L
431
+ 14. If you wish to incorporate parts of the Library into other free
432
+ programs whose distribution conditions are incompatible with these,
433
+ write to the author to ask for permission. For software which is
434
+ copyrighted by the Free Software Foundation, write to the Free
435
+ Software Foundation; we sometimes make exceptions for this. Our
436
+ decision will be guided by the two goals of preserving the free status
437
+ of all derivatives of our free software and of promoting the sharing
438
+ and reuse of software generally.
439
+
440
+ NO WARRANTY
441
+
442
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
443
+ WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
444
+ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
445
+ OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
446
+ KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
447
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
448
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
449
+ LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
450
+ THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
451
+
452
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
453
+ WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
454
+ AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
455
+ FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
456
+ CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
457
+ LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
458
+ RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
459
+ FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
460
+ SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
461
+ DAMAGES.
462
+
463
+ END OF TERMS AND CONDITIONS
464
+ ^L
465
+ How to Apply These Terms to Your New Libraries
466
+
467
+ If you develop a new library, and you want it to be of the greatest
468
+ possible use to the public, we recommend making it free software that
469
+ everyone can redistribute and change. You can do so by permitting
470
+ redistribution under these terms (or, alternatively, under the terms
471
+ of the ordinary General Public License).
472
+
473
+ To apply these terms, attach the following notices to the library.
474
+ It is safest to attach them to the start of each source file to most
475
+ effectively convey the exclusion of warranty; and each file should
476
+ have at least the "copyright" line and a pointer to where the full
477
+ notice is found.
478
+
479
+
480
+ <one line to give the library's name and a brief idea of what it
481
+ does.>
482
+ Copyright (C) <year> <name of author>
483
+
484
+ This library is free software; you can redistribute it and/or
485
+ modify it under the terms of the GNU Lesser General Public
486
+ License as published by the Free Software Foundation; either
487
+ version 2 of the License, or (at your option) any later version.
488
+
489
+ This library is distributed in the hope that it will be useful,
490
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
491
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
492
+ Lesser General Public License for more details.
493
+
494
+ You should have received a copy of the GNU Lesser General Public
495
+ License along with this library; if not, write to the Free Software
496
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
497
+
498
+ Also add information on how to contact you by electronic and paper
499
+ mail.
500
+
501
+ You should also get your employer (if you work as a programmer) or
502
+ your
503
+ school, if any, to sign a "copyright disclaimer" for the library, if
504
+ necessary. Here is a sample; alter the names:
505
+
506
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the
507
+ library `Frob' (a library for tweaking knobs) written by James
508
+ Random Hacker.
509
+
510
+ <signature of Ty Coon>, 1 April 1990
511
+ Ty Coon, President of Vice
512
+
513
+ That's all there is to it!
514
+
515
+
data/README CHANGED
@@ -1,7 +1,7 @@
1
1
  Spreadsheet::ParseExcel - Get information from an Excel file.
2
2
  ============
3
- Version: 0.5.1
4
- Date: 2006-05-18
3
+ Version: 0.5.1.1
4
+ Date: 2006-08-29
5
5
 
6
6
  Short Description:
7
7
  Spreadsheet::ParseExcel allows you to get information out of a
@@ -21,20 +21,21 @@ Install
21
21
  De-Compress archive and enter its top directory.
22
22
  Then type:
23
23
 
24
- $ ruby setup.rb config
25
- $ ruby setup.rb setup
24
+ $ ruby install.rb config
25
+ $ ruby install.rb setup
26
26
  ($ su)
27
- # ruby setup.rb install
27
+ # ruby install.rb install
28
28
 
29
29
  You can also install files into your favorite directory
30
- by supplying setup.rb some options. Try "ruby setup.rb --help".
30
+ by supplying install.rb with some options. Try "ruby install.rb --help".
31
+ More information can be found in the redistributed file usage-en.txt
31
32
 
32
33
 
33
34
  Usage
34
35
  -----
35
36
  #!/usr/bin/env ruby
36
37
 
37
- require 'parseexcel/parser'
38
+ require 'parseexcel'
38
39
 
39
40
  # your first step is always reading in the file.
40
41
  # that gives you a workbook-object, which has one or more worksheets,
data/lib/parseexcel.rb ADDED
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env ruby
2
+ # ParseExcel -- parseexcel -- 29.08.2006 -- hwyss@ywesee.com
3
+
4
+ require 'parseexcel/parseexcel'
@@ -26,44 +26,54 @@ module Spreadsheet
26
26
  module ParseExcel
27
27
  class Format
28
28
  @@fmt_strs = {
29
- 0x00 => '@',
30
- 0x01 => '0',
31
- 0x02 => '0.00',
32
- 0x03 => '#,##0',
33
- 0x04 => '#,##0.00',
34
- 0x05 => '($#,##0_);($#,##0)',
35
- 0x06 => '($#,##0_);[RED]($#,##0)',
36
- 0x07 => '($#,##0.00_);($#,##0.00_)',
37
- 0x08 => '($#,##0.00_);[RED]($#,##0.00_)',
38
- 0x09 => '0%',
39
- 0x0A => '0.00%',
40
- 0x0B => '0.00E+00',
41
- 0x0C => '# ?/?',
42
- 0x0D => '# ??/??',
43
- 0x0E => 'm-d-yy',
44
- 0x0F => 'd-mmm-yy',
45
- 0x10 => 'd-mmm',
46
- 0x11 => 'mmm-yy',
47
- 0x12 => 'h:mm AM/PM',
48
- 0x13 => 'h:mm:ss AM/PM',
49
- 0x14 => 'h:mm',
50
- 0x15 => 'h:mm:ss',
51
- 0x16 => 'm-d-yy h:mm',
52
- #0x17-0x24 -- Differs in Natinal
53
- 0x25 => '(#,##0_);(#,##0)',
54
- 0x26 => '(#,##0_);[RED](#,##0)',
55
- 0x27 => '(#,##0.00);(#,##0.00)',
56
- 0x28 => '(#,##0.00);[RED](#,##0.00)',
57
- 0x29 => '_(*#,##0_);_(*(#,##0);_(*"-"_);_(@_)',
58
- 0x2A => '_($*#,##0_);_($*(#,##0);_(*"-"_);_(@_)',
59
- 0x2B => '_(*#,##0.00_);_(*(#,##0.00);_(*"-"??_);_(@_)',
60
- 0x2C => '_($*#,##0.00_);_($*(#,##0.00);_(*"-"??_);_(@_)',
61
- 0x2D => 'mm:ss',
62
- 0x2E => '[h]:mm:ss',
63
- 0x2F => 'mm:ss.0',
64
- 0x30 => '##0.0E+0',
65
- 0x31 => '@',
29
+ 0x00 => "@",
30
+ 0x01 => "0",
31
+ 0x02 => "0.00",
32
+ 0x03 => "#,##0",
33
+ 0x04 => "#,##0.00",
34
+ 0x05 => "($#,##0_);($#,##0)",
35
+ 0x06 => "($#,##0_);[RED]($#,##0)",
36
+ 0x07 => "($#,##0.00_);($#,##0.00_)",
37
+ 0x08 => "($#,##0.00_);[RED]($#,##0.00_)",
38
+ 0x09 => "0%",
39
+ 0x0A => "0.00%",
40
+ 0x0B => "0.00E+00",
41
+ 0x0C => "# ?/?",
42
+ 0x0D => "# ??/??",
43
+ 0x0E => "m-d-yy",
44
+ 0x0F => "d-mmm-yy",
45
+ 0x10 => "d-mmm",
46
+ 0x11 => "mmm-yy",
47
+ 0x12 => "h:mm AM/PM",
48
+ 0x13 => "h:mm:ss AM/PM",
49
+ 0x14 => "h:mm",
50
+ 0x15 => "h:mm:ss",
51
+ 0x16 => "m-d-yy h:mm",
52
+ #0x17-0x24 -- national differences?
53
+ 0x25 => "(#,##0_);(#,##0)",
54
+ 0x26 => "(#,##0_);[RED](#,##0)",
55
+ 0x27 => "(#,##0.00);(#,##0.00)",
56
+ 0x28 => "(#,##0.00);[RED](#,##0.00)",
57
+ 0x29 => "_(*#,##0_);_(*(#,##0);_(*\"-\"_);_(@_)",
58
+ 0x2A => "_($*#,##0_);_($*(#,##0);_(*\"-\"_);_(@_)",
59
+ 0x2B => "_(*#,##0.00_);_(*(#,##0.00);_(*\"-\"??_);_(@_)",
60
+ 0x2C => "_($*#,##0.00_);_($*(#,##0.00);_(*\"-\"??_);_(@_)",
61
+ 0x2D => "mm:ss",
62
+ 0x2E => "[h]:mm:ss",
63
+ 0x2F => "mm:ss.0",
64
+ 0x30 => "##0.0E+0",
65
+ 0x31 => "@",
66
66
  }
67
+ begin
68
+ require 'iconv'
69
+ iconv = Iconv.new('utf16le', 'latin1')
70
+ @@fmt_strs = @@fmt_strs.inject({}) { |memo, (key, val)|
71
+ memo.store(key, iconv.iconv(val))
72
+ memo
73
+ }
74
+ rescue
75
+ warn("default formats are encoded in ISO-8859-1")
76
+ end
67
77
  attr_accessor :font_no, :fmt_idx, :lock, :hidden, :style, :key_123
68
78
  attr_accessor :align_h, :wrap, :align_v, :just_last, :rotate, :indent
69
79
  attr_accessor :shrink, :merge, :read_dir, :encoding
@@ -23,6 +23,7 @@
23
23
  # OLEReader -- Spreadsheet::ParseExcel -- 05.06.2003 -- hwyss@ywesee.com
24
24
 
25
25
  require 'date'
26
+ require 'stringio'
26
27
 
27
28
  module OLE
28
29
  class UnknownFormatError < RuntimeError; end
@@ -90,7 +91,7 @@ module OLE
90
91
  end
91
92
  end
92
93
  end
93
- class Storage < File
94
+ class Storage
94
95
  PpsType_Root = 5
95
96
  PpsType_Dir = 1
96
97
  PpsType_File = 2
@@ -99,10 +100,18 @@ module OLE
99
100
  PpsSize = 0x80
100
101
  attr_reader :header
101
102
  def initialize(filename)
102
- super(filename, "r")
103
- binmode
103
+ case filename
104
+ when StringIO, File
105
+ @fh = filename
106
+ else
107
+ @fh = File.open(filename, "r")
108
+ end
109
+ @fh.binmode
104
110
  @header = get_header
105
111
  end
112
+ def close
113
+ @fh.close
114
+ end
106
115
  module PPS
107
116
  class Node
108
117
  attr_reader :no, :type, :prev_pps, :next_pps, :data
@@ -339,9 +348,11 @@ module OLE
339
348
  private
340
349
  def get_header
341
350
  #0. Check ID
342
- rewind
343
- return unless(read(8) == "\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1")
344
- Header.new(self)
351
+ @fh.rewind
352
+ unless(@fh.read(8) == "\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1")
353
+ raise UnknownFormatError
354
+ end
355
+ Header.new(@fh)
345
356
  end
346
357
  end
347
358
  def asc2ucs(str)
@@ -135,6 +135,9 @@ module Spreadsheet
135
135
  def each(skip=0, &block)
136
136
  @cells[skip..-1].each(&block)
137
137
  end
138
+ def num_rows
139
+ @cells.size
140
+ end
138
141
  def row(row)
139
142
  @cells[row] ||= []
140
143
  end
@@ -28,7 +28,7 @@ require 'test/unit'
28
28
  require 'parseexcel/olestorage'
29
29
 
30
30
  module OLE
31
- class Storage < File
31
+ class Storage
32
32
  public :get_header
33
33
  class Header
34
34
  attr_writer :bbd_info
@@ -126,6 +126,11 @@ class TestOLEStorage < Test::Unit::TestCase
126
126
  result = @ole.search_pps(lowercase, true)
127
127
  assert_equal(expected, result)
128
128
  end
129
+ def test_unknown_format
130
+ assert_raises(OLE::UnknownFormatError) {
131
+ OLE::Storage.new(StringIO.new('12345678'))
132
+ }
133
+ end
129
134
  end
130
135
  class TestOLEStorageHeader < Test::Unit::TestCase
131
136
  def setup
data/usage-en.txt ADDED
@@ -0,0 +1,112 @@
1
+ Installing Programs with install.rb / setup.rb
2
+ ==============================================
3
+
4
+ Overview
5
+ --------
6
+
7
+ Type these lines on command line:
8
+ ("#" line may require root privilege)
9
+
10
+ $ ruby install.rb config
11
+ $ ruby install.rb setup
12
+ # ruby install.rb install
13
+
14
+
15
+ There's no difference in a usage between install.rb
16
+ and setup.rb.
17
+
18
+ $ ruby setup.rb config
19
+ $ ruby setup.rb setup
20
+ # ruby setup.rb install
21
+
22
+
23
+ Details
24
+ -------
25
+
26
+ Usage of install.rb/setup.rb is:
27
+
28
+ ruby install.rb <global options>
29
+ ruby install.rb [<global options>] <task> [<task options>]
30
+
31
+
32
+ -q,--quiet
33
+ suppress message outputs
34
+ --verbose
35
+ output messages verbosely (default)
36
+ -h,--help
37
+ prints help and quit
38
+ -v,--version
39
+ prints version and quit
40
+ --copyright
41
+ prints copyright and quit
42
+
43
+ These are acceptable tasks:
44
+ config
45
+ saves configurations
46
+ show
47
+ prints current configurations
48
+ setup
49
+ compiles extentions
50
+ install
51
+ installs files
52
+ clean
53
+ cleans created files
54
+
55
+ Task Options for Config
56
+ -----------------------
57
+
58
+ --prefix=PATH
59
+ a prefix of the installing directory path
60
+ --std-ruby=PATH
61
+ the directory for standard ruby libraries
62
+ --site-ruby-common=PATH
63
+ the directory for version-independent non-standard
64
+ ruby libraries
65
+ --site-ruby=PATH
66
+ the directory for non-standard ruby libraries
67
+ --bin-dir=PATH
68
+ the directory for commands
69
+ --rb-dir=PATH
70
+ the directory for ruby scripts
71
+ --so-dir=PATH
72
+ the directory for ruby extentions
73
+ --data-dir=PATH
74
+ the directory for shared data
75
+ --ruby-path=PATH
76
+ path to set to #! line
77
+ --ruby-prog=PATH
78
+ the ruby program using for installation
79
+ --make-prog=NAME
80
+ the make program to compile ruby extentions
81
+ --without-ext
82
+ forces to install.rb never to compile/install
83
+ ruby extentions.
84
+ --rbconfig=PATH
85
+ your rbconfig.rb to load
86
+
87
+ You can view default values of these options by typing
88
+
89
+ $ ruby install.rb --help
90
+
91
+
92
+ In addition, setup.rb accepts these options:
93
+ --with=NAME,NAME,NAME...
94
+ package names which you want to install
95
+ --without=NAME,NAME,NAME...
96
+ package names which you do not want to install
97
+
98
+ [NOTE] You can pass options for extconf.rb like this:
99
+
100
+ ruby install.rb config -- --with-tklib=/usr/lib/libtk-ja.so.8.0
101
+
102
+
103
+ Task Options for Install
104
+ ------------------------
105
+
106
+ --no-harm
107
+ prints what to do and done nothing really.
108
+ --prefix=PATH
109
+ a prefix of the installing directory path.
110
+ This option may help binary package maintainers.
111
+ A default value is an empty string.
112
+
metadata CHANGED
@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
3
3
  specification_version: 1
4
4
  name: parseexcel
5
5
  version: !ruby/object:Gem::Version
6
- version: 0.5.1
7
- date: 2006-06-06 00:00:00 +02:00
6
+ version: 0.5.1.1
7
+ date: 2006-08-29 00:00:00 +02:00
8
8
  summary: Reads Excel documents on any platform
9
9
  require_paths:
10
10
  - lib
@@ -29,19 +29,20 @@ authors:
29
29
  - Hannes Wyss
30
30
  files:
31
31
  - lib/parseexcel
32
- - lib/parseexcel/olestorage.rb
33
- - lib/parseexcel/parseexcel.rb
32
+ - lib/parseexcel.rb
34
33
  - lib/parseexcel/worksheet.rb
35
34
  - lib/parseexcel/format.rb
35
+ - lib/parseexcel/olestorage.rb
36
36
  - lib/parseexcel/workbook.rb
37
37
  - lib/parseexcel/parser.rb
38
+ - lib/parseexcel/parseexcel.rb
38
39
  - test/data
39
40
  - test/suite.rb
40
41
  - test/test_format.rb
41
- - test/test_olestorage.rb
42
42
  - test/test_workbook.rb
43
43
  - test/test_worksheet.rb
44
44
  - test/test_parser.rb
45
+ - test/test_olestorage.rb
45
46
  - test/data/bar.xls
46
47
  - test/data/dates.xls
47
48
  - test/data/foo.xls
@@ -56,12 +57,16 @@ files:
56
57
  - test/data/comment.5.0.xls
57
58
  - test/data/annotation.xls
58
59
  - README
60
+ - COPYING
61
+ - usage-en.txt
59
62
  test_files:
60
63
  - test/suite.rb
61
64
  rdoc_options: []
62
65
 
63
66
  extra_rdoc_files:
64
67
  - README
68
+ - COPYING
69
+ - usage-en.txt
65
70
  executables: []
66
71
 
67
72
  extensions: []