fixes #11

Author: jph00

markdown_merge/core.py

@@ -66,18 +66,18 @@ def smtp_connection(host, port, user=None, password=None, use_ssl=True, use_tls=
 # %% ../nbs/00_core.ipynb
 class MarkdownMerge:
     "Send templated email merge messages formatted with Markdown"
-    def __init__(self, addrs, from_addr, subj, msg, smtp_cfg=None, inserts=None, test=False, hdrs=None, env_from=None):
+    def __init__(self, addrs, from_addr, subj, msg, smtp_cfg=None, inserts=None, test=False, hdrs=None, env_from=None, attach=None):
         self.addrs,self.from_addr,self.subj,self.msg,self.i = addrs,from_addr,subj,msg,0
         self.inserts = [{}]*len(addrs) if inserts is None else inserts
-        self.smtp_cfg,self.test,self.hdrs,self.env_from = smtp_cfg,test,hdrs,env_from
+        self.smtp_cfg,self.test,self.hdrs,self.env_from,self.attach = smtp_cfg,test,hdrs,env_from,attach
 
     def send_msgs(self, pause=0.2):
         "Send all unsent messages to `addrs` with `pause` secs between each send"
         conn = smtp_connection(**self.smtp_cfg)
         while self.i < len(self.addrs):
             addr,insert = self.addrs[self.i],self.inserts[self.i]
             msg = self.msg.format(**insert)
-            eml = md2email(self.subj, self.from_addr, addr, md=msg, hdrs=self.hdrs)
+            eml = md2email(self.subj, self.from_addr, addr, md=msg, hdrs=self.hdrs, attach=self.attach)
             if self.test: print(f"To: {addr}\n{'-'*40}\n{msg}\n{'='*40}\n")
             else:
                 conn.send_message(eml, from_addr=self.env_from)

nbs/00_core.ipynb

@@ -387,18 +387,18 @@
     "#| export\n",
     "class MarkdownMerge:\n",
     "    \"Send templated email merge messages formatted with Markdown\"\n",
-    "    def __init__(self, addrs, from_addr, subj, msg, smtp_cfg=None, inserts=None, test=False, hdrs=None, env_from=None):\n",
+    "    def __init__(self, addrs, from_addr, subj, msg, smtp_cfg=None, inserts=None, test=False, hdrs=None, env_from=None, attach=None):\n",
     "        self.addrs,self.from_addr,self.subj,self.msg,self.i = addrs,from_addr,subj,msg,0\n",
     "        self.inserts = [{}]*len(addrs) if inserts is None else inserts\n",
-    "        self.smtp_cfg,self.test,self.hdrs,self.env_from = smtp_cfg,test,hdrs,env_from\n",
+    "        self.smtp_cfg,self.test,self.hdrs,self.env_from,self.attach = smtp_cfg,test,hdrs,env_from,attach\n",
     "\n",
     "    def send_msgs(self, pause=0.2):\n",
     "        \"Send all unsent messages to `addrs` with `pause` secs between each send\"\n",
     "        conn = smtp_connection(**self.smtp_cfg)\n",
     "        while self.i < len(self.addrs):\n",
     "            addr,insert = self.addrs[self.i],self.inserts[self.i]\n",
     "            msg = self.msg.format(**insert)\n",
-    "            eml = md2email(self.subj, self.from_addr, addr, md=msg, hdrs=self.hdrs)\n",
+    "            eml = md2email(self.subj, self.from_addr, addr, md=msg, hdrs=self.hdrs, attach=self.attach)\n",
     "            if self.test: print(f\"To: {addr}\\n{'-'*40}\\n{msg}\\n{'='*40}\\n\")\n",
     "            else:\n",
     "                conn.send_message(eml, from_addr=self.env_from)\n",
@@ -513,15 +513,37 @@
    "source": [
     "mm.reset()"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4cd75daa",
+   "metadata": {},
+   "source": [
+    "### Attachments"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "62351144",
+   "metadata": {},
+   "source": [
+    "Pass `attach` to include file attachments with your email. It can be a single file path or a list of paths:\n",
+    "\n",
+    "```python\n",
+    "mm = MarkdownMerge(addrs, from_addr, 'Subject', msg, smtp_cfg=smtp_cfg, attach='report.pdf')\n",
+    "```\n",
+    "\n",
+    "For multiple attachments:\n",
+    "\n",
+    "```python\n",
+    "mm = MarkdownMerge(addrs, from_addr, 'Subject', msg, smtp_cfg=smtp_cfg, attach=['report.pdf', 'data.csv'])\n",
+    "```\n",
+    "\n",
+    "The MIME type is automatically detected from the file extension. If the type cannot be determined, it defaults to `application/octet-stream`."
+   ]
   }
  ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "python3",
-   "language": "python",
-   "name": "python3"
-  }
- },
+ "metadata": {},
  "nbformat": 4,
  "nbformat_minor": 5
 }

nbs/index.ipynb

@@ -128,6 +128,18 @@
     "The `test=True` parameter prints the messages instead of sending them."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "d223e6e5",
+   "metadata": {},
+   "source": [
+    "Pass `attach` to include file attachments with your email. It can be a single file path or a list of paths:\n",
+    "\n",
+    "```python\n",
+    "ml = MarkdownMerge(to_addrs, from_addr, 'Subject', msg, smtp_cfg=smtp_cfg, attach='report.pdf')\n",
+    "```"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "52d9e79f",