github-email-alert 0.1.0__tar.gz

github_email_alert-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

github_email_alert-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

github_email_alert-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: github-email-alert
+Version: 0.1.0
+Summary: Reusable GitHub Email Alert package for CI/CD workflows
+Author: Pandiyaraj Karuppasamy
+Requires-Python: >=3.8

github_email_alert-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "github-email-alert"
+version = "0.1.0"
+description = "Reusable GitHub Email Alert package for CI/CD workflows"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [{ name = "Pandiyaraj Karuppasamy" }]
+dependencies = []
+
+[project.scripts]
+github-email-alert = "github_email_alert.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/github_email_alert"]

github_email_alert-0.1.0/src/github_email_alert/cli.py

@@ -0,0 +1,51 @@
+import os
+import argparse
+from .emailer import send_email
+from .templates import build_email
+
+
+def parse_list(value):
+    if not value:
+        return []
+    return [x.strip() for x in value.split(",") if x.strip()]
+
+
+def main():
+    parser = argparse.ArgumentParser(description="GitHub Email Alert")
+    parser.add_argument("branch_ref")
+    parser.add_argument("event_type")
+
+    args = parser.parse_args()
+
+    context = {
+        "actor": os.getenv("GITHUB_ACTOR", "Unknown"),
+        "pr_title": os.getenv("PR_TITLE", "N/A"),
+        "branch_ref": args.branch_ref,
+        "base_ref": os.getenv("BASE_REF", "main"),
+        "repo_name": os.getenv("REPO_NAME", "Unknown"),
+    }
+
+    email_user = os.getenv("EMAIL_USER")
+    email_pass = os.getenv("EMAIL_PASS")
+    email_to = parse_list(os.getenv("EMAIL_TO"))
+    email_cc = parse_list(os.getenv("EMAIL_CC"))
+
+    if not all([email_user, email_pass, email_to]):
+        raise ValueError("EMAIL_USER, EMAIL_PASS, EMAIL_TO required")
+
+    subject, body = build_email(args.event_type, context)
+
+    send_email(
+        smtp_host=os.getenv("SMTP_HOST", "smtp.gmail.com"),
+        smtp_port=int(os.getenv("SMTP_PORT", 587)),
+        email_user=email_user,
+        email_pass=email_pass,
+        to_list=email_to,
+        cc_list=email_cc,
+        subject=subject,
+        body=body,
+    )
+
+
+if __name__ == "__main__":
+    main()

github_email_alert-0.1.0/src/github_email_alert/emailer.py

@@ -0,0 +1,31 @@
+import smtplib
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+
+
+def send_email(
+    smtp_host,
+    smtp_port,
+    email_user,
+    email_pass,
+    to_list,
+    cc_list,
+    subject,
+    body,
+):
+    msg = MIMEMultipart()
+    msg["From"] = email_user
+    msg["To"] = ", ".join(to_list)
+
+    if cc_list:
+        msg["Cc"] = ", ".join(cc_list)
+
+    msg["Subject"] = subject
+    msg.attach(MIMEText(body, "html"))
+
+    recipients = to_list + cc_list
+
+    with smtplib.SMTP(smtp_host, smtp_port) as server:
+        server.starttls()
+        server.login(email_user, email_pass)
+        server.sendmail(email_user, recipients, msg.as_string())

github_email_alert-0.1.0/src/github_email_alert/templates.py

@@ -0,0 +1,40 @@
+def build_email(event_type, context):
+    templates = {
+        "new_pr": {
+            "subject": f"🆕 [NEW PR] {context['pr_title']}",
+            "header": "New Pull Request Created",
+            "color": "#0076D7",
+        },
+        "merge_pr": {
+            "subject": f"✅ [MERGED PR] {context['pr_title']}",
+            "header": "Pull Request Merged",
+            "color": "#28A745",
+        },
+        "conflict": {
+            "subject": f"⚠️ [CONFLICT] {context['branch_ref']}",
+            "header": "Merge Conflict Detected",
+            "color": "#DC3545",
+        },
+    }
+
+    template = templates.get(event_type)
+
+    if not template:
+        return f"[TEST] {event_type}", "<h2>Test Email</h2>"
+
+    body = f"""
+    <html>
+    <body>
+        <h2 style="color:{template['color']};">{template['header']}</h2>
+        <p><strong>Actor:</strong> {context['actor']}</p>
+        <p><strong>Title:</strong> {context['pr_title']}</p>
+        <p><strong>Source Branch:</strong> {context['branch_ref']}</p>
+        <p><strong>Target Branch:</strong> {context['base_ref']}</p>
+        <p><strong>Repository:</strong> {context['repo_name']}</p>
+        <hr>
+        <p><em>Automated GitHub Notification</em></p>
+    </body>
+    </html>
+    """
+
+    return template["subject"], body

github_email_alert-0.1.0/src/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from github-email-alert!")
+
+
+if __name__ == "__main__":
+    main()

github_email_alert-0.1.0/uv.lock

@@ -0,0 +1,12 @@
+version = 1
+revision = 3
+requires-python = ">=3.8"
+resolution-markers = [
+    "python_full_version >= '3.9'",
+    "python_full_version < '3.9'",
+]
+
+[[package]]
+name = "github-email-alert"
+version = "0.1.0"
+source = { editable = "." }