clasp-ruby 0.23.1 → 0.23.3

data/README.md

@@ -1,40 +1,56 @@
 # CLASP.Ruby <!-- omit in toc -->
+
 Command-Line Argument Sorting and Parsing, for Ruby
 
+![Language](https://img.shields.io/badge/Ruby-CC342D?style=flat&logo=ruby&logoColor=white)
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
 [![Gem Version](https://badge.fury.io/rb/clasp-ruby.svg)](https://badge.fury.io/rb/clasp-ruby)
+[![Last Commit](https://img.shields.io/github/last-commit/synesissoftware/CLASP.Ruby)](https://github.com/synesissoftware/CLASP.Ruby/commits/master)
+[![Ruby](https://github.com/synesissoftware/CLASP.Ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/synesissoftware/CLASP.Ruby/actions/workflows/ruby.yml)
+
 
 ## Table of Contents <!-- omit in toc -->
 
 - [Introduction](#introduction)
-    - [libCLImate.Ruby](#libclimateruby)
+  - [libCLImate.Ruby](#libclimateruby)
 - [Installation](#installation)
 - [Components](#components)
-    - [Command-line parsing](#command-line-parsing)
-    - [Declarative specification of the flags and options for a CLI](#declarative-specification-of-the-flags-and-options-for-a-cli)
-    - [Utility functions for displaying usage and version information](#utility-functions-for-displaying-usage-and-version-information)
+  - [Command-line parsing](#command-line-parsing)
+  - [Declarative specification of the flags and options for a CLI](#declarative-specification-of-the-flags-and-options-for-a-cli)
+  - [Utility functions for displaying usage and version information](#utility-functions-for-displaying-usage-and-version-information)
 - [Examples](#examples)
 - [Project Information](#project-information)
-    - [Where to get help](#where-to-get-help)
-    - [Contribution guidelines](#contribution-guidelines)
-    - [Related projects](#related-projects)
-    - [License](#license)
+  - [Where to get help](#where-to-get-help)
+  - [Contribution guidelines](#contribution-guidelines)
+  - [Dependencies](#dependencies)
+    - [Efferent (fan-out)](#efferent-fan-out)
+      - [Runtime Dependencies (aka "Normal Dependencies")](#runtime-dependencies-aka-normal-dependencies)
+      - [Development Dependencies](#development-dependencies)
+    - [Afferent (fan-in)](#afferent-fan-in)
+      - [Runtime dependents](#runtime-dependents)
+      - [Development dependents](#development-dependents)
+  - [Related projects](#related-projects)
+  - [License](#license)
+
 
 ## Introduction
 
-**CLASP** stands for **C**ommand-**L**ine **A**rgument **S**orting and **P**arsing. The first **CLASP** library was a C library with a C++ wrapper (see project [**CLASP**](https://github.com/synesissoftware/CLASP/)). There have been several implementations in other languages (as listed in [Relation projects](#related-projects)). **CLASP.Ruby** is the Ruby version.
+**CLASP** stands for **C**ommand-**L**ine **A**rgument **S**orting and **P**arsing. The first **CLASP** library was a C library with a C++ wrapper (see project [**CLASP**](https://github.com/synesissoftware/CLASP/)). There have been several implementations in other languages (as listed in [Related projects](#related-projects)). **CLASP.Ruby** is the Ruby version.
 
 All **CLASP** libraries provide the facilities to **C**ommand **L**ine **I**nterface (**CLI**) programs as described in detail below.
 
+
 ### libCLImate.Ruby
 
-The [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby) library is implemented in terms of **CLASP.Ruby** but provides a higher-level abstration as well as several utility functions and the facility to fully specify command-line arguments declaratively in the `__END__` section of a source file. More information and examples provided in the [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby) project.
+The [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby) library is implemented in terms of **CLASP.Ruby** but provides a higher-level abstraction as well as several utility functions and the facility to fully specify command-line arguments declaratively in the `__END__` section of a source file. More information and examples provided in the [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby) project.
+
 
 ## Installation
 
 Install via **gem** as in:
 
 ```
-    gem install clasp-ruby
+gem install clasp-ruby
 ```
 
 or add it to your `Gemfile`.
@@ -45,8 +61,10 @@ Use via **require**, as in:
 require 'clasp'
 ```
 
+
 ## Components
 
+
 ### Command-line parsing
 
 All **CLASP** libraries discriminate between three types of command-line arguments:
@@ -97,6 +115,7 @@ UNIX standard arguments confer specific meanings:
  * `--version` means that the program should show the version information and terminate;
  * `--` means that all subsequent arguments should be treated as values, regardless of any hyphen-prefixes or embedded `=` signs.
 
+
 ### Declarative specification of the flags and options for a CLI
 
 To support such above special processing, CLASP libraries provide facilities
@@ -139,6 +158,7 @@ puts Args.values[1]                 # => "outfile"
 
 ```
 
+
 ### Utility functions for displaying usage and version information
 
 There are aspects common to all CLI programs, such as responding to `--help` and `--version`. All **CLASP** libraries provide facilities to assist the programmer: **CLASP.Ruby** provides the two module methods CLASP.show_usage() and CLASP.show_version(), as shown in the following code extending the example above:
@@ -165,7 +185,7 @@ Args.flags.each do |f|
 Given the command
 
 ```
-    ./cr-example.rb --help
+./cr-example.rb --help
 ```
 
 then the program will output the following
@@ -200,7 +220,7 @@ flags/options:
 and given the command
 
 ```
-    ./cr-example.rb --version
+./cr-example.rb --version
 ```
 
 then the program will output the following
@@ -209,44 +229,81 @@ then the program will output the following
 cr-example.rb 0.1.2
 ```
 
+
 ## Examples
 
 Examples are provided in the ```examples``` directory, along with a markdown description for each. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).
 
+
 ## Project Information
 
+
 ### Where to get help
 
 [GitHub Page](https://github.com/synesissoftware/CLASP.Ruby "GitHub Page")
 
+
 ### Contribution guidelines
 
 Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/CLASP.Ruby.
 
+
+### Dependencies
+
+
+#### Efferent (fan-out)
+
+Libraries upon which **CLASP.Ruby** depends:
+
+
+##### Runtime Dependencies (aka "Normal Dependencies")
+
+* \<none>;
+
+
+##### Development Dependencies
+
+* [**rake**](https://rubygems.org/gems/rake);
+* [**test-unit**](https://rubygems.org/gems/test-unit);
+* [**xqsr3**](https://github.com/synesissoftware/xqsr3);
+
+
+#### Afferent (fan-in)
+
+Projects that depend on **CLASP.Ruby**:
+
+
+##### Runtime dependents
+
+* [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby);
+* [**oss-src-tools**](https://github.com/mwsis/oss-src-tools);
+
+
+##### Development dependents
+
+* \<none>;
+
+
 ### Related projects
 
 **CLASP.Ruby** is inspired by the [C/C++ CLASP library](https://github.com/synesissoftware/CLASP), which is documented in the articles:
 
- * _An Introduction to CLASP_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), January 2012;
- * _[Anatomy of a CLI Program written in C](http://synesis.com.au/publishing/software-anatomies/anatomy-of-a-cli-program-written-in-c.html)_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), September 2012; and
- * _[Anatomy of a CLI Program written in C++](http://synesis.com.au/publishing/software-anatomies/anatomy-of-a-cli-program-written-in-c++.html)_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), September 2015.
+* _An Introduction to CLASP_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), January 2012;
+* _[Anatomy of a CLI Program written in C](http://synesis.com.au/publishing/software-anatomies/anatomy-of-a-cli-program-written-in-c.html)_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), September 2012; and
+* _[Anatomy of a CLI Program written in C++](http://synesis.com.au/publishing/software-anatomies/anatomy-of-a-cli-program-written-in-c++.html)_, Matthew Wilson, [CVu](http://accu.org/index.php/journals/c77/), September 2015;
 
 Other CLASP libraries include:
 
-* [**CLASP**](https://github.com/synesissoftware/CLASP/)
-* [**CLASP.Go**](https://github.com/synesissoftware/CLASP.Go/)
-* [**CLASP.js**](https://github.com/synesissoftware/CLASP.js/)
-* [**CLASP.NET**](https://github.com/synesissoftware/CLASP.NET/)
-* [**CLASP.Python**](https://github.com/synesissoftware/CLASP.Python/)
+* [**CLASP**](https://github.com/synesissoftware/CLASP/);
+* [**CLASP.Go**](https://github.com/synesissoftware/CLASP.Go/);
+* [**CLASP.js**](https://github.com/synesissoftware/CLASP.js/);
+* [**CLASP.NET**](https://github.com/synesissoftware/CLASP.NET/);
+* [**CLASP.Python**](https://github.com/synesissoftware/CLASP.Python/);
 
-Projects in which **CLASP.Ruby** is used include:
-
-* [**libCLImate.Ruby**](https://github.com/synesissoftware/libCLImate.Ruby)
 
 ### License
 
-**CLASP.Ruby** is released under the 3-clause BSD license. See LICENSE for details.
+**CLASP.Ruby** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.
 
 
 <!-- ########################### end of file ########################### -->
-

data/Rakefile

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Rakefile for CLASP.Ruby
+
+require 'rake/testtask'
+
+
+Rake::TestTask.new do |tt|
+
+  tt.libs << 'lib'
+  tt.libs << 'test'
+  tt.name = 'test'
+  tt.test_files = FileList['test/**/tc_*.rb']
+  tt.verbose = true
+end
+
+
+task :default => :test
+
+
+# ############################## end of file ############################# #

data/SECURITY.md

@@ -0,0 +1,23 @@
+# CLASP.Ruby - Security <!-- omit in toc -->
+
+
+## Table of Contents <!-- omit in toc -->
+
+- [Reporting a vulnerability](#reporting-a-vulnerability)
+- [Supported versions](#supported-versions)
+
+
+## Reporting a vulnerability
+
+Please report security issues privately via GitHub Security Advisories on https://github.com/synesissoftware/CLASP.Ruby/security, or by opening an issue if an advisory cannot be filed. Do not attach exploit proofs of concept against third-party systems.
+
+
+## Supported versions
+
+| Version | Supported |
+| ------- | --------- |
+| 0.23.x  | ✅        |
+| < 0.23  | ❌        |
+
+
+<!-- ########################### end of file ########################### -->

data/TODO.md

@@ -0,0 +1,24 @@
+# CLASP.Ruby - TODO <!-- omit in toc -->
+
+
+## Functional improvements
+
+* \<none>
+
+
+## Performance improvements
+
+* \<none>
+
+
+## Packaging improvements
+
+* [x] ~~~rename gemspec so the filename stem matches `spec.name` (`CLASP.gemspec` → **clasp-ruby.gemspec**)~~~;
+* [x] ~~~obtain a **run_all_unit_tests.sh** (from **misc-dev-scripts**) that skips `tput` when `$TERM` is unset or stdout is not a TTY (CI: `tput: No value for $TERM and no -T specified`)~~~;
+* [x] ~~~drop gemspec `required_ruby_version` `< 4` upper bound~~~;
+* [x] ~~~gemspec polish: README tagline as `spec.summary`, include **CHANGES.md** (and sibling docs) in packaged files, exclude **Gemfile.lock** / **.ruby-version**~~~;
+* [x] ~~~stop tracking **Gemfile.lock**; **Gemfile** `lockfile false` when Bundler supports it; CI `bundler-cache: false`~~~;
+* [x] ~~~after the packaging/boilerplate/CI baseline: bump **VERSION** and align **CHANGES**/**NEWS**~~~;
+
+
+<!-- ########################### end of file ########################### -->

data/examples/flag_and_option_specifications.md

@@ -1,4 +1,4 @@
-# CLASP.Ruby Example - **flag_and_option_specifications**
+# CLASP.Ruby - Example - **flag_and_option_specifications**
 
 ## Summary
 
@@ -21,10 +21,10 @@ ProgramVersion = [ 0, 0, 1 ]
 
 InfoLines = [
 
-    'CLASP.Ruby examples',
-    :version,
-    "Illustrates use of CLASP.Ruby's use of flags, options, and aliases",
-    '',
+  'CLASP.Ruby examples',
+  :version,
+  "Illustrates use of CLASP.Ruby's use of flags, options, and aliases",
+  '',
 ]
 
 # Specify specifications, parse, and checking standard flags
@@ -35,24 +35,24 @@ Flag_Chatty = CLASP.Flag('--verbosity=chatty', alias: '-c')
 
 Specifications = [
 
-    Flag_Debug,
-    Option_Verbosity,
-    Flag_Chatty,
+  Flag_Debug,
+  Option_Verbosity,
+  Flag_Chatty,
 
-    CLASP::FlagSpecification.Help,
-    CLASP::FlagSpecification.Version,
+  CLASP::FlagSpecification.Help,
+  CLASP::FlagSpecification.Version,
 ]
 
 args = CLASP::Arguments.new ARGV, Specifications
 
 if args.flags.include?(CLASP::FlagSpecification.Help)
 
-    CLASP.show_usage(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout, info_lines: InfoLines, default_indicator: '*default*')
+  CLASP.show_usage(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout, info_lines: InfoLines, default_indicator: '*default*')
 end
 
 if args.flags.include?('--version')
 
-    CLASP.show_version(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout)
+  CLASP.show_version(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout)
 end
 
 
@@ -60,12 +60,12 @@ end
 
 if (opt = args.find_option('--verbosity'))
 
-    $stdout.puts "verbosity is specified as: #{opt.value}"
+  $stdout.puts "verbosity is specified as: #{opt.value}"
 end
 
 if args.flags.include?('--debug')
 
-    $stdout.puts 'Debug mode is specified'
+  $stdout.puts 'Debug mode is specified'
 end
 
 
@@ -74,9 +74,9 @@ end
 
 if (unused = args.find_first_unknown())
 
-    $stderr.puts "#{args.program_name}: unrecognised flag/option: #{unused}"
+  $stderr.puts "#{args.program_name}: unrecognised flag/option: #{unused}"
 
-    exit 1
+  exit 1
 end
 ```
 
@@ -87,13 +87,13 @@ end
 If executed with no arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb
+ruby examples/flag_and_option_specifications.rb
 ```
 
 or (in a Unix shell):
 
 ```
-    ./examples/flag_and_option_specifications.rb
+./examples/flag_and_option_specifications.rb
 ```
 
 it gives the output:
@@ -106,7 +106,7 @@ it gives the output:
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb --help
+ruby examples/flag_and_option_specifications.rb --help
 ```
 
 it gives the output:
@@ -146,7 +146,7 @@ flags/options:
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb --debug --verbosity=silent
+ruby examples/flag_and_option_specifications.rb --debug --verbosity=silent
 ```
 
 it gives the output:
@@ -161,7 +161,7 @@ Debug mode is specified
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb -v silent -d
+ruby examples/flag_and_option_specifications.rb -v silent -d
 ```
 
 it gives the (same) output:
@@ -176,7 +176,7 @@ Debug mode is specified
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb -c -d
+ruby examples/flag_and_option_specifications.rb -c -d
 ```
 
 it gives the output:
@@ -191,7 +191,7 @@ Debug mode is specified
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb -dc
+ruby examples/flag_and_option_specifications.rb -dc
 ```
 
 it gives the (same) output:
@@ -206,7 +206,7 @@ Debug mode is specified
 If executed with the arguments
 
 ```
-    ruby examples/flag_and_option_specifications.rb -d --verbosity=
+ruby examples/flag_and_option_specifications.rb -d --verbosity=
 ```
 
 it gives the output:

data/examples/show_usage_and_version.md

@@ -1,4 +1,4 @@
-# CLASP.Ruby Example - **show_usage_and_version**
+# CLASP.Ruby - Example - **show_usage_and_version**
 
 ## Summary
 
@@ -21,30 +21,30 @@ ProgramVersion = [ 0, 0, 1 ]
 
 InfoLines = [
 
-    'CLASP.Ruby examples',
-    :version,
-    "Illustrates use of CLASP.Ruby's CLASP.show_usage() and CLASP.show_version() methods",
-    '',
+  'CLASP.Ruby examples',
+  :version,
+  "Illustrates use of CLASP.Ruby's CLASP.show_usage() and CLASP.show_version() methods",
+  '',
 ]
 
 # Specify specifications, parse, and checking standard flags
 
 Specifications = [
 
-    CLASP::FlagSpecification.Help,
-    CLASP::FlagSpecification.Version,
+  CLASP::FlagSpecification.Help,
+  CLASP::FlagSpecification.Version,
 ]
 
 args = CLASP::Arguments.new ARGV, Specifications
 
 if args.flags.include?('--help')
 
-    CLASP.show_usage(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout, info_lines: InfoLines)
+  CLASP.show_usage(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout, info_lines: InfoLines)
 end
 
 if args.flags.include?('--version')
 
-    CLASP.show_version(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout)
+  CLASP.show_version(Specifications, exit_code: 0, version: ProgramVersion, stream: $stdout)
 end
 
 
@@ -52,9 +52,9 @@ end
 
 if (unused = args.find_first_unknown())
 
-    $stderr.puts "#{args.program_name}: unrecognised flag/option: #{unused}"
+  $stderr.puts "#{args.program_name}: unrecognised flag/option: #{unused}"
 
-    sys.exit(1)
+  sys.exit(1)
 end
 
 
@@ -68,13 +68,13 @@ $stdout.puts 'no flags specified'
 If executed with no arguments
 
 ```
-    ruby examples/show_usage_and_version.rb
+ruby examples/show_usage_and_version.rb
 ```
 
 or (in a Unix shell):
 
 ```
-    ./examples/show_usage_and_version.rb
+./examples/show_usage_and_version.rb
 ```
 
 it gives the output:
@@ -88,7 +88,7 @@ no flags specified
 If executed with the arguments
 
 ```
-    ruby examples/show_usage_and_version.rb --help
+ruby examples/show_usage_and_version.rb --help
 ```
 
 it gives the output:
@@ -114,7 +114,7 @@ flags/options:
 If executed with the arguments
 
 ```
-    ruby examples/show_usage_and_version.rb --version
+ruby examples/show_usage_and_version.rb --version
 ```
 
 it gives the output:
@@ -128,7 +128,7 @@ show_usage_and_version.rb 0.0.1
 If executed with the arguments
 
 ```
-    ruby examples/show_usage_and_version.rb --unknown=value
+ruby examples/show_usage_and_version.rb --unknown=value
 ```
 
 it gives the output (on the standard error stream):

data/lib/clasp/arguments.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/arguments.rb
 #
 # Purpose:  Definition of the Arguments class, the main class in CLASP.Ruby
 #
 # Created:  14th February 2014
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/clasp.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/clasp.rb
 #
 # Purpose:  Common 'require file' for CLASP.Ruby library
 #
 # Created:  14th February 2014
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/cli.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/cli.rb
 #
 # Purpose:  Command-line interface
 #
 # Created:  27th July 2015
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/doc_.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/xqsr3/doc_.rb
 #
 # Purpose:      Documentation of the CLASP.Ruby modules
 #
 # Created:      11th June 2016
-# Updated:      20th January 2024
+# Updated:      15th August 2026
 #
-# Home:         http://github.com/synesissoftware/xqsr3
+# Home:         https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:       Matthew Wilson
 #

data/lib/clasp/old_module.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/old_module.rb
 #
 # Purpose:  Introduces old module Clasp (which clashes with an existing gem)
 #
 # Created:  10th June 2016
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/specifications.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/specifications.rb
 #
 # Purpose:  Argument specification classes
 #
 # Created:  25th October 2014
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/util/exceptions.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/util/exceptions.rb
 #
 # Purpose:  Exception classes
 #
 # Created:  20th April 2019
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #

data/lib/clasp/util/value_parser.rb

@@ -1,13 +1,13 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     clasp/util/value_parser.rb
 #
 # Purpose:  Utility component for typed values
 #
 # Created:  20th April 2019
-# Updated:  6th March 2025
+# Updated:  15th August 2026
 #
-# Home:     http://github.com/synesissoftware/CLASP.Ruby
+# Home:     https://github.com/synesissoftware/CLASP.Ruby
 #
 # Author:   Matthew Wilson
 #