Skip to content

v3.5.5

Choose a tag to compare

@github-actions github-actions released this 08 Jul 21:01
· 132 commits to main since this release
a8c4d84

gomailtesttool Suite - Email Infrastructure Testing Tools

Portable CLI tools for comprehensive email infrastructure testing - covering cloud services (Exchange Online via Microsoft Graph), SMTP, IMAP, POP3, and JMAP protocols.

What's Included

Each ZIP archive contains a single unified binary:

  • gomailtest - Unified CLI for all protocols (smtp, imap, pop3, jmap, msgraph subcommands)

Plus documentation:

  • README.md - Main documentation
  • TOOLS.md - Protocol-specific tool guides
  • LICENSE - MIT License

Installation

Windows (amd64):

  1. Download gomailtesttool-windows-amd64-v3.5.5.zip
  2. Extract the ZIP file
  3. Run: gomailtest.exe --help

Linux (amd64):

  1. Download gomailtesttool-linux-amd64-v3.5.5.zip
  2. Extract: unzip gomailtesttool-linux-amd64-v3.5.5.zip
  3. Make executable: chmod +x gomailtest
  4. Run: ./gomailtest --help

macOS (Apple Silicon/arm64):

  1. Download gomailtesttool-macos-arm64-v3.5.5.zip
  2. Extract: unzip gomailtesttool-macos-arm64-v3.5.5.zip
  3. Make executable: chmod +x gomailtest
  4. Run: ./gomailtest --help

Note for macOS: If you see "cannot be opened because the developer cannot be verified":

  • Right-click the binary and select "Open", or
  • Run: xattr -d com.apple.quarantine gomailtest

Quick Start Examples

SMTP Testing:

# Test connectivity
./gomailtest smtp testconnect -host smtp.example.com -port 25

# TLS diagnostics
./gomailtest smtp teststarttls -host smtp.example.com -port 587

IMAP Testing:

# Test connection
./gomailtest imap testconnect -host imap.gmail.com -imaps

# List folders with OAuth2
./gomailtest imap listfolders -host imap.gmail.com -imaps \
  -username user@gmail.com -accesstoken "ya29..."

POP3 Testing:

# Test connection
./gomailtest pop3 testconnect -host pop.gmail.com -pop3s

# List mail
./gomailtest pop3 listmail -host pop.gmail.com -pop3s \
  -username user@gmail.com -password "app-password"

JMAP Testing:

# Discover session
./gomailtest jmap testconnect -host jmap.fastmail.com

# Get mailboxes
./gomailtest jmap getmailboxes -host jmap.fastmail.com \
  -username user@fastmail.com -accesstoken "token"

Microsoft Graph:

./gomailtest msgraph -tenantid "..." -clientid "..." -secret "..." \
  -mailbox "user@example.com" -action getinbox

Documentation