PyEmailerAJM 0.1__tar.gz → 1.1__tar.gz

{PyEmailerAJM-0.1 → PyEmailerAJM-1.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: PyEmailerAJM
-Version: 0.1
+Version: 1.1
 Summary: Allows for automating sending Email with the Outlook Desktop client. Future releases will add more client support
 Home-page: https://github.com/amcsparron2793-Water/PyEmailer
 Author: Amcsparron
 Author-email: amcsparron@albanyny.gov
 License: MIT License
-Download-URL: https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/0.1.tar.gz
+Download-URL: https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/1.1.tar.gz
 Keywords: Outlook,Email,Automation
 Platform: UNKNOWN
 License-File: LICENSE.txt

{PyEmailerAJM-0.1 → PyEmailerAJM-1.1}/PyEmailerAJM/PyEmailerAJM.py

@@ -4,6 +4,7 @@ PyEmailerAJM.py
 
 install win32 with pip install pywin32
 """
+from os.path import isfile, abspath, isabs, join
 
 # imports
 
@@ -40,17 +41,102 @@ class PyEmailer:
         self._recipient = None
         self._subject = None
         self._text = None
+        self.read_folder = None
 
         try:
             self.email_app = win32.Dispatch(self.email_app_name)
+            self._mapi_ns = self.email_app.GetNamespace('MAPI')
             self.email = self.email_app.CreateItem(0)
         except com_error as e:
             self._logger.error(e, exc_info=True)
             raise e
 
-    def SetupEmail(self, recipient: str, subject: str, text: str):
+    def _GetReadFolder(self, email_dir_index: int = 6):
+        # 6 = inbox
+        self.read_folder = self._mapi_ns.GetDefaultFolder(email_dir_index)
+        return self.read_folder
+
+    def GetMessages(self, folder_index=None):
+        if isinstance(folder_index, int):
+            self.read_folder = self._GetReadFolder(folder_index)
+        elif not folder_index and self.read_folder:
+            pass
+        elif not folder_index:
+            self.read_folder = self._GetReadFolder()
+        else:
+            try:
+                raise TypeError("folder_index must be an integer or self.read_folder must be defined")
+            except TypeError as e:
+                self._logger.error(e, exc_info=True)
+                raise e
+        return self.read_folder.Items
+
+    def GetEmailMessageBody(self, msg):
+        """message = messages.GetLast()"""
+        body_content = msg.body
+        if body_content:
+            return body_content
+        else:
+            try:
+                raise ValueError("This message has no body.")
+            except ValueError as e:
+                self._logger.error(e, exc_info=True)
+                raise e
+
+    def FindMsgBySubject(self, subject: str) -> list:
+        matched_messages = []
+        for message in self.GetMessages():
+            if message.Subject == subject:
+                matched_messages.append(message)
+        return matched_messages
+
+    def SaveAllEmailAttachments(self, msg, save_dir_path):
+        attachments = msg.Attachments
+        for attachment in attachments:
+            full_save_path = join(save_dir_path, str(attachment))
+            try:
+                attachment.SaveAsFile(full_save_path)
+                self._logger.debug(f"{full_save_path} saved from email with subject {msg.subject}")
+            except Exception as e:
+                self._logger.error(e, exc_info=True)
+                raise e
+
+    def SetupEmail(self, recipient: str, subject: str, text: str, attachments: list = None):
+        def _validate_attachments():
+            if attachments:
+                if isinstance(attachments, list):
+                    for a in attachments:
+                        if isfile(a):
+                            if isabs(a):
+                                self.email.Attachments.Add(a)
+                            else:
+                                a = abspath(a)
+                                if isfile(a):
+                                    self.email.Attachments.Add(a)
+                                else:
+                                    try:
+                                        raise FileNotFoundError(f"file {a} could not be attached.")
+                                    except FileNotFoundError as e:
+                                        self._logger.error(e, exc_info=True)
+                                        raise e
+                        else:
+                            try:
+                                raise FileNotFoundError(f"file {a} could not be attached.")
+                            except FileNotFoundError as e:
+                                self._logger.error(e, exc_info=True)
+                                raise e
+                else:
+                    try:
+                        raise TypeError("attachments attribute must be a list")
+                    except TypeError as e:
+                        self._logger.error(e, exc_info=True)
+                        raise e
+            else:
+                self._logger.debug("no attachments detected")
+
         try:
             # set the params
+            _validate_attachments()
             self.email.To = recipient
             self.email.Subject = subject
             self.email.HtmlBody = text
@@ -146,18 +232,9 @@ if __name__ == "__main__":
     r_dict = {
         "subject": f"TEST: Your TEST "
                    f"agreement expires in 30 days or less!",
-        "text": f"To whom it may concern,<br>"
-                f"&emsp; Your TEST "
-                f"agreement <b>expires in 30 days or less (your due date is TEST)</b>. "
-                f"Please renew the aforementioned by dropping off a hard copy to "
-                f"the Albany Water Department at 10 N Enterprise Dr.<br>"
-                f"Thank You,<br>"
-                f"AWD"
-                f"<br>"
-                f"<br>"
-                f"<br>"
-                f"This is an automated email, Please do not respond directly to it.",
-        "recipient": ''
+        "text": "testing to see if the attachment works",
+        "recipient": 'pbehnke@albanyny.gov',
+        "attachments": []
     }
     # &emsp; is the tab character for emails
     emailer.SetupEmail(**r_dict)  # recipient="amcsparron@albanyny.gov", subject="test subject", text="test_body")

{PyEmailerAJM-0.1 → PyEmailerAJM-1.1}/PyEmailerAJM.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: PyEmailerAJM
-Version: 0.1
+Version: 1.1
 Summary: Allows for automating sending Email with the Outlook Desktop client. Future releases will add more client support
 Home-page: https://github.com/amcsparron2793-Water/PyEmailer
 Author: Amcsparron
 Author-email: amcsparron@albanyny.gov
 License: MIT License
-Download-URL: https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/0.1.tar.gz
+Download-URL: https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/1.1.tar.gz
 Keywords: Outlook,Email,Automation
 Platform: UNKNOWN
 License-File: LICENSE.txt

PyEmailerAJM-1.1/README.md

@@ -0,0 +1,8 @@
+# <u>PyEmailerAJM</u>
+### <i>Makes automating Outlook emails quick and easy</i>
+
+- PyEmailerAJM uses pywin32 to automate the sending of Outlook emails.
+
+<b>Import</b>
+
+import PyEmailer class using `from PyEmailerAJM.PyEmailerAJM import PyEmailer`

{PyEmailerAJM-0.1 → PyEmailerAJM-1.1}/setup.py

@@ -2,10 +2,10 @@ from setuptools import setup
 
 setup(
     name='PyEmailerAJM',
-    version='0.1',
+    version='1.1',
     packages=['PyEmailerAJM'],
     url='https://github.com/amcsparron2793-Water/PyEmailer',
-    download_url='https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/0.1.tar.gz',
+    download_url='https://github.com/amcsparron2793-Water/PyEmailer/archive/refs/tags/1.1.tar.gz',
     keywords=["Outlook", "Email", "Automation"],
     install_requires=['pywin32'],
     license='MIT License',

PyEmailerAJM-0.1/README.md

@@ -1,8 +0,0 @@
-# <u>PyEmailer</u>
-### <i>Makes automating Outlook emails quick and easy</i>
-
-- PyEmailer uses pywin32 to automate the sending of Outlook emails.
-
-<b>Import</b>
-
-import SQLite3HelperClass using `from PyEmailer import PyEmailer`