email-module-sender 1.1.0__py3-none-any.whl

email_module/__init__.py

@@ -0,0 +1,8 @@
+"""
+Module d'envoi d'emails simplifié avec support HTML et pièces jointes.
+"""
+
+from .sender import SendEmail
+
+__all__ = ["SendEmail"]
+__version__ = "1.1.0"

email_module/sender.py

@@ -0,0 +1,152 @@
+import smtplib
+import mimetypes
+from pathlib import Path
+from email.message import EmailMessage
+from typing import Union, Tuple, List
+from functools import lru_cache
+
+@lru_cache(maxsize=128)
+def get_mime_type(filename: str) -> Tuple[str, str]:
+    """Retourne (maintype, subtype) avec cache."""
+    mime_type, _ = mimetypes.guess_type(filename)
+    if mime_type is None:
+        mime_type = "application/octet-stream"
+    return tuple(mime_type.split("/", 1))
+
+
+def SendEmail(
+    from_email: str,
+    password: str,
+    to: Union[str, List[str]],  # ← Accepte string OU liste
+    subject: str,
+    text: str = None,
+    text_color: Union[str, Tuple[int, int, int]] = None,
+    text_size: Union[int, str] = 16,
+    text_font: str = "Arial, sans-serif",
+    html: str = None,
+    cc: Union[str, List[str]] = None,  # ← Accepte string OU liste
+    bcc: Union[str, List[str]] = None,  # ← Accepte string OU liste
+    attachments: Union[str, List[str]] = None,  # ← Accepte string OU liste
+    smtp_server: str = "smtp.gmail.com",
+    smtp_port: int = 587,
+    timeout: int = 30
+):
+    """
+    Envoie un email avec options de style avancées.
+    
+    Parameters:
+        - from_email : adresse email de l'expéditeur
+        - password : mot de passe ou app password SMTP
+        - to : destinataire(s) - string ou liste (ex: "user@example.com" ou ["user@example.com"])
+        - subject : sujet de l'email
+        - text : contenu texte simple
+        - text_color : couleur du texte ('red', '#ff0000', ou (255,0,0))
+        - text_size : taille du texte en px (ex: 16, "18px", "1.2em")
+        - text_font : police du texte (ex: "Arial", "Georgia, serif")
+        - html : HTML personnalisé complet (ignore text/color/size/font)
+        - cc : copie carbone - string ou liste
+        - bcc : copie carbone invisible - string ou liste
+        - attachments : fichier(s) à joindre - string ou liste (ex: "file.pdf" ou ["file.pdf"])
+        - smtp_server : serveur SMTP (par défaut Gmail)
+        - smtp_port : port SMTP (587 pour TLS)
+        - timeout : timeout de connexion en secondes
+    """
+    
+    # Conversion automatique en listes
+    if isinstance(to, str):
+        to = [to]
+    if isinstance(cc, str):
+        cc = [cc]
+    if isinstance(bcc, str):
+        bcc = [bcc]
+    if isinstance(attachments, str):
+        attachments = [attachments]
+    
+    # Valeurs par défaut
+    cc = cc or []
+    bcc = bcc or []
+    attachments = attachments or []
+    
+    # Validations
+    if not to:
+        raise ValueError("La liste 'to' ne peut pas être vide")
+    if not (text or html):
+        raise ValueError("Il faut fournir 'text' ou 'html'")
+    
+    # Création du message
+    msg = EmailMessage()
+    msg["From"] = from_email
+    msg["To"] = ", ".join(to)
+    msg["Subject"] = subject
+    
+    if cc:
+        msg["Cc"] = ", ".join(cc)
+    
+    # ----- CONTENU -----
+    if html:
+        msg.set_content("Votre client email ne supporte pas le HTML.")
+        msg.add_alternative(html, subtype="html")
+    
+    elif text:
+        # Traitement de la couleur
+        color = "black"
+        if text_color:
+            if isinstance(text_color, tuple):
+                if len(text_color) != 3:
+                    raise ValueError("text_color tuple doit être (R, G, B)")
+                color = f"rgb({text_color[0]},{text_color[1]},{text_color[2]})"
+            else:
+                color = text_color
+        
+        # Traitement de la taille
+        if isinstance(text_size, int):
+            size = f"{text_size}px"
+        else:
+            size = text_size
+        
+        # Remplacement des sauts de ligne
+        text_html = text.replace("\n", "<br>")
+        
+        # Génération du HTML
+        html_content = f"""<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+</head>
+<body>
+    <p style="color: {color}; font-size: {size}; font-family: {text_font}; line-height: 1.6;">
+        {text_html}
+    </p>
+</body>
+</html>"""
+        
+        msg.set_content(text)
+        msg.add_alternative(html_content, subtype="html")
+    
+    # ----- PIÈCES JOINTES -----
+    if attachments:
+        paths = []
+        for file in attachments:
+            path = Path(file)
+            if not path.exists():
+                raise FileNotFoundError(f"Fichier introuvable : {file}")
+            paths.append(path)
+        
+        for path in paths:
+            maintype, subtype = get_mime_type(path.name)
+            
+            with open(path, "rb") as f:
+                msg.add_attachment(
+                    f.read(),
+                    maintype=maintype,
+                    subtype=subtype,
+                    filename=path.name
+                )
+    
+    # ----- ENVOI -----
+    all_recipients = to + cc + bcc
+    
+    with smtplib.SMTP(smtp_server, smtp_port, timeout=timeout) as server:
+        server.starttls()
+        server.login(from_email, password)
+        server.send_message(msg, to_addrs=all_recipients)

email_module_sender-1.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: email-module-sender
+Version: 1.1.0
+Summary: Simple email sender module
+Author: Yassine SEFFAR
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Email Module Sender
+
+A simple Python email sending module.

email_module_sender-1.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+email_module/__init__.py,sha256=AEKN2z4x72ip6cwVkd4epFa3uxnbrT-raA_sahqDiKU,165
+email_module/sender.py,sha256=scbF_NzaKImDAJ8cd9KDLuZu-WdBioJd_XYU2sq3uA0,5100
+email_module_sender-1.1.0.dist-info/METADATA,sha256=KcVTI1jnPyLpWuI_g-vCaWrpCIYRIr-mQz03lKfXieg,258
+email_module_sender-1.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+email_module_sender-1.1.0.dist-info/top_level.txt,sha256=1nQSJYFESF7n90qz8H2nQ4ppcAbr9i3h8LiX0abolM8,13
+email_module_sender-1.1.0.dist-info/RECORD,,

email_module_sender-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

email_module_sender-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+email_module