From 6aa6fcfeed9652225471c423170b214f4e2638b8 Mon Sep 17 00:00:00 2001
From: Jonathan Rosenbaum <bike@bikeshopi.org>
Date: Sat, 2 May 2026 16:38:27 -0400
Subject: [PATCH] Subscribe members to mailman-connector, utilizes positional
 arguments

---
 subscribe-members.sh | 150 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 150 insertions(+)
 create mode 100755 subscribe-members.sh

diff --git a/subscribe-members.sh b/subscribe-members.sh
new file mode 100755
index 0000000..bb21363
--- /dev/null
+++ b/subscribe-members.sh
@@ -0,0 +1,150 @@
+#!/bin/bash
+# Production batch subscription script for LWVWV members
+# Usage: ./subscribe-members.sh <csv_file> <password> [list_id] [connector_url]
+#
+# This script reads a CSV file (email,first_name,last_name) and subscribes
+# all members to the specified Mailman list via the connector API.
+#
+# Arguments:
+#   csv_file        Path to CSV file with format: email,first_name,last_name
+#   password        Secret password for the mailman-connector (required)
+#   list_id         Target mailing list (default: members.lists.example.org)
+#   connector_url   URL of the mailman-connector (default: https://mailman-connector.example.com)
+#
+# Example:
+#   ./subscribe-members.sh members.csv mysecretpassword
+#   ./subscribe-members.sh members.csv mysecretpassword test.lists.example.org
+#   ./subscribe-members.sh members.csv mysecretpassword test.lists.example.org https://connector.example.com
+
+# Show help
+show_help() {
+    cat << EOF
+Usage: $0 <csv_file> <password> [list_id] [connector_url]
+
+Arguments:
+  csv_file        Path to CSV file with format: email,first_name,last_name
+  password        Secret password for the mailman-connector (required)
+  list_id         Target mailing list (default: members.lists.example.org)
+  connector_url   URL of the mailman-connector (default: https://mailman-connector.example.com)
+
+Examples:
+  $0 members.csv mysecretpassword
+  $0 members.csv mysecretpassword test.lists.example.org
+  $0 members.csv mysecretpassword test.lists.example.org https://connector.example.com
+
+CSV Format:
+  The CSV file should have one member per line:
+  email@example.com,FirstName,LastName
+  another@example.com,John,Doe
+
+EOF
+}
+
+# Check for help flag
+if [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
+    show_help
+    exit 0
+fi
+
+# Parse arguments
+CSV_FILE="${1:-}"
+CONNECTOR_PASSWORD="${2:-}"
+LIST_ID="${3:-members.lists.example.org}"
+CONNECTOR_URL="${4:-https://mailman-connector.example.com}"
+
+# Validation
+if [ -z "$CSV_FILE" ]; then
+    echo "Error: CSV file argument is required"
+    echo ""
+    show_help
+    exit 1
+fi
+
+if [ -z "$CONNECTOR_PASSWORD" ]; then
+    echo "Error: Password argument is required"
+    echo ""
+    show_help
+    exit 1
+fi
+
+if [ ! -f "$CSV_FILE" ]; then
+    echo "Error: File not found: $CSV_FILE"
+    exit 1
+fi
+
+# Validate CSV format
+if ! grep -q ',' "$CSV_FILE"; then
+    echo "Error: CSV file appears invalid (no commas found)"
+    echo "Expected format: email,first_name,last_name"
+    exit 1
+fi
+
+# Read CSV content
+CSV_DATA=$(cat "$CSV_FILE")
+if [ -z "$CSV_DATA" ]; then
+    echo "Error: CSV file is empty"
+    exit 1
+fi
+
+# Count members
+MEMBER_COUNT=$(wc -l < "$CSV_FILE" | tr -d ' ')
+
+echo "=========================================="
+echo "LWVWV Member Subscription"
+echo "=========================================="
+echo "Connector URL: $CONNECTOR_URL"
+echo "Target List:   $LIST_ID"
+echo "CSV File:      $CSV_FILE"
+echo "Members:       $MEMBER_COUNT"
+echo "=========================================="
+echo ""
+
+# Check if jq is installed
+if ! command -v jq &> /dev/null; then
+    echo "Error: jq is required but not installed"
+    echo "Install with: apt-get install jq (Debian/Ubuntu) or yum install jq (RHEL/CentOS)"
+    exit 1
+fi
+
+# Send to connector
+echo "Subscribing members..."
+echo ""
+
+RESPONSE=$(curl -s -X POST "$CONNECTOR_URL" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"subscribe_batch\": \"subscribe_batch\",
+    \"password\": \"$CONNECTOR_PASSWORD\",
+    \"list_id\": \"$LIST_ID\",
+    \"csv_data\": $(echo "$CSV_DATA" | jq -R -s .)
+  }")
+
+# Check response
+if echo "$RESPONSE" | jq -e . &> /dev/null; then
+    echo "Response:"
+    echo "$RESPONSE" | jq .
+    
+    # Extract summary if available
+    if echo "$RESPONSE" | jq -e '.summary' &> /dev/null; then
+        echo ""
+        echo "Summary:"
+        echo "  Total processed:     $(echo "$RESPONSE" | jq -r '.summary.total_received // "N/A"')"
+        echo "  Newly subscribed:    $(echo "$RESPONSE" | jq -r '.summary.subscribed // "N/A"')"
+        echo "  Already subscribed:  $(echo "$RESPONSE" | jq -r '.summary.already_subscribed // "N/A"')"
+        echo "  Errors:              $(echo "$RESPONSE" | jq -r '.summary.errors // "N/A"')"
+    fi
+    
+    # Check for errors
+    if echo "$RESPONSE" | jq -e '.error' &> /dev/null; then
+        echo ""
+        echo "ERROR: $(echo "$RESPONSE" | jq -r '.error')"
+        exit 1
+    fi
+else
+    echo "Error: Invalid response from connector"
+    echo "Response: $RESPONSE"
+    exit 1
+fi
+
+echo ""
+echo "Done!"