webscout 8.2.2__py3-none-any.whl → 2026.1.19__py3-none-any.whl

webscout/Extra/tempmail/cli.py

@@ -1,187 +1,191 @@
-"""
-Command-line interface for temporary email generation using SwiftCLI
-"""
-
-import sys
-import time
-from rich.console import Console
-from webscout.swiftcli import CLI, option
-from .base import get_provider
-
-# Initialize console for rich output
-console = Console()
-
-# Create CLI app
-app = CLI(
-    name="tempmail",
-    help="Temporary Email CLI Tool",
-    version="1.0.0"
-)
-
-@app.command()
-@option("--wait", "-w", type=int, default=10, help="Wait time in seconds between checking for new messages")
-@option("--output", "-o", type=str, choices=["simple", "detailed"], default="simple", help="Output format")
-@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
-def monitor(wait: int = 10, output: str = "simple", provider: str = "mailtm"):
-    """
-    Create and monitor a temporary email account
-
-    Continuously checks for new messages and displays them in the terminal.
-    Press Ctrl+C to exit and delete the account.
-    """
-    # Create a new email
-    mail = get_provider(provider_name=provider)
-
-    if hasattr(mail, 'auto_create'):
-        mail = get_provider(provider_name=provider, async_provider=False)
-        mail.create_account()
-    else:
-        success = mail.create_account()
-        if not success:
-            console.print("[red]Failed to create temporary email account.[/red]")
-            sys.exit(1)
-
-    console.print("[yellow]Temporary email address CLI[/yellow]")
-    console.print(f"[cyan]EMAIL: {mail.email}[/cyan]")
-    console.print(f"Account ID: {mail.account_id}")
-    console.print("Press Ctrl+C to exit and delete the account")
-
-    try:
-        while True:
-            console.print(f"Checking for new messages... ({time.strftime('%H:%M:%S')})")
-            new_messages = mail.check_new_messages()
-
-            if new_messages:
-                console.print(f"New messages: {len(new_messages)}")
-                console.print("-" * 40)
-
-                for msg in new_messages:
-                    console.print(f"From: {msg['from']}")
-                    console.print(f"Subject: {msg['subject']}")
-
-                    if output == "detailed":
-                        console.print(f"Body: {msg['body']}")
-                        console.print(f"Has attachments: {msg['hasAttachments']}")
-                        console.print(f"Created at: {msg['createdAt']}")
-
-                    console.print("[magenta]" + "-" * 40 + "[/magenta]")
-
-            time.sleep(wait)
-
-    except KeyboardInterrupt:
-        console.print("\nCtrl+C pressed. Exiting program and deleting account...")
-        if mail.delete_account():
-            console.print("[red]--Account deleted--[/red]")
-        else:
-            console.print("[red]--Failed to delete account--[/red]")
-
-@app.command()
-@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
-def create(provider: str = "mailtm"):
-    """
-    Create a temporary email account and display its details
-
-    Creates a new temporary email account and displays the email address.
-    The account will remain active until manually deleted.
-    """
-    mail = get_provider(provider_name=provider)
-
-    if hasattr(mail, 'auto_create'):
-        mail = get_provider(provider_name=provider, async_provider=False)
-        mail.create_account()
-    else:
-        success = mail.create_account()
-        if not success:
-            console.print("[red]Failed to create temporary email account.[/red]")
-            sys.exit(1)
-
-    console.print("[yellow]Temporary Email Created[/yellow]")
-    console.print(f"[cyan]EMAIL: {mail.email}[/cyan]")
-    console.print(f"Account ID: {mail.account_id}")
-    console.print("Use 'tempmail monitor' to check for messages")
-
-@app.command()
-@option("--email", "-e", type=str, required=True, help="Email address to check")
-@option("--account-id", "-a", type=str, required=True, help="Account ID for the email")
-@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
-@option("--output", "-o", type=str, choices=["simple", "detailed"], default="simple", help="Output format")
-def check(email: str, account_id: str, provider: str = "mailtm", output: str = "simple"):
-    """
-    Check messages for an existing temporary email account
-
-    Retrieves and displays messages for an existing temporary email account.
-    Requires the email address and account ID.
-    """
-    mail = get_provider(provider_name=provider)
-    mail.email = email
-    mail.account_id = account_id
-
-    # Try to get token if needed
-    if hasattr(mail, 'get_token'):
-        mail.get_token()
-
-    console.print(f"[cyan]Checking messages for: {email}[/cyan]")
-
-    try:
-        messages = mail.get_messages()
-
-        if not messages:
-            console.print("[yellow]No messages found[/yellow]")
-            return
-
-        console.print(f"Found {len(messages)} messages:")
-        console.print("-" * 40)
-
-        for msg in messages:
-            console.print(f"From: {msg['from']}")
-            console.print(f"Subject: {msg['subject']}")
-
-            if output == "detailed":
-                console.print(f"Body: {msg['body']}")
-                console.print(f"Has attachments: {msg['hasAttachments']}")
-                console.print(f"Created at: {msg['createdAt']}")
-
-            console.print("[magenta]" + "-" * 40 + "[/magenta]")
-
-    except Exception as e:
-        console.print(f"[red]Error checking messages: {str(e)}[/red]")
-
-@app.command()
-@option("--email", "-e", type=str, required=True, help="Email address to delete")
-@option("--account-id", "-a", type=str, required=True, help="Account ID for the email")
-@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
-def delete(email: str, account_id: str, provider: str = "mailtm"):
-    """
-    Delete an existing temporary email account
-
-    Deletes a temporary email account using the provided email address and account ID.
-    """
-    mail = get_provider(provider_name=provider)
-    mail.email = email
-    mail.account_id = account_id
-
-    # Try to get token if needed
-    if hasattr(mail, 'get_token'):
-        mail.get_token()
-
-    console.print(f"[yellow]Deleting account: {email}[/yellow]")
-
-    try:
-        success = mail.delete_account()
-        if success:
-            console.print("[green]Account successfully deleted[/green]")
-        else:
-            console.print("[red]Failed to delete account[/red]")
-    except Exception as e:
-        console.print(f"[red]Error deleting account: {str(e)}[/red]")
-
-def main():
-    """Main CLI function for tempmail"""
-    try:
-        app.run()
-    except Exception as e:
-        console.print(f"[red]Error: {str(e)}[/red]")
-        sys.exit(1)
-
-if __name__ == "__main__":
-    main()
+"""
+Command-line interface for temporary email generation using SwiftCLI
+"""
+
+import sys
+import time
+from typing import Optional, cast
+
+from rich.console import Console
+
+from webscout.swiftcli import CLI, option
+
+from .base import TempMailProvider, get_provider
+
+# Initialize console for rich output
+console = Console()
+
+# Create CLI app
+app = CLI(
+    name="tempmail",
+    help="Temporary Email CLI Tool",
+    version="1.0.0"
+)
+
+@app.command()
+@option("--wait", "-w", type=int, default=10, help="Wait time in seconds between checking for new messages")
+@option("--output", "-o", type=str, choices=["simple", "detailed"], default="simple", help="Output format")
+@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
+def monitor(wait: int = 10, output: str = "simple", provider: str = "mailtm"):
+    """
+    Create and monitor a temporary email account
+
+    Continuously checks for new messages and displays them in the terminal.
+    Press Ctrl+C to exit and delete the account.
+    """
+    # Create a new email
+    mail = cast(TempMailProvider, get_provider(provider_name=provider))
+
+    if hasattr(mail, 'auto_create'):
+        mail = cast(TempMailProvider, get_provider(provider_name=provider, async_provider=False))
+        mail.create_account()
+    else:
+        success = mail.create_account()
+        if not success:
+            console.print("[red]Failed to create temporary email account.[/red]")
+            sys.exit(1)
+
+    console.print("[yellow]Temporary email address CLI[/yellow]")
+    console.print(f"[cyan]EMAIL: {mail.email}[/cyan]")
+    console.print(f"Account ID: {mail.account_id}")
+    console.print("Press Ctrl+C to exit and delete the account")
+
+    try:
+        while True:
+            console.print(f"Checking for new messages... ({time.strftime('%H:%M:%S')})")
+            new_messages = mail.check_new_messages()
+
+            if new_messages:
+                console.print(f"New messages: {len(new_messages)}")
+                console.print("-" * 40)
+
+                for msg in new_messages:
+                    console.print(f"From: {msg['from']}")
+                    console.print(f"Subject: {msg['subject']}")
+
+                    if output == "detailed":
+                        console.print(f"Body: {msg['body']}")
+                        console.print(f"Has attachments: {msg['hasAttachments']}")
+                        console.print(f"Created at: {msg['createdAt']}")
+
+                    console.print("[magenta]" + "-" * 40 + "[/magenta]")
+
+            time.sleep(wait)
+
+    except KeyboardInterrupt:
+        console.print("\nCtrl+C pressed. Exiting program and deleting account...")
+        if mail.delete_account():
+            console.print("[red]--Account deleted--[/red]")
+        else:
+            console.print("[red]--Failed to delete account--[/red]")
+
+@app.command()
+@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
+def create(provider: str = "mailtm"):
+    """
+    Create a temporary email account and display its details
+
+    Creates a new temporary email account and displays the email address.
+    The account will remain active until manually deleted.
+    """
+    mail = cast(TempMailProvider, get_provider(provider_name=provider))
+
+    if hasattr(mail, 'auto_create'):
+        mail = cast(TempMailProvider, get_provider(provider_name=provider, async_provider=False))
+        mail.create_account()
+    else:
+        success = mail.create_account()
+        if not success:
+            console.print("[red]Failed to create temporary email account.[/red]")
+            sys.exit(1)
+
+    console.print("[yellow]Temporary Email Created[/yellow]")
+    console.print(f"[cyan]EMAIL: {mail.email}[/cyan]")
+    console.print(f"Account ID: {mail.account_id}")
+    console.print("Use 'tempmail monitor' to check for messages")
+
+@app.command()
+@option("--email", "-e", type=str, required=True, help="Email address to check")
+@option("--account-id", "-a", type=str, required=True, help="Account ID for the email")
+@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
+@option("--output", "-o", type=str, choices=["simple", "detailed"], default="simple", help="Output format")
+def check(email: str, account_id: str, provider: str = "mailtm", output: str = "simple"):
+    """
+    Check messages for an existing temporary email account
+
+    Retrieves and displays messages for an existing temporary email account.
+    Requires the email address and account ID.
+    """
+    mail = cast(TempMailProvider, get_provider(provider_name=provider))
+    mail.email = email
+    mail.account_id = account_id
+
+    # Try to get token if needed
+    if hasattr(mail, 'get_token'):
+        mail.get_token()
+
+    console.print(f"[cyan]Checking messages for: {email}[/cyan]")
+
+    try:
+        messages = mail.get_messages()
+
+        if not messages:
+            console.print("[yellow]No messages found[/yellow]")
+            return
+
+        console.print(f"Found {len(messages)} messages:")
+        console.print("-" * 40)
+
+        for msg in messages:
+            console.print(f"From: {msg['from']}")
+            console.print(f"Subject: {msg['subject']}")
+
+            if output == "detailed":
+                console.print(f"Body: {msg['body']}")
+                console.print(f"Has attachments: {msg['hasAttachments']}")
+                console.print(f"Created at: {msg['createdAt']}")
+
+            console.print("[magenta]" + "-" * 40 + "[/magenta]")
+
+    except Exception as e:
+        console.print(f"[red]Error checking messages: {str(e)}[/red]")
+
+@app.command()
+@option("--email", "-e", type=str, required=True, help="Email address to delete")
+@option("--account-id", "-a", type=str, required=True, help="Account ID for the email")
+@option("--provider", "-p", type=str, choices=["mailtm", "tempmailio"], default="mailtm", help="Email provider to use")
+def delete(email: str, account_id: str, provider: str = "mailtm"):
+    """
+    Delete an existing temporary email account
+
+    Deletes a temporary email account using the provided email address and account ID.
+    """
+    mail = cast(TempMailProvider, get_provider(provider_name=provider))
+    mail.email = email
+    mail.account_id = account_id
+
+    # Try to get token if needed
+    if hasattr(mail, 'get_token'):
+        mail.get_token()
+
+    console.print(f"[yellow]Deleting account: {email}[/yellow]")
+
+    try:
+        success = mail.delete_account()
+        if success:
+            console.print("[green]Account successfully deleted[/green]")
+        else:
+            console.print("[red]Failed to delete account[/red]")
+    except Exception as e:
+        console.print(f"[red]Error deleting account: {str(e)}[/red]")
+
+def main():
+    """Main CLI function for tempmail"""
+    try:
+        app.run()
+    except Exception as e:
+        console.print(f"[red]Error: {str(e)}[/red]")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

webscout/Extra/tempmail/emailnator.py

@@ -1,84 +1,88 @@
-"""
-Emailnator Provider Implementation
-Synchronous provider for Emailnator.com
-"""
-
-from typing import List, Dict
-from time import sleep
-from requests import Session
-from webscout.litagent import LitAgent
-from .base import TempMailProvider
-from json import loads
-from re import findall
-
-class EmailnatorProvider(TempMailProvider):
-    def __init__(self):
-        self.client = Session()
-        self.client.get("https://www.emailnator.com/", timeout=6)
-        self.cookies = self.client.cookies.get_dict()
-        self.user_agent = LitAgent()
-        self.client.headers = {
-            "authority": "www.emailnator.com",
-            "origin": "https://www.emailnator.com",
-            "referer": "https://www.emailnator.com/",
-            "user-agent": self.user_agent.random(),
-            "x-xsrf-token": self.client.cookies.get("XSRF-TOKEN")[:-3] + "=",
-        }
-        self.email = None
-        self._messages = []
-        self._account_deleted = False
-
-    def create_account(self) -> bool:
-        response = self.client.post(
-            "https://www.emailnator.com/generate-email",
-            json={"email": ["plusGmail", "dotGmail"]},
-        )
-        self.email = loads(response.text)["email"][0]
-        return bool(self.email)
-
-    def get_messages(self) -> List[Dict]:
-        # Wait for at least one message
-        for _ in range(30):  # Wait up to 60 seconds
-            sleep(2)
-            mail_token = self.client.post(
-                "https://www.emailnator.com/message-list", json={"email": self.email}
-            )
-            mail_token = loads(mail_token.text)["messageData"]
-            if len(mail_token) > 1:
-                break
-        else:
-            return []
-        # Get message details
-        messages = []
-        for msg in mail_token[1:]:
-            msg_id = msg["messageID"]
-            mail_context = self.client.post(
-                "https://www.emailnator.com/message-list",
-                json={"email": self.email, "messageID": msg_id},
-            )
-            # The response is HTML, so we just store it as body
-            messages.append({
-                "msg_id": msg_id,
-                "from": msg.get("from", ""),
-                "subject": msg.get("subject", ""),
-                "body": mail_context.text,
-            })
-        self._messages = messages
-        return messages
-
-    def check_new_messages(self) -> List[Dict]:
-        current = self.get_messages()
-        if not self._messages:
-            return current
-        # Return only new messages
-        old_ids = {m["msg_id"] for m in self._messages}
-        new_msgs = [m for m in current if m["msg_id"] not in old_ids]
-        return new_msgs
-
-    def delete_account(self) -> bool:
-        # Emailnator does not support explicit account deletion, so just mark as deleted
-        self._account_deleted = True
-        return True
-
-    def get_account_info(self) -> Dict:
-        return {"email": self.email, "deleted": self._account_deleted}
+"""
+Emailnator Provider Implementation
+Synchronous provider for Emailnator.com
+"""
+
+from json import loads
+from time import sleep
+from typing import Dict, List, Optional
+
+from requests import Session
+
+from webscout.litagent import LitAgent
+
+from .base import TempMailProvider
+
+
+class EmailnatorProvider(TempMailProvider):
+    def __init__(self):
+        self.client = Session()
+        self.client.get("https://www.emailnator.com/", timeout=6)
+        self.cookies = self.client.cookies.get_dict()
+        self.user_agent = LitAgent()
+        xsrf_token = self.client.cookies.get("XSRF-TOKEN")
+        self.client.headers = {
+            "authority": "www.emailnator.com",
+            "origin": "https://www.emailnator.com",
+            "referer": "https://www.emailnator.com/",
+            "user-agent": self.user_agent.random(),
+            "x-xsrf-token": (xsrf_token[:-3] + "=") if xsrf_token else "",
+        }
+        self.email = None
+        self._messages = []
+        self._account_deleted = False
+
+    def create_account(self) -> bool:
+        response = self.client.post(
+            "https://www.emailnator.com/generate-email",
+            json={"email": ["plusGmail", "dotGmail"]},
+        )
+        self.email = loads(response.text)["email"][0]
+        return bool(self.email)
+
+    def get_messages(self) -> List[Dict]:
+        # Wait for at least one message
+        for _ in range(30):  # Wait up to 60 seconds
+            sleep(2)
+            mail_token = self.client.post(
+                "https://www.emailnator.com/message-list", json={"email": self.email}
+            )
+            mail_token = loads(mail_token.text)["messageData"]
+            if len(mail_token) > 1:
+                break
+        else:
+            return []
+        # Get message details
+        messages = []
+        for msg in mail_token[1:]:
+            msg_id = msg["messageID"]
+            mail_context = self.client.post(
+                "https://www.emailnator.com/message-list",
+                json={"email": self.email, "messageID": msg_id},
+            )
+            # The response is HTML, so we just store it as body
+            messages.append({
+                "msg_id": msg_id,
+                "from": msg.get("from", ""),
+                "subject": msg.get("subject", ""),
+                "body": mail_context.text,
+            })
+        self._messages = messages
+        return messages
+
+    def check_new_messages(self) -> List[Dict]:
+        current = self.get_messages()
+        if not self._messages:
+            return current
+        # Return only new messages
+        old_ids = {m["msg_id"] for m in self._messages}
+        new_msgs = [m for m in current if m["msg_id"] not in old_ids]
+        return new_msgs
+
+    def delete_account(self) -> bool:
+        # Emailnator does not support explicit account deletion, so just mark as deleted
+        self._account_deleted = True
+        return True
+
+    def get_account_info(self) -> Dict:
+        return {"email": self.email, "deleted": self._account_deleted}