Merge pull request #920 from pgrenaud/check-tools-option-and-github-workflow

Add --check-tools option and GitHub workflow

Author: six2dez

.github/workflows/tests.yml

@@ -0,0 +1,39 @@
+name: tests
+
+on: [push, pull_request]
+
+jobs:
+  tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - macos-14
+          - macos-15
+          - ubuntu-20.04
+          - ubuntu-22.04
+          - ubuntu-24.04
+
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Install bash from homebrew
+        if: ${{ startsWith(matrix.os, 'macos-') }}
+        run: brew install bash
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install reconFTW
+        shell: bash
+        continue-on-error: true
+        run: ./install.sh
+
+      - name: Check if all tools are installed
+        shell: bash
+        run: ./reconftw.sh --check-tools
+
+      - name: Check if chromium dependencies are installed
+        shell: bash
+        run: nuclei -headless -id screenshot

README.md

@@ -408,6 +408,7 @@ reset='\033[0m'
 | -o | Output directory |
 | -v | Axiom distributed VPS |
 | -q | Rate limit in requests per second |
+| --check-tools | Exit if one of the tools is missing |
 
 ## Example Usage
 

reconftw.sh

@@ -256,6 +256,10 @@ function tools_installed() {
 
 	printf "%b[%s] Tools check finished%b\n" "$bblue" "$(date +'%Y-%m-%d %H:%M:%S')" "$reset"
 	printf "%b#######################################################################\n%b" "$bgreen" "$reset"
+
+	if [[ $CHECK_TOOLS_OR_EXIT == true && $all_installed != true ]]; then
+		exit 2
+	fi
 }
 
 #####################################################################cc##########################################
@@ -6007,6 +6011,7 @@ function help() {
 	printf "   -o output/path    Define output folder\n"
 	printf "   -v, --vps         Axiom distributed VPS \n"
 	printf "   -q                Rate limit in requests per second \n"
+	printf "   --check-tools     Exit if one of the tools is missing\n"
 	printf " \n"
 	printf " ${bblue}USAGE EXAMPLES${reset}\n"
 	printf " ${byellow}Perform full recon (without attacks):${reset}\n"
@@ -6041,7 +6046,12 @@ if [[ $OSTYPE == "darwin"* ]]; then
 	PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"
 fi
 
-PROGARGS=$(getopt -o 'd:m:l:x:i:o:f:q:c:z:rspanwvh::' --long 'domain:,list:,recon,subdomains,passive,all,web,osint,zen,deep,help,vps' -n 'reconFTW' -- "$@")
+PROGARGS=$(getopt -o 'd:m:l:x:i:o:f:q:c:z:rspanwvh::' --long 'domain:,list:,recon,subdomains,passive,all,web,osint,zen,deep,help,vps,check-tools' -n 'reconFTW' -- "$@")
+
+exit_status=$?
+if [[ $exit_status -ne 0 ]]; then
+	UNKNOWN_ARGUMENT=true
+fi
 
 # Note the quotes around "$PROGARGS": they are essential!
 eval set -- "$PROGARGS"
@@ -6158,13 +6168,18 @@ while true; do
 		shift
 		break
 		;;
-	'--help' | '-h' | *)
+	'--check-tools')
+		CHECK_TOOLS_OR_EXIT=true
+		shift
+		continue
+		;;
+	'--help' | '-h')
+		break
+		;;
+	*)
 		# echo "Unknown argument: $1"
-		. ./reconftw.cfg
-		banner
-		help
-		tools_installed
-		exit 1
+		UNKNOWN_ARGUMENT=true
+		break
 		;;
 	esac
 done
@@ -6396,6 +6411,8 @@ case $opt_mode in
 *)
 	help
 	tools_installed
-	exit 1
+	if [[ $UNKNOWN_ARGUMENT == true ]]; then
+		exit 1
+	fi
 	;;
 esac