ktcommon 0.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 81c64e7c3478570a0841f5e7972ff0e81113c62d
+  data.tar.gz: 6b4ee02f4af83f0e427fd5ef711fe36fb24d2fd1
+SHA512:
+  metadata.gz: dad9d0a0eb629658e29dd094e63e1c0b9462d86b5c97f909a8e96bc91ac1ad7e748237c39f334d7f18241fb3e7533782f86bd5ca77d561564a90101a07f5a7f8
+  data.tar.gz: e8177af062a618dd562e780a65ea5fc7c8773b3f22970315b272a775ecd0289c2b446b73ee62735abc1af4c8148f24e694a4ca11e18ecc9dce5e242be7c67bc4

data/.gitignore

@@ -0,0 +1,14 @@
+# Gitignore file
+#
+##############################################################################
+
+
+# SVN Ignore
+#########################
+.svn
+
+# Project specific files
+#########################
+pkg/
+install.cmd
+

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in test.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Jeff McAffee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,55 @@
+# KtCommon Library
+
+
+## Summary
+
+KtCommon is a library of utility classes.
+
+## Installation
+
+Add this line to your Gemfile:
+
+    gem 'ktcommon'
+
+And then execute:
+
+    $ bundle
+
+or install it yourself as:
+
+    $ gem install ktcommon
+
+## Usage
+
+Require and instantiate classes as needed.
+
+## Testing
+
+KtCommon uses RSpec for testing.
+
+To run all existing tests:
+
+    $ rake spec
+
+or directly:
+
+    $ bundle exec rspec
+
+## TODO
+
+* Rename methods to follow ruby naming conventions (ie. `snake_case` rather than `camelCase`)
+
+## Contributing
+
+1. Fork it ( https://bitbucket.org/ktechsystems/ktcommon/fork )
+1. Clone it (`git clone git@bitbucket.org:[my-bitbucket-username]/ktcommon.git`)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Create tests for your feature branch
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request
+
+## License
+
+This gem is licensed under the MIT license. See LICENSE file for details.
+

data/docs/README.rdoc

@@ -0,0 +1,14 @@
+========================================================================
+= File: 	README.rdoc
+= Purpose: 	KtCommon utilities
+=
+= Generated:	09/17/2010
+= Copyright: 	Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+= Website:   	http://ktechsystems.com
+========================================================================
+
+OVERVIEW:
+
+	This project contains a number of utility class objects and mixins 
+	used by other projects.
+	

data/ktcommon.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ktcommon/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ktcommon"
+  spec.version       = KtCommon::VERSION
+  spec.authors       = ["Jeff McAffee"]
+  spec.email         = ["jeff@ktechsystems.com"]
+  spec.summary       = %q{kTech common helper class library}
+  spec.description   = spec.summary
+  spec.homepage      = "https://bitbucket.org/ktechsystems/ktcommon"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_runtime_dependency "git_store"
+end

data/lib/ktcommon.rb

@@ -0,0 +1,24 @@
+######################################################################################
+#
+# ktcommon.rb
+#
+# Jeff McAffee   6/27/09
+#
+# Purpose: kTech Common utility/helper functions and classes
+#
+######################################################################################
+
+module KtCommon
+
+end # module
+
+# Require source files
+
+#require 'find'
+
+#class_files = File.join( File.dirname(__FILE__), 'ktcommon', '*.rb')
+#$: << File.join( File.dirname(__FILE__), 'ktcommon')                   # Add directory to the include file array
+#Dir.glob(class_files) do | class_file | 
+#  require class_file[/\w+\.rb$/]
+#end
+

data/lib/ktcommon/consoleio.rb

@@ -0,0 +1,75 @@
+##############################################################################
+# File:: 	ktconsoleio.rb
+# Purpose:: KtConsole I/O object gets input from the console.
+# 
+# Author::    Jeff McAffee 09/26/2010
+# Copyright:: Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+##############################################################################
+
+
+##############################################################################
+# 
+module KtCommon
+
+require 'ktcommon/ktcmdline'
+	  
+	###
+	# The ConsoleIO class provides methods for reading from and writing to
+	# the console.
+	#
+	class ConsoleIO
+	include KtCmdLine			# Mixin the getInput() method
+
+	attr_reader			:answers
+	
+	
+		###
+		# ConsoleIO class constructor
+		#
+		def initialize()
+			$LOG.debug "ConsoleIO::new"
+			@answers = {}
+		end
+		
+		
+		###
+		# Ask questions and store the answers.
+		#	Questions will be an array of hashes. Each element in the array
+		#	is a question. Each question hash can have the following keys:
+		#		- :param	- this will be used as the key to the answer hash
+		#		- :q		- The question to be displayed. No punctuation will be added so include it if needed.
+		#		- :desc		- Description text to be displayed before showing the question (optional)
+		#
+		def ask(questions)
+			$LOG.debug "ConsoleIO::ask"
+			raise ArgumentError.new("Expecting Array of Hashes. [questions] not an Array.") if questions.class != Array
+			raise ArgumentError.new("Expecting Array of Hashes. [questions] is empty.") if questions.empty?
+			
+			qs = []
+			questions.each do |ques|
+				raise ArgumentError.new("Expecting Hash.") if ques.class != Hash
+				raise ArgumentError.new("Missing key :param") if !ques.has_key? :param
+				raise ArgumentError.new("Missing key :q") if !ques.has_key? :q
+				
+				qs.clear
+				if(!ques[:desc].nil?)							# If there is a :desc key,
+					if(ques[:desc].class == Array)					# If it is an array,
+						ques[:desc].each {|d| qs << d}					# add each element to the text to display.
+					else
+						qs << ques[:desc]							# otherwise add :desc to text to display.
+					end
+				end
+				qs << ques[:q]									# Add the actual question to text to display.
+				
+				@answers[ques[:param]] = getInput(qs)			# Ask the question and store the answer.
+			end
+			
+			@answers		# Return the answers hash for easy usage.
+		end
+		
+		
+	end # class ConsoleIO
+	
+
+end # module KtCommon

data/lib/ktcommon/csvloader.rb

@@ -0,0 +1,162 @@
+##############################################################################
+# File:: ktcsvloader.rb
+# Purpose:: CSV Loader object for loading and parsing CSV files
+# 
+# Author::    Jeff McAffee 09/25/2010
+# Copyright:: Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+#
+# This class is based on an original implementation of
+# ruby/gdl/ppmgenerator/lib/ppmgenerator/csvloader.rb
+#
+##############################################################################
+
+require 'csv'
+
+##############################################################################
+# 
+module KtCommon
+	  
+	###
+	# CsvLoader is used to parse CSV data. It generates symbols to use as
+	# hash keys based on the header row of data. This means that a header
+	# row is REQUIRED. 
+	#
+	# - All loaded data can be retrieved from the .rows attribute.
+	# - .rows is an array of Hashes, each hash being data for one row,
+	#	indexed by the symbols mentioned above.
+	#
+	# Example Rows Data Layout:
+	#
+	# rows[0] = Hash{:colHeaderItem1 => "row1Col1 Data", :colHeaderItem2 => "row1Col2 Data"}
+	# rows[1] = Hash{:colHeaderItem1 => "row2Col1 Data", :colHeaderItem2 => "row2Col2 Data"}
+	# rows[2] = Hash{:colHeaderItem1 => "row3Col1 Data", :colHeaderItem2 => "row3Col2 Data"}
+	#
+	class CsvLoader
+
+	attr_reader :verbose
+	attr_reader :rows
+		
+		
+		###
+		# CsvLoader constructor
+		#
+		def initialize()
+			$LOG.debug "KtCommon::CsvLoader::initialize"
+			@verbose 	= false
+			@rows = Array.new
+		end
+		  
+
+		###
+		# Turn on verbose messaging.
+		#
+		# arg:: true to turn on verbose messaging
+		#
+		def verbose(arg)
+			$LOG.debug "KtCommon::CsvLoader::verbose( #{arg} )"
+			puts "Verbose mode: #{arg.to_s}" if @verbose
+			@verbose = arg
+		end
+		  
+	  
+		###
+		# Create a symbol to be used for hash keys (column) indexes for 
+		# each row. The symbol is created by removing all whitespace.
+		# All capitalization will be kept as-is.
+		#
+		# hdr:: Header data row from loaded CSV file
+		#
+		def createSymbolsFromHeader(hdr)
+			i = 0
+			@header = Array.new
+			hdr.each do |colHdr|
+				#puts "colHdr (before): " + colHdr
+				val = colHdr.gsub(/\s/, "").to_s
+				#puts "colHdr (after):  " + val
+				raise "Unrecognized header value: #{colHdr} in #{__FILE__}:#{__LINE__}" if !colHdr.nil? && val.nil?
+				unless(colHdr.nil? || colHdr.empty?)
+					#@header[i] = colHdr.gsub!(/s/, "").to_s.intern if(!colHdr.nil? && !colHdr.empty?)
+					@header[i] = val.intern
+				end
+				i += 1
+			end # each colHdr
+			
+			#puts "header[#{i.to_s}]: #{@header[i]}"
+			
+			return true
+		end
+		
+		
+		###
+		# Process a row of data. Used internally.
+		#
+		# row:: a row of data read from a CSV file
+		#
+		def process(row)
+			$LOG.debug "KtCommon::CsvLoader::process"
+			rowData = Hash.new
+			row.each_index do |i|
+				rowData[@header[i]] = row[i] if(!row[i].nil? && !row[i].empty?)
+			end
+			@rows << rowData
+		end
+		private :process
+		
+		
+		###
+		# Load a CSV file and process it into an array of hashes.
+		#
+		# filepath:: path to file to process
+		#
+		def load(filepath)
+			$LOG.debug "KtCommon::CsvLoader::load( #{filepath} )"
+			
+			if(!File.exist?( filepath ))
+				raise IOError.new("File not found: #{filepath}")
+				return false
+			end
+			
+			reader = CSV.open(filepath, "r")
+			header = reader.shift
+			
+			if(@verbose)
+				puts "CSV Column Headers:"
+				header.each {|h| puts "\t#{h}" }
+				puts
+			end
+			
+			if(!createSymbolsFromHeader( header ))
+				return false
+			end
+			
+			reader.each do |row|
+				process(row)
+			end
+			
+			return true
+		end
+		  
+	  
+		###
+		# Generate an example CSV file.
+		# filepath:: path and name of file to generate
+		# hdr:: array of text to create headers from
+		# rows:: an array of arrays of row data ( [ ["row1Col1", "row1Col2", "row1Col3"], ["row2Col1", "row2Col2", "row2Col3"] ] )
+		#
+		def generateTemplate(filepath, hdr, rows=nil)
+			$LOG.debug "KtCommon::CsvLoader::generateTemplate( #{filepath}, hdr )"
+		
+			writer = CSV.open(filepath, "w")
+			writer << hdr
+			unless(rows.nil?)
+				rows.each {|r| writer << r}
+			end
+			writer.close
+		end
+		
+		
+	end # class CsvLoader
+
+
+end # module KtCommon

data/lib/ktcommon/date.rb

@@ -0,0 +1,59 @@
+##############################################################################
+# File:: 	date.rb
+# Purpose:: KtCommon::Date module. Helper functions for date and time.
+# 
+# Author::    Jeff McAffee 10/06/2010
+# Copyright:: Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+##############################################################################
+
+
+##############################################################################
+# 
+module KtCommon
+
+
+	module Date
+
+		###
+    # Return a timestamp string including both date and time.
+    #
+    # returns:: timestamp string
+    #
+    def timestamp()
+			now = DateTime::now()
+			now.strftime("%m/%d/%Y %H:%M:%S")
+		end # def
+		
+
+		###
+    # Return a datestamp string including only the date.
+    #
+    # returns:: datestamp string
+    #
+		def datestamp()
+			now = Date::today()
+			now.strftime("%m/%d/%Y")
+		end # def
+		
+
+		###
+    # Alias for #timestamp
+    #
+    def current_datetime()
+				return timestamp()
+		end # def
+
+
+		###
+    # Alias for #datestamp
+    #
+		def current_date()
+				return datestamp()
+		end # def
+
+		
+	end # module Date
+	
+
+end # module KtCommon

data/lib/ktcommon/gitdatastore.rb

@@ -0,0 +1,118 @@
+##############################################################################
+# File:: 	gitdatastore.rb
+# Purpose:: GitDataStore object encapsulates a Git repository for programatic
+#           access.
+# 
+# Author::    Jeff McAffee 09/17/2010
+# Copyright:: Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+##############################################################################
+
+require 'stringio'
+require 'git_store'
+
+module KtCommon
+	  
+  ###########################################################################
+  # GitDataStore encapsulates a Git repository
+	class GitDataStore
+		
+		
+		def initialize(location)
+			$LOG.debug "GitDataStore::new"
+			@location 	= location
+			@store 		= nil
+		end
+		
+		
+		def ymlPath(path)
+			#puts "IN: #{path}"
+			raise ArgumentError.new("Empty path") if (path.nil? || path.empty?)
+			
+			path += ".yml" unless !File.extname(path).empty?
+			#puts "OUT: #{path}"
+			return path
+		end
+		
+		
+		def store()
+			return @store unless @store.nil?
+			raise ArgumentError.new("No repo location provided before store requested.") unless (!@location.nil? && !@location.empty?)
+			begin
+				@store = GitStore.new(@location)
+			rescue ArgumentError => e
+				if(e.message.include?("must be a valid Git repo"))
+					raise RuntimeError.new("Cannot find a valid Git repo. Are you sure you've initialized the dir at #{@location}?")
+				end
+				raise $:
+			end
+		end
+		
+		
+		def location(location)
+			raise ArgumentError.new("Repo already opened when new location submitted: #{location}") unless @store.nil?
+			@location = location
+		end
+		
+		
+		def create(path, data)
+			$LOG.debug "GitDataStore::create"
+			
+			store[ymlPath(path)] = data
+			commitMsg	= "Added to data store:  #{ymlPath(path)}"
+			store.commit commitMsg
+		end
+		
+		
+		###
+		# Read a specific file from the store based on a <em>path</em>.
+		# path:: path to retrieve data from
+		# returns:: <em>one(1)</em> data object
+		def read(path)
+			$LOG.debug "GitDataStore::read(#{ymlPath(path)})"
+			
+			return store[ymlPath(path)]
+		end
+		
+		
+		###
+		# Read data from the store based on a <em>path</em>.
+		# path:: path to retrieve data from
+		# returns:: a Hash of data
+		def read_path(path)
+			$LOG.debug "GitDataStore::read_path(#{path})"
+			
+			return store[path]
+		end
+		
+		
+		def update(path, data)
+			$LOG.debug "GitDataStore::update"
+			
+			store[ymlPath(path)] = data
+			commitMsg	= "Updated data store: #{ymlPath(path)}"
+			store.commit commitMsg
+		end
+		
+		
+		def delete(path)
+			$LOG.debug "GitDataStore::delete"
+			
+			
+			result 		= store.delete ymlPath(path)
+			commitMsg	= "Deleted from data store: #{ymlPath(path)}"
+			store.commit commitMsg
+			
+			return result
+		end
+		
+		
+	end # class GitDataStore
+	
+=begin ======================================================================
+#      ======================================================================
+=end
+	
+
+
+end # module KtCommon

data/lib/ktcommon/ktcfg.rb

@@ -0,0 +1,84 @@
+######################################################################################
+#
+# ktCfg.rb
+#
+# Jeff McAffee   10/24/09
+#
+# Purpose: YAML based config file related functions
+#
+######################################################################################
+
+module KtCfg
+
+  require 'yaml'
+  require 'fileutils'
+  require 'ktcommon/ktpath'
+  
+  class CfgFile
+    
+    attr_reader :rootDir
+
+    
+    def initialize(rootDir = nil)
+      $LOG.debug "CfgFile::initialize"
+      @rootDir = rootDir
+      
+      if( rootDir )
+          @rootDir = File.rubypath(@rootDir)
+          if( !File.exists?(@rootDir))
+            $LOG.debug "Creating directory: #{@rootDir}"
+            FileUtils.mkdir(@rootDir)
+          end
+      end
+    end # initialize
+    
+    
+    def rootDir=(dir)
+      @rootDir = File.rubypath(dir)
+    end
+    
+    
+	def cfgFilePath(filename)
+      $LOG.debug "CfgFile::cfgFilePath( #{filename} )"
+	  filepath = filename
+      if( @rootDir )
+          filepath = File.join(@rootDir, filename)
+      end
+		  $LOG.debug "Filepath: #{filepath}"
+		filepath
+	end
+
+
+    def write(filename, cfg)
+      $LOG.debug "CfgFile::write"
+      $LOG.debug "Config File Contents: #{cfg.inspect} "
+      
+      filepath = cfgFilePath(filename)
+      
+      open(filepath, 'w') { |f| YAML.dump(cfg, f) }
+      
+    end #write
+
+
+    def read(filename)
+          $LOG.debug "CfgFile::read"
+
+      filepath = cfgFilePath(filename)
+      
+      cfg = {}
+      
+	  if(File.exists?(filepath))
+		open(filepath) { |f| cfg = YAML.load(f) }
+	  end
+      cfg
+    end
+    
+    
+  end # class CfgFile
+
+
+  
+end # module KtPath
+
+
+

data/lib/ktcommon/ktcmdline.rb

@@ -0,0 +1,42 @@
+######################################################################################
+#
+# ktCmdLine.rb
+#
+# Jeff McAffee   10/26/09
+#
+# Purpose: Command Line helper methods
+#
+######################################################################################
+
+module KtCmdLine
+
+#  require 'yaml'
+#  require 'fileutils'
+#  require 'ktcommon/ktpath'
+  
+  ###
+  # Display a short message and collect input from the keyboard.
+  #  Accepts either an array of strings or a single string.
+  #  When the last array element is printed the cursor will 
+  #  stay on the same line waiting for user input.
+  #
+  # text:: string or array[string]: text to display to user
+  #
+  def getInput(text)
+      lines = text
+	  *lines = text if text.class != Array
+	  text = lines.pop
+	  lines.each {|l| puts l }
+	  $stdout.write "#{text} "
+      i = $stdin.readline
+      i.chomp!.strip!
+      return i
+  end # def getInput
+
+    
+
+  
+end # module KtCmdLine
+
+
+

data/lib/ktcommon/ktlogger.rb

@@ -0,0 +1,63 @@
+##############################################################################
+# File:: ktLogger.rb
+# Purpose: Set up logging for ruby applications
+# 
+# Author::    Jeff McAffee 10/30/2009
+# Copyright:: Copyright (c) 2009 kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+##############################################################################
+
+
+require 'logger'
+
+# Available release levels.
+releaseLevels = [:debug, :alpha, :beta, :production]
+
+$DEBUG          ||= false
+$LOGGING        ||= false
+$RELEASE_LEVEL  ||= :production
+
+PROJNAME = 'ktLogger' unless defined?(PROJNAME)
+
+if($LOGGING == true && PROJNAME.empty?)
+  raise("ktLogger: PROJNAME needs to be defined for logging purposes.")
+end
+
+if(!releaseLevels.include? $RELEASE_LEVEL)
+  raise("ktLogger: $RELEASE_LEVEL needs to be defined for logging purposes.")
+end
+
+debugfileindicator = "debug.txt"
+if(File.exists?("/#{debugfileindicator}"))
+  $DEBUG = true
+  $LOGGING = true
+  $RELEASE_LEVEL = :debug
+end
+
+
+if($LOGGING)
+  $LOG = Logger.new( "#{PROJNAME.downcase}.log", 3, 100 * 1024 )     # Rotate 3 logs, each no larger than 100k
+  $LOG.datetime_format = "%Y-%m-%d %H:%M:%S"
+  $LOG.level = Logger::WARN
+else
+  $LOG = Logger.new(STDERR)
+  $LOG.datetime_format = "%Y-%m-%d %H:%M:%S"
+  $LOG.level = Logger::FATAL
+end
+
+if($RELEASE_LEVEL == :debug)
+  $LOG.level = Logger::DEBUG
+end
+
+if($RELEASE_LEVEL == :alpha)
+  $LOG.level = Logger::INFO
+end
+
+if($RELEASE_LEVEL == :beta)
+  $LOG.level = Logger::WARN
+end
+
+if($RELEASE_LEVEL == :production)
+  $LOG.level = Logger::ERROR
+end
+

data/lib/ktcommon/ktpath.rb

@@ -0,0 +1,31 @@
+######################################################################################
+#
+# ktPath.rb
+#
+# Jeff McAffee   6/27/09
+#
+# Purpose: File path related functions
+#
+######################################################################################
+
+
+# Add path conversion functionality to File class
+class File
+end
+
+class << File
+    # Convert windows file path seperators to forward slashes.
+    # path:: path to convert
+    def rubypath path
+      return path.gsub(/\\/, "/")
+    end
+	
+    # Convert forward slashes to windows file path seperators (back slashes).
+    # path:: path to convert
+    def winpath path
+      return path.gsub(/\//, "\\")
+    end
+end
+
+
+

data/lib/ktcommon/ktregistry.rb

@@ -0,0 +1,118 @@
+##############################################################################
+# File:: ktRegistry.rb
+# Purpose: Class to read windows registry.
+# 
+# Author::    Jeff McAffee 10/04/09
+# Copyright:: Copyright (c) 2009 kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+##############################################################################
+
+
+require 'win32/registry'
+
+class KtRegistry
+
+  attr_accessor :coName
+  attr_accessor :appName
+  
+  def initialize(companyName="kTechSystems")
+    $LOG.debug "KtRegistry::initialize()"
+    
+    @coName = companyName
+    @appName = "Unknown"
+  end
+  
+  
+  def softwarePath()
+    path = 'Software' + "\\" + @coName + "\\" + @appName
+  end
+  
+  
+  def readValue(valueName, defaultValue)
+    $LOG.debug "KtRegistry::readValue( #{valueName}, #{defaultValue} )"
+    result = ""
+    regType = nil
+    regValue = nil
+    
+    begin
+      Win32::Registry::HKEY_LOCAL_MACHINE.open(softwarePath()) do |reg|
+        #default_reg_typ, reg_defaultVal = reg.read('')   # Throws error if value doesn't exist.
+        regType, regValue = reg.read(valueName)
+        if(defaultValue.class == TrueClass || defaultValue.class == FalseClass) # Handle returning bools.
+          if(regValue != 0)
+            regValue = true
+          else
+            regValue = false
+          end
+        end
+      end
+    rescue Win32::Registry::Error => e
+      $LOG.error "Error ocurred while reading path: #{softwarePath()}, #{valueName}"
+      $LOG.error "#{e.class} : #{e.to_s}"
+      $LOG.debug "Returning user supplied default value."
+      regValue = defaultValue
+    end
+
+    regValue
+  end
+  
+  
+  def writeValue(valueName, value)
+    $LOG.debug "KtRegistry::setValue( #{valueName}, #{value} )"
+    $LOG.debug "Value class: #{value.class}"
+    regType = nil
+    regValue = nil
+    
+    begin
+      Win32::Registry::HKEY_LOCAL_MACHINE.open(softwarePath(), Win32::Registry::Constants::KEY_WRITE) do |reg|
+        case value.class.to_s
+          when 'Fixnum'
+            # Write as a dword
+            $LOG.debug "Writing integer to registry"
+            reg.write_i(valueName, value)
+          
+          when 'TrueClass'
+            # Write as a dword
+            $LOG.debug "Writing TrueClass to registry"
+            reg.write_i(valueName, 1)
+          
+          when 'FalseClass'
+            # Write as a dword
+            $LOG.debug "Writing FalseClass to registry"
+            reg.write_i(valueName, 0)
+          
+          else
+            # Write as a string
+            $LOG.debug "Writing String to registry"
+            reg.write_s(valueName, value)
+          
+        end
+      end
+    rescue Win32::Registry::Error => e
+      $LOG.error "Error ocurred while writing path: #{softwarePath()}, #{valueName}"
+      $LOG.error "#{e.class} : #{e.to_s}"
+      return false
+    end
+    
+    return true
+  end
+  
+  
+  def deleteValue(valueName)
+    $LOG.debug "KtRegistry::deleteValue( #{valueName} )"
+    begin
+      Win32::Registry::HKEY_LOCAL_MACHINE.open(softwarePath(), Win32::Registry::Constants::KEY_WRITE) do |reg|
+        reg.delete_value(valueName)
+      end
+    rescue Win32::Registry::Error => e
+      $LOG.error "Error ocurred while deleting value (#{valueName}) from path: #{softwarePath()}"
+      $LOG.error "#{e.class} : #{e.to_s}"
+      return false
+    end
+    
+    return true
+  end
+  
+end # class KtRegistry
+
+

data/lib/ktcommon/version.rb

@@ -0,0 +1,5 @@
+module KtCommon
+  VERSION = "0.0.7" unless constants.include?("VERSION")
+  APPNAME = "KtCommon" unless constants.include?("APPNAME")
+  COPYRIGHT = "Copyright (c) 2013, kTech Systems LLC. All rights reserved" unless constants.include?("COPYRIGHT")
+end

data/rakefile.rb

@@ -0,0 +1,47 @@
+######################################################################################
+# File:: rakefile
+# Purpose:: Build tasks for ktCommon library
+#
+# Author::    Jeff McAffee 09/17/2010
+# Copyright:: Copyright (c) 2010, kTech Systems LLC. All rights reserved.
+# Website::   http://ktechsystems.com
+######################################################################################
+
+require 'bundler/gem_tasks'
+require 'psych'
+gem 'rdoc', '>= 3.9.4'
+
+require 'rake'
+require 'rake/clean'
+require 'rdoc/task'
+require 'rspec/core/rake_task'
+
+# Setup common directory structure
+
+
+PROJNAME        = "KtCommon"
+
+# Setup common clean and clobber targets
+
+CLEAN.include("pkg")
+CLOBBER.include("pkg")
+
+
+#############################################################################
+RDoc::Task.new(:rdoc) do |rdoc|
+  files = ['docs/**/*.rdoc', 'lib/**/*.rb', 'app/**/*.rb']
+  rdoc.rdoc_files.add( files )
+  rdoc.main = "docs/README.rdoc"           	# Page to start on
+  #puts "PWD: #{FileUtils.pwd}"
+  rdoc.title = "#{PROJNAME} Documentation"
+  rdoc.rdoc_dir = 'doc'                   # rdoc output folder
+  rdoc.options << '--line-numbers' << '--all'
+end
+
+
+#############################################################################
+desc "Run all specs"
+RSpec::Core::RakeTask.new do |t|
+  #t.rcov = true
+end
+

data/spec/ktcommon_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe 'ktcommon require file' do
+  it 'does not crash programs when required' do
+    require_relative '../lib/ktcommon'
+  end
+
+
+end

data/spec/ktlogger_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe 'ktcommon/ktlogger require file' do
+  it 'does not crash programs when required' do
+    require_relative '../lib/ktcommon/ktlogger'
+  end
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: ktcommon
+version: !ruby/object:Gem::Version
+  version: 0.0.7
+platform: ruby
+authors:
+- Jeff McAffee
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: git_store
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: kTech common helper class library
+email:
+- jeff@ktechsystems.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE
+- README.md
+- docs/README.rdoc
+- ktcommon.gemspec
+- lib/ktcommon.rb
+- lib/ktcommon/consoleio.rb
+- lib/ktcommon/csvloader.rb
+- lib/ktcommon/date.rb
+- lib/ktcommon/gitdatastore.rb
+- lib/ktcommon/ktcfg.rb
+- lib/ktcommon/ktcmdline.rb
+- lib/ktcommon/ktlogger.rb
+- lib/ktcommon/ktpath.rb
+- lib/ktcommon/ktregistry.rb
+- lib/ktcommon/version.rb
+- rakefile.rb
+- spec/ktcommon_spec.rb
+- spec/ktlogger_spec.rb
+- spec/spec_helper.rb
+homepage: https://bitbucket.org/ktechsystems/ktcommon
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: kTech common helper class library
+test_files:
+- spec/ktcommon_spec.rb
+- spec/ktlogger_spec.rb
+- spec/spec_helper.rb
+has_rdoc: