Converted to zsh and improved handling of error cases and arg lists for the main routines. Added a description of the check-*.sh scripts to the README.

Signed-off-by: Dean Wampler <[email protected]>

Author: deanwampler

README.md

@@ -1,10 +1,12 @@
 # "Programming Scala, 3rd Edition" Code Examples
 
+<!--
 [![Join the chat at https://gitter.im/deanwampler/programming-scala-book-code-examples](https://badges.gitter.im/deanwampler/programming-scala-book-code-examples.svg)](https://gitter.im/deanwampler/programming-scala-book-code-examples?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+-->
 [![Scala Steward badge](https://img.shields.io/badge/Scala_Steward-helping-blue.svg?style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAQCAMAAAARSr4IAAAAVFBMVEUAAACHjojlOy5NWlrKzcYRKjGFjIbp293YycuLa3pYY2LSqql4f3pCUFTgSjNodYRmcXUsPD/NTTbjRS+2jomhgnzNc223cGvZS0HaSD0XLjbaSjElhIr+AAAAAXRSTlMAQObYZgAAAHlJREFUCNdNyosOwyAIhWHAQS1Vt7a77/3fcxxdmv0xwmckutAR1nkm4ggbyEcg/wWmlGLDAA3oL50xi6fk5ffZ3E2E3QfZDCcCN2YtbEWZt+Drc6u6rlqv7Uk0LdKqqr5rk2UCRXOk0vmQKGfc94nOJyQjouF9H/wCc9gECEYfONoAAAAASUVORK5CYII=)](https://scala-steward.org)
 
 * [Dean Wampler](mailto:[email protected])
-* Dean Wampler's [Bluesky](https://bsky.app/profile/deanwampler.bsky.social), [Mastodon](https://discuss.systems/@deanwampler), or [LinkedIn](https://www.linkedin.com/in/deanwampler/) accounts.
+* Dean Wampler's [Bluesky](https://bsky.app/profile/deanwampler.bsky.social), [Mastodon](https://discuss.systems/@deanwampler), and [LinkedIn](https://www.linkedin.com/in/deanwampler/) accounts.
 * [My Book Page](http://programming-scala.org)
 * [Blog about Scala 3](https://medium.com/scala-3)
 
@@ -173,6 +175,17 @@ $
 > [!NOTE]
 > The `--` argument separator is required for Scala 3.5.0 and later. It is not used for Scala 3.4.X and earlier.
 
+### Testing the Scala Scripts and "Mains"
+
+There are a lot of _script_ files under `src/script/scala/...`, which are used in the book as suggestions to try in the console as you are reading the book. However, they are hard to test in the usual way. Similarly, there are many `@main` routines and they are also not covered by tests. So, to "semi-automate" testing them, try the following two `zsh` scripts, both of which take a long time to run:
+
+```shell
+check-scripts.sh
+check-mains.sh
+```
+
+Both have `--help` options to see what options they accept. Both do their best to check that the output is expected, but a complication is the fact that many of the Scala scripts and "mains" have deliberate errors for illustrative purposes. The `check-*.sh` scripts attempt to compensate for this, for example by knowing which scripts should fail and allowing them to fail "successfully", but to be _absolutely certain_ they are running correctly, it is really necessary to visually inspect the saved output from the runs (as described in console output of the `check-*.sh`) to see if the behavior _looks_ correct.
+
 ## Feedback
 
 I welcome feedback on the Book and these examples. Please post comments, corrections, etc. to one of the following places:
@@ -185,6 +198,8 @@ There is also my dedicated site for the book where occasional updates, clarifica
 
 ## A Little History
 
+Some milestones (but probably not all of them...).
+
 | Key Dates          | Description |
 | :----------------- | :---------- |
 | August 11, 2014    | 2nd edition examples |
@@ -202,5 +217,6 @@ There is also my dedicated site for the book where occasional updates, clarifica
 | September 15, 2024 | Scala 3.5.0 changes, e.g. the [new Scala CLI](https://docs.scala-lang.org/sips/scala-cli.html). |
 | December 21, 2024  | Scala 3.6.2 changes, supporting new syntax options. |
 | June 17, 2025      | Scala 3.7.X breaking changes and fixed some old bugs in some of the "scripts". |
+| September 20, 2025 | Scala 3.7.3 breaking changes. Yes, a "patch" release, but in fairness, triggered by my strict compiler flags. |
 
 

check-mains.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env zsh
 
 out_root="target/main-tests"
 out_ext="out"
@@ -53,7 +53,7 @@ def_mains=(
   progscala3.meta.TryStaging
   progscala3.meta.TryTracer
   progscala3.meta.TryUsingClassTagViews
-  "progscala3.meta.performance.InlinePerf true 10"
+  progscala3.meta.performance.InlinePerf
   progscala3.objectsystem.CommandArgs
   progscala3.objectsystem.JavaArrays
   progscala3.objectsystem.objects.TryPerson
@@ -67,7 +67,16 @@ def_mains=(
   progscala3.typesystem.payroll.TryPhantomTypesPipeline
   progscala3.typesystem.selftype.TryButtonSubjectObserver
 )
-expected_errors_in=()
+
+declare -A mains_args
+mains_args["progscala3.meta.performance.InlinePerf"]="true 10"
+mains_args["progscala3.objectsystem.CommandArgs"]="--help"
+
+expected_errors_in=(
+  progscala3.meta.TryInvariant
+  progscala3.meta.TryInvariant1
+  progscala3.objectsystem.JavaArrays
+)
 
 error() {
   echo "ERROR: $@"
@@ -165,7 +174,7 @@ count_problem() {
 }
 
 report() {
-  let status=$1
+  let run_status=$1
   main=$2
   out=$3
   for skip in ${expected_errors_in[@]}
@@ -177,7 +186,7 @@ report() {
     fi
   done
   let error_count=0
-  if [[ $status -ne 0 ]]
+  if [[ $run_status -ne 0 ]]
   then
     echo "ERROR: $main failed! ($out)"
     let error_count+=1
@@ -202,10 +211,10 @@ check() {
     if [[ -z "$NOOP" ]]
     then
       mkdir -p $(dirname "$out")
-      TERM=dumb sbt "runMain $main $@" > "$out"
+      TERM=dumb sbt "runMain $main $mains_args[\"$main\"] $@" > "$out"
     else
       $NOOP mkdir -p $(dirname $out)
-      $NOOP "TERM=dumb sbt runMain $main $@ > $out"
+      $NOOP "TERM=dumb sbt runMain $main $mains_args[\"$main\"] $@ > $out"
     fi
   fi
   $NOOP report $? "$main" "$out"

check-scripts.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env zsh
 
 default_dirs=( "src/script/scala" )
 out_root="target/script-tests"
@@ -173,7 +173,7 @@ count_problem() {
 }
 
 report() {
-  let status=$1
+  let run_status=$1
   script=$2
   out=$3
   for skip in ${expected_errors_in[@]}
@@ -185,7 +185,7 @@ report() {
     fi
   done
   let error_count=0
-  if [[ $status -ne 0 ]]
+  if [[ $run_status -ne 0 ]]
   then
     echo "ERROR: $script failed! ($out)"
     let error_count+=1