Create app.py

app.py

@@ -0,0 +1,659 @@
+#!/usr/bin/env python3
+"""
+Gradio Email Client App - Web interface for email fetching and management
+Supports IMAP and POP3 protocols with secure authentication
+"""
+
+import gradio as gr
+import imaplib
+import poplib
+import email
+from email.header import decode_header
+from email.utils import parsedate_to_datetime
+import json
+import logging
+from datetime import datetime
+import pandas as pd
+from typing import List, Dict, Tuple, Optional
+import re
+
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("gradio-email-app")
+
+class EmailClient:
+    """Email client supporting both IMAP and POP3"""
+    
+    def __init__(self):
+        self.imap_conn = None
+        self.pop_conn = None
+        self.protocol = None
+        self.connected_email = None
+        
+    def connect_imap(self, server: str, port: int, email_addr: str, password: str, use_ssl: bool = True):
+        """Connect to IMAP server"""
+        try:
+            if use_ssl:
+                self.imap_conn = imaplib.IMAP4_SSL(server, port)
+            else:
+                self.imap_conn = imaplib.IMAP4(server, port)
+                
+            self.imap_conn.login(email_addr, password)
+            self.protocol = "IMAP"
+            self.connected_email = email_addr
+            logger.info(f"Connected to IMAP server: {server}")
+            return True, f"✅ Connected to IMAP server: {server}"
+        except Exception as e:
+            logger.error(f"IMAP connection failed: {e}")
+            return False, f"❌ IMAP connection failed: {str(e)}"
+    
+    def connect_pop3(self, server: str, port: int, email_addr: str, password: str, use_ssl: bool = True):
+        """Connect to POP3 server"""
+        try:
+            if use_ssl:
+                self.pop_conn = poplib.POP3_SSL(server, port)
+            else:
+                self.pop_conn = poplib.POP3(server, port)
+                
+            self.pop_conn.user(email_addr)
+            self.pop_conn.pass_(password)
+            self.protocol = "POP3"
+            self.connected_email = email_addr
+            logger.info(f"Connected to POP3 server: {server}")
+            return True, f"✅ Connected to POP3 server: {server}"
+        except Exception as e:
+            logger.error(f"POP3 connection failed: {e}")
+            return False, f"❌ POP3 connection failed: {str(e)}"
+    
+    def get_folders(self) -> Tuple[List[str], str]:
+        """Get available folders (IMAP only)"""
+        if self.protocol != "IMAP" or not self.imap_conn:
+            return [], "❌ Folders are only available with IMAP connections"
+            
+        try:
+            status, folders = self.imap_conn.list()
+            folder_list = []
+            for folder in folders:
+                # Parse folder name from IMAP response
+                parts = folder.decode().split('"')
+                if len(parts) >= 3:
+                    folder_name = parts[-2]
+                    folder_list.append(folder_name)
+            return folder_list, f"✅ Found {len(folder_list)} folders"
+        except Exception as e:
+            logger.error(f"Failed to get folders: {e}")
+            return [], f"❌ Failed to get folders: {str(e)}"
+    
+    def fetch_emails(self, folder: str = "INBOX", limit: int = 10, search_criteria: str = "ALL") -> Tuple[List[Dict], str]:
+        """Fetch emails from specified folder"""
+        if self.protocol == "IMAP":
+            return self._fetch_emails_imap(folder, limit, search_criteria)
+        elif self.protocol == "POP3":
+            return self._fetch_emails_pop3(limit)
+        else:
+            return [], "❌ Not connected to any email server"
+    
+    def _fetch_emails_imap(self, folder: str, limit: int, search_criteria: str) -> Tuple[List[Dict], str]:
+        """Fetch emails using IMAP"""
+        if not self.imap_conn:
+            return [], "❌ No IMAP connection"
+            
+        try:
+            self.imap_conn.select(folder)
+            status, messages = self.imap_conn.search(None, search_criteria)
+            
+            if status != 'OK':
+                return [], f"❌ Search failed in folder {folder}"
+                
+            email_ids = messages[0].split()
+            email_ids = email_ids[-limit:] if len(email_ids) > limit else email_ids
+            
+            emails = []
+            for email_id in reversed(email_ids):
+                try:
+                    status, msg_data = self.imap_conn.fetch(email_id, '(RFC822)')
+                    if status == 'OK':
+                        email_body = msg_data[0][1]
+                        email_message = email.message_from_bytes(email_body)
+                        parsed_email = self._parse_email(email_message)
+                        parsed_email['id'] = email_id.decode()
+                        emails.append(parsed_email)
+                except Exception as e:
+                    logger.error(f"Failed to fetch email {email_id}: {e}")
+                    continue
+                    
+            return emails, f"✅ Fetched {len(emails)} emails from {folder}"
+        except Exception as e:
+            logger.error(f"IMAP fetch failed: {e}")
+            return [], f"❌ IMAP fetch failed: {str(e)}"
+    
+    def _fetch_emails_pop3(self, limit: int) -> Tuple[List[Dict], str]:
+        """Fetch emails using POP3"""
+        if not self.pop_conn:
+            return [], "❌ No POP3 connection"
+            
+        try:
+            num_messages = len(self.pop_conn.list()[1])
+            start_index = max(1, num_messages - limit + 1)
+            
+            emails = []
+            for i in range(start_index, num_messages + 1):
+                try:
+                    raw_email = b'\n'.join(self.pop_conn.retr(i)[1])
+                    email_message = email.message_from_bytes(raw_email)
+                    parsed_email = self._parse_email(email_message)
+                    parsed_email['id'] = str(i)
+                    emails.append(parsed_email)
+                except Exception as e:
+                    logger.error(f"Failed to fetch email {i}: {e}")
+                    continue
+                    
+            return list(reversed(emails)), f"✅ Fetched {len(emails)} emails"
+        except Exception as e:
+            logger.error(f"POP3 fetch failed: {e}")
+            return [], f"❌ POP3 fetch failed: {str(e)}"
+    
+    def _parse_email(self, email_message) -> Dict:
+        """Parse email message into dictionary"""
+        def decode_mime_words(s):
+            if s is None:
+                return ""
+            decoded_parts = decode_header(s)
+            decoded_string = ""
+            for part, encoding in decoded_parts:
+                if isinstance(part, bytes):
+                    if encoding:
+                        decoded_string += part.decode(encoding)
+                    else:
+                        decoded_string += part.decode('utf-8', errors='ignore')
+                else:
+                    decoded_string += part
+            return decoded_string
+        
+        # Extract basic headers
+        subject = decode_mime_words(email_message.get('Subject', ''))
+        from_addr = decode_mime_words(email_message.get('From', ''))
+        to_addr = decode_mime_words(email_message.get('To', ''))
+        date_str = email_message.get('Date', '')
+        
+        # Parse date
+        try:
+            date_obj = parsedate_to_datetime(date_str)
+            formatted_date = date_obj.strftime("%Y-%m-%d %H:%M:%S")
+        except:
+            formatted_date = date_str
+        
+        # Extract body
+        body = self._extract_body(email_message)
+        
+        # Extract attachments info
+        attachments = self._extract_attachments_info(email_message)
+        
+        return {
+            'subject': subject,
+            'from': from_addr,
+            'to': to_addr,
+            'date': formatted_date,
+            'body_text': body.get('text', ''),
+            'body_html': body.get('html', ''),
+            'attachments': attachments,
+            'attachment_count': len(attachments)
+        }
+    
+    def _extract_body(self, email_message) -> Dict[str, str]:
+        """Extract email body (text and HTML)"""
+        body = {'text': '', 'html': ''}
+        
+        if email_message.is_multipart():
+            for part in email_message.walk():
+                content_type = part.get_content_type()
+                content_disposition = str(part.get('Content-Disposition', ''))
+                
+                if 'attachment' not in content_disposition:
+                    if content_type == 'text/plain':
+                        try:
+                            body['text'] = part.get_payload(decode=True).decode('utf-8', errors='ignore')
+                        except:
+                            body['text'] = str(part.get_payload())
+                    elif content_type == 'text/html':
+                        try:
+                            body['html'] = part.get_payload(decode=True).decode('utf-8', errors='ignore')
+                        except:
+                            body['html'] = str(part.get_payload())
+        else:
+            content_type = email_message.get_content_type()
+            try:
+                payload = email_message.get_payload(decode=True).decode('utf-8', errors='ignore')
+            except:
+                payload = str(email_message.get_payload())
+                
+            if content_type == 'text/plain':
+                body['text'] = payload
+            elif content_type == 'text/html':
+                body['html'] = payload
+            else:
+                body['text'] = payload
+        
+        return body
+    
+    def _extract_attachments_info(self, email_message) -> List[str]:
+        """Extract attachment information"""
+        attachments = []
+        
+        if email_message.is_multipart():
+            for part in email_message.walk():
+                content_disposition = str(part.get('Content-Disposition', ''))
+                if 'attachment' in content_disposition:
+                    filename = part.get_filename()
+                    if filename:
+                        filename = decode_header(filename)[0][0]
+                        if isinstance(filename, bytes):
+                            filename = filename.decode('utf-8', errors='ignore')
+                        attachments.append(filename)
+        
+        return attachments
+    
+    def disconnect(self):
+        """Disconnect from email server"""
+        try:
+            if self.imap_conn:
+                self.imap_conn.close()
+                self.imap_conn.logout()
+                self.imap_conn = None
+            if self.pop_conn:
+                self.pop_conn.quit()
+                self.pop_conn = None
+            self.protocol = None
+            self.connected_email = None
+            logger.info("Disconnected from email server")
+            return "✅ Disconnected from email server"
+        except Exception as e:
+            logger.error(f"Disconnect error: {e}")
+            return f"❌ Disconnect error: {str(e)}"
+
+# Global email client instance
+email_client = EmailClient()
+
+# Email server configurations
+EMAIL_SERVERS = {
+    'Gmail': {
+        'imap': {'server': 'imap.gmail.com', 'port': 993},
+        'pop3': {'server': 'pop.gmail.com', 'port': 995}
+    },
+    'Outlook/Hotmail': {
+        'imap': {'server': 'outlook.office365.com', 'port': 993},
+        'pop3': {'server': 'outlook.office365.com', 'port': 995}
+    },
+    'Yahoo': {
+        'imap': {'server': 'imap.mail.yahoo.com', 'port': 993},
+        'pop3': {'server': 'pop.mail.yahoo.com', 'port': 995}
+    },
+    'iCloud': {
+        'imap': {'server': 'imap.mail.me.com', 'port': 993},
+        'pop3': {'server': 'pop.mail.me.com', 'port': 995}
+    }
+}
+
+def connect_to_email(email_addr, password, provider, protocol, custom_server="", custom_port=993):
+    """Connect to email server"""
+    if not email_addr or not password:
+        return "❌ Email and password are required", "", []
+    
+    # Get server configuration
+    if provider == "Custom":
+        if not custom_server:
+            return "❌ Custom server address is required", "", []
+        server_addr = custom_server
+        port = custom_port
+    else:
+        if provider not in EMAIL_SERVERS:
+            return f"❌ Unsupported provider: {provider}", "", []
+        
+        server_config = EMAIL_SERVERS[provider][protocol.lower()]
+        server_addr = server_config["server"]
+        port = server_config["port"]
+    
+    # Connect to email server
+    if protocol.lower() == "imap":
+        success, message = email_client.connect_imap(server_addr, port, email_addr, password)
+    else:
+        success, message = email_client.connect_pop3(server_addr, port, email_addr, password)
+    
+    if success:
+        # Get folders if IMAP
+        if protocol.lower() == "imap":
+            folders, _ = email_client.get_folders()
+            return message, f"Connected as: {email_addr}", gr.update(choices=folders, value="INBOX")
+        else:
+            return message, f"Connected as: {email_addr}", gr.update(choices=["INBOX"], value="INBOX")
+    else:
+        return message, "", []
+
+def fetch_emails_ui(folder, limit, search_criteria):
+    """Fetch emails and return as DataFrame"""
+    if not email_client.protocol:
+        return None, "❌ Not connected to email server"
+    
+    emails, message = email_client.fetch_emails(folder, limit, search_criteria)
+    
+    if not emails:
+        return None, message
+    
+    # Convert to DataFrame for better display
+    df_data = []
+    for email_data in emails:
+        df_data.append({
+            'Subject': email_data['subject'][:50] + "..." if len(email_data['subject']) > 50 else email_data['subject'],
+            'From': email_data['from'],
+            'Date': email_data['date'],
+            'Attachments': email_data['attachment_count'],
+            'Preview': (email_data['body_text'][:100] + "...") if email_data['body_text'] else "No text content"
+        })
+    
+    df = pd.DataFrame(df_data)
+    return df, message
+
+def search_emails_ui(query, folder, limit):
+    """Search emails with query"""
+    if not email_client.protocol:
+        return None, "❌ Not connected to email server"
+    
+    if not query.strip():
+        return None, "❌ Search query is required"
+    
+    # Create search criteria
+    if email_client.protocol == "IMAP":
+        search_criteria = f'(OR (SUBJECT "{query}") (FROM "{query}") (BODY "{query}"))'
+    else:
+        search_criteria = "ALL"  # POP3 doesn't support server-side search
+    
+    emails, message = email_client.fetch_emails(folder, limit, search_criteria)
+    
+    if not emails:
+        return None, message
+    
+    # Additional client-side filtering for POP3 or better results
+    filtered_emails = []
+    query_lower = query.lower()
+    for email_data in emails:
+        if (query_lower in email_data.get('subject', '').lower() or 
+            query_lower in email_data.get('from', '').lower() or 
+            query_lower in email_data.get('body_text', '').lower()):
+            filtered_emails.append(email_data)
+    
+    if not filtered_emails:
+        return None, f"❌ No emails found matching query: {query}"
+    
+    # Convert to DataFrame
+    df_data = []
+    for email_data in filtered_emails:
+        df_data.append({
+            'Subject': email_data['subject'][:50] + "..." if len(email_data['subject']) > 50 else email_data['subject'],
+            'From': email_data['from'],
+            'Date': email_data['date'],
+            'Attachments': email_data['attachment_count'],
+            'Preview': (email_data['body_text'][:100] + "...") if email_data['body_text'] else "No text content"
+        })
+    
+    df = pd.DataFrame(df_data)
+    return df, f"✅ Found {len(filtered_emails)} emails matching '{query}'"
+
+def disconnect_email():
+    """Disconnect from email server"""
+    message = email_client.disconnect()
+    return message, "", []
+
+def get_connection_status():
+    """Get current connection status"""
+    if email_client.protocol and email_client.connected_email:
+        return f"🟢 Connected to {email_client.connected_email} via {email_client.protocol}"
+    else:
+        return "🔴 Not connected"
+
+def update_custom_server_visibility(provider):
+    """Show/hide custom server fields based on provider selection"""
+    if provider == "Custom":
+        return gr.update(visible=True), gr.update(visible=True)
+    else:
+        return gr.update(visible=False), gr.update(visible=False)
+
+# Create Gradio interface
+with gr.Blocks(title="Email Client", theme=gr.themes.Soft()) as app:
+    gr.Markdown("# 📧 Email Client")
+    gr.Markdown("Connect to your email account and manage your emails with a user-friendly interface.")
+    
+    # Connection status
+    with gr.Row():
+        status_display = gr.Textbox(
+            label="Connection Status",
+            value=get_connection_status(),
+            interactive=False,
+            scale=4
+        )
+        refresh_status_btn = gr.Button("🔄 Refresh Status", scale=1)
+    
+    with gr.Tabs():
+        # Connection Tab
+        with gr.TabItem("🔗 Connect"):
+            gr.Markdown("### Email Connection Settings")
+            
+            with gr.Row():
+                email_input = gr.Textbox(
+                    label="Email Address",
+                    placeholder="[email protected]",
+                    scale=3
+                )
+                password_input = gr.Textbox(
+                    label="Password",
+                    placeholder="Your password or app password",
+                    type="password",
+                    scale=3
+                )
+            
+            with gr.Row():
+                provider_dropdown = gr.Dropdown(
+                    choices=list(EMAIL_SERVERS.keys()) + ["Custom"],
+                    label="Email Provider",
+                    value="Gmail",
+                    scale=2
+                )
+                protocol_dropdown = gr.Dropdown(
+                    choices=["IMAP", "POP3"],
+                    label="Protocol",
+                    value="IMAP",
+                    scale=1
+                )
+            
+            # Custom server fields (initially hidden)
+            with gr.Row():
+                custom_server_input = gr.Textbox(
+                    label="Custom Server",
+                    placeholder="mail.example.com",
+                    visible=False,
+                    scale=3
+                )
+                custom_port_input = gr.Number(
+                    label="Port",
+                    value=993,
+                    visible=False,
+                    scale=1
+                )
+            
+            with gr.Row():
+                connect_btn = gr.Button("🔌 Connect", variant="primary", scale=1)
+                disconnect_btn = gr.Button("❌ Disconnect", scale=1)
+            
+            connection_message = gr.Textbox(
+                label="Connection Message",
+                interactive=False
+            )
+            
+            gr.Markdown("""
+            ### 💡 Connection Tips:
+            - **Gmail**: Use app passwords instead of your regular password
+            - **IMAP**: Recommended for full folder access and search capabilities
+            - **POP3**: Downloads emails to local client, limited folder support
+            """)
+        
+        # Email Management Tab
+        with gr.TabItem("📬 Emails"):
+            with gr.Row():
+                folder_dropdown = gr.Dropdown(
+                    label="Folder",
+                    choices=["INBOX"],
+                    value="INBOX",
+                    scale=2
+                )
+                limit_slider = gr.Slider(
+                    minimum=1,
+                    maximum=100,
+                    value=10,
+                    step=1,
+                    label="Email Limit",
+                    scale=1
+                )
+            
+            with gr.Row():
+                search_criteria_input = gr.Textbox(
+                    label="Search Criteria (IMAP only)",
+                    placeholder="ALL, UNSEEN, FROM [email protected]",
+                    value="ALL",
+                    scale=3
+                )
+                fetch_btn = gr.Button("📥 Fetch Emails", variant="primary", scale=1)
+            
+            fetch_message = gr.Textbox(
+                label="Fetch Status",
+                interactive=False
+            )
+            
+            emails_dataframe = gr.Dataframe(
+                label="Emails",
+                headers=["Subject", "From", "Date", "Attachments", "Preview"],
+                interactive=False
+            )
+        
+        # Search Tab
+        with gr.TabItem("🔍 Search"):
+            with gr.Row():
+                search_query_input = gr.Textbox(
+                    label="Search Query",
+                    placeholder="Enter keywords to search in subject, sender, or body",
+                    scale=3
+                )
+                search_btn = gr.Button("🔍 Search", variant="primary", scale=1)
+            
+            with gr.Row():
+                search_folder_dropdown = gr.Dropdown(
+                    label="Search in Folder",
+                    choices=["INBOX"],
+                    value="INBOX",
+                    scale=2
+                )
+                search_limit_slider = gr.Slider(
+                    minimum=1,
+                    maximum=100,
+                    value=20,
+                    step=1,
+                    label="Max Results",
+                    scale=1
+                )
+            
+            search_message = gr.Textbox(
+                label="Search Status",
+                interactive=False
+            )
+            
+            search_results_dataframe = gr.Dataframe(
+                label="Search Results",
+                headers=["Subject", "From", "Date", "Attachments", "Preview"],
+                interactive=False
+            )
+        
+        # Help Tab
+        with gr.TabItem("❓ Help"):
+            gr.Markdown("""
+            ## How to Use This Email Client
+            
+            ### 1. **Connect to Your Email**
+            - Enter your email address and password
+            - For **Gmail**: You need to use an "App Password" instead of your regular password
+              - Go to your Google Account settings
+              - Enable 2-Step Verification
+              - Generate an App Password for "Mail"
+            - Choose your email provider or use "Custom" for other providers
+            - Select IMAP (recommended) or POP3 protocol
+            
+            ### 2. **Fetch Emails**
+            - Select a folder (INBOX is default)
+            - Set the number of emails to fetch
+            - Use search criteria for IMAP (e.g., "UNSEEN" for unread emails)
+            
+            ### 3. **Search Emails**
+            - Enter keywords to search in subject, sender, or email body
+            - Choose the folder to search in
+            - Set maximum number of results to return
+            
+            ### **Supported Email Providers:**
+            - Gmail (imap.gmail.com, pop.gmail.com)
+            - Outlook/Hotmail (outlook.office365.com)
+            - Yahoo (imap.mail.yahoo.com, pop.mail.yahoo.com)
+            - iCloud (imap.mail.me.com, pop.mail.me.com)
+            - Custom servers
+            
+            ### **Security Notes:**
+            - Your credentials are only used for the current session
+            - Use app-specific passwords when available
+            - All connections use SSL/TLS encryption
+            """)
+    
+    # Event handlers
+    provider_dropdown.change(
+        fn=update_custom_server_visibility,
+        inputs=[provider_dropdown],
+        outputs=[custom_server_input, custom_port_input]
+    )
+    
+    connect_btn.click(
+        fn=connect_to_email,
+        inputs=[email_input, password_input, provider_dropdown, protocol_dropdown, custom_server_input, custom_port_input],
+        outputs=[connection_message, status_display, folder_dropdown]
+    )
+    
+    disconnect_btn.click(
+        fn=disconnect_email,
+        outputs=[connection_message, status_display, folder_dropdown]
+    )
+    
+    refresh_status_btn.click(
+        fn=get_connection_status,
+        outputs=[status_display]
+    )
+    
+    fetch_btn.click(
+        fn=fetch_emails_ui,
+        inputs=[folder_dropdown, limit_slider, search_criteria_input],
+        outputs=[emails_dataframe, fetch_message]
+    )
+    
+    search_btn.click(
+        fn=search_emails_ui,
+        inputs=[search_query_input, search_folder_dropdown, search_limit_slider],
+        outputs=[search_results_dataframe, search_message]
+    )
+    
+    # Update search folder dropdown when main folder dropdown changes
+    folder_dropdown.change(
+        fn=lambda x: gr.update(value=x),
+        inputs=[folder_dropdown],
+        outputs=[search_folder_dropdown]
+    )
+
+# Launch the app
+if __name__ == "__main__":
+    app.launch(
+        server_name="0.0.0.0",
+        server_port=7860,
+        share=True,
+        show_error=True
+    )