mailsight 0.1.0

A comprehensive email verification tool: domain validation, DNS/WHOIS lookup, blacklist check, MX record validation, SMTP handshake, and ping test.

Mailsight

CLI tool to validate email addresses using DNS lookups, optional WHOIS and Spamhaus checks, and (unless --dry-run) live SMTP verification.

Install

uv sync

Or install the package in editable mode:

uv pip install -e .

The mailsight command is provided by [project.scripts] in pyproject.toml.

Usage

mailsight [e-mail]
python -m mailsight.command.cli [e-mail]
python main.py [e-mail]

Options

Flag	Meaning
--dry-run	Run DNS-based checks only (no WHOIS, SMTP, catch-all probe, ping, or expiration). Exits 0 on success.
--ping / -p	Ping the primary MX host (ignored when combined with --dry-run).
--theme light|dark	Catppuccin-based Rich theme.
--verbose / -v	More logging.
--version	Print version and exit.
--debug-info	Print environment/debug details.

Exit code 0 means verification finished without a blocking error; 1 means a check failed (see the printed message and remediation hint).

Limitations

• SMTP and catch-all checks open real connections to the MX host. Use responsibly and respect provider policies; prefer --dry-run for passive checks only.
• WHOIS and DNSBL results depend on public data and may be slow or incomplete.
• ping3 may require elevated privileges on some systems.

Development

uv run pytest -c config/pytest.ini
uv run ruff check --config config/ruff.toml src tests
uv run mypy --config config/mypy.ini src tests