better dependency listing

Author: thomasWeise

bookbase

@@ -0,0 +1,36 @@
+#!/bin/bash -
+
+# This script prints the versions of the dependencies and software environment under which the book was built.
+# It uses the basic dependency versions given in bookbase and adds python tool information.
+
+# strict error handling
+set -o pipefail  # trace ERR through pipes
+set -o errtrace  # trace ERR through 'time command' and other functions
+set -o nounset   # set -u : exit the script if you try to use an uninitialized variable
+set -o errexit   # set -e : exit the script if any statement returns a non-true return value
+
+hasOutput=false  # Do we have some output and need a separator?
+
+# Check the versions of the tools and packages.
+for pack in "pytest" "pytest-timeout" "mypy" "ruff" "pylint"; do
+  version="$(python3 -m pip show "$pack" 2>/dev/null || true)"
+  if [ -z "$version" ]; then
+    # pytest or the plugin is not installed, so we install it now.
+    # We do this silently, without printing any information...
+    python3 -m pip install --require-virtualenv "$pack" 1>/dev/null 2>&1
+    version="$(python3 -m pip show "$pack" 2>/dev/null)"
+  fi
+
+  # For each tool or plugin, we get the version separately.
+  version="$(grep Version: <<< "$version")"
+  version="$(sed -n 's/.*Version:\s*\([.0-9]*\)/\1/p' <<< "$version")"
+  if [ -n "$version" ]; then  # ... and we concatenate them
+    echo "$pack: $version"
+    hasOutput=true
+  fi
+done
+
+# separator if we have anything
+if [ "$hasOutput" = true ]; then
+  echo ""
+fi

text/front/preface/__dependencyVersionsInner.sh

@@ -0,0 +1,14 @@
+#!/bin/bash -
+
+# This script prints the versions of the dependencies and software environment under which the book was built.
+# It uses the basic dependency versions given in bookbase and adds python tool information.
+
+# strict error handling
+set -o pipefail  # trace ERR through pipes
+set -o errtrace  # trace ERR through 'time command' and other functions
+set -o nounset   # set -u : exit the script if you try to use an uninitialized variable
+set -o errexit   # set -e : exit the script if any statement returns a non-true return value
+
+# get the script directory
+scriptDir="$(readlink -f "$(dirname "$0")")"
+"bookbase/scripts/dependencyVersions.sh" "$scriptDir/__dependencyVersionsInner.sh" "${@:1}"

text/front/preface/dependencyVersions.sh

@@ -66,4 +66,4 @@ \chapter*{Preface}%
 %
 \strut\vfill\strut%
 This book was built using the following software:%
-\gitOutputWithStyle{}{}{bookbase/scripts/dependencyVersions.sh}{versions}{}{text_style}%
+\gitOutputWithStyle{}{}{text/front/preface/dependencyVersions.sh}{versions}{}{text_style}%