libclimate-ruby 0.17.0 → 0.17.0.1

data/lib/libclimate/version.rb

@@ -4,11 +4,11 @@
 # Purpose:  Version for libclimate.Ruby library
 #
 # Created:  13th July 2015
-# Updated:  10th August 2024
+# Updated:  6th March 2025
 #
 # Home:     http://github.com/synesissoftware/libCLImate.Ruby
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2025, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2015-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -43,18 +43,18 @@
 
 module LibCLImate
 
-	# Current version of the libCLImate.Ruby library
-	VERSION					=	'0.17.0'
-
-	private
-	VERSION_PARTS_			=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
-	public
-	# Major version of the libCLImate.Ruby library
-	VERSION_MAJOR			=	VERSION_PARTS_[0] # :nodoc:
-	# # Minor version of the libCLImate.Ruby library
-	VERSION_MINOR			=	VERSION_PARTS_[1] # :nodoc:
-	# # Revision version of the libCLImate.Ruby library
-	VERSION_REVISION		=	VERSION_PARTS_[2] # :nodoc:
+  # Current version of the libCLImate.Ruby library
+  VERSION           = '0.17.0.1'
+
+  private
+  VERSION_PARTS_    = VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+  public
+  # Major version of the libCLImate.Ruby library
+  VERSION_MAJOR     = VERSION_PARTS_[0] # :nodoc:
+  # # Minor version of the libCLImate.Ruby library
+  VERSION_MINOR     = VERSION_PARTS_[1] # :nodoc:
+  # # Revision version of the libCLImate.Ruby library
+  VERSION_REVISION  = VERSION_PARTS_[2] # :nodoc:
 end # module LibCLImate
 
 

data/test/scratch/blankzeroes.rb

@@ -1,14 +1,14 @@
 #!/usr/bin/ruby
 
 #############################################################################
-# File:         test/scratch/blankzeroes.rb
+# File:     test/scratch/blankzeroes.rb
 #
-# Purpose:      This filter program converts 0 values in a TSV into blanks
+# Purpose:  This filter program converts 0 values in a TSV into blanks
 #
-# Created:      14th May 2016
-# Updated:      13th April 2019
+# Created:  14th May 2016
+# Updated:  6th March 2025
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 #############################################################################
 
@@ -20,21 +20,21 @@ require 'libclimate'
 # ##########################################################
 # constants
 
-PROGRAM_VER_MAJOR	=	0
-PROGRAM_VER_MINOR	=	1
-PROGRAM_VER_PATCH	=	4
-PROGRAM_VER_BUILD	=	6
+PROGRAM_VER_MAJOR = 0
+PROGRAM_VER_MINOR = 1
+PROGRAM_VER_PATCH = 4
+PROGRAM_VER_BUILD = 6
 
 # ##########################################################
 # command-line parsing
 
 LibCLImate::Climate.new do |cl|
 
-	cl.info_lines = [
+  cl.info_lines = [
 
-		:version,
-		'converts 0 values into blanks',
-	]
+    :version,
+    'converts 0 values into blanks',
+  ]
 end.run
 
 # ##########################################################
@@ -42,7 +42,7 @@ end.run
 
 $<.each_line do |line|
 
-	puts line.split(/\t/).map { |s| '0' == s ? '' : s }.join("\t")
+  puts line.split(/\t/).map { |s| '0' == s ? '' : s }.join("\t")
 end
 
 # ############################## end of file ############################# #

data/test/scratch/specifications.rb

@@ -1,14 +1,14 @@
 #! /usr/bin/env ruby
 
 #############################################################################
-# File:         test/scratch/specifications.rb
+# File:     test/scratch/specifications.rb
 #
-# Purpose:      Demonstrates use of specifications in options and flags
+# Purpose:  Demonstrates use of specifications in options and flags
 #
-# Created:      7th February 2018
-# Updated:      22nd July 2022
+# Created:  7th February 2018
+# Updated:  6th March 2025
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 # Copyright:    <<TBD>>
 #
@@ -22,10 +22,10 @@ require 'libclimate'
 # ##########################################################
 # constants
 
-PROGRAM_VER_MAJOR	=	0
-PROGRAM_VER_MINOR	=	1
-PROGRAM_VER_PATCH	=	2
-PROGRAM_VER_BUILD	=	1
+PROGRAM_VER_MAJOR = 0
+PROGRAM_VER_MINOR = 1
+PROGRAM_VER_PATCH = 2
+PROGRAM_VER_BUILD = 1
 
 # ##########################################################
 # command-line parsing
@@ -34,25 +34,25 @@ options = {}
 
 r = LibCLImate::Climate.new do |cl|
 
-	cl.add_flag('--verbose', alias: '-v', help: 'specifies verbosity') { options[:verbose] = true }
-	cl.add_alias('--verbose', '--V')
+  cl.add_flag('--verbose', alias: '-v', help: 'specifies verbosity') { options[:verbose] = true }
+  cl.add_alias('--verbose', '--V')
 
-	cl.add_option('--logging-threshold', alias: '-l', help: 'specifies the logging threshold') { |o, a| options[:logging_threshold] = o.value }
-	cl.add_alias('--logging-threshold=informational', '--I')
+  cl.add_option('--logging-threshold', alias: '-l', help: 'specifies the logging threshold') { |o, a| options[:logging_threshold] = o.value }
+  cl.add_alias('--logging-threshold=informational', '--I')
 
-	cl.info_lines = [
+  cl.info_lines = [
 
-		:version,
-		'demonstrates use of specifications',
-	]
+    :version,
+    'demonstrates use of specifications',
+  ]
 
-	cl.version = [
+  cl.version = [
 
-		PROGRAM_VER_MAJOR,
-		PROGRAM_VER_MINOR,
-		PROGRAM_VER_PATCH,
-		PROGRAM_VER_BUILD,
-	]
+    PROGRAM_VER_MAJOR,
+    PROGRAM_VER_MINOR,
+    PROGRAM_VER_PATCH,
+    PROGRAM_VER_BUILD,
+  ]
 end.run
 
 

data/test/unit/tc_abort.rb

@@ -15,71 +15,71 @@ require 'stringio'
 
 class Test_Climate_abort < Test::Unit::TestCase
 
-	def test_abort_normal
+  def test_abort_normal
 
-		strout = StringIO.new
-		strerr = StringIO.new
+    strout = StringIO.new
+    strerr = StringIO.new
 
-		climate = LibCLImate::Climate.new do |cl|
+    climate = LibCLImate::Climate.new do |cl|
 
-			cl.program_name	=	'myprog'
-			cl.stdout			=	strout
-			cl.stderr			=	strerr
-		end
+      cl.program_name = 'myprog'
+      cl.stdout       = strout
+      cl.stderr       = strerr
+    end
 
-		s			=	climate.abort 'something happened', exit: nil
+    s         = climate.abort 'something happened', exit: nil
 
-		lines_err	=	strerr.string.split /\n/
+    lines_err = strerr.string.split /\n/
 
-		assert_equal 'myprog: something happened', s
+    assert_equal 'myprog: something happened', s
 
-		assert_equal 1, lines_err.size
-		assert_equal 'myprog: something happened', lines_err[0]
-	end
+    assert_equal 1, lines_err.size
+    assert_equal 'myprog: something happened', lines_err[0]
+  end
 
-	def test_abort_no_program_name
+  def test_abort_no_program_name
 
-		strout = StringIO.new
-		strerr = StringIO.new
+    strout = StringIO.new
+    strerr = StringIO.new
 
-		climate = LibCLImate::Climate.new do |cl|
+    climate = LibCLImate::Climate.new do |cl|
 
-			cl.program_name	=	'myprog'
-			cl.stdout			=	strout
-			cl.stderr			=	strerr
-		end
+      cl.program_name = 'myprog'
+      cl.stdout       = strout
+      cl.stderr       = strerr
+    end
 
-		s			=	climate.abort 'something happened', exit: nil, program_name: ''
+    s         = climate.abort 'something happened', exit: nil, program_name: ''
 
-		lines_err	=	strerr.string.split /\n/
+    lines_err = strerr.string.split /\n/
 
-		assert_equal 'something happened', s
+    assert_equal 'something happened', s
 
-		assert_equal 1, lines_err.size
-		assert_equal 'something happened', lines_err[0]
-	end
+    assert_equal 1, lines_err.size
+    assert_equal 'something happened', lines_err[0]
+  end
 
-	def test_abort_custom_program_name
+  def test_abort_custom_program_name
 
-		strout = StringIO.new
-		strerr = StringIO.new
+    strout = StringIO.new
+    strerr = StringIO.new
 
-		climate = LibCLImate::Climate.new do |cl|
+    climate = LibCLImate::Climate.new do |cl|
 
-			cl.program_name	=	'myprog'
-			cl.stdout			=	strout
-			cl.stderr			=	strerr
-		end
+      cl.program_name = 'myprog'
+      cl.stdout       = strout
+      cl.stderr       = strerr
+    end
 
-		s			=	climate.abort 'something happened', exit: nil, program_name: 'my-prog'
+    s         = climate.abort 'something happened', exit: nil, program_name: 'my-prog'
 
-		lines_err	=	strerr.string.split /\n/
+    lines_err = strerr.string.split /\n/
 
-		assert_equal 'my-prog: something happened', s
+    assert_equal 'my-prog: something happened', s
 
-		assert_equal 1, lines_err.size
-		assert_equal 'my-prog: something happened', lines_err[0]
-	end
+    assert_equal 1, lines_err.size
+    assert_equal 'my-prog: something happened', lines_err[0]
+  end
 end
 
 # ############################## end of file ############################# #

data/test/unit/tc_double_slash_index.rb

@@ -15,77 +15,77 @@ require 'stringio'
 
 class Test_Climate_double_slash_index < Test::Unit::TestCase
 
-	def test_some_arguments_without_DSI
-
-		climate = LibCLImate::Climate.new do |cl|
-
-			cl.add_flag('--abc')
-
-			cl.add_flag('-d')
-			cl.add_flag('-e')
-			cl.add_flag('-f')
-		end
-
-		argv = %w{ --abc -d -e -f }
-
-		r = climate.run argv
-
-		assert_not_nil r
-		assert_kind_of ::Hash, r
-		assert 3 <= r.size
-		assert_not_nil r[:flags]
-		assert_not_nil r[:options]
-		assert_not_nil r[:values]
-		assert_equal 4, r[:flags].size
-		assert_equal 4, r.flags.size
-		assert_equal 4, r[:flags][:given].size
-		assert_equal 0, r[:flags][:handled].size
-		assert_equal 4, r[:flags][:unhandled].size
-		assert_equal 0, r[:flags][:unknown].size
-		assert_equal 4, r[:options].size
-		assert_equal 0, r[:options][:given].size
-		assert_equal 0, r[:options][:handled].size
-		assert_equal 0, r[:options][:unhandled].size
-		assert_equal 0, r[:options][:unknown].size
-		assert_equal 0, r[:values].size
-		assert_nil r.double_slash_index
-	end
-
-	def test_some_arguments_with_DSI
-
-		climate = LibCLImate::Climate.new do |cl|
-
-			cl.add_flag('--abc')
-
-			cl.add_flag('-d')
-			cl.add_flag('-e')
-			cl.add_flag('-f')
-		end
-
-		argv = %w{ --abc -d -- -e -f }
-
-		r = climate.run argv
-
-		assert_not_nil r
-		assert_kind_of ::Hash, r
-		assert 3 <= r.size
-		assert_not_nil r[:flags]
-		assert_not_nil r[:options]
-		assert_not_nil r[:values]
-		assert_equal 4, r[:flags].size
-		assert_equal 4, r.flags.size
-		assert_equal 2, r[:flags][:given].size
-		assert_equal 0, r[:flags][:handled].size
-		assert_equal 2, r[:flags][:unhandled].size
-		assert_equal 0, r[:flags][:unknown].size
-		assert_equal 4, r[:options].size
-		assert_equal 0, r[:options][:given].size
-		assert_equal 0, r[:options][:handled].size
-		assert_equal 0, r[:options][:unhandled].size
-		assert_equal 0, r[:options][:unknown].size
-		assert_equal 2, r[:values].size
-		assert_equal '-e', r[:values][0]
-		assert_equal '-f', r[:values][1]
-		assert_equal 2, r.double_slash_index
-	end
+  def test_some_arguments_without_DSI
+
+    climate = LibCLImate::Climate.new do |cl|
+
+      cl.add_flag('--abc')
+
+      cl.add_flag('-d')
+      cl.add_flag('-e')
+      cl.add_flag('-f')
+    end
+
+    argv = %w{ --abc -d -e -f }
+
+    r = climate.run argv
+
+    assert_not_nil r
+    assert_kind_of ::Hash, r
+    assert 3 <= r.size
+    assert_not_nil r[:flags]
+    assert_not_nil r[:options]
+    assert_not_nil r[:values]
+    assert_equal 4, r[:flags].size
+    assert_equal 4, r.flags.size
+    assert_equal 4, r[:flags][:given].size
+    assert_equal 0, r[:flags][:handled].size
+    assert_equal 4, r[:flags][:unhandled].size
+    assert_equal 0, r[:flags][:unknown].size
+    assert_equal 4, r[:options].size
+    assert_equal 0, r[:options][:given].size
+    assert_equal 0, r[:options][:handled].size
+    assert_equal 0, r[:options][:unhandled].size
+    assert_equal 0, r[:options][:unknown].size
+    assert_equal 0, r[:values].size
+    assert_nil r.double_slash_index
+  end
+
+  def test_some_arguments_with_DSI
+
+    climate = LibCLImate::Climate.new do |cl|
+
+      cl.add_flag('--abc')
+
+      cl.add_flag('-d')
+      cl.add_flag('-e')
+      cl.add_flag('-f')
+    end
+
+    argv = %w{ --abc -d -- -e -f }
+
+    r = climate.run argv
+
+    assert_not_nil r
+    assert_kind_of ::Hash, r
+    assert 3 <= r.size
+    assert_not_nil r[:flags]
+    assert_not_nil r[:options]
+    assert_not_nil r[:values]
+    assert_equal 4, r[:flags].size
+    assert_equal 4, r.flags.size
+    assert_equal 2, r[:flags][:given].size
+    assert_equal 0, r[:flags][:handled].size
+    assert_equal 2, r[:flags][:unhandled].size
+    assert_equal 0, r[:flags][:unknown].size
+    assert_equal 4, r[:options].size
+    assert_equal 0, r[:options][:given].size
+    assert_equal 0, r[:options][:handled].size
+    assert_equal 0, r[:options][:unhandled].size
+    assert_equal 0, r[:options][:unknown].size
+    assert_equal 2, r[:values].size
+    assert_equal '-e', r[:values][0]
+    assert_equal '-f', r[:values][1]
+    assert_equal 2, r.double_slash_index
+  end
 end

data/test/unit/tc_infer_version.rb

@@ -13,96 +13,96 @@ require 'test/unit'
 
 require 'stringio'
 
-PROGRAM_VER_MAJOR	=	3
+PROGRAM_VER_MAJOR = 3
 
 class Test_Climate_infer_version_3_22 < Test::Unit::TestCase
 
-	PROGRAM_VER_MINOR	=	22
+  PROGRAM_VER_MINOR = 22
 
-	def test_inference_of_version
+  def test_inference_of_version
 
-		strout = StringIO.new
+    strout = StringIO.new
 
-		climate = LibCLImate::Climate.new(version_context: self) do |cl|
+    climate = LibCLImate::Climate.new(version_context: self) do |cl|
 
-			cl.program_name		=	'myprog'
-			cl.stdout			=	strout
+      cl.program_name   = 'myprog'
+      cl.stdout         = strout
 
-			cl.exit_on_usage	=	false
-		end.run [ 'myprog', '--version' ]
+      cl.exit_on_usage  = false
+    end.run [ 'myprog', '--version' ]
 
-		s = strout.string
+    s = strout.string
 
-		assert_equal "myprog 3.22", s.chomp
-	end
+    assert_equal "myprog 3.22", s.chomp
+  end
 end
 
 class Test_Climate_infer_version_3_2_99 < Test::Unit::TestCase
 
-	PROGRAM_VER_MINOR		=	2
-	PROGRAM_VER_REVISION	=	99
+  PROGRAM_VER_MINOR     = 2
+  PROGRAM_VER_REVISION  = 99
 
-	def test_inference_of_version
+  def test_inference_of_version
 
-		strout = StringIO.new
+    strout = StringIO.new
 
-		climate = LibCLImate::Climate.new(version_context: self) do |cl|
+    climate = LibCLImate::Climate.new(version_context: self) do |cl|
 
-			cl.program_name		=	'myprog'
-			cl.stdout			=	strout
+      cl.program_name   = 'myprog'
+      cl.stdout         = strout
 
-			cl.exit_on_usage	=	false
-		end.run [ 'myprog', '--version' ]
+      cl.exit_on_usage  = false
+    end.run [ 'myprog', '--version' ]
 
-		s = strout.string
+    s = strout.string
 
-		assert_equal "myprog 3.2.99", s.chomp
-	end
+    assert_equal "myprog 3.2.99", s.chomp
+  end
 end
 
 class Test_Climate_infer_PROGRAM_VERSION_as_array < Test::Unit::TestCase
 
-	PROGRAM_VERSION	=	[ 11, 12, 13 ]
+  PROGRAM_VERSION = [ 11, 12, 13 ]
 
-	def test_inference_of_version
+  def test_inference_of_version
 
-		strout = StringIO.new
+    strout = StringIO.new
 
-		climate = LibCLImate::Climate.new(version_context: self) do |cl|
+    climate = LibCLImate::Climate.new(version_context: self) do |cl|
 
-			cl.program_name		=	'myprog'
-			cl.stdout			=	strout
+      cl.program_name   = 'myprog'
+      cl.stdout         = strout
 
-			cl.exit_on_usage	=	false
-		end.run [ 'myprog', '--version' ]
+      cl.exit_on_usage  = false
+    end.run [ 'myprog', '--version' ]
 
-		s = strout.string
+    s = strout.string
 
-		assert_equal "myprog 11.12.13", s.chomp
-	end
+    assert_equal "myprog 11.12.13", s.chomp
+  end
 end
 
 class Test_Climate_infer_version_3_2_99_via_PATCH < Test::Unit::TestCase
 
-	PROGRAM_VER_MINOR	=	7
-	PROGRAM_VER_PATCH	=	101
+  PROGRAM_VER_MINOR = 7
+  PROGRAM_VER_PATCH = 101
 
-	def test_inference_of_version
+  def test_inference_of_version
 
-		strout = StringIO.new
+    strout = StringIO.new
 
-		climate = LibCLImate::Climate.new(version_context: self) do |cl|
+    climate = LibCLImate::Climate.new(version_context: self) do |cl|
 
-			cl.program_name		=	'myprog'
-			cl.stdout			=	strout
+      cl.program_name   = 'myprog'
+      cl.stdout         = strout
 
-			cl.exit_on_usage	=	false
-		end.run [ 'myprog', '--version' ]
+      cl.exit_on_usage  = false
+    end.run [ 'myprog', '--version' ]
 
-		s = strout.string
+    s = strout.string
 
-		assert_equal "myprog 3.7.101", s.chomp
-	end
+    assert_equal "myprog 3.7.101", s.chomp
+  end
 end
 
 # ############################## end of file ############################# #