refactor: Modularize wallos-fetch.sh and add CSV output support

wallos-fetch.sh

@@ -1,161 +1,123 @@
 #!/bin/bash
 
-VERSION="2025.04"
+VERSION="2025.05"
-
-# Configuration
 HOST="https://your-api-host.com"
 ENDPOINT="/api/subscriptions/get_subscriptions.php"
 API_KEY="${API_KEY:-$WALLOS_API_KEY}"
 
-# Defaults
 MODE="md"
 FULL=false
-OUTPUT=""  # Will set default per mode later
+OUTPUT=""
+TMP_FILE=$(mktemp)
+
+# 🚨 Dependencies check
+for dep in curl jq; do
+  command -v "$dep" >/dev/null 2>&1 || {
+    echo "❌ Missing required dependency: $dep"
+    exit 1
+  }
+done
 
-# Show help
 show_help() {
   cat << EOF
 ℹ️ Wallos Fetcher Script - v$VERSION
 
 Usage: ./wallos-fetch.sh [OPTIONS]
 
-Fetch and export subscription data from a Wallos instance.
-
 Options:
   --json             Output raw JSON
   --md               Output Markdown table
-  --full             Include more fields in CSV/Markdown
+  --csv              Output CSV table
+  --full             Include more fields
   --output <file>    Custom output filename
-  --help             Show this help message and exit
+  --help             Show this help message
-  --version          Show version and exit
+  --version          Show version
-
-Default output is Markdown.
 EOF
 }
 
-# Argument parser
+parse_args() {
-while [[ "$#" -gt 0 ]]; do
+  while [[ "$#" -gt 0 ]]; do
     case "$1" in
       --json) MODE="json" ;;
       --md) MODE="md" ;;
+      --csv) MODE="csv" ;;
       --full) FULL=true ;;
-    --output)
+      --output) shift; OUTPUT="$1" ;;
-      shift
-      OUTPUT="$1"
-      ;;
       --help) show_help; exit 0 ;;
-    --version) echo "❓ wallos-fetch v$VERSION"; exit 0 ;;
+      --version) echo "🧾 wallos-fetch v$VERSION"; exit 0 ;;
-    *) echo "Unknown option: $1" && show_help && exit 1 ;;
+      *) echo "Unknown option: $1"; show_help; exit 1 ;;
     esac
     shift
-done
+  done
 
-# Set default filenames if none specified
+  # Set default output filename
-if [[ -z "$OUTPUT" ]]; then
+  [[ -z "$OUTPUT" ]] && OUTPUT="subscriptions.${MODE}"
-  case "$MODE" in
+}
-    json) OUTPUT="subscriptions.json" ;;
-    md) OUTPUT="subscriptions.md" ;;
-    csv) OUTPUT="subscriptions.csv" ;;
-  esac
-fi
 
-# Construct the API URL
+fetch_data() {
-URL="${HOST}${ENDPOINT}?api_key=${API_KEY}"
+  URL="${HOST}${ENDPOINT}?api_key=${API_KEY}"
+  RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" "$URL")
+  STATUS=$(echo "$RESPONSE" | sed -n 's/^HTTP_STATUS://p')
+  BODY=$(echo "$RESPONSE" | sed '/^HTTP_STATUS:/d')
 
-# Perform the request
+  echo "$BODY" > "$TMP_FILE"
-RESPONSE=$(curl -s -w "\nHTTP_STATUS:%{http_code}" "$URL")
-BODY=$(echo "$RESPONSE" | sed -n '1,/^HTTP_STATUS:/p' | sed '$d')
-STATUS=$(echo "$RESPONSE" | tr -d '\n' | sed -e 's/.*HTTP_STATUS://')
 
-echo "HTTP Status: $STATUS"
+  if [[ "$STATUS" != "200" ]]; then
+    echo "❌ API request failed with status: $STATUS"
+    rm -f "$TMP_FILE"
+    exit 1
+  fi
+}
 
-if [ "$STATUS" -eq 200 ]; then
+output_json() {
-  echo "$BODY" > temp_response.json
+  mv "$TMP_FILE" "$OUTPUT"
-
-  if [ "$MODE" == "json" ]; then
-    mv temp_response.json "$OUTPUT"
   echo "💾 Saved JSON to $OUTPUT"
+}
 
-elif [ "$MODE" == "md" ]; then
+output_markdown() {
-  # Write markdown header and description
   {
     echo "# 🧾 Active Subscriptions Overview"
-    echo ""
-    echo "This document lists all recurring subscriptions tied to this household or individual. It includes costs, renewal dates, categories, and payment methods. This record is provided as a reference for financial planning, digital legacy management, or to assist family members in case of emergencies or estate matters."
-    echo ""
     echo "_Last updated: $(date +'%Y-%m-%d')_"
     echo ""
   } > "$OUTPUT"
 
-  if [ "$FULL" = true ]; then
+  if $FULL; then
     echo "| ID | Name | Price | Currency | Next Payment | Cycle | Auto Renew | Category | Payment Method |" >> "$OUTPUT"
     echo "|----|------|-------|----------|---------------|-------|-------------|----------|----------------|" >> "$OUTPUT"
-    jq -r '
+    jq -r '.subscriptions[] | [.id, .name, .price, .currency_id, .next_payment, .cycle, .auto_renew, .category_name, .payment_method_name] | @tsv' "$TMP_FILE" |
-      .subscriptions[] | [
+    while IFS=$'\t' read -r id name price curr next cycle renew cat pay; do
-        .id,
-        .name,
-        (.price | tostring),
-        .currency_id,
-        .next_payment,
-        .cycle,
-        .auto_renew,
-        (.category_name | gsub("&gt;"; ">") | gsub("&amp;"; "&")),
-        .payment_method_name
-      ] | @tsv
-    ' temp_response.json | while IFS=$'\t' read -r id name price curr next cycle renew cat pay; do
       echo "| $id | $name | $price | $curr | $next | $cycle | $renew | $cat | $pay |" >> "$OUTPUT"
     done
   else
     echo "| ID | Name | Price | Next Payment | Category | Payment Method |" >> "$OUTPUT"
     echo "|----|------|-------|---------------|----------|----------------|" >> "$OUTPUT"
-    jq -r '
+    jq -r '.subscriptions[] | [.id, .name, .price, .next_payment, .category_name, .payment_method_name] | @tsv' "$TMP_FILE" |
-      .subscriptions[] | [
+    while IFS=$'\t' read -r id name price next cat pay; do
-        .id,
-        .name,
-        (.price | tostring),
-        .next_payment,
-        (.category_name | gsub("&gt;"; ">") | gsub("&amp;"; "&")),
-        .payment_method_name
-      ] | @tsv
-    ' temp_response.json | while IFS=$'\t' read -r id name price next cat pay; do
       echo "| $id | $name | $price | $next | $cat | $pay |" >> "$OUTPUT"
     done
   fi
-    rm -f temp_response.json
+  echo "💾 Saved Markdown to $OUTPUT"
-    echo "💾 Saved Markdown table to $OUTPUT"
+  rm -f "$TMP_FILE"
+}
 
-  else
+output_csv() {
-    if [ "$FULL" = true ]; then
+  if $FULL; then
     echo '"id","name","price","currency_id","next_payment","cycle","auto_renew","category_name","payment_method_name"' > "$OUTPUT"
-      jq -r '
+    jq -r '.subscriptions[] | [.id, .name, .price, .currency_id, .next_payment, .cycle, .auto_renew, .category_name, .payment_method_name] | @csv' "$TMP_FILE" >> "$OUTPUT"
-        .subscriptions[] | [
-          .id,
-          .name,
-          .price,
-          .currency_id,
-          .next_payment,
-          .cycle,
-          .auto_renew,
-          .category_name,
-          .payment_method_name
-        ] | @csv
-      ' temp_response.json >> "$OUTPUT"
   else
     echo '"id","name","price","next_payment","category_name","payment_method_name"' > "$OUTPUT"
-      jq -r '
+    jq -r '.subscriptions[] | [.id, .name, .price, .next_payment, .category_name, .payment_method_name] | @csv' "$TMP_FILE" >> "$OUTPUT"
-        .subscriptions[] | [
-          .id,
-          .name,
-          .price,
-          .next_payment,
-          .category_name,
-          .payment_method_name
-        ] | @csv
-      ' temp_response.json >> "$OUTPUT"
   fi
-    rm -f temp_response.json
   echo "💾 Saved CSV to $OUTPUT"
-  fi
+  rm -f "$TMP_FILE"
-else
+}
-  echo "❌ Request failed. Response not saved."
+
-fi
+# 🏁 Main
+parse_args "$@"
+fetch_data
+
+case "$MODE" in
+  json) output_json ;;
+  md) output_markdown ;;
+  csv) output_csv ;;
+esac