إرسال بريد إلكتروني باستخدام Python يمكن أن يبدأ من قائمة CSV صغيرة تخص أشخاصًا يتوقعون رسالتك. يقرأ المثال العناوين ويتحقق من شكلها ويزيل التكرار المطابق، ثم يتوقف في وضع المعاينة دون تسجيل دخول أو إرسال. لا يبدأ الاتصال بـSMTP إلا عند إضافة –send صراحة. هذا الفصل يجعل تجربة قراءة الملف مستقلة عن حساب البريد، ويمنع إرسال رسائل حقيقية لمجرد تشغيل مثال تعليمي لأول مرة.
أوامر التجهيز والتشغيل
python mail_csv.py emails.csv
# Actual sending only after checking your account and recipient list:
# python mail_csv.py emails.csv --sendتجهيز CSV والرسالة وبيانات الحساب
أنشئ emails.csv بعمود اسمه email، مثل email في السطر الأول ثم user1@example.com وuser2@example.com في سطرين منفصلين. استخدم عناوين تجريبية في المعاينة، واستبدلها بقائمتك المصرح بها قبل الإرسال الحقيقي. ضع محتوى الرسالة في message.txt بترميز UTF-8. يحتاج الإرسال متغيري البيئة SMTP_USER وSMTP_HOST وإعدادات مزود يدعم SMTP_SSL على المنفذ 465. لا تستخدم هذا الاتصال مع منفذ يتطلب STARTTLS دون تعديل مناسب.
لماذا نستخدم DictReader وwith؟
تعتمد DictReader اسم العمود بدل موضعه، فتستطيع إضافة name لاحقًا دون أن يصبح الاسم هو عنوان المستلم. يبقى المرور على الصفوف داخل with، لأن القارئ يعتمد على ملف مفتوح. يتعامل الكود مع UTF-8 BOM والصفوف الفارغة، ويرفض عنوانًا يحاول إضافة مستلم ثان أو محرف سطر جديد. الفحص نحوي فقط؛ لا يثبت أن صندوق البريد موجود أو أن الرسالة ستصل إليه. لا تُحذف عناوين غير صالحة بصمت: أصلح الملف ثم أعد المعاينة.
الكود: mail_csv.py
import argparse
import csv
import getpass
import os
import smtplib
import ssl
import time
from email.headerregistry import Address
from email.message import EmailMessage
from pathlib import Path
def validated_address(value):
value = value.strip()
if not value or any(c in value for c in "\r\n,;"):
raise ValueError("Use exactly one email address per row")
address = Address(addr_spec=value)
if not address.username or not address.domain:
raise ValueError("Missing email username or domain")
return address.addr_spec
def read_recipients(path):
recipients, seen = [], set()
with Path(path).open(newline="", encoding="utf-8-sig") as source:
reader = csv.DictReader(source)
if not reader.fieldnames or "email" not in reader.fieldnames:
raise ValueError("CSV must have an email column")
for row in reader:
value = (row.get("email") or "").strip()
if not value:
continue
email = validated_address(value)
if email not in seen:
seen.add(email)
recipients.append(email)
return recipients
def make_message(sender, recipient, subject, body):
message = EmailMessage()
message["From"] = validated_address(sender)
message["To"] = validated_address(recipient)
message["Subject"] = subject
message.set_content(body)
return message
def send_batch(recipients, sender, password, subject, body, host, port=465):
accepted = 0
with smtplib.SMTP_SSL(host, port, context=ssl.create_default_context(), timeout=20) as server:
server.login(sender, password)
for recipient in recipients:
message = make_message(sender, recipient, subject, body)
server.send_message(message)
accepted += 1
print("SMTP accepted message:", accepted)
time.sleep(1)
return accepted
if __name__ == "__main__":
parser = argparse.ArgumentParser()
parser.add_argument("csv_path")
parser.add_argument("--send", action="store_true")
args = parser.parse_args()
recipients = read_recipients(args.csv_path)
if not recipients:
raise SystemExit("No recipients")
print("Validated unique recipients:", len(recipients))
if not args.send:
raise SystemExit("Preview only: no login and no messages sent")
if len(recipients) > 20:
raise SystemExit("Demo limit is 20; review provider limits before designing larger batches")
sender = os.environ["SMTP_USER"]
host = os.environ["SMTP_HOST"]
password = getpass.getpass("SMTP app password or provider credential: ")
subject = input("Subject: ")
body = Path("message.txt").read_text(encoding="utf-8")
print("Accepted by SMTP:", send_batch(recipients, sender, password, subject, body, host))
رسالة منفصلة لكل مستلم
تنشئ make_message كائن EmailMessage جديدًا في كل مرة وتضع مستلمًا واحدًا في To. بذلك لا تكشف قائمة الآخرين كما يحدث عند جمع كل العناوين في الرأس نفسه. ينسق set_content جسم الرسالة النصي، وتضيف المكتبة الترميز المناسب. اسم المرسل يجب أن يطابق ما يسمح به مزود البريد؛ نجاح إدخال عنوان في From لا يمنح صلاحية الإرسال باسمه. لا تضع مرفقات أو HTML قبل نجاح المسار النصي البسيط.
كلمة المرور وTLS وحدود المزود
تطلب getpass بيانات المصادقة دون إظهارها أثناء الكتابة، ولا تحفظها في السكربت أو CSV. قد تحتاج كلمة مرور تطبيق أو OAuth حسب المزود وسياسات الحساب، فلا تفترض أن كلمة مرور تسجيل الدخول العادية ستعمل. يستخدم الاتصال سياق TLS افتراضيًا يتحقق من الشهادة مع مهلة زمنية. حد العشرين مستلمًا قيد تعليمي في البرنامج، وليس وعدًا بحدود أي خدمة. الفاصل ثانية واحدة لا يلغي حصص الإرسال أو متطلبات مكافحة الرسائل المزعجة.
الأخطاء وتفسير قبول SMTP
إذا رفض الخادم مستلمًا أو فشلت المصادقة، قد يتوقف البرنامج بعد إرسال بعض الرسائل. سجّل ما قبله الخادم قبل إعادة المحاولة كي لا تعيد إرسال الدفعة كلها عشوائيًا. طباعة SMTP accepted تعني أن الخادم قبل الرسالة في تلك المرحلة، ولا تضمن ظهورها في صندوق الوارد؛ قد ترتد أو تُصنف لاحقًا. راجع العناوين والسجلات وسياسات المزود عند حدوث مشكلة، ولا تعطل التحقق من الشهادة لتجاوز خطأ اتصال.
كيف تختبر قبل الاستخدام الحقيقي؟
ابدأ بملف فارغ وبملف لا يحتوي email ثم بعنوان مكرر وآخر غير صالح، وتأكد أن المعاينة لا تفتح اتصالًا. بعد ذلك استخدم حساب اختبار ومستلمًا تملكه ورسالة قصيرة عند رغبتك في تجربة فعلية. اختبارات الكود المعروضة هنا تستخدم خادمًا وهميًا ولا ترسل رسائل. للتطبيق الأكبر تحتاج سجل نتائج دائمًا وإدارة إعادة المحاولة وإلغاء الاشتراك حسب طبيعة التواصل؛ هذا المثال أساس لتعلم CSV وSMTP، لا نظام حملات بريدية جاهزًا.






