sqlite2dbf 0.1.8 → 0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a174046549fd4651a2dcabcf6ab907d790f4b0ac
-  data.tar.gz: 24e59b0daac11a547ba42166bbca9c7390255e91
+  metadata.gz: 7ff3c85738ba063a8b74ca3729e4f4d34fd0310f
+  data.tar.gz: abfe59914da80f1118822e0a3ebf91a93c5f5a40
 SHA512:
-  metadata.gz: 6928d69a1a10f29487437ea08fdba0fa8df2fd2a4be45295e31992a77d7f75773ac07d4d49c268055fac789d6fd7b54ccf957107ce005d461630aaf54e9a4018
-  data.tar.gz: 32a353698e77bc9a64773af5715053fb302190bf437ec640fb734f2d4c3cd1a645c7c28636a46039b84a51b4cb27c8925643d81b686f52f260403c59feb7244d
+  metadata.gz: ef5cbc10c43925b74b319b9049d81ccd9c04e95d2158ddb0954f7232377eff0c2a3323cd4b333193e3947bd7599bdbe0081baa6f8d59752fc77c432bb682048e
+  data.tar.gz: 48b7629bcf6b490f3f1396d61991a48134a1b6dc05be084136bd49cd0bafbbac7b77714e84a344adb3a50f7d0c1fc1d7211231ba12d1879ba40ce02494807544

data/lib/argparser.rb

@@ -30,46 +30,56 @@ require_relative 'constants'
 
 class ArgParser 
 
-	self.extend(Logging)
-	self.extend(Translating)
-	@@log = init_logger()
-
-	# Returns a structure describing the options.
-	#
-	def self.parse(args)
-		# The options specified on the command line will be collected in <b>options</b>.
-		# We set default values here.
-		
-		options = OpenStruct.new
-		options.debug = false 
-		options.table_name = false
-
-		op = OptionParser.new do |opts|
-			opts.banner = "\n" << trl("Usage") << ":\t" << $APPNAME.dup << ' ' << trl("-s [sqlite-file] [options]") << "\n\t" << trl("or %s [Common options]") %($APPNAME) 
-
-			opts.separator ""
-			opts.separator trl("Specific options") << ':'
-
-			opts.on('-' << trl("s"), '--' << trl("source [FILE.sqlite]"), trl( "SQLite-file to read.")) do |source|
-				options.source = source
-			end
-
-			opts.on('-' << trl("t"), '--' << trl("target [FILE(0...n).dbf]"), trl( "Name for the dBase-files (1 per table) to be written.")) do |target|
-				options.target = target
-			end
-	
-			opts.on('--' << trl("time [list]"), trl( "A list of space-separated fields (table-columns) which shall be handled as timestamp values.")) do |list|
-				options.time = list.gsub(/[,;]/, '').split
-			end
-			
-			opts.on('--' << trl("dates [list]"), trl( "A list of space-separated fields (table-columns) which shall be handled as date-time values.")) do |list|
-				options.datetime = list.gsub(/[,;]/, '').split
-			end
-
-			opts.on('-' << trl('o'), trl("--orig [PATH]"), trl('Use the table-name as file-name for the DBF-result, store output in PATH')) do |path|
-				options.table_name = true
-				options.out_dir = path
-			end
+  self.extend(Logging)
+  self.extend(Translating)
+  @@log = init_logger()
+  
+  # Returns a structure describing the options.
+  #
+  def self.parse(args)
+    # The options specified on the command line will be collected in <b>options</b>.
+    # We set default values here.
+
+    options = OpenStruct.new
+
+    op = OptionParser.new do |opts|
+      opts.banner = "\n" << trl("Usage") << ":\t" << $APPNAME.dup << ' ' << trl("-s [SQLite-file] [options]") << "\n\t" << trl("or %s [Common options]") %($APPNAME) 
+
+      opts.separator ""
+      opts.separator trl("Specific options") << ':'
+
+      opts.on('-' << trl("s"), '--' << trl("source [PATH]"), trl( "SQLite-file to read.")) do |source|
+	options.source = source
+      end
+
+      opts.on('-' << trl('c'), '--' << trl("config [PATH]"), trl('Configuration file for this transformation')) do |config|
+              options.config = config
+      end
+
+      opts.on('-' << trl('n'), '--' << trl("name [TABLE]"), trl('The name of the table from the SQLite-database to convert')) do |name|
+	options.name = name
+      end
+
+      opts.on('-' << trl("t"), '--' << trl("target [PATH]"), trl( "Path to the dBase-file to be written.")) do |target|
+	options.target = target
+      end
+
+      opts.on('-' << trl("l"), '--' << trl("list"), trl( "Show the list of available tables and exit")) do |target|
+	options.list = true
+      end
+
+      opts.on('-' << trl('o'), '--' << trl("out [PATH]"), trl('Use the table-name as file-name for the DBF-result, store output in PATH')) do |path|
+	options.name_like_table = true
+	options.out = path
+      end
+
+      opts.on('--' << trl("time [list]"), trl( "Fields (table-columns) which shall be handled as timestamp values.")) do |list|
+	options.time = list.gsub(/[,;]/, '').split
+      end
+
+      opts.on('--' << trl("date [list]"), trl( "Fields (table-columns) which shall be handled as date-time values.")) do |list|
+	options.datetime = list.gsub(/[,;]/, '').split
+      end
 
 =begin
 
@@ -87,39 +97,39 @@ opts.on("-g", "--generic [CONFIG FILE]",
 	options.generic = File.expand_path(file )
 end
 =end
-			opts.separator ""
-			opts.separator trl("Common options") << ':'
-
-			# No argument, shows at tail.  This will print an options summary.
-			#
-			opts.on_tail(trl("-d"), trl("--debug"), trl("Show debug-messages") ) do
-				options.debug = true
-				@@log.level = Logger::DEBUG
-			end
-
-
-			opts.on_tail(trl("-h"), trl("--help"), trl("Show this message") ) do
-				puts opts
-				exit true
-			end
-
-			opts.on_tail(trl("-v"), trl("--version"), trl("Show version and program information") ) do
-				puts "\t#{$APPNAME}"
-				puts "\t© #{$YEARS}, } <#{$AUTHORS.join(', ')}>"
-				exit true
-			end
-		end
-		begin
-			op.parse!(args)
-		rescue OptionParser::ParseError => er
-			msg = trl("ERROR! Unsuitable or incomplete program-arguments") << (": %s" %er.message	)
-			puts msg
-			puts trl("Start this program with parameter -h or --help to see the usage-message.")
-			exit false
-		end
-
-		options
-	end  # parse()
+      opts.separator ""
+      opts.separator trl("Common options") << ':'
+
+      # No argument, shows at tail.  This will print an options summary.
+      #
+      opts.on_tail(trl("-d"), trl("--debug"), trl("Show debug-messages") ) do
+	options.debug = true
+	@@log.level = Logger::DEBUG
+      end
+
+
+      opts.on_tail(trl("-h"), trl("--help"), trl("Show this message") ) do
+	puts opts
+	exit true
+      end
+
+      opts.on_tail(trl("-v"), trl("--version"), trl("Show version and program information") ) do
+	puts "\t#{$APPNAME}"
+	puts "\t© #{$YEARS}, <#{$AUTHORS.join(', ')}>"
+	exit true
+      end
+    end
+    begin
+      op.parse!(args)
+    rescue OptionParser::ParseError => er
+      msg = trl("ERROR! Unsuitable or incomplete program-arguments") << (": %s" %er.message	)
+      puts msg
+      puts trl("Start this program with parameter -h or --help to see the usage-message.")
+      exit false
+    end
+
+    options
+  end  # parse()
 
 end  
 

data/lib/config

@@ -0,0 +1,104 @@
+#
+#   ©2016-2016, Michael Uplawski <michael.uplawski@souris-libre.fr>  
+#   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.                                   
+#                                                                          
+#   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.                          
+#                                                                         
+#   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.             
+# =========================================================================
+
+# Exemplary configuration file for sqlite2dbf.
+# Overwrite the settings in this file by either naming a different file with
+# the --config parameter or by specifying each or some of the options on the
+# command-line.
+
+# The syntax of this file or your own versions is simple:
+# Under the name of an option, you note the value that the option should adopt.
+# Indent the value by 1 space minimum.  The option-names are identical to the
+# long options, which can be used on the command-line, like, for example
+# --source.
+# 
+# Example: If you transform the always same database with this
+# configuration-file, you note the path to the SQLite-file under the option
+# “source:”, like this:
+# source:
+#   /path/to_the/database/file.sqlite
+# i.e. with one or several spaces in front of the value.  Lines with a leading
+# hashmark are comments. Keep them intact.
+# 
+# The following option “save_what” is not used by SQlite2DBF but shall serve as
+# EXAMPLE.
+save_what:
+ our_ship
+
+# -------------- Define your own settings below this line -------------------
+#
+# The source-file (sqlite).
+#
+#   Value: a SQLite database file which can be opened for reading.
+# Example: /data/my_database/customers.sqlite
+#          ./my_employers.sqlite
+#          F:\\Path_to_database\Products.db
+# Default: empty (required on the command-line)
+source: 
+
+# The name of the table, which is converted.
+#
+#   Value: A string which corresponds to the name of a
+#          table in the SQLite-database
+# Example: employees
+#          Price-list
+# Default: empty (required on the command-line)
+name: 
+
+# The target-file (dBase).
+#
+#   Value: The path to the file, that should be written.
+# Example: /data/my_database/customers.dbf
+#          ./my_employers.dbf
+#          F:\\Path_to_database\Products.dbf
+# Default: empty (NOT required)
+target:
+
+# Fields which shall be treated as time.
+#
+#   Value: One field-name or a list of space-separated
+#          field-names (columns). 
+# Example: created
+#          "created last_accessed"
+# Default: empty (NOT required)
+time: 
+
+# Fields which shall be treated as date-time.
+#
+#   Value: One field-name or a list of space-separated field-names (columns).  
+# Example: joined
+#          "expires since last_update"
+# Default: empty (NOT required)
+date: last_visit_date
+
+# Shall the dBase-file be named after the table?  Is set by specifying a
+# target-directory as value to this option.
+#
+#   Value: Path to the target directory
+# Example: /data/base/dBase/
+# Default: empty (NOT required)
+out:
+
+# Shall debug messages be printed out? You can modify the logging-
+# options also in the file log.conf, that you find in the sub-directory lib of
+# the gem-directory. This way, you can direct all output to 1 or several files.
+#
+#   Value: true, yes, false or no (same as empty)
+# Example: yes
+# Default: empty/no/false (NOT required)
+debug: 

data/lib/configuration.rb

@@ -0,0 +1,114 @@
+#encoding: UTF-8 
+=begin
+/***************************************************************************
+ *   ©2016 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.                                   *
+ *                                                                         *
+ *   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.                          *
+ *                                                                         *
+ *   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 'yaml'
+require 'singleton'
+require 'ostruct'
+require_relative 'file_checking'
+require_relative 'logging'
+require_relative 'translating'
+
+class Configuration
+  include File_Checking
+  include Logging
+  include Singleton
+  include Translating
+
+  # default configuration file
+  @@config_file = File::dirname(__FILE__) << File::Separator << 'config'
+
+  # do initializations
+  def initialize()
+    init_logger()
+  end
+
+  # Configure with the command-line arguments.
+  def set(options)
+    @log.debug('options are: ' << options.to_s )
+    # User-provided configuration-file?
+    if(options['config'])
+      cf = options['config'] 
+      msg = check_file(cf, :file, :readable)
+      if(!msg) 
+        @@config_file = cf
+      else
+        msg = trl("The file %s " << msg.split[1,100].join(' ')) %msg.split[0]
+        @log.error(trl("ERROR! Unsuitable file") << ' ' << msg)
+        give_up
+      end
+    end
+
+    @log.debug('config-file is ' << @@config_file)
+    # read defaults from configuration-file
+    co = OpenStruct.new(YAML::load_file(@@config_file))
+    # merge and overwrite with the comman-line arguments
+    @config = co.to_h.merge(options.to_h)
+    @log.debug('config is now: ' << @config.to_s )
+    verify
+  end
+
+  # return any value stored in @config
+  def method_missing(msg, *args)
+    ms = msg.to_sym
+    # Exception-handling is not a control-structure.
+    # This is.
+    if @config[ms]
+      return @config[ms]
+    else
+      return nil
+    end
+  end
+
+  private
+
+  # exit on error
+  def give_up
+    @log.error("\t" << trl("Aborting. Bye!"))
+    exit false
+  end
+
+  # Do a maximum of verifications. 
+  # Not everything is possible before the database has been read.
+  def verify
+    msg = nil
+    # ensure :source is set
+    if(! @config[:source] )
+      msg = trl('missing argument %s') %'source' 
+      # either :name or :list are needed in addition
+    elsif (!@config[:name] && !@config[:list])
+      msg = trl("Either --name (-n) or --list (-l) is needed as additional program-argument" )
+    end
+
+    # avoid contradicting options
+    if !msg && @config[:target] && @config[:out]
+      msg = trl("contradictory arguments (%s):" %['target', 'out'])
+    end
+
+    if msg
+      @log.error msg
+      @log.error(trl("Start this program with parameter -h or --help to see the usage-message.") )
+      give_up
+    end
+  end
+
+end
+
+#eof

data/lib/constants.rb

@@ -1,6 +1,6 @@
 $APPNAME = 'sqlite2dbf'
-$VERSION = '0.1.8'
-$DATE = '2016-11-12'
+$VERSION = '0.2'
+$DATE = '2016-11-24'
 $AUTHORS = ["Michael Uplawski <michael.uplawski@uplawski.eu>"]
 $EMAIL = 'michael.uplawski@uplawski.eu'
 $LICENSE = 'GPL-3.0'

data/lib/file_checking.rb

@@ -27,57 +27,57 @@ but maybe you find it useful.
 =end
 module File_Checking
 
-	@@text_messages  = {
-		:exist? => "does not exist!",
-		:exist => "does not exist!",
-		:readable? => "is not readable!",
-		:readable => "is not readable!",
-		:executable? => "is not executable!",
-		:executable => "is not executable!",
-		:writable? => "is not writable!",
-		:writable => "is not writable!",
-		:directory? => "is not a directory!",
-		:directory => "is not a directory!",
-		:file? => "is not a file!",
-		:file => "is not a file!",
-	}
+  @@text_messages  = {
+    :exist? => "does not exist!",
+    :exist => "does not exist!",
+    :readable? => "is not readable!",
+    :readable => "is not readable!",
+    :executable? => "is not executable!",
+    :executable => "is not executable!",
+    :writable? => "is not writable!",
+    :writable => "is not writable!",
+    :directory? => "is not a directory!",
+    :directory => "is not a directory!",
+    :file? => "is not a file!",
+    :file => "is not a file!",
+  }
 
-	# Checks if the file with the name from the first
-	# parameter has the properties, listed in the second. 
-	# The messages parameter is an array of one or several
-	# of :exist?, :readable?, :writable?, :directory?  or 
-	# their string-representations, respectively. 
-	# Returns nil in case of success, otherwise an 
-	# informative message, describing the first negative
-	# test-result.
-	def file_check(file, *messages)
-		File_Checking.file_check(file, *messages)
-	end
+  # Checks if the file with the name from the first
+  # parameter has the properties, listed in the second. 
+  # The messages parameter is an array of one or several
+  # of :exist?, :readable?, :writable?, :directory?  or 
+  # their string-representations, respectively. 
+  # Returns nil in case of success, otherwise an 
+  # informative message, describing the first negative
+  # test-result.
+  def file_check(file, *messages)
+    File_Checking.file_check(file, *messages)
+  end
 
-	# Checks if the file with the name from the first
-	# parameter has the properties, listed in the second. 
-	# The messages parameter is an array of one or all
-	# of :exist?, :readable?, :writable?, :directory? or
-	# their string-representations, respectively. 
-	# Returns nil in case of success, otherwise an 
-	# informative message, describing the first negative
-	# test-result.
-	def self.file_check(file, *messages)
-		msg = nil
-		if(file && messages.respond_to?(:to_ary) && !messages.empty?)
-			messages.each do |k|
-				if(! k.to_s.end_with?('?'))	
-					k = (k.to_s << '?').to_sym
-				end
-				@log.debug ('checking ' << k.to_s) if @log
-				if(msg == nil && File.respond_to?(k) && ! File.send(k, file.to_s))
-					msg = "#{file} #{@@text_messages[k.to_sym]}"
-				end
-			end
-		end
-		msg
+  # Checks if the file with the name from the first
+  # parameter has the properties, listed in the second. 
+  # The messages parameter is an array of one or all
+  # of :exist?, :readable?, :writable?, :directory? or
+  # their string-representations, respectively. 
+  # Returns nil in case of success, otherwise an 
+  # informative message, describing the first negative
+  # test-result.
+  def self.file_check(file, *messages)
+    msg = nil
+    if(file && messages.respond_to?(:to_ary) && !messages.empty?)
+      messages.each do |k|
+	if(! k.to_s.end_with?('?'))	
+	  k = (k.to_s << '?').to_sym
+	end
+	@log.debug ('checking ' << k.to_s) if @log
+	if(msg == nil && File.respond_to?(k) && ! File.send(k, file.to_s))
+	  msg = "#{file} #{@@text_messages[k.to_sym]}"
 	end
-	alias :check_file :file_check
+      end
+    end
+    msg
+  end
+  alias :check_file :file_check
 end
 
 =begin

data/lib/log.conf

@@ -47,6 +47,9 @@ unknown = Logger::UNKNOWN
 
 :ArgParser => info,
 :SQLite2DBF => info,
+:Configuration => info,
+:Translating => info,
+:Mapping => info
 
 # And ignore the remainder, too.
 }