Contents

Chapter 1

Features

This chapter covers the core features and capabilities of List Hygiene Tool.

Features

  • 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
  • Multiple output formats — CSV, TXT, or JSON
  • Cleaning report — Summary of what was removed and why

Requirements

  • Python 3.10+
  • No external dependencies (stdlib only)
Chapter 2

Quick Start

Follow this guide to get List Hygiene Tool up and running in your environment.

Quick Start

bash
# 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

What Gets Cleaned

CheckExampleAction
Invalid syntaxnot-an-emailRemoved
Disposable domainuser@mailinator.comRemoved (unless --keep-disposable)
Role addressadmin@example.comRemoved (unless --keep-roles)
Domain typouser@gmial.comCorrected to user@gmail.com
DuplicateMultiple user@example.comDeduplicated
Gmail dotsu.s.e.r@gmail.comNormalized to user@gmail.com
Plus aliasesuser+tag@example.comNormalized to user@example.com
Chapter 3
🔒 Available in full product

Report Output

Chapter 4
🔒 Available in full product

License

You’ve reached the end of the free preview

Get the full List Hygiene Tool and unlock everything.

All Chapters

Get the complete guide with every chapter unlocked, including code samples, diagrams, and best practices.

Full Tool Suite

Access all interactive tools with complete data, all workload profiles, and the full scenario library.

Source Files

Downloadable source code, configuration files, and working examples from every chapter.

Lifetime Updates

Free updates for life. Every new chapter, tool, and improvement included.

Buy Now — $19 →
📦 Free sample included — download another copy for the full product.
List Hygiene Tool v1.0.0 — Free Preview