Merge pull request avinashkranjan#635 from SpecTEviL/AutoBDayWisher-GSSoC'21#623

Added Auto B'day Wisher - gssoc'21 avinashkranjan#623

Author: avinashkranjan

Auto Birthday Wisher/Auto B'Day Wisher.py

@@ -0,0 +1,42 @@
+import pandas as pd                                                     # Pandas library is used for importing and reading the data
+import datetime                                                         # datetime module is used for fetching the dates
+import smtplib															# smtp library used for sending mail
+import os
+
+current_path = os.getcwd()
+print(current_path)
+os.chdir(current_path)                                                  # Changing the Path of the directory in which you are currently working
+
+GMAIL_ID = input("Enter your email: ")                                  # Give your mail here from which you want to send the wishes
+GMAIL_PSWD = input("Enter password for your email mentioned above: ")   # Give your mail password
+
+
+def sendEmail(to, sub, msg):
+    print(f"Email to {to} sent: \nSubject: {sub} ,\nMessage: {msg}")
+    s = smtplib.SMTP('smtp.gmail.com', 587)                             # creating server to send mail
+    s.starttls()                                                        # start a TLS session
+    s.login(GMAIL_ID, GMAIL_PSWD)                                       # the function will login with your Gmail credentials
+    s.sendmail(GMAIL_ID, to, f"Subject: {sub} \n\n {msg}")              # sending the mail
+    s.quit()
+
+
+if __name__ == "__main__":
+    df = pd.read_excel("data.xlsx")                                     # the datasheet where the data of the friends is stored
+    today = datetime.datetime.now().strftime("%d-%m")
+    yearNow = datetime.datetime.now().strftime("%Y")
+
+    writeInd = []
+    for index, item in df.iterrows():
+        bday = item['Birthday']
+        bday = datetime.datetime.strptime(bday, "%d-%m-%Y")
+        bday = bday.strftime("%d-%m")
+        if(today == bday) and yearNow not in str(item['LastWishedYear']):
+            sendEmail(item['Email'], "Happy Birthday", item['Dialogue'])    # calling the sendmail function
+            writeInd.append(index)
+
+    if writeInd != None:
+        for i in writeInd:
+            oldYear = df.loc[i, 'LastWishedYear']
+            df.loc[i, 'LastWishedYear'] = str(oldYear) + ", " + str(yearNow)
+
+    df.to_excel('data.xlsx', index=False)

Auto Birthday Wisher/README.md

@@ -0,0 +1,42 @@
+# Auto Birthday Wisher
+
+One forgets to send birthday wishes to friends many times. At such times an automatic birthday wisher comes handy. An automatic birthday wisher via email makes one's life easy. It will send the birthday wishes to friends via email automatically via a server and using an excel sheet to store the data of friends and their birthdays along with email id. It'll send the wishes to friends for all the upcoming years untill we stop the server.
+
+## Setup instructions
+
+In order to run this script, You just need the following modules:
+
+- **Pandas** is a fast, powerful, flexible and easy to use open source data analysis and manipulation tool,
+built on top of the Python programming language.
+```bash
+pip install pandas
+```
+
+- **Datetime** is a module used for Encapsulation of date/time values.
+```bash
+pip install DateTime
+```
+
+- **smtplib** module defines an SMTP client session object that can be used to send mail to any Internet machine with an SMTP or ESMTP listener daemon.
+
+## Configuration
+1. Assign the Gmail Id of sender to the GMAIL_ID variable in *line 10* of **"Auto B'Day Wisher.py"** file. (e.g. 'xyz@gmail.com')
+2. Similar to first step assign the Gmail password of sender to the GMAIL_PSWD variable in *line 11* of **"Auto B'Day Wisher.py"** file. (e.g. '1234')
+3. In **"data.xlsx"** file insert the name of the receiver in second column under *Name*. Similarly update the **Birthday** field with the birth date of receiver in the given format*("%dd-%mm-%YYYY")*. Update the **Dailogue** field with a short message you want to send and the **Email** field with the email of the receiver.
+4. Make sure to give permission to your google account from which you're sending email to **Allow less secure apps**. Just turn this *"ON"* from [here](https://support.google.com/accounts/answer/6010255?hl=en#zippy=%2Cif-less-secure-app-access-is-off-for-your-account).
+5. Run the command
+```bash
+python "Auto B'Day Wisher.py"
+```
+
+## Screenshots
+
+<p align="center">
+    <img src="https://raw.githubusercontent.com/SpecTEviL/Amazing-Python-Scripts/AutoBDayWisher-GSSoC'21%23623/Auto%20Birthday%20Wisher/emailReceived.jpg" height="700" alt="Email received by friend"/>
+    <br>
+    Birthday Wishes received by the Friend via Email  
+</p>
+
+## Author
+
+[Vishal Patil](https://github.com/SpecTEviL)