diff options
| author | Eugene Triguba <hello@eugenetriguba.com> | 2025-07-20 18:50:30 -0400 |
|---|---|---|
| committer | Eugene Triguba <hello@eugenetriguba.com> | 2025-07-20 18:50:30 -0400 |
| commit | 004db1b9fe33c501907764fe6ecf718afe1bcd92 (patch) | |
| tree | e98ff0ffb032e7c6b684379b11746b18b756257a /executables | |
| parent | Replace barbar with harpoon / adjust config (diff) | |
| download | dotfiles-004db1b9fe33c501907764fe6ecf718afe1bcd92.zip | |
Add msmtp/isync setup for local email processing via aerc
Diffstat (limited to 'executables')
| -rwxr-xr-x | executables/bin/get-password | 44 | ||||
| -rwxr-xr-x | executables/bin/msmtp-queue | 294 | ||||
| -rwxr-xr-x | executables/bin/msmtp-send | 147 |
3 files changed, 463 insertions, 22 deletions
diff --git a/executables/bin/get-password b/executables/bin/get-password index ca13d93..3b83bb7 100755 --- a/executables/bin/get-password +++ b/executables/bin/get-password @@ -5,32 +5,32 @@ VAULT="Private" CREDENTIAL="" main() { - parse_args "$@" - op read "op://$VAULT/$CREDENTIAL/password" + parse_args "$@" + op read "op://$VAULT/$CREDENTIAL/password" } parse_args() { - while [ $# -gt 0 ]; do - case "$1" in - --vault) - VAULT="$2" - shift 2 - ;; - --credential) - CREDENTIAL="$2" - shift 2 - ;; - *) - echo "Usage: $0 [--vault <name>] --credential <name>" - exit 1 - ;; - esac - done + while [ $# -gt 0 ]; do + case "$1" in + --vault) + VAULT="$2" + shift 2 + ;; + --credential) + CREDENTIAL="$2" + shift 2 + ;; + *) + echo "Usage: $0 [--vault <name>] --credential <name>" + exit 1 + ;; + esac + done - if [ -z "$CREDENTIAL" ]; then - echo "Invalid or empty CREDENTIAL" >&2 - exit 1 - fi + if [ -z "$CREDENTIAL" ]; then + echo "Invalid or empty CREDENTIAL" >&2 + exit 1 + fi } main "$@" diff --git a/executables/bin/msmtp-queue b/executables/bin/msmtp-queue new file mode 100755 index 0000000..fb1e487 --- /dev/null +++ b/executables/bin/msmtp-queue @@ -0,0 +1,294 @@ +#!/usr/bin/env bash +# msmtp queue management utility +# +# Provides commands to process, check status, and clear the +# msmtp email queue that is populated by msmtp-send. +set -euo pipefail + +DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}" +QUEUE_DIR="${DATA_DIR}/msmtp-queue" +LOG_FILE="${DATA_DIR}/msmtp-queue-processor.log" +MSMTP_PATH="$(command -v msmtp)" + +main() { + if [[ $# -eq 0 ]]; then + print_usage + exit 1 + fi + + local subcommand="$1" + shift + + case "$subcommand" in + process) + process_queue "$@" + ;; + status) + show_status "$@" + ;; + clear) + clear_queue "$@" + ;; + -h | --help) + print_usage + exit 0 + ;; + *) + log_message "ERROR" "Unknown subcommand: $subcommand" + print_usage + exit 1 + ;; + esac +} + +print_usage() { + cat <<USAGE +Usage: $(basename "$0") <subcommand> [OPTIONS] + +A utility to manage the msmtp email queue. + +SUBCOMMANDS: + process Process all queued emails (attempt to send) + status Show queue status and recent activity + clear [ACCOUNT] Clear queued emails (all accounts or specific account) + +OPTIONS: + -h, --help Show this help message + +EXAMPLES: + $(basename "$0") process + $(basename "$0") status + $(basename "$0") clear + $(basename "$0") clear gmail + +NOTES: + - Queue directory: $QUEUE_DIR + - Log file: $LOG_FILE + - Queued files are named: timestamp-pid-random-ACCOUNT +USAGE +} + +log_message() { + local level="$1" + shift + local message + message="$(date '+%Y-%m-%d %H:%M:%S') [$level] $*" + + if [[ -d "$QUEUE_DIR" ]]; then + echo "$message" >>"$LOG_FILE" + fi + echo "$message" >&2 +} + +process_queue() { + if [[ $# -gt 0 ]]; then + log_message "ERROR" "process subcommand takes no arguments" + print_usage + exit 1 + fi + + if ! command -v "$MSMTP_PATH" >/dev/null 2>&1; then + log_message "ERROR" "msmtp not found at $MSMTP_PATH" + exit 1 + fi + + setup_queue_directory + + local total_count + total_count="$(count_queued_files)" + if [[ "$total_count" -eq 0 ]]; then + log_message "INFO" "No emails in queue" + return 0 + fi + + log_message "DEBUG" "Files from get_queued_files:" + get_queued_files | while IFS= read -r debug_file; do + log_message "DEBUG" " - $debug_file" + done + + log_message "INFO" "Processing $total_count queued emails" + local sent_count=0 + local failed_count=0 + # NOTE: Temporarily disable exit on error for msmtp call + # so that it can continue processing other files even if + # one fails. + set +e + while IFS= read -r file; do + if [[ -n "$file" ]]; then + local account + account="$(extract_account_from_filename "$file")" + + log_message "INFO" "Attempting to send $(basename "$file") via $account" + + local msmtp_output + if msmtp_output=$("$MSMTP_PATH" --account="$account" -t <"$file" 2>&1); then + rm "$file" + log_message "INFO" "SUCCESS: Sent $(basename "$file") via $account" + ((sent_count++)) + else + log_message "ERROR" "FAILED: Could not send $(basename "$file") via $account - $msmtp_output" + ((failed_count++)) + fi + fi + done < <(get_queued_files) + set -e + + log_message "INFO" "Processing complete: $sent_count sent, $failed_count failed" +} + +setup_queue_directory() { + if ! mkdir -p "$QUEUE_DIR"; then + log_message "ERROR" "Failed to create queue directory: $QUEUE_DIR" + exit 1 + fi +} + +extract_account_from_filename() { + local filename="$1" + local basename_file + basename_file="$(basename "$filename")" + + # NOTE: Expected format of timestamp-pid-random-ACCOUNT + if [[ "$basename_file" =~ ^[0-9]+-[0-9]+-[a-fA-F0-9]+-(.+)$ ]]; then + echo "${BASH_REMATCH[1]}" + else + log_message "WARN" "Could not extract account from filename: $basename_file" + echo "unknown" + fi +} + +get_queued_files() { + local account_filter="${1:-}" + + if [[ ! -d "$QUEUE_DIR" ]]; then + return 0 + fi + + for file in "$QUEUE_DIR"/*; do + if [[ -f "$file" ]]; then + if [[ -z "$account_filter" ]]; then + echo "$file" + else + local file_account + file_account="$(extract_account_from_filename "$file")" + if [[ "$file_account" == "$account_filter" ]]; then + echo "$file" + fi + fi + fi + done +} + +count_queued_files() { + local account_filter="${1:-}" + local count=0 + + while IFS= read -r -d '' file; do + ((count++)) + done < <(get_queued_files "$account_filter" | tr '\n' '\0') + + echo "$count" +} + +show_status() { + if [[ $# -gt 0 ]]; then + log_message "ERROR" "status subcommand takes no arguments" + print_usage + exit 1 + fi + + setup_queue_directory + + echo "=== Queue Status ===" + + local total_count + total_count="$(count_queued_files)" + echo "Total queued: $total_count" + + if [[ "$total_count" -gt 0 ]]; then + echo "" + echo "By account:" + while IFS= read -r account; do + if [[ -n "$account" ]]; then + local account_count + account_count="$(count_queued_files "$account")" + echo " $account: $account_count" + fi + done < <(get_all_accounts) + fi + + if [[ -f "$LOG_FILE" ]]; then + echo "" + echo "=== Recent Activity (last 10 lines) ===" + tail -10 "$LOG_FILE" 2>/dev/null || echo "No log entries yet" + fi +} + +get_all_accounts() { + local accounts=() + + while IFS= read -r file; do + if [[ -n "$file" ]]; then + local account + account="$(extract_account_from_filename "$file")" + if [[ "$account" != "unknown" ]]; then + accounts+=("$account") + fi + fi + done < <(get_queued_files) + + # Remove duplicates and sort + printf '%s\n' "${accounts[@]}" | sort -u +} + +clear_queue() { + local account_filter="${1:-}" + + if [[ $# -gt 1 ]]; then + log_message "ERROR" "clear subcommand takes at most one argument (account name)" + print_usage + exit 1 + fi + + setup_queue_directory + + if [[ -n "$account_filter" ]]; then + local account_count + account_count="$(count_queued_files "$account_filter")" + + if [[ "$account_count" -eq 0 ]]; then + echo "No queued emails for account: $account_filter" + return 0 + fi + + while IFS= read -r file; do + if [[ -n "$file" ]]; then + rm "$file" + fi + done < <(get_queued_files "$account_filter") + + log_message "INFO" "Cleared $account_count queued emails for account: $account_filter" + echo "Cleared $account_count queued emails for account: $account_filter" + else + local total_count + total_count="$(count_queued_files)" + + if [[ "$total_count" -eq 0 ]]; then + echo "No queued emails to clear" + return 0 + fi + + while IFS= read -r file; do + if [[ -n "$file" ]]; then + rm "$file" + fi + done < <(get_queued_files) + + log_message "INFO" "Cleared $total_count queued emails (all accounts)" + echo "Cleared $total_count queued emails (all accounts)" + fi +} + +if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then + main "$@" +fi diff --git a/executables/bin/msmtp-send b/executables/bin/msmtp-send new file mode 100755 index 0000000..fad2f9e --- /dev/null +++ b/executables/bin/msmtp-send @@ -0,0 +1,147 @@ +#!/bin/bash +# Smart sendmail replacement with account selection and offline queuing +# +# When the mail server is offline, emails are queued in a local directory. +# When the server is back online, queued emails are sent automatically. +set -euo pipefail + +MSMTP_ACCOUNT="" +DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}" +QUEUE_DIR="${DATA_DIR}/msmtp-queue" +TEMP_DIR="${DATA_DIR}/msmtp-temp" +MSMTP_PATH="$(command -v msmtp)" + +main() { + parse_args "$@" + + if ! command -v "$MSMTP_PATH" >/dev/null 2>&1; then + log_message "ERROR" "msmtp not found at $MSMTP_PATH" + exit 1 + fi + + setup_directories + + local temp_file + temp_file=$(create_temp_file) + if ! cat >"$temp_file"; then + log_message "ERROR" "Failed to read email content" + cleanup_temp_file "$temp_file" + exit 1 + fi + + send_email "$temp_file" "$MSMTP_ACCOUNT" +} + +parse_args() { + while [[ $# -gt 0 ]]; do + case $1 in + --account) + if [[ -z "${2:-}" ]]; then + log_message "ERROR" "--account requires an argument" + print_usage + exit 1 + fi + MSMTP_ACCOUNT="$2" + shift 2 + ;; + -h | --help) + print_usage + exit 0 + ;; + esac + done + + if [[ -z "$MSMTP_ACCOUNT" ]]; then + log_message "ERROR" "No account specified. Use --account <account> to specify an account." + print_usage + exit 1 + fi +} + +log_message() { + local level="$1" + shift + echo "$(date '+%Y-%m-%d %H:%M:%S') [$level] $*" >&2 +} + +print_usage() { + cat <<USAGE +Usage: $(basename "$0") --account <account> [OPTIONS] [RECIPIENT...] + +A sendmail replacement that routes emails through msmtp with offline queuing. + +ARGUMENTS: + --account <account> Specify the account to use. It should match the name in your + msmtp configuration. + RECIPIENT... Email recipients (optional, can be specified in email body) + +OPTIONS: + -h, --help Show this help message + +EXAMPLES: + echo "test email" | $(basename "$0") --account gmail user@example.com + +NOTES: + - Emails are queued offline and sent when connection is available + - Queue directory: $QUEUE_DIR +USAGE +} + +create_temp_file() { + local timestamp + timestamp="$(date +%s)" + local pid="$$" + local random + random="$(od -An -N4 -tx4 </dev/urandom | tr -d ' ')" + echo "$TEMP_DIR/${timestamp}-${pid}-${random}" +} + +setup_directories() { + if ! mkdir -p "$QUEUE_DIR" "$TEMP_DIR"; then + log_message "ERROR" "Failed to create directories" + exit 1 + fi +} + +cleanup_temp_file() { + local temp_file="$1" + rm -f "$temp_file" +} + +send_email() { + local temp_file="$1" + local account="$2" + + if "$MSMTP_PATH" --account="$account" -t <"$temp_file" 2>/dev/null; then + log_message "INFO" "Email sent successfully via $account" + cleanup_temp_file "$temp_file" + return 0 + else + log_message "INFO" "Failed to send email, queuing for later" + queue_email "$temp_file" "$account" + return 1 + fi +} + +queue_email() { + local temp_file="$1" + local account="$2" + local timestamp + timestamp="$(date +%s)" + local pid="$$" + local random + random="$(od -An -N4 -tx4 </dev/urandom | tr -d ' ')" + local queued_file="$QUEUE_DIR/${timestamp}-${pid}-${random}-${account}" + + if mv "$temp_file" "$queued_file"; then + log_message "INFO" "Email queued for later delivery: $(basename "$queued_file")" + else + log_message "ERROR" "Failed to queue email" + cleanup_temp_file "$temp_file" + exit 1 + fi +} + +if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then + main "$@" +fi |