* GitHub Actions;

* `interface{}` => `any`;
* boilerplate;
* documentation;

Author: synesissoftware

.github/workflows/go.yml

@@ -0,0 +1,28 @@
+# This workflow will build a golang project
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-go
+
+name: Go
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Go
+      uses: actions/setup-go@v4
+      with:
+        go-version: '1.24'
+
+    - name: Build
+      run: ./build.sh
+
+    - name: Test
+      run: ./run_all_unit_tests.sh

.gitignore

@@ -1,15 +1,30 @@
-
 # directories (by name)
 
-.DS_Store
+/scratch/
+
 
 # directories (by pattern)
 
+
 # files (by name)
 
+.DS_Store
+
+
 # files (by pattern)
 
 *~
-*.swp
+*.[568vq]
+*.a
+*.dylib
+*.exe
+*.lib
+*.o
+*.out
+*.prof
+*.so
+*.sw[pon]
+*.test
 *.tmp
+*.zip
 

CHANGES.md

@@ -1,6 +1,14 @@
 # **CLASP.Go** Changes <!-- omit in toc -->
 
 
+## 0.17.1-beta1 - 27th March 2025
+
+* GitHub Actions;
+* `interface{}` => `any`;
+* boilerplate;
+* documentation;
+
+
 ## 0.17.0 - 27th March 2025
 
 * 0.17.0;

README.md

@@ -1,5 +1,10 @@
 # CLASP.Go <!-- omit in toc -->
 
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![GitHub release](https://img.shields.io/github/v/release/synesissoftware/CLASP.Go.svg)](https://github.com/synesissoftware/CLASP.Go/releases/latest)
+[![Last Commit](https://img.shields.io/github/last-commit/synesissoftware/CLASP.Go)](https://github.com/synesissoftware/CLASP.Go/commits/master)
+[![Go](https://github.com/synesissoftware/CLASP.Go/actions/workflows/go.yml/badge.svg)](https://github.com/synesissoftware/CLASP.Go/actions/workflows/go.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/synesissoftware/CLASP.Go)](https://goreportcard.com/report/github.com/synesissoftware/CLASP.Go)
 [![Go Reference](https://pkg.go.dev/badge/github.com/synesissoftware/CLASP.Go.svg)](https://pkg.go.dev/github.com/synesissoftware/CLASP.Go)
 
 **C**ommand-**L**ine **A**rgument **S**orting and **P**arsing for Go
@@ -27,6 +32,7 @@ Go version.
 	- [Related projects](#related-projects)
 	- [License](#license)
 
+
 ## Installation
 
 Install via `go get`, as in:

api.go

@@ -68,7 +68,7 @@ type Specification struct {
 	ValueSet   []string
 	BitFlags   int
 	BitFlags64 int64
-	Extras     map[string]interface{}
+	Extras     map[string]any
 
 	flags_receiver   *int
 	flags64_receiver *int64
@@ -292,11 +292,11 @@ func (specification Specification) SetAliases(aliases ...string) Specification {
 }
 
 // Builder method to set an Extras entry.
-func (specification Specification) SetExtra(key string, value interface{}) Specification {
+func (specification Specification) SetExtra(key string, value any) Specification {
 
 	if specification.Extras == nil {
 
-		specification.Extras = make(map[string]interface{})
+		specification.Extras = make(map[string]any)
 	}
 
 	specification.Extras[key] = value
@@ -707,7 +707,7 @@ func (args Arguments) AllBit64Flags() int64 {
 // [Specification] - was observed during parsing.
 //
 // If an argument is found, then it is marked used.
-func (args *Arguments) FlagIsSpecified(id interface{}) bool {
+func (args *Arguments) FlagIsSpecified(id any) bool {
 
 	name := ""
 	found := false
@@ -759,7 +759,7 @@ func (args *Arguments) FlagIsSpecified(id interface{}) bool {
 // [Specification] - in the parsed arguments.
 //
 // If an argument is found, then it is marked used.
-func (args *Arguments) LookupFlag(id interface{}) (*Argument, bool) {
+func (args *Arguments) LookupFlag(id any) (*Argument, bool) {
 
 	name := ""
 	found := false
@@ -807,7 +807,7 @@ func (args *Arguments) LookupFlag(id interface{}) (*Argument, bool) {
 // [Specification] - in the parsed arguments.
 //
 // If an argument is found, then it is marked used.
-func (args *Arguments) LookupOption(id interface{}) (*Argument, bool) {
+func (args *Arguments) LookupOption(id any) (*Argument, bool) {
 
 	name := ""
 	found := false

build.sh

@@ -0,0 +1,35 @@
+#! /bin/bash
+
+ScriptPath=$0
+Dir=$(cd $(dirname "$ScriptPath"); pwd)
+
+
+mkdir -p "$Dir/scratch/build-artefacts/"
+
+
+# library
+echo "building library ..."
+go build -v $Dir
+
+# examples
+if [ -d "$Dir/examples" ];then
+
+	echo "building examples ..."
+	cd "$Dir/scratch/build-artefacts/"
+	find "$Dir/examples" -type f -name '*.go' -print -exec go build -v {} \;
+	cd ->/dev/null
+fi
+
+
+# tests
+if [ -d "$Dir/tests" ];then
+
+	echo "building tests ..."
+	cd "$Dir/scratch/build-artefacts/"
+	find "$Dir/tests" -type f -name '*.go' -print -exec go build -v {} \;
+	cd ->/dev/null
+fi
+
+
+# ############################## end of file ############################# #
+

parse_test.go

@@ -51,7 +51,7 @@ func equalInNonNillLhs(lhs clasp.Argument, rhs clasp.Argument) bool {
 }
 
 /*
-func require(t *testing.T, cond bool, format string, args ...interface{}) {
+func require(t *testing.T, cond bool, format string, args ...any) {
 
 	if !cond {
 
@@ -70,7 +70,7 @@ func require(t *testing.T, cond bool, format string, args ...interface{}) {
 }
 */
 
-func check(t *testing.T, cond bool, format string, args ...interface{}) bool {
+func check(t *testing.T, cond bool, format string, args ...any) bool {
 
 	if !cond {
 

run_all_unit_tests.sh

@@ -0,0 +1,103 @@
+#! /bin/bash
+
+ScriptPath=$0
+Dir=$(cd $(dirname "$ScriptPath"); pwd)
+
+
+ListOnly=0
+Verbosity=${XTESTS_VERBOSITY:-${TEST_VERBOSITY:-3}}
+
+
+# ##########################################################
+# command-line handling
+
+while [[ $# -gt 0 ]]; do
+
+  case $1 in
+    -l|--list-only)
+
+      ListOnly=1
+      ;;
+    --verbosity)
+
+      shift
+      Verbosity=$1
+      ;;
+    --help)
+
+      cat << EOF
+ANGoLS provides Algorithms Not in the Go Language Standard library
+Copyright (c) 2019-2025, Matthew Wilson and Synesis Information Systems
+Runs all (matching) component and unit test programs
+
+$ScriptPath [ ... flags/options ... ]
+
+Flags/options:
+
+    behaviour:
+
+    -l
+    --list-only
+        lists the target programs but does not execute them
+
+    --verbosity <verbosity>
+        specifies an explicit verbosity for the unit-test(s)
+
+
+    standard flags:
+
+    --help
+        displays this help and terminates
+
+EOF
+
+      exit 0
+      ;;
+    *)
+
+      >&2 echo "$ScriptPath: unrecognised argument '$1'; use --help for usage"
+
+      exit 1
+      ;;
+  esac
+
+  shift
+done
+
+
+# ##########################################################
+# main()
+
+
+for f in $(find $Dir -type f -name '*_test.go')
+do
+
+    if [ $ListOnly -ne 0 ]; then
+
+      echo "would execute $f:"
+
+      continue
+    fi
+
+    if [ $Verbosity -ge 3 ]; then
+
+      echo
+    fi
+    if [ $Verbosity -ge 2 ]; then
+
+      echo "executing $f:"
+    fi
+
+    if [ $Verbosity -ge 2 ]; then
+
+		go test -v "$f"
+	else
+
+		go test  "$f"
+    fi
+
+done
+
+
+# ############################## end of file ############################# #
+

usage.go

@@ -38,7 +38,7 @@ type UsageParams struct {
 	UsageFlags    UsageFlag
 	ExitCode      int
 	Exiter        Exiter
-	Version       interface{}
+	Version       any
 	VersionPrefix string
 	InfoLines     []string
 	ValuesString  string
@@ -99,7 +99,7 @@ func should_call_Exit(params UsageParams) bool {
 	return true
 }
 
-func collect_array_as_strings(a []interface{}) []string {
+func collect_array_as_strings(a []any) []string {
 
 	r := make([]string, len(a))
 

usage_test.go

@@ -93,7 +93,7 @@ func call_ShowUsage_(t *testing.T, specifications []clasp.Specification, ups cla
 	return
 }
 
-func test_ShowVersion_(t *testing.T, expected string, specifications []clasp.Specification, program_name string, version interface{}, version_prefix string) {
+func test_ShowVersion_(t *testing.T, expected string, specifications []clasp.Specification, program_name string, version any, version_prefix string) {
 
 	t.Helper()