import poplib

# 連線到 POP3 伺服器（SSL）
server = poplib.POP3_SSL('pop.gmail.com', 995)

# 或使用明文連線（不建議）
# server = poplib.POP3('pop.example.com', 110)

# 登入
server.user('alice@gmail.com')
server.pass_('password')

# 取得郵件統計
num_messages = len(server.list()[1])
print(f'共有 {num_messages} 封郵件')

# 登出
server.quit()

import poplib
from email import parser

# 連線並登入
server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 取得郵件數量
num_messages = len(server.list()[1])
print(f'共有 {num_messages} 封郵件')

# 下載所有郵件
for i in range(num_messages):
    # 下載郵件（1-indexed）
    raw_email = b"\n".join(server.retr(i+1)[1])

    # 解析郵件
    email_message = parser.Parser().parsestr(raw_email.decode('utf-8'))

    # 顯示基本資訊
    print(f"\n郵件 #{i+1}")
    print(f"From: {email_message['From']}")
    print(f"To: {email_message['To']}")
    print(f"Subject: {email_message['Subject']}")
    print(f"Date: {email_message['Date']}")

    # 取得內容
    if email_message.is_multipart():
        for part in email_message.walk():
            content_type = part.get_content_type()
            if content_type == 'text/plain':
                body = part.get_payload(decode=True).decode('utf-8', errors='ignore')
                print(f"Content:\n{body[:200]}...")  # 只顯示前 200 字元
    else:
        body = email_message.get_payload(decode=True)
        if body:
            print(f"Content:\n{body.decode('utf-8', errors='ignore')[:200]}...")

    print('-' * 60)

# 關閉連線
server.quit()

import poplib
from email import parser

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 先列出所有郵件
resp, mails, octets = server.list()
print(f"郵件清單：")
for mail in mails:
    print(mail.decode())  # 格式：編號 大小

# 下載第 1 封郵件
resp, lines, octets = server.retr(1)

# 合併郵件內容
raw_email = b"\n".join(lines)
email_message = parser.Parser().parsestr(raw_email.decode('utf-8'))

print(f"Subject: {email_message['Subject']}")
print(f"From: {email_message['From']}")

server.quit()

import poplib

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 使用 TOP 命令：取得郵件前 0 行（只有標頭）
resp, lines, octets = server.top(1, 0)

# 解析標頭
raw_header = b"\n".join(lines).decode('utf-8')
print(raw_header)

server.quit()

import poplib
from email import parser
import os

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 下載第 1 封郵件
raw_email = b"\n".join(server.retr(1)[1])
email_message = parser.Parser().parsestr(raw_email.decode('utf-8'))

# 處理附件
if email_message.is_multipart():
    for part in email_message.walk():
        # 取得 Content-Disposition
        content_disposition = str(part.get('Content-Disposition'))

        # 檢查是否為附件
        if 'attachment' in content_disposition:
            filename = part.get_filename()
            if filename:
                # 解碼檔名
                if filename:
                    print(f"發現附件：{filename}")

                    # 儲存附件
                    filepath = os.path.join('attachments', filename)
                    os.makedirs('attachments', exist_ok=True)

                    with open(filepath, 'wb') as f:
                        f.write(part.get_payload(decode=True))

                    print(f"已儲存到：{filepath}")

server.quit()

import poplib
import json
import os

# 儲存已下載郵件的 UID
UIDL_FILE = 'downloaded_uids.json'

def load_downloaded_uids():
    """載入已下載的 UID"""
    if os.path.exists(UIDL_FILE):
        with open(UIDL_FILE, 'r') as f:
            return set(json.load(f))
    return set()

def save_downloaded_uids(uids):
    """儲存已下載的 UID"""
    with open(UIDL_FILE, 'w') as f:
        json.dump(list(uids), f)

# 連線
server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 載入已下載的 UID
downloaded_uids = load_downloaded_uids()

# 取得伺服器上所有郵件的 UIDL
resp, uidl_list, octets = server.uidl()

new_count = 0

for uidl_line in uidl_list:
    # 格式：編號 UID
    msg_num, uid = uidl_line.decode().split()
    msg_num = int(msg_num)

    # 檢查是否已下載
    if uid not in downloaded_uids:
        print(f"下載新郵件 #{msg_num} (UID: {uid})")

        # 下載郵件
        raw_email = b"\n".join(server.retr(msg_num)[1])

        # ... 處理郵件 ...

        # 標記為已下載
        downloaded_uids.add(uid)
        new_count += 1

        # 不刪除郵件（POP3 預設會刪除，這裡不呼叫 DELE）

print(f"下載了 {new_count} 封新郵件")

# 儲存 UID 清單
save_downloaded_uids(downloaded_uids)

server.quit()

# 1. 第一次執行
server.uidl()
# 回應：
# 1 AAA111
# 2 BBB222
# 3 CCC333

# 下載並記錄：['AAA111', 'BBB222', 'CCC333']

# 2. 第二次執行（收到新郵件）
server.uidl()
# 回應：
# 1 AAA111  ← 已下載
# 2 BBB222  ← 已下載
# 3 CCC333  ← 已下載
# 4 DDD444  ← 新郵件！

# 只下載 UID = DDD444 的郵件

import poplib
import json

# 載入已下載的 UID
def load_uids():
    try:
        with open('uids.json', 'r') as f:
            return set(json.load(f))
    except:
        return set()

# 儲存 UID
def save_uids(uids):
    with open('uids.json', 'w') as f:
        json.dump(list(uids), f)

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('user@gmail.com')
server.pass_('password')

downloaded = load_uids()

# 取得所有郵件的 UID
resp, uidl_list, octets = server.uidl()

for line in uidl_list:
    num, uid = line.decode().split()

    if uid not in downloaded:
        # 下載新郵件
        raw_email = server.retr(int(num))[1]
        # ... 處理郵件 ...

        # 記錄 UID
        downloaded.add(uid)

save_uids(downloaded)
server.quit()

# ❌ 會刪除郵件
server.retr(1)  # 下載
server.dele(1)  # 刪除
server.quit()   # 確認刪除

# ✅ 保留郵件
server.retr(1)  # 只下載
# 不呼叫 dele()
server.quit()   # 郵件保留在伺服器

import poplib

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 下載所有郵件
num_messages = len(server.list()[1])

for i in range(1, num_messages + 1):
    # 只下載，不刪除
    raw_email = server.retr(i)[1]

    # ... 處理郵件 ...

    # 注意：不呼叫 server.dele(i)

# 郵件保留在伺服器
server.quit()

# 使用 UIDL 記錄已下載的郵件
# 下次只下載新郵件
# 郵件保留在伺服器
# 不會重複處理

import poplib

server = poplib.POP3_SSL('pop.gmail.com', 995)
server.user('alice@gmail.com')
server.pass_('password')

# 取得郵件列表（包含大小）
resp, mails, octets = server.list()

MAX_SIZE = 5 * 1024 * 1024  # 5 MB

for mail in mails:
    num, size = mail.decode().split()
    num = int(num)
    size = int(size)

    if size > MAX_SIZE:
        print(f"郵件 #{num} 太大 ({size} bytes)，跳過")
        continue

    # 下載郵件
    raw_email = server.retr(num)[1]
    # ... 處理 ...

server.quit()

# 使用 TOP 只下載標頭
resp, lines, octets = server.top(1, 0)  # 只取標頭（0 行內容）

# 檢查標頭
from email import parser
header = parser.Parser().parsestr(b"\n".join(lines).decode())

# 檢查主旨
if '重要' in header['Subject']:
    # 下載完整郵件
    raw_email = server.retr(1)[1]
else:
    print("不重要的郵件，跳過")

# POP3 不支援分塊下載
# 如果需要下載大型郵件，建議：
# 1. 使用 IMAP（支援部分下載）
# 2. 增加超時時間
# 3. 使用專業郵件客戶端

import socket
socket.setdefaulttimeout(300)  # 5 分鐘超時

server = poplib.POP3_SSL('pop.gmail.com', 995)
# ... 下載大型郵件 ...