sqlite2dbf 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 45babe3b6624235add48f6c62c22a5aaccefc294
+  data.tar.gz: bd7ed59177cb0fa945defa4e0413558bcdd5823b
+SHA512:
+  metadata.gz: c7920489b4c73e5f1799c8cf5a695ad97cd30dfe294b68cf377d9e02e53df306277223197b3fc5a1b8c77008e6dea5140163b87f71cc9c4438f323f58816ce99
+  data.tar.gz: 2dccbcbd83841acb53670181820f58f9cb1df999437f89d492894384a3a52a3dc5b64780097abddb0a4163100f6e1a612a3af7ad4247d8588d79036350397cc3

data/bin/sqlite2dbf

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2013, 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_relative '../lib/sqlite2dbf'
+SQLite2DBF.new(*ARGV)

data/lib/argparser.rb

@@ -0,0 +1,113 @@
+#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 'optparse'
+require 'optparse/time'
+require 'ostruct'
+require_relative 'logging'
+require_relative 'translating'
+require_relative 'constants'
+
+class ArgParser 
+	include Logging
+	include Translating
+
+	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 
+
+		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/sqlite-file [FILE.sqlite]"), trl( "SQLite-file to read.")) do |source|
+				options.source = source
+			end
+			opts.on('-' << trl("t"), '--' << trl("dBase-files [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('o'), trl("--orig"), trl('Use the table-name as file-name for the DBF-result')) do
+				options.table_name = true
+			end
+
+=begin
+
+# This is for later. The evaluation of the file-content may be allocated to the
+# Configuration singleton, as it does not mean a lot of I/O nor does it imply 
+# much management.
+
+opts.on("-c", "--config [CONFIG FILE]",
+	"Read alternative configuration from this file") do |conf|
+	$LOG.debug("config-file should be #{conf}") if $LOG
+	options.config = File.expand_path(conf )
+end
+opts.on("-g", "--generic [CONFIG FILE]",
+	"Write generic configuration options to this file") do |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
+			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/constants.rb

@@ -0,0 +1,9 @@
+$APPNAME = 'sqlite2dbf'
+$VERSION = '0.1.6'
+$DATE = '2016-11-12'
+$AUTHORS = ["Michael Uplawski <michael.uplawski@uplawski.eu>"]
+$EMAIL = 'michael.uplawski@uplawski.eu'
+$LICENSE = 'GPL-3.0'
+
+$YEARS = '2016'
+

data/lib/file_checking.rb

@@ -0,0 +1,89 @@
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-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
+
+=begin
+A module to facilitate frequently occuring checks on
+file-system objects. You can certainly do without this, 
+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!",
+	}
+
+	# 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
+	end
+	alias :check_file :file_check
+end
+
+=begin
+# example
+
+include File_Checking
+msg = file_check('some_file.txt', [:exist?, :readable?, 'writable'])
+puts msg if msg
+=end

data/lib/log.conf

@@ -0,0 +1,53 @@
+#encoding: UTF-8 
+=begin
+/***************************************************************************
+ *   ©2013-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.             *
+ ***************************************************************************/
+
+A simplified logger configuration. Set the level for each individual logger
+below. Choose a different log-device or log-file if you like. Keep the 
+formatting intact.  Do not change other sections of this file.
+=end
+
+# Do not touch from here ----->
+require 'logger'
+
+debug = Logger::DEBUG
+info = Logger::INFO
+error = Logger::ERROR
+fatal = Logger::FATAL
+warn = Logger::WARN
+unknown = Logger::UNKNOWN
+{
+# <---------------- to here !
+
+# Enter your settings here, but take into consideration that not all 
+# the named classes will really produce readable output. Well, you can 
+# always try... Either name just the log-level or make the log-level
+# precede the output-device or output-file like in the examples.
+
+# Example: naming a log-file
+# :HtmlBuilder => [info, 'C:\temp\htmlbuilder.log']
+# :HtmlBuilder => [debug, '/tmp/htmlbuilder.log'],
+
+:SQLite2DBF => info,
+
+# And ignore the remainder, too.
+}
+
+#eof

data/lib/logging.rb

@@ -0,0 +1,193 @@
+#encoding: UTF-8 
+=begin
+/***************************************************************************
+ *   ©2011-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 'logger'
+require_relative 'file_checking'
+
+=begin Creates a member @log and precede its output with the name of the class
+of the object. 
+Example for a class-level logger:
+# --------------------
+class TClass
+	self.extend(Logging)
+	@@log = init_logger(STDOUT)
+	def test_log
+		@@log.info('class-level logger called from instance: ' << @@log.to_s)
+		@log = @@log
+		@log.info('AGAIN: class-level logger called from instance: ' << @log.to_s)
+	end
+	def self::test_log
+		@log.info('class-level logger called from class: ' << @log.to_s)
+		@@log.info('AGAIN: class-level logger called from class: ' << @@log.to_s)
+	end
+end
+#---------------------
+Example for a object-level logger:
+ATTN! This means 1 logger per object.
+# --------------------
+class TClass
+	include Logging
+	def initialize
+		init_logger(STDOUT, Logger::DEBUG)
+	end
+	def test_log
+		@log.debug('called test_log() ')
+	end
+end
+=end
+module Logging
+	include File_Checking
+
+	@@have_log = false
+	@@LOG_CONF = File.dirname(File.absolute_path(__FILE__)) << File::Separator << 'log.conf'
+
+	# Call this method in an instance-method (e.g. initialize() ) to define the
+	# object-level logger; i.e. an object-specific member @log.
+	# Call this method within the class-definition for a class-level logger; i.e.
+	# a member @log for class-level acces.
+	# The method returns the logger, so you can actually do what you want with it.
+	def init_logger(target = STDOUT, level = Logger::INFO)
+		# Prepare for a class-level logger. This is actually quite cool.
+		
+		# ---> Ingeniuous code starts here
+		cn = (self.class == Class ? name : self.class.name)
+		# <--- Ingeniuous code ends here
+		
+		# allow to override the set log-levels with an
+		# external configuration (log.conf).
+		log_conf(cn)
+		# Or use the defaults as set here or elsewhere...
+
+		@level ||= level 
+		@target ||= target
+
+		@log = Logger.new(@target)
+		@log.level = @level
+
+		@log.formatter = proc do |severity, datetime, progname, msg|
+			t = Time.now
+			"#{cn}: #{severity} #{t.hour}-#{t.min}-#{t.sec}: #{msg}\n"
+		end
+		if ! @@have_log
+			@log.debug cn.dup << ' reading logging-configuration from ' << @@LOG_CONF	
+			@@have_log = true
+			@log.debug('level is ' << level.to_s)
+		end
+		return @log
+	end
+
+	# Set the log-target to an IO object.
+	def log_target=(target)
+		@target = target
+		@log = Logger.new(@@target)
+		@log.level = @level
+	end
+
+	# set the log-level
+	def log_level=(level)
+		@level = level
+		@log.level = @level
+	end
+
+	private
+
+	# Override or set the log-level and target-device, as set in a file 'log.conf'.
+	# I do not like the look of this, but it works just the way I want it to.
+	# "HEAVANS! Isn't there a standard way to do this in Ruby, for Christ's sake?", you say.
+	# Heck, I don't care. <= Read that again, I say.
+	def log_conf(cn = nil)
+		config = level = target = nil
+		# puts 'log-config is in ' << @@LOG_CONF
+		if(File::exist?(@@LOG_CONF) )
+			begin
+				conf = File.read(@@LOG_CONF)
+				config = instance_eval(conf)
+			rescue Exception => ex
+				STDERR.puts "WARNING! Cannot evaluate the logger-configuration!" << ' ' << ex.message
+				STDERR.puts "Default log-levels apply."
+			end
+		else
+			puts "Default log-levels apply."
+		end
+
+		if(config && config.respond_to?(:to_hash) )
+			config.default = nil
+			if cn
+				config = config[cn.to_sym]
+			else
+				config = config[self.class.name.to_sym]
+			end
+
+			if(config )
+				if(config.respond_to?(:to_ary) && config.size == 2)
+					@level, @target = config
+					@target.downcase!
+					logdir = File.dirname(@target)
+					msg = file_check(logdir, :exist?, :directory?, :writable?)
+					if(msg) 
+						STDERR.puts "WARNING! A logfile for '%s' cannot be written to %s (%s)!" %[self.class.name, logdir, msg] 
+						@target = nil
+					end
+				else
+					@level = config
+				end	
+			end
+		end
+	end
+end
+
+######### test
+if __FILE__ == $0
+	class TClass
+		# class level ---->
+		self.extend(Logging)
+		@@log = init_logger(STDOUT, Logger::INFO)
+		# <------
+		# object-level ---->
+		include Logging
+		# <---------
+
+		def test_log
+			@@log.info('class-level logger called from instance: ' << @@log.to_s)
+			#@log = @@log # works too
+			@log = TClass.class_eval{@log}
+			@log.info('AGAIN: class-level logger called from instance: ' << @log.to_s)
+			@log.debug("you won't see this on log-level INFO")
+
+			# object-level ---->
+			init_logger
+			# <-----------
+			@log.info("That's a different thing: " << @log.to_s << " - object-level logger!")
+
+		end
+		def self::test_log
+			@log.info('class-level logger called from class: ' << @log.to_s)
+			@@log.info('AGAIN: class-level logger called from class: ' << @log.to_s)
+		end
+	end
+
+	TClass.new.test_log # class-logger + 1st object-logger
+	TClass.new.test_log # same class-logger + 2nd object-logger
+
+	TClass::test_log # same class-logger
+	puts 'And just say it once clearly: THIS IS COOOL!!'
+end
+#EOF

data/lib/sqlite2dbf.rb

@@ -0,0 +1,136 @@
+#!/usr/bin/env ruby
+#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_relative 'file_checking'
+require_relative 'logging'
+require 'shp'
+require 'sqlite3'
+require_relative 'argparser'
+
+=begin
+ 	The main program class. Does it.
+=end
+
+class SQLite2DBF
+	include Logging
+	include Translating
+
+	def initialize(*args)
+		options = ArgParser::parse(args)
+		init_logger
+		level = (options.debug ? Logger::DEBUG : @log.level)
+		@log.level = level	
+		@log.debug('options are: ' << options.to_s)
+
+		if(options.source)
+			sqlite_file = options.source	
+			dbf_file = options.target if options.target
+			dbf_file = :table if options.table_name
+			dbf_file ||= File.dirname(sqlite_file) << File::Separator << File.basename(sqlite_file, '.*')
+			msg = nil
+		
+			if(dbf_file != :table)
+				if(File.exist?(dbf_file))
+					msg = File_Checking.file_check(dbf_file, :file, :writable)
+				elsif(File.exist?(File.dirname(dbf_file))) 
+					msg = File_Checking.file_check(File.dirname(dbf_file), :directory, :writable)
+				end
+			end
+
+			msg ||= File_Checking.file_check(sqlite_file, :exist, :readable, :file)
+
+			if(!msg)
+				@log.debug('will transform ' << sqlite_file << ' to  ' << dbf_file.to_s << '.dbf')
+				transform(sqlite_file, dbf_file)
+			else
+				msg = trl("ERROR! Unsuitable file") << " : %s" %msg
+				@log.error(msg)
+				exit false
+			end
+		else
+			puts trl("ERROR! Source-file is a mandatory program parameter!")
+			puts trl("Start this program with parameter -h or --help to see the usage-message.")  
+		end
+
+	end
+
+	private
+
+	def transform(sqlite_file, dbf_file)
+		# <------------ mapping SQLite-types to SHP/XBase ------------>
+		tmap = {'INT' => 1, 'TINYINT' => 1, 'SMALLINT' => 1, 'MEDIUMINT' => 1, 'BIGINT' => 1, 'UNSIGNED BIGINT' => 1, 'VARCHAR' => 0, 'CHARACTER' => 0, 'VARYING CHARACTER(255)' => 0, 'LONGVARCHAR' => 0, 'TEXT' => 0, 'INTEGER' => 1, 'FLOAT' => 2, 'REAL' => 2, 'DOUBLE' => 2}
+		# -----------> in a way ... <--------------
+		
+		begin
+			SQLite3::Database.new(sqlite_file) do |db|
+				table_names = db.execute('select name from sqlite_master WHERE type="table"') 
+				@log.debug('sqlite contains ' << table_names.size.to_s << ' table(s): ' << table_names.join(', '))
+				table_names.each_with_index do |tn, num| 
+					tname = tn.join
+					table_info = db.table_info(tname) 
+					@log.debug(tn[0] << ': ' << table_info.join)
+					content = db.execute('select * from ' << tname ) 
+					if(:table == dbf_file)	
+						dbf_name = tname << (content.empty? ? '_empty' : '')<< '.dbf'
+					else
+						dbf_name = dbf_file.dup << num.to_s << (content.empty? ? '_empty' : '')<< '.dbf'
+					end
+					@log.debug('dbf will be ' << dbf_name)
+					dbt = SHP::DBF.create(dbf_name) 
+					table_info.each_with_index do |field, index|
+						ftype = 0 
+						# -----> determine the simple dbf data-type that has to do. <----
+						sql_type = tmap.keys.detect {|kt| field['type'].start_with?(kt) }
+						ftype ||= tmap[sql_type]
+						# <---- Yes. I know. ---->
+
+						dbt.add_field(field['name'], ftype, 200, 0)
+					end
+
+					content.each_with_index do |row, record_no|
+						@log.debug('row is ' << row.to_s)
+						row.each_with_index do |svalue, field_index|
+							type = table_info[field_index]['type']
+							@log.debug('field is ' << table_info[field_index]['name'] << ', svalue is ' << svalue.to_s << ', type is ' << type)
+							if(svalue)
+								dbt.write_string_attribute(record_no, field_index, svalue ) if 'TEXT' == type
+								begin
+									dbt.write_integer_attribute(record_no, field_index, svalue) if 'INTEGER' == type
+									dbt.write_double_attribute(record_no, field_index, svalue) if 'FLOAT' == type
+								rescue RangeError => ex
+									@log.error(trl("ERROR! cannot write value of type %s" %type) << ': ' << ex.message )
+								end
+							else
+								dbt.write_null_attribute(record_no, field_index) if (!svalue || type.empty?)
+							end
+						end
+					end
+					dbt.close
+				end
+			end 
+		end
+	rescue SQLite3::Exception => er
+		@log.error trl("ERROR! Cannot read the source-file") << ' (' << sqlite_file << "): %s" %er.message << '.'
+	end
+end

data/lib/translating.rb

@@ -0,0 +1,91 @@
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2015, 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
+
+
+RD = File.expand_path(File.dirname(__FILE__) ) +  File::SEPARATOR if !defined?(RD)
+
+require 'yaml'
+require_relative 'file_checking'
+
+
+=begin 
+ A way to produce translated text in a ruby-program.
+ Translations are read from a file "translations" in the program folder.
+=end
+module Translating
+	# There are better ways to extend a translated 
+	# string, but I keep the 'wild-card' for 
+	# historical reasons.
+	@@awild = 'XX'
+
+	@@lang = nil 
+	@@lang_file = format("%s%s", RD, 'LANG')  
+	@@tr = YAML::load_file("#{RD}translations")
+	
+	# find the current language-setting and return it.
+	def self.language()
+		if @@lang == nil
+			r = ENV['LANG']
+			if(r)
+				@@lang = r[0, 2]
+			elsif( !File_Checking::file_check(@@lang_file, [:exist?, :readable?]) && File::size(@@lang_file) >= 2)
+				File::open(@@lang_file, 'r') {|f| @@lang = f.readline}
+				@@lang.chomp!.downcase! if @@lang
+			end
+		end
+		@@lang = 'en' if !@@lang
+	end
+
+	# Translate a string to the currently set langage. 
+	# The args parameter may contain replacement-text which 
+	# will appear at the positions indicated by wildcard-characters
+	# in the original string.
+	def self.trl(t, *args)
+		Translating::language()
+		lt = @@tr[t]
+		if(lt)
+			lt = lt[@@lang]
+		else
+			# File.open('/tmp/mtf', 'a+') {|f| f << t << "\n"}
+			puts "\nTRANSLATION MISSING: \"" << t << "\""
+		end
+		lt ||= t
+		if(args && !args.empty?)
+			i = -1 
+			lt = lt.gsub(@@awild) do |a| 
+				i += 1
+				args.flatten[i]
+			end
+			lt += args[i + 1, args.length].join
+		end
+		return lt
+	end
+
+	# Translate a string to the currently set langage. 
+	# The args parameter may contain replacement-text which 
+	# will appear at the positions indicated by wildcard-characters
+	# in the original string.
+	def trl(t, *args )
+		Translating::trl(t, args)
+	end
+end

data/lib/translations

@@ -0,0 +1,153 @@
+#
+#   ©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.             
+# =========================================================================
+#  These are the messages printed by SQLite2DBF. The first line of each
+#  block is the original english message, the following lines contain the
+#  translations for different locales.
+
+# Keep this key 'SQLite2DB' as it is
+
+SQLite2DBF:
+
+Usage:
+ de: Aufrufsyntax
+ fr: Syntax
+
+-s [sqlite-file] [options]:
+ de: -q [SQLite-Datei] [Optionen]
+ fr: -s [Fichier SQLite] [Options]
+
+or %s [Common options]:
+ de: oder %s [Allgemeine Optionen]
+ fr: ou %s [Options généraux]
+
+Specific options:
+ de: Spezielle Optionen
+ fr: Options spécifiques
+
+# program argument -s (source)
+s:
+ de: q
+ fr: s
+
+source/sqlite-file [FILE.sqlite]:
+ de: quelle (SQLite) [Datei.sqlite]
+ fr: source (SQLite) [Fichier.sqlite]
+
+SQLite-file to read.:
+ de: SQLite Datei, die gelesen wird.
+ fr: Fichier SQLite qui sera lu.
+
+# program option -o (original table-name)
+o:
+  de: t
+  fr: t
+
+--orig:
+ de: --tab
+ fr: --tab
+
+Table-names:
+  de: Namen der Tabellen
+  fr: Noms des tableaux
+
+Use the table-name as file-name for the DBF-result:
+ de: Tabellen-Namen als Dateinamen für die DBF-Ausgabe verwenden
+ fr: Utiliser les noms des tableaux comme noms des fichiers DBF
+
+ERROR! cannot write value of type INTEGER:
+ de: FEHLER! Kann INTEGER-Wert nicht schreiben
+ fr: ERREUR ! Ne peux pas écrire valeur de type 'INTEGER'
+
+# program argument -t (target)
+t:
+ de: z
+ fr: c
+
+dBase-files [FILE(0...n).dbf]:
+ de: dBase Dateien [Datei(0...n).dbf]
+ fr: cible Fichier dBase [Fichier(0...n).dbf]
+
+Name for the dBase-files (1 per table) to be written.:
+ de: Name der dBase-Dateien (1 pro Tabelle), die geschrieben werden.
+ fr: Nom des fichiers (1 par tableau) qui seront écris.
+
+Common options:
+ de: Allgemeine Optionen
+ fr: Options généraux
+
+# program argument -d (debug)
+-d:
+ de: -d
+ fr: -d
+
+--debug:
+ de: --debug
+ fr: --debug
+
+Show debug-messages:
+ de: Debug Meldungen zeigen
+ fr: Afficher tous les messages 
+
+# program option -h (help)
+-h:
+ de: -h
+ fr: -a
+
+--help:
+ de: --hilfe
+ fr: --aide
+
+Show this message:
+ de: Diese Nachricht anzeigen
+ fr: Afficher ce message
+
+# program option -v (version)
+-v:
+ de: -v 
+ fr: -v
+
+--version:
+ de: --version
+ fr: --version
+
+Show version and program information:
+ de: Versions- und Programminformationen anzeigen
+ fr: Afficher des informations sur le logiciel et sa version
+
+ERROR! Source-file is a mandatory program parameter!:
+ de: FEHLER! Quelldatei ist ein obligatorischer Programmparameter!
+ fr: ERREUR ! Source est un paramètre obligatoire !
+
+Start this program with parameter -h or --help to see the usage-message.:
+ de: Wenn Sie das Programm mit dem Parameter -h oder mit --hilfe starten, wird die Eingabsyntax angezeigt.
+ fr: Lancez le logiciel avec le paramètre -a ou avec --aide, pour voir la syntax de l'entrée.
+
+ERROR! Unsuitable or incomplete program-arguments:
+ de: FEHLER! Ungeeignete oder unvollständige Programmparameter
+ fr: ERREUR ! Paramètres invalides ou incomplètes
+
+ERROR! Unsuitable file:
+ de: FEHLER! Ungeeignete Datei!
+ fr: ERREUR ! Fichier inapte !
+
+ERROR! Cannot read the source-file:
+ de: FEHLER! Kann die Quelldatei nicht lesen
+ fr: ERREUR ! Source inlisible
+
+
+# eof

data/sqlite2dbf.gemspec

@@ -0,0 +1,15 @@
+require_relative 'lib/constants'
+Gem::Specification.new do |s|
+  s.name        = $APPNAME
+  s.version     = $VERSION
+  s.date        = $DATE
+  s.summary     = "missing files added."
+  s.description = "converts SQLite to DBase"
+  s.authors     = $AUTHORS
+  s.email       = $EMAIL
+  s.files  	=  %w~sqlite2dbf~.collect{|f| 'bin/' << f} + %w~constants.rb argparser.rb sqlite2dbf.rb file_checking.rb log.conf logging.rb translating.rb translations ~.collect{|f| 'lib/' << f} + %w~sqlite2dbf.gemspec~.collect{|f|f}
+  s.requirements = 'shp, sqlite3'
+  s.executables = 'sqlite2dbf'
+  s.license     = $LICENSE
+  s.required_ruby_version = '>= 2.3'
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: sqlite2dbf
+version: !ruby/object:Gem::Version
+  version: 0.1.6
+platform: ruby
+authors:
+- Michael Uplawski <michael.uplawski@uplawski.eu>
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-12 00:00:00.000000000 Z
+dependencies: []
+description: converts SQLite to DBase
+email: michael.uplawski@uplawski.eu
+executables:
+- sqlite2dbf
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/sqlite2dbf
+- lib/argparser.rb
+- lib/constants.rb
+- lib/file_checking.rb
+- lib/log.conf
+- lib/logging.rb
+- lib/sqlite2dbf.rb
+- lib/translating.rb
+- lib/translations
+- sqlite2dbf.gemspec
+homepage: 
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- shp, sqlite3
+rubyforge_project: 
+rubygems_version: 2.6.7
+signing_key: 
+specification_version: 4
+summary: missing files added.
+test_files: []