build: improve update script error handling (#832)

Co-authored-by: Bill Glesias <[email protected]>

Author: MikeMcC399

docs/MAINTENANCE.md

@@ -40,6 +40,12 @@ Again, this needs to be repeated if you change the base node version using nvm.
 
 - [Visual Studio Code](https://code.visualstudio.com/) or other editor
 
+Under Microsoft Windows it may be necessary to also execute the following preparatory command:
+
+```bash
+npm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe" --location user
+```
+
 ## Updating examples
 
 When a new version of [Cypress](https://docs.cypress.io/guides/references/changelog) is published, the examples can be updated.

scripts/check-package-manager-npm.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# This script checks that the prerequisite
+# npm is installed
+
+if ! command -v npm &> /dev/null
+then
+    echo "**npm is required and not installed**"
+    echo "install Node.js LTS from:"
+    echo "https://nodejs.org/en/"
+    echo "or install and use nvm"
+    echo
+exit 1 # failure
+else
+    echo "npm is installed"
+fi

scripts/check-package-managers-other.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# This script checks that the prerequisites
+# pnpm and yarn are installed
+
+pnpmInstalled=false
+if ! command -v pnpm &> /dev/null
+then
+    echo "**pnpm not installed**"
+    echo "execute the following command:"
+    echo "npm install pnpm -g"
+    echo
+else
+pnpmInstalled=true
+fi
+
+yarnInstalled=false
+if ! command -v yarn &> /dev/null
+then
+    echo "**yarn not installed**"
+    echo "execute the following command:"
+    echo "npm install yarn -g"
+    echo
+else
+yarnInstalled=true
+fi
+
+if $pnpmInstalled == true && $yarnInstalled == true
+then
+    echo "pnpm and yarn are installed"
+else
+exit 1 # failure
+fi

scripts/update-cypress-latest-npm.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+set -e # fail on error
 #
 # All examples using npm technology are updated to
 # Cypress latest version

scripts/update-cypress-latest-other.sh

@@ -1,8 +1,11 @@
 #!/bin/bash
+set -e # fail on error
 #
 # Examples using yarn and pnpm package managers are
 # updated to Cypress latest version
 #
+# Make sure that pnpm and yarn are installed
+./scripts/check-package-managers-other.sh
 
 echo updating yarn examples to Cypress latest version
 cd examples

scripts/update-cypress-latest.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+set -e # fail on error
 #
 # All examples are updated to Cypress latest version
 #
@@ -8,6 +9,11 @@
 # npm install pnpm -g
 # The VScode editor is also used in the last step if available.
 #
+# First check if the required package managers are installed
+./scripts/check-package-manager-npm.sh
+./scripts/check-package-managers-other.sh
+# then proceed to updating the examples
+echo
 ./scripts/update-cypress-latest-npm.sh
 ./scripts/update-cypress-latest-other.sh