feat: better setup.sh to cover checking

This refactor includes the below changes

- Make ansible playbook with the latest collections
- Better setup script to cover ansible playbook checking

Referenced error message:

Unsupported parameters for (community.general.cargo) module: locked.
Supported parameters include: version, name, state, path."}

.github/workflows/tests.yml

@@ -21,8 +21,10 @@ jobs:
         uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python-version }}
+
       # Use separate run commands so command status handled correctly on Windows
-      - name: install ansible
+      - name: Install ansible
         run: pip install ansible
-      - name: run ansible-playbook check
-        run: cd ansible && ansible-playbook setup.yml --check
+
+      - name: Run ansible-playbook check
+        run: ./setup.sh --check

ansible/requirements.yml

@@ -0,0 +1,2 @@
+collections:
+  - name: community.general

setup.sh

@@ -1,5 +1,8 @@
 #!/usr/bin/env bash
 
+# Exit immediately if a command exits with a non-zero status
+set -e
+
 if ! command -v ansible-playbook &> /dev/null; then
   echo "Command ansible-playbook could not be found!"
   echo
@@ -9,4 +12,29 @@ if ! command -v ansible-playbook &> /dev/null; then
   exit 1
 fi
 
-cd ./ansible && ansible-playbook --ask-become-pass setup.yml
+ANSIBLE_PLAYBOOK_ARGS=()
+
+function usage() {
+  echo "Usage: setup.sh [OPTIONS]"
+  echo
+  echo "Options:"
+  echo ""
+  echo "--help   Show this message and exit"
+  echo "--check  Run the playbook in check mode (default: false)"
+  exit 0
+}
+
+# idiomatic parameter and option handling in sh
+while test $# -gt 0; do
+  case "$1" in
+      --check) ANSIBLE_PLAYBOOK_ARGS+=("--check");;
+      --help) usage;;
+      --*) echo "bad option $1";;
+        *) usage;;
+  esac
+  shift
+done
+
+cd ./ansible
+ansible-galaxy collection install -r requirements.yml --upgrade
+ansible-playbook --ask-become-pass setup.yml ${ANSIBLE_PLAYBOOK_ARGS[@]}