mailgrab 1.3.0

Un outil Python pour extraire des adresses email depuis des pages web ou des fichiers texte.

mailgrab

mailgrab is a Python tool designed to extract email addresses from web pages or text files. It uses regular expressions for email extraction and Playwright for web scraping. This tool is perfect for collecting email addresses from multiple sources.

Features

• Extracts email addresses from a URL or text file
• Extracts emails from mailto: links in HTML
• Uses Playwright for headless web scraping
• Searches with regular expressions
• Simple command-line interface (CLI)
• Can be used as a Python module

Installation

Install mailgrab from PyPI:

pip install mailgrab

⚠️ Make sure to install Playwright browsers:

python -m playwright install

Usage

CLI (Command Line)

$ mailgrab --help                            
usage: mailgrab [-h] (--url WEBSITE_URL | --file PATH_TO_FILE) [-v]

Collection of emails in text file or website page.

options:
  -h, --help           show this help message and exit
  --url WEBSITE_URL    Website url to read and extract emails
  --file PATH_TO_FILE  Path to file to read and extract emails
  -v, --version        show program's version number and exit

Examples

mailgrab --url "https://example.com"        # Extract emails from https://example.com
mailgrab --file "file.txt"                  # Extract emails from file.txt
mailgrab -v                                 # Show program's version

As a Python module

import mailgrab as mgb  # or from mailgrab import *

# Validate the path to a file containing emails
path = mgb.validate_path("file.txt")

# Read file content
with open(path, "r") as f:
    content = f.read()

# Extract emails from content
emails = mgb.extract_emails(content)

# Display emails using the built-in printer
mgb.print_emails(emails)

CLI Example Output

[¤] Found 3 unique email address(es):

 1) [e-mail]
 2) [e-mail]
 3) [e-mail]

Path validation

When using the --file option or validate_path() function, mailgrab ensures:

• the path exists,
• it is a valid file,
• it can be opened for reading.

If not, a MailgrabError with a clear message is raised.

Contributing

Want to improve this project? Awesome! Please read the contributing guidelines before submitting a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.