added comments in attachment.py

Author: Kirtan17

Attachment_Downloader/attachment.py

@@ -1,33 +1,39 @@
 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(len(resulthreads)):
-            if len(resulthreads[i].messages) > 1:
+        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()
+                    resulthreads[i].messages[
+                        j].downloadAllAttachments()  # downloads attachment(s) for individual messages
             else:
-                resulthreads[i].messages[0].downloadAllAttachments()
+                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).")
-    finally:
-        print("Download compelete. Please check your root directory.")
+
 
 if __name__ == '__main__':
     query = input("Enter search query: ")
-    newquery = query + " + has:attachment"
-    resulthreads = ezgmail.search(newquery)
+    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("Results have no attachments")
+        print("Result has no attachments")  # Executed if results don't have attachment
     else:
-        print("Results: ")
+        print("Result(s): ")
         for threads in resulthreads:
-            print(f"Email Subject: {threads.messages[0].subject}")
+            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 results (Yes/No)? ")
+            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)
+                attachmentdownload(resulthreads)  # calls the function that downloads attachment(s)
             else:
                 print("Program exited")
         except:

Attachment_Downloader/credentials.json

@@ -0,0 +1 @@
+{"installed":{"client_id":"1004827760520-vhe76mj8bnhl2djbi911hul9ebiuar5p.apps.googleusercontent.com","project_id":"attachment-downl-1615836904083","auth_uri":"https://accounts.google.com/o/oauth2/auth","token_uri":"https://oauth2.googleapis.com/token","auth_provider_x509_cert_url":"https://www.googleapis.com/oauth2/v1/certs","client_secret":"jiOeNPFSLKb6TeAGge-Fta-5","redirect_uris":["urn:ietf:wg:oauth:2.0:oob","http://localhost"]}}

Attachment_Downloader/token.json

@@ -0,0 +1 @@
+{"access_token": "ya29.a0AfH6SMD8DyPYCFTJf7BhOwGEoo59dmruTK1_VEjH23ESyxyONhGYnqEZCRRKId6wMe93a-jRwAzryCcYoH8sM4HOZuf0Em3mudNCS3zG_MzjGNDQS_axcF5J68XqS2GNVz8w8NyLa-qr33VvMKL1yReek0s-vw", "client_id": "1004827760520-vhe76mj8bnhl2djbi911hul9ebiuar5p.apps.googleusercontent.com", "client_secret": "jiOeNPFSLKb6TeAGge-Fta-5", "refresh_token": "1//0grs3VlWC1FgpCgYIARAAGBASNwF-L9Ir6d_ihrdvKysfTi86Eqv2w18XTWSxi8x8GHHBoeZjm_viWL3RT7qr45a4KIhYoLMbvd4", "token_expiry": "2021-03-16T11:52:35Z", "token_uri": "https://oauth2.googleapis.com/token", "user_agent": null, "revoke_uri": "https://oauth2.googleapis.com/revoke", "id_token": null, "id_token_jwt": null, "token_response": {"access_token": "ya29.a0AfH6SMD8DyPYCFTJf7BhOwGEoo59dmruTK1_VEjH23ESyxyONhGYnqEZCRRKId6wMe93a-jRwAzryCcYoH8sM4HOZuf0Em3mudNCS3zG_MzjGNDQS_axcF5J68XqS2GNVz8w8NyLa-qr33VvMKL1yReek0s-vw", "expires_in": 3599, "scope": "https://mail.google.com/", "token_type": "Bearer"}, "scopes": ["https://mail.google.com/"], "token_info_uri": "https://oauth2.googleapis.com/tokeninfo", "invalid": false, "_class": "OAuth2Credentials", "_module": "oauth2client.client"}