yopmail-client 1.2.2

A clean, modular Python client for YOPmail disposable email service with send and RSS functionality

📧 YOPmail Client

⚠️ IMPORTANT DISCLAIMER: This project is for educational purposes only. Please use responsibly and in accordance with YOPmail's terms of service. The authors are not responsible for any misuse of this software.

---

🎯 Overview

A clean, modular Python client for interacting with YOPmail disposable email service. Built with modern Python practices, comprehensive error handling, and a simple API for easy integration.

✨ Key Features

• 🔐 Secure Authentication - Robust cookie management and session handling
• 📬 Message Management - List, fetch, and process emails efficiently
• 📤 Send Messages - Send emails to other YOPmail addresses
• 📡 RSS Feeds - Get RSS feed URLs and data for any YOPmail address
• 🛡️ Rate Limiting - Built-in protection against service limits
• 🌐 Proxy Support - Advanced proxy rotation capabilities
• 📊 Comprehensive Logging - Detailed operation tracking
• 🎛️ CLI Interface - Easy command-line access
• 📚 Type Safety - Full type annotations throughout

---

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/firasguendouz/yopmail_auto.git
cd yopmail_auto

# Install dependencies
pip install -r requirements.txt

# Install the package
pip install -e .

Basic Usage

from yopmail_client import YOPMailClient

# Create client and send a message
with YOPMailClient("yourmailbox") as client:
    client.open_inbox()
    
    # Send a message to another YOPmail address
    result = client.send_message(
        "[e-mail]",
        "Test Subject",
        "This is a test message"
    )
    print(f"Message sent: {result['success']}")
    
    # List messages
    messages = client.list_messages()
    for msg in messages:
        print(f"Subject: {msg.subject}")

---

📖 Essential API

Core Functions

Function	Description	Parameters
client.open_inbox()	Initialize inbox access	None
client.list_messages(page)	List messages in inbox	page: int = 1
client.fetch_message(msg_id)	Fetch specific message content	msg_id: str
client.send_message(to, subject, body)	Send email to YOPmail address	to: str, subject: str, body: str
client.get_inbox_info()	Get inbox overview	None

Advanced Usage

from yopmail_client import YOPMailClient

# Full client control with send functionality
with YOPMailClient("mailbox") as client:
    client.open_inbox()
    
    # Send a message
    result = client.send_message(
        "[e-mail]",
        "Important Update",
        "This is an important message with details..."
    )
    
    # Get RSS feed URL
    rss_url = client.get_rss_feed_url("mailbox")
    print(f"RSS URL: {rss_url}")
    
    # Get RSS feed data
    rss_data = client.get_rss_feed_data("mailbox")
    print(f"RSS has {rss_data['message_count']} messages")
    
    # List and process messages
    messages = client.list_messages()
    for msg in messages:
        content = client.fetch_message(msg.id)
        print(f"Subject: {msg.subject}")
        print(f"From: {msg.sender}")
        print(f"Content: {content[:100]}...")

---

🖥️ Command Line Interface

# List all messages
yopmail-client yourmailbox --list

# Show detailed message information
yopmail-client yourmailbox --list --details

# Fetch specific message content
yopmail-client yourmailbox --fetch MESSAGE_ID

# Send an email message
yopmail-client yourmailbox --send --to "[e-mail]" --subject "Test Subject" --body "Test message body"

# Get RSS feed URL
yopmail-client yourmailbox --rss

# Get RSS feed data
yopmail-client yourmailbox --rss-data

---

🏗️ Architecture

Project Structure

yopmail-client/
├── 📁 modules/
│   └── 📁 yopmail_client/
│       ├── 📄 client.py          # Core client implementation
│       ├── 📄 simple_api.py      # Essential API functions
│       ├── 📄 constants.py       # Configuration constants
│       ├── 📄 cookies.py         # Cookie management
│       ├── 📄 exceptions.py      # Custom exceptions
│       ├── 📄 utils.py           # Utility functions
│       ├── 📄 cli.py             # Command-line interface
│       └── 📄 proxy_manager.py   # Proxy rotation
├── 📁 artifacts/
│   └── 📄 api_summary.json       # API documentation
├── 📄 requirements.txt           # Dependencies
├── 📄 setup.py                   # Package configuration
└── 📄 README.md                  # This file

Design Principles

• 🔧 Modularity - Clean separation of concerns
• 🛡️ Security - Safe handling of credentials and sessions
• 📈 Scalability - Built for high-volume operations
• 🔍 Observability - Comprehensive logging and monitoring
• 🎯 Simplicity - Easy-to-use API design

---

⚙️ Configuration

Rate Limiting

config = {
    "rate_limit_detection": True,
    "rate_limit_delay": 2.0,  # seconds
    "max_retries": 3
}

messages = check_inbox("mailbox", config=config)

Proxy Support

config = {
    "proxy_enabled": True,
    "proxy_list": [
        "http://proxy1:8080",
        "http://proxy2:8080"
    ],
    "proxy_rotation": True
}

---

🧪 Testing

# Run all tests
pytest tests/

# Run with coverage report
pytest --cov=modules.yopmail_client tests/

# Run specific test file
pytest tests/test_client_basic.py

---

📊 Performance

• ⚡ Fast Response - Optimized HTTP requests
• 🔄 Connection Pooling - Efficient resource usage
• 📈 Rate Limiting - Automatic backoff strategies
• 🌐 Proxy Rotation - Load distribution across proxies

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

# Clone and setup development environment
git clone https://github.com/firasguendouz/yopmail_auto.git
cd yopmail_auto

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest tests/

---

📄 License

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

---

⚠️ Legal Notice

This software is provided for educational and research purposes only.

• 🚫 No Spam - Do not use for sending unsolicited emails
• 🚫 No Abuse - Respect YOPmail's terms of service
• 🚫 No Commercial Use - Not intended for commercial applications
• ✅ Educational Use - Perfect for learning email automation
• ✅ Research - Ideal for academic and research projects

The authors are not responsible for any misuse of this software.

---

📞 Support

• 📧 Issues: GitHub Issues
• 📚 Documentation: Wiki
• 💬 Discussions: GitHub Discussions

---

Made with ❤️ for the Python community