16 Eylül 2025Türkçe

Python'ın email paketini kullanarak MIME (Çok Amaçlı İnternet Posta Uzantıları) mesajlarını oluşturma, gönderme ve ayrıştırma hakkında kapsamlı bir kılavuz.

Python E-posta Paketi: MIME Mesajı Oluşturma ve Ayrıştırma

E-posta, dünya çapındaki bireyler ve kuruluşlar için kritik bir iletişim aracı olmaya devam ediyor. Python'ın yerleşik email paketi, özellikle MIME (Çok Amaçlı İnternet Posta Uzantıları) standardını kullanarak karmaşık biçimlendirme ve ekler içeren e-postalar oluşturmak, göndermek ve almak için güçlü yetenekler sağlar. Bu kapsamlı kılavuz, Python'ın email paketini kullanarak MIME mesajı oluşturma ve ayrıştırmayı inceleyerek pratik örnekler ve en iyi uygulamalar sunar.

MIME'yi Anlamak

Koda dalmadan önce, MIME'nin ne olduğunu anlamak önemlidir. MIME, temel e-posta biçimini destekleyecek şekilde genişletir:

ASCII dışındaki karakter kümelerindeki metin.
Ses, video, resim ve uygulama programlarının ekleri.
Birden çok bölüm içeren mesaj gövdeleri.
ASCII dışındaki karakter kümelerindeki başlık alanları.

MIME mesajları hiyerarşik olarak yapılandırılmıştır. En üst düzey mesaj, bir veya daha fazla mesaj bölümünden oluşur. Her bölümün, Content-Type, Content-Disposition ve diğer ilgili bilgileri tanımlayan kendi başlıkları vardır. Content-Type başlığı, bölümün medya türünü belirtir (örneğin, text/plain, text/html, image/jpeg, application/pdf).

Ortamınızı Kurma

Python'ın email paketi standart kitaplığın bir parçasıdır, bu nedenle ayrı olarak yüklemeniz gerekmez. Ancak, e-posta göndermeyi planlıyorsanız büyük olasılıkla smtplib'i yüklemek isteyeceksiniz. Ayrıca, iki faktörlü kimlik doğrulama kullanıyorsanız, e-posta sağlayıcınızı "daha az güvenli uygulamalara" izin verecek veya bir uygulama parolası oluşturacak şekilde yapılandırmanız gerekebilir.

E-posta göndermek için genellikle bir SMTP (Basit Posta Aktarım Protokolü) istemci oturum nesnesi sağlayan smtplib modülünü kullanırsınız.

Basit Bir Metin E-postası Oluşturma

Basit bir metin e-postası oluşturma ve gönderme temel bir örneğiyle başlayalım:

Örnek: Temel Bir Metin E-postası Gönderme

```python import smtplib from email.message import EmailMessage # E-posta yapılandırması gonderen_email = "your_email@example.com" # E-posta adresinizle değiştirin alici_email = "recipient_email@example.com" # Alıcının e-posta adresiyle değiştirin parola = "your_password" # E-posta parolanız veya uygulama parolanız ile değiştirin # E-posta mesajını oluştur msg = EmailMessage() msg['Subject'] = 'Python'dan Merhaba!' msg['From'] = gonderen_email msg['To'] = alici_email msg.set_content('Bu, Python'dan gönderilen düz metin bir e-postadır.') # E-postayı gönder try: with smtplib.SMTP_SSL('smtp.gmail.com', 465) as smtp: smtp.login(gonderen_email, parola) smtp.send_message(msg) print("E-posta başarıyla gönderildi!") except Exception as e: print(f"E-posta gönderme hatası: {e}") ```

Açıklama:

E-posta göndermek için smtplib ve e-posta oluşturmak için EmailMessage olmak üzere gerekli modülleri içe aktarıyoruz.
Gönderenin e-posta adresini, alıcının e-posta adresini ve parolayı (veya uygulama parolasını) tanımlıyoruz. Önemli: Parolalar gibi hassas bilgileri asla kodunuzda sabit kodlamayın. Bunun yerine ortam değişkenlerini veya güvenli yapılandırma dosyalarını kullanın.
Bir EmailMessage nesnesi oluşturuyoruz.
Subject, From ve To başlıklarını ayarlıyoruz.
E-posta gövdesini düz metin olarak ayarlamak için set_content() kullanıyoruz.
SMTP sunucusuna (bu durumda, SSL kullanarak Gmail'in SMTP sunucusu) bağlanıyoruz ve gönderenin kimlik bilgilerini kullanarak oturum açıyoruz.
smtp.send_message(msg) kullanarak e-postayı gönderiyoruz.
Gönderme işlemi sırasında olası istisnaları ele alıyoruz.

Ekleri Olan MIME Mesajları Oluşturma

E-postaları eklerle göndermek için, birden çok bölüm içeren bir MIME mesajı oluşturmamız gerekir. Ana mesajı oluşturmak için MIMEMultipart sınıfını ve ayrı ayrı bölümleri oluşturmak için MIMEText, MIMEImage, MIMEAudio ve MIMEApplication sınıflarını kullanacağız.

Örnek: Bir Metin ve Bir Resim Ekiyle Bir E-posta Gönderme

```python import smtplib from email.message import EmailMessage from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.image import MIMEImage # E-posta yapılandırması gonderen_email = "your_email@example.com" # E-posta adresinizle değiştirin alici_email = "recipient_email@example.com" # Alıcının e-posta adresiyle değiştirin parola = "your_password" # E-posta parolanız veya uygulama parolanız ile değiştirin # Çok parçalı mesajı oluştur msg = MIMEMultipart() msg['Subject'] = 'Metin ve Resim Eki ile E-posta' msg['From'] = gonderen_email msg['To'] = alici_email # Düz metin bölümünü ekle text = MIMEText('Bu, e-postanın düz metin bölümüdür.', 'plain') msg.attach(text) # HTML bölümünü ekle (isteğe bağlı) html = MIMEText('

Bu, e-postanın HTML bölümüdür.

', 'html') msg.attach(html) # Resim ekini ekle with open('image.jpg', 'rb') as img_file: img = MIMEImage(img_file.read(), name='image.jpg') img.add_header('Content-ID', '') # HTML'ye gömmek için gerekli msg.attach(img) # E-postayı gönder try: with smtplib.SMTP_SSL('smtp.gmail.com', 465) as smtp: smtp.login(gonderen_email, parola) smtp.send_message(msg) print("E-posta başarıyla gönderildi!") except Exception as e: print(f"E-posta gönderme hatası: {e}") ```

Açıklama:

MIMEMultipart, MIMEText ve MIMEImage dahil olmak üzere gerekli modülleri içe aktarıyoruz.
E-postanın farklı bölümlerini tutmak için bir MIMEMultipart nesnesi oluşturuyoruz.
Düz metin bölümü için bir MIMEText nesnesi oluşturuyoruz ve ana mesaja ekliyoruz.
HTML bölümü için başka bir MIMEText nesnesi oluşturuyoruz ve ana mesaja ekliyoruz. Resim gömme için kullanılan Content-ID başlığına dikkat edin.
Resim dosyasını ikili okuma modunda ('rb') açıyoruz ve bir MIMEImage nesnesi oluşturuyoruz. Ardından ana mesaja ekliyoruz.
E-postayı daha önce olduğu gibi gönderiyoruz.

Farklı Ek Türlerini İşleme

Uygun MIME sınıfını kullanarak yukarıdaki örneği farklı ek türlerini işlemek için uyarlayabilirsiniz:

MIMEAudio: Ses dosyaları için.
MIMEApplication: Genel uygulama dosyaları için (örneğin, PDF, ZIP).

Örneğin, bir PDF dosyası eklemek için aşağıdaki kodu kullanırsınız:

```python from email.mime.application import MIMEApplication with open('document.pdf', 'rb') as pdf_file: pdf = MIMEApplication(pdf_file.read(), _subtype='pdf') pdf.add_header('Content-Disposition', 'attachment', filename='document.pdf') msg.attach(pdf) ```

Content-Disposition başlığı, e-posta istemcisine eki nasıl işleyeceğini söyler. attachment değeri, dosyanın satır içi görüntülenmek yerine indirilmesi gerektiğini gösterir.

MIME Mesajlarını Ayrıştırma

Python'ın email paketi ayrıca MIME mesajlarını ayrıştırmanıza da olanak tanır. Bu, gelen e-postaları işlemeniz, ekleri çıkarmanız veya e-posta içeriğini analiz etmeniz gerektiğinde yararlıdır.

Örnek: Bir E-posta Mesajını Ayrıştırma

```python import email from email.policy import default # Örnek e-posta mesajı (gerçek e-posta içeriğinizle değiştirin) email_string = ''' From: sender@example.com To: recipient@example.com Subject: Ekli Test E-postası Content-Type: multipart/mixed; boundary="----boundary" ------boundary Content-Type: text/plain Bu, e-postanın düz metin bölümüdür. ------boundary Content-Type: application/pdf; name="document.pdf" Content-Disposition: attachment; filename="document.pdf" ... (PDF dosya içeriği burada - bu ikili veri olacaktır) ... ------boundary-- ''' # E-posta mesajını ayrıştır msg = email.message_from_string(email_string, policy=default) # E-posta başlıklarına eriş print(f"Kimden: {msg['From']}") print(f"Kime: {msg['To']}") print(f"Konu: {msg['Subject']}") # Mesaj bölümlerinde yinele for part in msg.walk(): content_type = part.get_content_type() content_disposition = part.get('Content-Disposition') if content_type == 'text/plain': print(f"\nDüz Metin:\n{part.get_payload()}") elif content_disposition: filename = part.get_filename() if filename: print(f"\nEk: {filename}") # Eki bir dosyaya kaydet with open(filename, 'wb') as f: f.write(part.get_payload(decode=True)) print(f"'{filename}' eki kaydedildi.") ```

Açıklama:

email modülünü ve default ilkesini içe aktarıyoruz.
Örnek bir e-posta mesajı dizesi tanımlıyoruz (gerçek bir uygulamada, bu bir e-posta sunucusundan veya dosyasından gelir).
Modern ayrıştırma davranışı için default ilkesini kullanarak, e-posta dizesini bir EmailMessage nesnesine ayrıştırmak için email.message_from_string() kullanıyoruz.
Sözlük benzeri erişim kullanarak e-posta başlıklarına erişebiliriz (örneğin, msg['From']).
Mesajın tüm bölümlerini (ana mesaj ve ekler dahil) yinelemek için msg.walk() kullanıyoruz.
Her bölüm için, nasıl işleneceğini belirlemek için Content-Type ve Content-Disposition başlıklarını kontrol ediyoruz.
Bölüm düz metinse, part.get_payload() kullanarak yükü çıkarıyoruz.
Bölüm bir eklentiyse, part.get_filename() kullanarak dosya adını çıkarıyoruz ve eki bir dosyaya kaydediyoruz. decode=True bağımsız değişkeni, yükün doğru şekilde kodunun çözülmesini sağlar.

En İyi Uygulamalar ve Güvenlik Hususları

Python'da e-postayla çalışırken, en iyi uygulamaları izlemek ve güvenlik etkilerini göz önünde bulundurmak önemlidir:

Parolaları asla sabit kodlamayın: Parolaları ve diğer hassas bilgileri ortam değişkenlerini, yapılandırma dosyalarını veya bir sır yönetimi sistemini kullanarak güvenli bir şekilde saklayın.
SSL/TLS kullanın: Kimlik bilgilerinizi ve e-posta içeriğinizi korumak için SMTP sunucularına bağlanırken her zaman SSL/TLS şifrelemesi kullanın.
E-posta adreslerini doğrulayın: E-posta göndermeden önce e-posta adreslerini doğrulamak için normal bir ifade veya özel bir e-posta doğrulama kitaplığı kullanın. Bu, geçersiz adreslere e-posta göndermeyi önlemeye yardımcı olur ve spam göndericisi olarak işaretlenme riskini azaltır.
İstisnaları zarifçe ele alın: E-posta gönderme ve ayrıştırma sırasında olası istisnaları yakalamak için uygun hata işlemeyi uygulayın. Hata ayıklama amacıyla hataları günlüğe kaydedin.
E-posta sınırlarına dikkat edin: Çoğu e-posta sağlayıcısının, gün veya saat başına gönderebileceğiniz e-posta sayısı konusunda sınırları vardır. Hesabınızın askıya alınmasını önlemek için bu sınırları aşmaktan kaçının.
E-posta içeriğini temizleyin: E-posta içeriğini dinamik olarak oluştururken, siteler arası komut dosyası çalıştırma (XSS) güvenlik açıklarını önlemek için kullanıcı girişini temizleyin.
DKIM, SPF ve DMARC'yi uygulayın: Bu e-posta kimlik doğrulama protokolleri, e-posta sahteciliğini ve kimlik avı saldırılarını önlemeye yardımcı olur. Bu protokolleri kullanmak için e-posta sunucunuzu ve DNS kayıtlarınızı yapılandırın.

Gelişmiş Özellikler ve Kitaplıklar

Python'ın email paketi, e-postalarla çalışmak için birçok gelişmiş özellik sağlar. İşte bazı önemli olanlar:

Karakter kodlaması: email paketi, karakter kodlamasını otomatik olarak işler ve e-postaların farklı e-posta istemcilerinde doğru şekilde görüntülenmesini sağlar.
Başlık manipülasyonu: EmailMessage nesnesini kullanarak e-posta başlıklarını kolayca ekleyebilir, değiştirebilir ve kaldırabilirsiniz.
İçerik kodlaması: email paketi, Base64 ve Quoted-Printable gibi farklı içerik kodlama şemalarını destekler.
E-posta ilkeleri: email.policy modülü, e-posta mesajlarının ayrıştırılmasını ve oluşturulmasını özelleştirmenize olanak tanır.

Standart email paketine ek olarak, çeşitli üçüncü taraf kitaplıklar Python'da e-posta işlemeyi basitleştirebilir:

yagmail: E-posta göndermek için basit ve kullanımı kolay bir kitaplık.
Flask-Mail: Flask uygulamalarından e-posta göndermeyi basitleştiren Flask web çerçevesi için bir uzantı.
django.core.mail: E-posta göndermek için Django web çerçevesindeki bir modül.

Uluslararasılaştırma Hususları

Küresel bir kitle için e-posta uygulamaları geliştirirken, aşağıdaki uluslararasılaştırma yönlerini göz önünde bulundurun:

Karakter kodlaması: Farklı dillerden çok çeşitli karakterleri desteklemek için e-posta içeriği ve başlıkları için UTF-8 kodlamasını kullanın.
Tarih ve saat biçimleri: Tarihleri ve saatleri kullanıcı dostu bir şekilde görüntülemek için yerel ayara özgü tarih ve saat biçimlerini kullanın.
Dil desteği: Birden çok dili desteklemek için e-posta şablonları ve kullanıcı arayüzleri için çeviriler sağlayın.
Sağdan sola diller: Uygulamanız sağdan sola dilleri (örneğin, Arapça, İbranice) destekliyorsa, e-posta içeriğinin ve düzenlerinin doğru şekilde görüntülendiğinden emin olun.

Sonuç

Python'ın email paketi, MIME mesajları oluşturmak ve ayrıştırmak için güçlü ve çok yönlü bir araçtır. MIME ilkelerini anlayarak ve uygun sınıfları ve yöntemleri kullanarak, karmaşık biçimlendirmeyi, ekleri ve uluslararasılaştırma gereksinimlerini ele alan gelişmiş e-posta uygulamaları oluşturabilirsiniz. E-posta uygulamalarınızın güvenilir, güvenli ve kullanıcı dostu olduğundan emin olmak için en iyi uygulamaları ve güvenlik yönergelerini izlemeyi unutmayın. Temel metin e-postalarından ekleri olan karmaşık çok parçalı mesajlara kadar, Python e-posta iletişimini etkili bir şekilde yönetmek için ihtiyacınız olan her şeyi sağlar.