email-checker-mv 0.1.0

Batch and CLI email validator

📧 Email Checker

Email Checker is a Python-based utility for validating email addresses in bulk or individually. It detects disposable email domains, supports scheduled checks via cron, and is available both as a standalone CLI tool and as a Dockerized service.

---

🚀 Features

• ✅ Validate a single email address from the CLI
• 📄 Batch validation from CSV files
• 🕒 Cron integration for scheduled checks
• 🐳 Dockerized for easy deployment
• 🔄 Automatic update of disposable domains list

---

📦 Installation (CLI Version)

Install the tool locally using pip:

  pip install .

Uninstall (CLI Version)

  pip uninstall email-checker

🛠️ CLI Commands

Check a single email:

  check_email [e-mail]

Batch check (from /input/*.csv):

  check_batch

Update the list of disposable email domains:

  python3 src/app/utils/update_disposable_domains.py

🐳 Docker Usage

This project includes a manage.sh script to simplify Docker operations.

Before first usage run:

  chmod +x manage.sh

Start the service:

  ./manage.sh start

Stop the service:

  ./manage.sh stop

Destroy the container:

  ./manage.sh destroy

Follow cron job logs:

  docker exec -it email_checker tail -f /var/log/cron.log

Run batch check inside Docker:

  docker exec -it email_checker check_batch

Run single email check inside Docker:

  docker exec -it email_checker check_email [e-mail]

📋 Notes

• Input CSV files should be placed in the input/ directory.

• Disposable email domains are fetched from Propaganistas/Laravel-Disposable-Email.

• Cron jobs are preconfigured in the Docker image to run checks and update disposable domains.

📄 License

• This project is licensed under the MIT License.