Merge pull request avinashkranjan#624 from Kirtan17/issue-482

Issue 482

Author: avinashkranjan

Attachment_Downloader/README.md

@@ -0,0 +1,38 @@
+# Attachment Downloader
+
+The script downloads gmail atttachment(s) in no time!
+
+
+# Setup Instructions
+
+The script uses ezgmail module (to know more visit https://pypi.org/project/EZGmail/). To install please type the following command in your bash.
+
+```bash
+pip install EZGmail
+```
+
+Once the module is installed you will need to download credentials.json file by going to [developers.google.com](https://developers.google.com/gmail/api/quickstart/python) and clicking the Enable the Gmail API button (select "Desktop app" as OAuth Client in second step).
+
+Once you have credentials.json (in root directory of project folder), the first time you run the script it will open up a browser window asking you to log in to your Gmail account and allow "Quickstart" app to access it. A token.json file will be generated (in root directory of project folder) which your script can use to access your account.
+
+# Outputs
+
+## Output 1
+
+![image](https://user-images.githubusercontent.com/75886245/111307477-82e5d100-867f-11eb-8461-58abd04fa56a.png)
+
+## Output 2
+
+![image](https://user-images.githubusercontent.com/75886245/111307625-ba547d80-867f-11eb-8f3b-77ded9e72416.png)
+
+## Output 3
+
+![image](https://user-images.githubusercontent.com/75886245/111307771-e66ffe80-867f-11eb-8bbe-457675fcb963.png)
+
+## Output 4
+
+![image](https://user-images.githubusercontent.com/75886245/111307864-0273a000-8680-11eb-8400-3009dff8d7db.png)
+
+# Author
+
+Contributed by Kirtan Bhatt

Attachment_Downloader/attachment.py

@@ -0,0 +1,44 @@
+import ezgmail
+
+def attachmentdownload(resulthreads):
+    # Two Objects used in code are GmailThread and GmailMessage
+    # 1.  GmailThread - Represents conversation threads
+    # 2.  GmailMessage - Represents individual emails within Threads
+    countofresults = len(resulthreads)
+    try:
+        for i in range(countofresults):
+            if len(resulthreads[i].messages) > 1:  # checks whether the count of messages in threads is greater than 1
+                for j in range(len(resulthreads[i].messages)):
+                    resulthreads[i].messages[
+                        j].downloadAllAttachments()  # downloads attachment(s) for individual messages
+            else:
+                resulthreads[i].messages[0].downloadAllAttachments()  # downloads attachment(s) for single message
+        print("Download compelete. Please check your root directory.")
+    except:
+        raise Exception("Error occured while downloading attachment(s).")
+
+
+if __name__ == '__main__':
+    query = input("Enter search query: ")
+    newquery = query + " + has:attachment"  # appending to make sure the result threads always has an attachment
+    resulthreads = ezgmail.search(newquery) # search functions accepts all the operators described at https://support.google.com/mail/answer/7190?hl=en
+
+    if len(resulthreads) == 0:
+        print("Result has no attachments:")  # Executed if results don't have attachment
+    else:
+        print("Result(s) with attachments:")
+        for threads in resulthreads:
+            print(f"Email Subject: {threads.messages[0].subject}")  # prints the subject line of email thread in results
+        try:
+            ask = input(
+                "Do you want to download attachment(s) in result(s) (Yes/No)? ")  # Allows user to decide whether they want to download attachment(s) or not
+            if ask == "Yes":
+                attachmentdownload(resulthreads)  # calls the function that downloads attachment(s)
+            else:
+                print("Program exited")
+        except:
+            print("Something went wrong")
+
+
+
+