viewworkbook 0.1.3

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: ca3d55e875c623f0c5f68504fa4b9c30cb599623277cd42717babd7067234554
4
+ data.tar.gz: 8199d7826f4c8edd0af5367bdabb88e41b86b998e3faa2fd828f13aa21042238
5
+ SHA512:
6
+ metadata.gz: 219f9555351a4e53c995f14a591241ffbaf57b23e4acaddf91e1141228662cfa9f42779c4ac175870364942d14f008ef2fbba3029f2e47b417f4573f6243cdbf
7
+ data.tar.gz: 955a93762333d83165c41c6dec9826e209c65ef1e6ef62955bfafc74b02cc10b323e02b4422b2cf4b921864fd155dd1289796d6bf02d26bec68921d9e3433987
@@ -0,0 +1,31 @@
1
+ #!/usr/bin/env ruby
2
+ #encoding: UTF-8
3
+ =begin
4
+ /***************************************************************************
5
+ * ©2011-2013, Michael Uplawski <michael.uplawski@uplawski.eu> *
6
+ * *
7
+ * This program is free software; you can redistribute it and/or modify *
8
+ * it under the terms of the GNU General Public License as published by *
9
+ * the Free Software Foundation; either version 3 of the License, or *
10
+ * (at your option) any later version. *
11
+ * *
12
+ * This program is distributed in the hope that it will be useful, *
13
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
14
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15
+ * GNU General Public License for more details. *
16
+ * *
17
+ * You should have received a copy of the GNU General Public License *
18
+ * along with this program; if not, write to the *
19
+ * Free Software Foundation, Inc., *
20
+ * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
21
+ ***************************************************************************/
22
+ =end
23
+
24
+ require_relative "../lib/viewworkbook.rb"
25
+
26
+ if(ARGV.compact.empty?)
27
+ puts purple("\n\tYou must name a valid spreadsheet file! Aborting\n")
28
+ puts
29
+ exit false
30
+ end
31
+ ViewWorkBook.new(ARGV[0])
@@ -0,0 +1,523 @@
1
+ <?xml version="1.0" encoding="utf-8" ?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
+ <head>
5
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
+ <meta name="generator" content="Docutils 0.13.1: http://docutils.sourceforge.net/" />
7
+ <title>Viewworkbook</title>
8
+ <style type="text/css">
9
+
10
+ /*
11
+ :Author: David Goodger (goodger@python.org)
12
+ :Id: $Id: html4css1.css 7952 2016-07-26 18:15:59Z milde $
13
+ :Copyright: This stylesheet has been placed in the public domain.
14
+
15
+ Default cascading style sheet for the HTML output of Docutils.
16
+
17
+ See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
18
+ customize this style sheet.
19
+ */
20
+
21
+ /* used to remove borders from tables and images */
22
+ .borderless, table.borderless td, table.borderless th {
23
+ border: 0 }
24
+
25
+ table.borderless td, table.borderless th {
26
+ /* Override padding for "table.docutils td" with "! important".
27
+ The right padding separates the table cells. */
28
+ padding: 0 0.5em 0 0 ! important }
29
+
30
+ .first {
31
+ /* Override more specific margin styles with "! important". */
32
+ margin-top: 0 ! important }
33
+
34
+ .last, .with-subtitle {
35
+ margin-bottom: 0 ! important }
36
+
37
+ .hidden {
38
+ display: none }
39
+
40
+ .subscript {
41
+ vertical-align: sub;
42
+ font-size: smaller }
43
+
44
+ .superscript {
45
+ vertical-align: super;
46
+ font-size: smaller }
47
+
48
+ a.toc-backref {
49
+ text-decoration: none ;
50
+ color: black }
51
+
52
+ blockquote.epigraph {
53
+ margin: 2em 5em ; }
54
+
55
+ dl.docutils dd {
56
+ margin-bottom: 0.5em }
57
+
58
+ object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
59
+ overflow: hidden;
60
+ }
61
+
62
+ /* Uncomment (and remove this text!) to get bold-faced definition list terms
63
+ dl.docutils dt {
64
+ font-weight: bold }
65
+ */
66
+
67
+ div.abstract {
68
+ margin: 2em 5em }
69
+
70
+ div.abstract p.topic-title {
71
+ font-weight: bold ;
72
+ text-align: center }
73
+
74
+ div.admonition, div.attention, div.caution, div.danger, div.error,
75
+ div.hint, div.important, div.note, div.tip, div.warning {
76
+ margin: 2em ;
77
+ border: medium outset ;
78
+ padding: 1em }
79
+
80
+ div.admonition p.admonition-title, div.hint p.admonition-title,
81
+ div.important p.admonition-title, div.note p.admonition-title,
82
+ div.tip p.admonition-title {
83
+ font-weight: bold ;
84
+ font-family: sans-serif }
85
+
86
+ div.attention p.admonition-title, div.caution p.admonition-title,
87
+ div.danger p.admonition-title, div.error p.admonition-title,
88
+ div.warning p.admonition-title, .code .error {
89
+ color: red ;
90
+ font-weight: bold ;
91
+ font-family: sans-serif }
92
+
93
+ /* Uncomment (and remove this text!) to get reduced vertical space in
94
+ compound paragraphs.
95
+ div.compound .compound-first, div.compound .compound-middle {
96
+ margin-bottom: 0.5em }
97
+
98
+ div.compound .compound-last, div.compound .compound-middle {
99
+ margin-top: 0.5em }
100
+ */
101
+
102
+ div.dedication {
103
+ margin: 2em 5em ;
104
+ text-align: center ;
105
+ font-style: italic }
106
+
107
+ div.dedication p.topic-title {
108
+ font-weight: bold ;
109
+ font-style: normal }
110
+
111
+ div.figure {
112
+ margin-left: 2em ;
113
+ margin-right: 2em }
114
+
115
+ div.footer, div.header {
116
+ clear: both;
117
+ font-size: smaller }
118
+
119
+ div.line-block {
120
+ display: block ;
121
+ margin-top: 1em ;
122
+ margin-bottom: 1em }
123
+
124
+ div.line-block div.line-block {
125
+ margin-top: 0 ;
126
+ margin-bottom: 0 ;
127
+ margin-left: 1.5em }
128
+
129
+ div.sidebar {
130
+ margin: 0 0 0.5em 1em ;
131
+ border: medium outset ;
132
+ padding: 1em ;
133
+ background-color: #ffffee ;
134
+ width: 40% ;
135
+ float: right ;
136
+ clear: right }
137
+
138
+ div.sidebar p.rubric {
139
+ font-family: sans-serif ;
140
+ font-size: medium }
141
+
142
+ div.system-messages {
143
+ margin: 5em }
144
+
145
+ div.system-messages h1 {
146
+ color: red }
147
+
148
+ div.system-message {
149
+ border: medium outset ;
150
+ padding: 1em }
151
+
152
+ div.system-message p.system-message-title {
153
+ color: red ;
154
+ font-weight: bold }
155
+
156
+ div.topic {
157
+ margin: 2em }
158
+
159
+ h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
160
+ h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
161
+ margin-top: 0.4em }
162
+
163
+ h1.title {
164
+ text-align: center }
165
+
166
+ h2.subtitle {
167
+ text-align: center }
168
+
169
+ hr.docutils {
170
+ width: 75% }
171
+
172
+ img.align-left, .figure.align-left, object.align-left, table.align-left {
173
+ clear: left ;
174
+ float: left ;
175
+ margin-right: 1em }
176
+
177
+ img.align-right, .figure.align-right, object.align-right, table.align-right {
178
+ clear: right ;
179
+ float: right ;
180
+ margin-left: 1em }
181
+
182
+ img.align-center, .figure.align-center, object.align-center {
183
+ display: block;
184
+ margin-left: auto;
185
+ margin-right: auto;
186
+ }
187
+
188
+ table.align-center {
189
+ margin-left: auto;
190
+ margin-right: auto;
191
+ }
192
+
193
+ .align-left {
194
+ text-align: left }
195
+
196
+ .align-center {
197
+ clear: both ;
198
+ text-align: center }
199
+
200
+ .align-right {
201
+ text-align: right }
202
+
203
+ /* reset inner alignment in figures */
204
+ div.align-right {
205
+ text-align: inherit }
206
+
207
+ /* div.align-center * { */
208
+ /* text-align: left } */
209
+
210
+ .align-top {
211
+ vertical-align: top }
212
+
213
+ .align-middle {
214
+ vertical-align: middle }
215
+
216
+ .align-bottom {
217
+ vertical-align: bottom }
218
+
219
+ ol.simple, ul.simple {
220
+ margin-bottom: 1em }
221
+
222
+ ol.arabic {
223
+ list-style: decimal }
224
+
225
+ ol.loweralpha {
226
+ list-style: lower-alpha }
227
+
228
+ ol.upperalpha {
229
+ list-style: upper-alpha }
230
+
231
+ ol.lowerroman {
232
+ list-style: lower-roman }
233
+
234
+ ol.upperroman {
235
+ list-style: upper-roman }
236
+
237
+ p.attribution {
238
+ text-align: right ;
239
+ margin-left: 50% }
240
+
241
+ p.caption {
242
+ font-style: italic }
243
+
244
+ p.credits {
245
+ font-style: italic ;
246
+ font-size: smaller }
247
+
248
+ p.label {
249
+ white-space: nowrap }
250
+
251
+ p.rubric {
252
+ font-weight: bold ;
253
+ font-size: larger ;
254
+ color: maroon ;
255
+ text-align: center }
256
+
257
+ p.sidebar-title {
258
+ font-family: sans-serif ;
259
+ font-weight: bold ;
260
+ font-size: larger }
261
+
262
+ p.sidebar-subtitle {
263
+ font-family: sans-serif ;
264
+ font-weight: bold }
265
+
266
+ p.topic-title {
267
+ font-weight: bold }
268
+
269
+ pre.address {
270
+ margin-bottom: 0 ;
271
+ margin-top: 0 ;
272
+ font: inherit }
273
+
274
+ pre.literal-block, pre.doctest-block, pre.math, pre.code {
275
+ margin-left: 2em ;
276
+ margin-right: 2em }
277
+
278
+ pre.code .ln { color: grey; } /* line numbers */
279
+ pre.code, code { background-color: #eeeeee }
280
+ pre.code .comment, code .comment { color: #5C6576 }
281
+ pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
282
+ pre.code .literal.string, code .literal.string { color: #0C5404 }
283
+ pre.code .name.builtin, code .name.builtin { color: #352B84 }
284
+ pre.code .deleted, code .deleted { background-color: #DEB0A1}
285
+ pre.code .inserted, code .inserted { background-color: #A3D289}
286
+
287
+ span.classifier {
288
+ font-family: sans-serif ;
289
+ font-style: oblique }
290
+
291
+ span.classifier-delimiter {
292
+ font-family: sans-serif ;
293
+ font-weight: bold }
294
+
295
+ span.interpreted {
296
+ font-family: sans-serif }
297
+
298
+ span.option {
299
+ white-space: nowrap }
300
+
301
+ span.pre {
302
+ white-space: pre }
303
+
304
+ span.problematic {
305
+ color: red }
306
+
307
+ span.section-subtitle {
308
+ /* font-size relative to parent (h1..h6 element) */
309
+ font-size: 80% }
310
+
311
+ table.citation {
312
+ border-left: solid 1px gray;
313
+ margin-left: 1px }
314
+
315
+ table.docinfo {
316
+ margin: 2em 4em }
317
+
318
+ table.docutils {
319
+ margin-top: 0.5em ;
320
+ margin-bottom: 0.5em }
321
+
322
+ table.footnote {
323
+ border-left: solid 1px black;
324
+ margin-left: 1px }
325
+
326
+ table.docutils td, table.docutils th,
327
+ table.docinfo td, table.docinfo th {
328
+ padding-left: 0.5em ;
329
+ padding-right: 0.5em ;
330
+ vertical-align: top }
331
+
332
+ table.docutils th.field-name, table.docinfo th.docinfo-name {
333
+ font-weight: bold ;
334
+ text-align: left ;
335
+ white-space: nowrap ;
336
+ padding-left: 0 }
337
+
338
+ /* "booktabs" style (no vertical lines) */
339
+ table.docutils.booktabs {
340
+ border: 0px;
341
+ border-top: 2px solid;
342
+ border-bottom: 2px solid;
343
+ border-collapse: collapse;
344
+ }
345
+ table.docutils.booktabs * {
346
+ border: 0px;
347
+ }
348
+ table.docutils.booktabs th {
349
+ border-bottom: thin solid;
350
+ text-align: left;
351
+ }
352
+
353
+ h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
354
+ h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
355
+ font-size: 100% }
356
+
357
+ ul.auto-toc {
358
+ list-style-type: none }
359
+
360
+ </style>
361
+ </head>
362
+ <body>
363
+ <div class="document" id="viewworkbook">
364
+ <h1 class="title">Viewworkbook</h1>
365
+ <h2 class="subtitle" id="view-spreadsheet-files-in-a-terminal-window">view spreadsheet files in a terminal window</h2>
366
+
367
+ <div class="section" id="synopsis">
368
+ <h1>SYNOPSIS</h1>
369
+ <p>viewworkbook &lt;spreadsheet&gt;</p>
370
+ </div>
371
+ <div class="section" id="description">
372
+ <h1>DESCRIPTION</h1>
373
+ <p>Viewworkbook lets you read spreadsheet-files in text-mode, in a terminal
374
+ window. It reproduces the tables which are contained in a spreadsheet file and
375
+ lets you navigate through the sheets. The visible part of a sheet is limited
376
+ laterally and horizontally by the terminal-size but can be scrolled. You can
377
+ adapt the width of table-columns, to render the table more readable and
378
+ finally, if you wish, save tables to a text-file. To the author of the
379
+ program, the utility serves to take a quick glance at spreadsheets that are
380
+ received via email, in the Mutt mail-client, which is itself a terminal
381
+ application.</p>
382
+ <p>The supported spreadsheet formats are those which are handled by the Ruby-gem
383
+ &quot;<strong>roo</strong>&quot; (February 2017):</p>
384
+ <ul class="simple">
385
+ <li>Microsoft™'s <strong>xls</strong> and <strong>xlsx</strong>,</li>
386
+ <li>the OpenDocument spreadsheet <strong>ods</strong></li>
387
+ <li>and the SoftMaker™ spreadsheet formats <strong>pmd</strong> and <strong>pmdx</strong>.</li>
388
+ </ul>
389
+ </div>
390
+ <div class="section" id="options">
391
+ <h1>Options</h1>
392
+ <p>Other than the path to the spreadsheet file, viewworkbook does currently not
393
+ interpret any command line arguments.</p>
394
+ <div class="section" id="menu-commands">
395
+ <h2>Menu commands</h2>
396
+ <p>A list of commands and their associated hotkeys (in parenthesis) is shown
397
+ below the current table:</p>
398
+ <table border="1" class="docutils">
399
+ <colgroup>
400
+ <col width="3%" />
401
+ <col width="14%" />
402
+ <col width="14%" />
403
+ <col width="14%" />
404
+ <col width="14%" />
405
+ <col width="14%" />
406
+ <col width="14%" />
407
+ <col width="14%" />
408
+ </colgroup>
409
+ <thead valign="bottom">
410
+ <tr><th class="head">11</th>
411
+ <th class="head">12.2</th>
412
+ <th class="head">July</th>
413
+ <th class="head">34000</th>
414
+ <th class="head">5%</th>
415
+ <th class="head">prior</th>
416
+ <th class="head">1957</th>
417
+ <th class="head">true</th>
418
+ </tr>
419
+ <tr><th class="head">12</th>
420
+ <th class="head">2.33</th>
421
+ <th class="head">July</th>
422
+ <th class="head">1234</th>
423
+ <th class="head">12.2%</th>
424
+ <th class="head">prior</th>
425
+ <th class="head">1966</th>
426
+ <th class="head">true</th>
427
+ </tr>
428
+ <tr><th class="head">13</th>
429
+ <th class="head">50.0</th>
430
+ <th class="head">August</th>
431
+ <th class="head">334566</th>
432
+ <th class="head">12%</th>
433
+ <th class="head">in</th>
434
+ <th class="head">1966</th>
435
+ <th class="head">false</th>
436
+ </tr>
437
+ </thead>
438
+ <tbody valign="top">
439
+ <tr><td>&nbsp;</td>
440
+ <td>A</td>
441
+ <td>B</td>
442
+ <td>C</td>
443
+ <td>D</td>
444
+ <td>E</td>
445
+ <td>F</td>
446
+ <td>G</td>
447
+ </tr>
448
+ </tbody>
449
+ </table>
450
+ <p><strong>value (v) * save to file (f) * sheet (s) * column (c) * up(i) * down(k) * left(j) * right(l) * quit (q) *</strong></p>
451
+ <p>When you enter one of the hotkeys, a command can be executed directly (like &quot;q&quot;
452
+ to terminate the program), a sub-menu may be shown (like with &quot;c&quot; which shall
453
+ give you control on column properties) or you are confronted with an input
454
+ invitation (like with &quot;v&quot;, where you have to enter a cell-reference). Read on
455
+ for an explanation of each menu command.</p>
456
+ <blockquote>
457
+ <dl class="docutils">
458
+ <dt>value (v)</dt>
459
+ <dd>display the value from a cell. This is useful, when columns are not wide
460
+ enough to show complete values. After entering &quot;<strong>v</strong>&quot;, you are
461
+ immediately invited to enter a cell reference. Cells are referenced in
462
+ the format &quot;Column:Row&quot;, e.g. D:12 for the cell in column &quot;D&quot; and row
463
+ &quot;12&quot;.</dd>
464
+ <dt>save to file (f)</dt>
465
+ <dd>Save the current or all tables to a text file. The command does initially
466
+ show two alternative sub-commands:</dd>
467
+ <dt>Current sheet (c) * all sheets (a)</dt>
468
+ <dd>Independently of your choice, in the next step you will have to enter the
469
+ path to the output file. You will be warned, if the file already exists
470
+ and may choose to either overwrite the existing file or name a different
471
+ one.</dd>
472
+ <dt>sheet (s)</dt>
473
+ <dd>Navigate to a different sheet in the current workbook. You may choose
474
+ between a sheet-number and the name of a sheet. If you want to indicate
475
+ the next sheet <strong>by name</strong>, the list of all available names is first
476
+ shown. You just type right away the one that you want.</dd>
477
+ <dt>column (c)</dt>
478
+ <dd>Alter the properties of the table-columns. At the time of this writing
479
+ (February 2017) the only property that can be changed, is the width of all
480
+ columns. When you enter &quot;<strong>c</strong>&quot; the subcommand column width (w) is shown.
481
+ After entering &quot;<strong>w</strong>&quot; you can enter the desired width in characters.</dd>
482
+ <dt>Arrows(i, j, k, l)</dt>
483
+ <dd>Navigate in a sheet that is too big to be displayed entirely at once.
484
+ These hotkeys correspond to the default navigation keys in the vi editor.</dd>
485
+ <dt>quit (q)</dt>
486
+ <dd>Enter &quot;<strong>q</strong>&quot; to quit the program at any moment except when an input
487
+ invitation is shown.</dd>
488
+ </dl>
489
+ </blockquote>
490
+ </div>
491
+ <div class="section" id="hidden-menu-commands">
492
+ <h2>Hidden (menu-)commands</h2>
493
+ <p>There is currently only one such command available:
494
+ The <strong>Escape-key</strong> will interrupt an unfinished action and refresh the display.</p>
495
+ </div>
496
+ </div>
497
+ <div class="section" id="other-information">
498
+ <h1>Other Information</h1>
499
+ <blockquote>
500
+ <dl class="docutils">
501
+ <dt>Development and source code</dt>
502
+ <dd>Viewworkbook has been written in Ruby. As Ruby is an interpreted programming
503
+ language, the executable file and all those that it may refer to at one
504
+ point in time, are themselves the source-files of the current
505
+ program-version. You can open them in any text-editor to scrutinize the
506
+ source-code. If you have received the program as a Ruby-gem, you can also
507
+ decompress a copy of the gem-file with <strong>tar -x</strong>, then <strong>tar -xzf</strong>.</dd>
508
+ <dt>Bugs</dt>
509
+ <dd>Negative values are not always displayed, when very long (like 15 ciphers).
510
+ Enlarging the column-width further does not have an effect.</dd>
511
+ <dt>License</dt>
512
+ <dd>Viewworkbook is distributed under the conditions of the GNU General Public
513
+ License, version 3.</dd>
514
+ <dt>Author</dt>
515
+ <dd>Viewworkbook has been developed by Michael Uplawski
516
+ &lt;<a class="reference external" href="mailto:michael.uplawski&#64;uplawski.eu">michael.uplawski&#64;uplawski.eu</a>&gt;</dd>
517
+ </dl>
518
+ </blockquote>
519
+ <p><strong>Ω</strong></p>
520
+ </div>
521
+ </div>
522
+ </body>
523
+ </html>