RubyGems - viewworkbook - Versions diffs - 0.1.3 → 0.2 - Mend

viewworkbook 0.1.3 → 0.2

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.

Files changed (21) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca3d55e875c623f0c5f68504fa4b9c30cb599623277cd42717babd7067234554
-  data.tar.gz: 8199d7826f4c8edd0af5367bdabb88e41b86b998e3faa2fd828f13aa21042238
+  metadata.gz: 4ea17c22ed36a2ee8c245622927a8aaa61b9f3b728ad8187d1ba7b12f9ee96ce
+  data.tar.gz: ed2fed97be3c121166774666db444c4f5012e1c669087e22bb45e656c3d7f5dc
 SHA512:
-  metadata.gz: 219f9555351a4e53c995f14a591241ffbaf57b23e4acaddf91e1141228662cfa9f42779c4ac175870364942d14f008ef2fbba3029f2e47b417f4573f6243cdbf
-  data.tar.gz: 955a93762333d83165c41c6dec9826e209c65ef1e6ef62955bfafc74b02cc10b323e02b4422b2cf4b921864fd155dd1289796d6bf02d26bec68921d9e3433987
+  metadata.gz: a5a5120bd2585eda4981751ca381250eba81efac51e8238da37fb0c60820c3c466da5af6fc97d8d65a9f249647f64c53c1d18727cef93fa778dc50683ea496c7
+  data.tar.gz: ad2f49b95c35e2d05e3ee5fa1f4954de464286abcefc213ce04c59d910b333ebe66be6e1ddf6cbf518ab0fc5a58a0d6ac2fd25fe1fba35875d130b15b0a31676

data/README.md ADDED Viewed

@@ -0,0 +1,126 @@
+Viewworkbook
+========================
+view spreadsheet files in a terminal window
+--------------------------
+SYNOPSIS
+========================
+viewworkbook \<spreadsheet\>
+DESCRIPTION
+========================
+Viewworkbook lets you read spreadsheet-files in text-mode, in a terminal
+window. It reproduces the tables which are contained in a spreadsheet file and
+lets you navigate through the sheets. The visible part of a sheet is limited
+laterally and horizontally by the terminal-size but can be scrolled. You can
+adapt the width of table-columns, to render the table more readable and
+finally, if you wish, save tables to a text-file.  To the author of the
+program, the utility serves to take a quick glance at spreadsheets that are
+received via email, in the Mutt mail-client, which is itself a terminal
+application.
+The supported spreadsheet formats are those which are handled by the Ruby-gem
+"**roo**" (February 2017):
+- Microsoft™'s **xls** and **xlsx**,
+- the OpenDocument spreadsheet **ods**
+- and the SoftMaker™ spreadsheet formats **pmd** and **pmdx**.
+Options
+========================
+Other than the path to the spreadsheet file, viewworkbook does currently not
+interpret any command line arguments.
+Menu commands
+========================
+A list of commands and their associated hotkeys (in parenthesis) is shown
+below the current table:
+|  |        |        |        |        |        |        |        |      |
+|--|--------|--------|--------|--------|--------|--------|--------|------|
+|11| 12.2   |  July  |  34000 | 5%     | prior  | 1957   | true   |      |
+|12|  2.33  |  July  |   1234 | 12.2%  | prior  | 1966   | true   |      |
+|13| 50.0   | August | 334566 | 12%    | in     | 1966   | false  |      |
+|  |       A|       B|       C|       D|       E|       F|       G|      |
+**value (v) * save to file (f) * sheet (s) * column (c) * up(i) * down(k) * left(j) * right(l) * quit (q) ***
+When you enter one of the hotkeys, a command can be executed directly (like "q"
+to terminate the program), a sub-menu may be shown (like with "c" which shall
+give you control on column properties) or you are confronted with an input
+invitation (like with "v", where you have to enter a cell-reference).  Read on
+for an explanation of each menu command.
+* **value (v)**
+display the value from a cell. This is useful, when columns are not wide
+nough to show complete values.  After entering "**v**", you are
+immediately invited to enter a cell reference.  Cells are referenced in
+the format "Column:Row", e.g. D:12 for the cell in column "D" and row
+"12".
+* **save to file (f)**
+Save the current or all tables to a text file. The command does initially
+show two alternative sub-commands:
+* **Current sheet (c) * all sheets (a)**
+Independently of your choice, in the next step you will have to enter the
+path to the output file.  You will be warned, if the file already exists
+and may choose to either overwrite the existing file or name a different
+one.
+* **sheet (s)**
+Navigate to a different sheet in the current workbook. You may choose
+between a sheet-number and the name of a sheet. If you want to indicate
+the next sheet **by name**, the list of all available names is first
+shown. You just type right away the one that you want.
+* **column (c)**
+Alter the properties of the table-columns.  At the time of this writing
+(February 2017) the only property that can be changed, is the width of all
+columns.  When you enter "**c**" the subcommand column width (w) is shown.
+After entering "**w**" you can enter the desired width in characters.
+* **Arrows(i, j, k, l)**
+Navigate in a sheet that is too big to be displayed entirely at once.
+These hotkeys correspond to the default navigation keys in the vi editor.
+* **quit (q)**
+Enter "**q**" to quit the program at any moment except when an input
+invitation is shown.
+Hidden (menu-)commands
+------------------------
+There is currently only one such command available:
+The **Escape-key** will interrupt an unfinished action and refresh the display.
+Other Information
+==================
+Development and source code
+---------------------------
+Viewworkbook has been written in Ruby. As Ruby is an interpreted programming
+language, the executable file and all those that it may refer to at one
+point in time, are themselves the source-files of the current
+program-version. You can open them in any text-editor to scrutinize the
+source-code. If you have received the program as a Ruby-gem, you can also
+decompress a copy of the gem-file with **tar -x**, then **tar -xzf**.
+Bugs
+----
+Negative values are not always displayed, when very long (like 15 ciphers).
+Enlarging the column-width further does not have an effect.
+License
+-------
+Viewworkbook is distributed under the conditions of the WTFPL-2 or later
+version; see https://wtfpl2.com for details.
+Author
+------
+Viewworkbook has been developed by Michael Uplawski
+<michael.uplawski@uplawski.eu>
+*Ω*

data/bin/viewworkbook CHANGED Viewed

@@ -2,26 +2,28 @@
 #encoding: UTF-8
 =begin
 /***************************************************************************
- *   ©2011-2013, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *   ©2016-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
- *   (at your option) any later version.                                   *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
- *   GNU General Public License for more details.                          *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
 =end
 require_relative "../lib/viewworkbook.rb"
+require_relative "../lib/basic_logging.rb"
+BasicLogging::set_target STDOUT
+BasicLogging::set_level BasicLogging::INFO
+# comment in for verbose output
+# BasicLogging::set_target "/tmp/viewworkbook.log"
+# BasicLogging::set_level BasicLogging::DEBUG
 if(ARGV.compact.empty?)
   puts purple("\n\tYou must name a valid spreadsheet file! Aborting\n")

data/lib/action.rb CHANGED Viewed

@@ -1,32 +1,25 @@
 #encoding: UTF-8
 =begin
 /***************************************************************************
- *   Copyright © 2014, Michael Uplawski <michael.uplawski@uplawski.eu>     *
+ *   ©2016-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
- *   (at your option) any later version.                                   *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
- *   GNU General Public License for more details.                          *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
 =end
-require_relative 'logging'
+require_relative 'basic_logging'
 # An Action is executed on a user's request.
 # It has a name, an associated closure and hotkey.
 class Action
-  include Logging
+  include BasicLogging
   class ActionError < StandardError
   end
@@ -39,7 +32,6 @@ class Action
   def initialize(options = {}, &b)
-    init_logger(STDOUT, Logger::INFO)
     @name = options[:name]
     @key = options[:key]

data/lib/basic_logging.rb ADDED Viewed

@@ -0,0 +1,178 @@
+#!/bin/env ruby
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2023-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
+#
+# Simplified logging.
+# See example code at the bottom of this file.
+# Execute this file to see the output.
+#
+#require 'time'
+module BasicLogging
+  DEBUG = 0
+  INFO =  1
+  WARN =  2
+  ERROR = 3
+  FATAL = 4
+  UNKNOWN = nil
+  # this is mainly for the translation of method calls into log levels
+  Levels = {:debug => DEBUG, :info => INFO, :warn => WARN, :error => ERROR,
+            :fatal => FATAL, :unknown => UNKNOWN}
+  @@log_level = UNKNOWN
+  @@target = STDOUT
+  @@muted = []
+  # do not log, if caller is obj (class or instance)
+  def self.mute(obj)
+    name = obj.class == Class ? obj.name.dup : obj.class.name
+    @@muted << name
+  end
+  def self.is_muted?(obj)
+    name = obj.class == Class ? obj.name.dup : obj.class.name
+    @@muted.include?(name)
+  end
+  # set the log level
+  def self::set_level(lv)
+    if lv.respond_to?(:to_str)
+      lv = Levels[lv.to_sym]
+    end
+    if(!lv || (lv.respond_to?(:to_int) && lv >= DEBUG && lv <= FATAL) )
+      @@log_level = lv
+    else
+      STDERR.puts __FILE__.dup << ": ERROR : invalid log level \"" << lv.to_s << "\""
+      STDERR.puts "Keepinng old log level " << Levels.keys.detect {| k| Levels[k] == @@log_level}.to_s
+    end
+  end
+  def set_level(lv)
+    BasicLogging::set_level(lv)
+  end
+  # set the log target
+  def self::set_target(tg)
+    if tg.respond_to?(:to_io)
+      @@target = tg
+    elsif(!File::exist?(tg) || ( File.file?(tg) && File.writable?(tg) ) )
+      @@target = File.open(tg, 'w+')
+    else
+      STDERR.puts __FILE__.dup << ': ERROR : target ' << tg << ' cannot be set'
+      STDERR.puts "Keeping old target " << @@target.inspect
+      return
+    end
+  end
+  def set_target(tg)
+    BasicLogging::set_target(tg)
+  end
+  # Output of log messages, depending on the log level set for the calling class
+  # and the name of the alias method which is actually called.
+  def log(message)
+    if !BasicLogging.is_muted?(self)
+      # how has this method been called?
+      mlevel = __callee__
+      if Levels.has_key?(mlevel) && Levels[mlevel] <=  FATAL
+        # output only for levels equal or above the value that corresponds to
+        # the calling alias.
+        format_log( message, mlevel) if @@log_level && Levels[mlevel] >= @@log_level
+      else
+        STDERR.puts __FILE__.dup << ": ERROR : invalid log level \"" << mlevel.to_s << "\""
+      end
+    end
+  end
+  alias :debug :log
+  alias :info :log
+  alias :warn :log
+  alias :error :log
+  alias :fatal :log
+  attr_reader :target, :log_level
+  private
+  # 1 format_log for all loggers.
+  def format_log(message, mlevel)
+    # indicate if a registered class or the registered object of a class is calling.
+    name = self.class == Class ? self.name.dup << ' [class]' : self.class.name
+    @@target.puts '' << name << ' ' << mlevel.to_s << ' ' << Time.now.strftime("%H:%M:%S:%6N")  << ': ' << message
+  end
+end
+#---------test: execute file----------
+if $0 == __FILE__
+  Array.extend(BasicLogging)
+  Array.set_level(BasicLogging::INFO)
+  Array.info('TEST')
+  ar = Array.new
+  ar.extend(BasicLogging)
+  # --- no output :
+  l = __LINE__
+  ar.debug(l.next.to_s << ': debug-test 0')
+  # output
+  ar.set_level(BasicLogging::DEBUG)
+  l = __LINE__
+  ar.debug(l.next.to_s << ': debug-test 1')
+  obj = Object.new
+  obj.extend(BasicLogging)
+  obj.set_level(BasicLogging::DEBUG)
+  puts "--------debug-----------"
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------info-----------"
+  obj.set_level("info")
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------fatal-----------"
+  obj.set_level("fatal")
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------UNKNOWN-----------"
+  obj.set_level(nil)
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts " ------ Output into file ----"
+  obj.set_target "/tmp/test_log.log"
+  puts " ------ INFO -----------"
+  obj.set_level BasicLogging::INFO
+  obj.info('info output')
+  obj.info('info output 2')
+  puts "---------- invalid -------"
+  obj.set_target "/dev/sr0"
+  obj.set_level "power"
+end
+# EOF

data/lib/cell.rb CHANGED Viewed

@@ -1,27 +1,19 @@
 #encoding: UTF-8
 =begin
 /***************************************************************************
- *   Copyright ©2016-2016, Michael Uplawski <michael.uplawski@uplawski.eu> *
+ *   ©2016-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
- *   (at your option) any later version.                                   *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
- *   GNU General Public License for more details.                          *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
 =end
-require_relative 'logging'
+require_relative 'basic_logging'
 require_relative 'row'
 require_relative 'column'
@@ -32,19 +24,18 @@ class Cell
   @@DEF_TYPE=Integer
   @@split_pattern = nil
-  self.extend(Logging)
-  @@log = self.init_logger
+  include BasicLogging
   def initialize(row = nil, col = nil, value = nil)
-    @log = @@log
     @row = row if row
     @col = col if col
+    @debinfo = '(' << @col.number.to_s << ':' << @row.number.to_s << ') '
     @type_class = @@DEF_TYPE
     @value = value
     split_value
     set_limits
     @row.resize
-    @log.debug("cell.initialize, lines is #{@lines}, value is #{value}, ideal_width is #{@ideal_width}")
+    debug(@debinfo << "cell.initialize, lines is #{@lines}, value is #{value}, ideal_width is #{@ideal_width}")
   end
   def to_cell()
@@ -70,7 +61,7 @@ class Cell
     @@split_pattern = nil
     @value = value
     split_value
-    @log.debug('after split_value, lines is ' <<  @lines.to_s)
+    debug(@debinfo << 'after split_value, lines is ' <<  @lines.to_s)
   end
   def col

data/lib/color_output.rb CHANGED Viewed

@@ -1,5 +1,21 @@
 #encoding 'UTF-8'
+=begin
+/***************************************************************************
+ *   ©2016-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
 # functions to apply colors to terminal output
 COLORS = {:default => 9, :black => 0, :red => 1, :green => 2, :yellow => 3, :blue => 4, :purple => 5, :cyan => 6, :white => 7 }

data/lib/column.rb CHANGED Viewed

@@ -2,38 +2,30 @@
 =begin
 /***************************************************************************
- *   Copyright ©2016-2016, Michael Uplawski <michael.uplawski@uplawski.eu> *
+ *   ©2016-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
- *   (at your option) any later version.                                   *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
- *   GNU General Public License for more details.                          *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
 =end
-require_relative 'logging'
+require_relative 'basic_logging'
 # Objects of this class represent columns in a spreadsheet table
 class Column
-  self.extend(Logging)
-  @@log = self.init_logger
+  include BasicLogging
   @@DEF_WIDTH=15
   @@col_width=@@DEF_WIDTH
   @@columns = Array.new
   def initialize(number = nil)
-    @log = @@log
     @number = number
     @cells = Array.new
     @width = @@col_width
@@ -48,7 +40,7 @@ class Column
       n_cell = Cell.new( cell, @number)
     else
       msg = 'For a new cell, a row-number must be specified'
-      @log.error(yellow(msg))
+      error(yellow(msg))
       raise StandardError(msg)
     end
     @cells.insert(n_cell.row, n_cell)
@@ -68,14 +60,14 @@ class Column
   def self::col_width=(w)
     @@col_width = w
-    @log.debug("self::col_width=(#{w}), calling resize")
+    debug(@number.to_s << ' ' <<"self::col_width=(#{w}), calling resize")
     @@columns.each {|col| col.resize(w)}
   end
   def resize(width)
     @width = width
-    @log.debug('calling resize')
+    debug(@number.to_s << ' ' <<'calling resize')
     @cells.each {|cell| cell.resize}
   end

data/lib/file_checking.rb CHANGED Viewed

@@ -1,25 +1,21 @@
 #encoding: UTF-8
 =begin
 /***************************************************************************
- *   ©2011-2013 Michael Uplawski <michael.uplawski@uplawski.eu>            *
+ *   ©2011-2024, Michael Uplawski <michael.uplawski@uplawski.eu>           *
  *                                                                         *
  *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 3 of the License, or     *
- *   (at your option) any later version.                                   *
+ *   it under the terms of the WTFPL 2.0 or later, see                     *
+ *   http://www.wtfpl.net/about/                                           *
  *                                                                         *
  *   This program is distributed in the hope that it will be useful,       *
  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
- *   GNU General Public License for more details.                          *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
  *                                                                         *
- *   You should have received a copy of the GNU General Public License     *
- *   along with this program; if not, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
 =end
+require 'filemagic'
 =begin
 A module to facilitate frequently occuring checks on
 file-system objects
@@ -39,6 +35,10 @@ module File_Checking
     :directory => "is not a directory!",
     :file? => "is not a file!",
     :file => "is not a file!",
+    :type => "is not of the sought file-type (not '%s', but '%s')!",
+    :type? => "is not of the sought file-type (not '%s', but '%s')!",
+    :mime => "does not have the sought mime-type (not '%s', but '%s')!",
+    :mime? => "does not have the sought mime-type (not '%s', but '%s')!",
   }
   # Checks if the file with the name from the first
@@ -76,12 +76,37 @@ module File_Checking
     end
     msg
   end
-end
+  def self.mime_check(file, mime_type)
+    fm = FileMagic.mime
+    fd = fm.fd(File.new(file) ).split(';')[0]
+    if fd != mime_type.strip
+             return file.dup << ' ' << (@@text_messages[:mime] %[mime_type, fd])
+    end
+    return nil
+  end
+  def self.magic_check(file, magic)
+    fm = FileMagic.fm
+    fd = fm.fd(File.new(file) ).split(';')[0]
+    if fd != magic.strip
+             return file.dup << ' ' << (@@text_messages[:type] %[magic, fd])
+    end
+    return nil
+  end
+end # module
 =begin
 # example
 include File_Checking
 msg = file_check('some_file.txt', [:exist?, :readable?, 'writable'])
+# same as
+# msg = file_check('some_file.txt', [:exist, :readable, 'writable?'])
+msg ||= magic_check('some_file.txt', [:type?], 'OpenDocument Text'
+msg ||= mime_check('some_file.txt', [:mime?], 'application/vnd.oasis.opendocument.text'
 puts msg if msg
 =end
+# E O F