mail-ops-scripts 2.3.0

A unified operational toolkit for email server administration and DMARC analysis.

Mail Ops Scripts

A unified operational toolkit for email server administration, security analysis, and reporting.

🚀 COMMANDS STATUS

Command	Status	Tech
mailops dkim example.com	✅ FULLY LIVE	OpenSSL key generation
mailops spf google.com	✅ FULLY LIVE	Google DNS-over-HTTPS
mailops report --alerts	✅ FILE READY	DMARC XML parsing
mailops fetch --user...	✅ CREDS READY	IMAPlib + Gmail/Outlook

✅ LIVE = Real code executing (DKIM keys generated, SPF DNS lookups, XML parsing) ⏳ TODO = Structure ready but needs real implementation ❌ BROKEN = Import errors or crashes

🎯 PRODUCTION WORKFLOW

📥 1. Fetch reports          → mailops fetch --user [e-mail] --password app-pass --days 7
📊 2. Analyze + alerts       → mailops report --alerts
🔍 3. SPF validation         → mailops spf yourdomain.com
🔑 4. DKIM key generation    → mailops dkim yourdomain.com --selector=mail

💾 Quick Start

# Clone + setup
git clone https://github.com/knowoneactual/mail-ops-scripts
cd mail-ops-scripts

# Virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv/bin/Activate.ps1   # Windows PowerShell

# Install
pip install -e .

# Test
mailops --help

📋 Commands Reference

# DKIM Key Generation
mailops dkim example.com                    # default selector
mailops dkim example.com --selector=mail    # custom selector

# SPF Checking  
mailops spf google.com
mailops spf yourdomain.com

# DMARC Reports
mailops report                          # All XML files
mailops report --alerts                 # Failures only
mailops report --csv output.csv         # Export CSV

# IMAP Fetching
mailops fetch --user [e-mail] --password app-password --days 7
mailops fetch --user [e-mail] --server imap.domain.com --days 30

🎉 Features

• ✅ Real OpenSSL DKIM generation → selector.private files
• ✅ Google DNS-over-HTTPS SPF → Production DNS lookups
• ✅ DMARC XML parsing → Console + CSV output
• ✅ IMAP report fetching → Gmail/Outlook/Exchange ready
• ✅ Global CLI install → ~/.local/bin/mailops
• ✅ VS Code workflow → Python/HTML/Bash integration
• ✅ Production ready → Error handling + help text

🛠 Development

# Dev dependencies
pip install -e '.[dev]'

# Code quality
black .
isort .
mypy .
pytest

📦 Build & Publish

pip install build twine
python -m build
twine upload dist/*

📖 Changelog

CHANGELOG.md

🤝 Contributing

CONTRIBUTING.md

📄 License

MIT

---

Made with ❤️ for email operations
knowoneactual/mail-ops-scripts