✉️ Email Operations — List Hygiene Tool Demo

• Email normalization — Lowercase, strip dots from Gmail, remove `+alias` tags
• Syntax validation — RFC 5322-compliant regex checking
• Disposable domain detection — Flags 32+ known throwaway email services
• Role address detection — Identifies 30+ non-personal prefixes (admin@, support@, info@, etc.)
• Domain typo correction — Fixes 14 common misspellings (gmial.com → gmail.com, etc.)
• Deduplication — Removes exact duplicates after normalization

# Clean a text file (one email per line)
python src/list_hygiene.py examples/sample_emails.txt

# Output as CSV
python src/list_hygiene.py emails.txt --output clean.csv --format csv

# Generate a cleaning report
python src/list_hygiene.py emails.txt --report

# Keep role addresses (don't filter them out)
python src/list_hygiene.py emails.txt --keep-roles

# Keep disposable domains
python src/list_hygiene.py emails.txt --keep-disposable

# Disable typo correction
python src/list_hygiene.py emails.txt --no-typo-fix

# Disable deduplication
python src/list_hygiene.py emails.txt --no-dedup

Email List Hygiene Report
=========================
Input:          1,250 addresses
Valid:            980
Removed:          270
  - Invalid syntax:     45
  - Disposable domain:  82
  - Role addresses:     31
  - Duplicates:        112
Typos corrected:        23