Auto BDay Wisher - GSSoC21#623

Author: VishalPatil18

Auto Birthday Wisher/Auto B'Day Wisher.py

@@ -0,0 +1,44 @@
+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 = '</ Enter your email here />'                                # Give your mail here from which you want to send the wishes
+GMAIL_PSWD = '</ Enter password for your email here />'                  # 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
+    print(df)
+    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")
+        print(bday)
+        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,50 @@
+# 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** 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
+```
+
+- **OpenPyxl** Openpyxl is a Python library to read/write Excel 2010 xlsx/xlsm/xltx/xltm files.
+```bash
+pip install openpyxl
+```
+
+- **datetime** It is a module used for Encapsulation of date/time values.
+```bash
+pip install DateTime
+```
+
+- **smtplib** It is a set of Python modules designed for writing video games.
+
+## 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
+```bash
+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="#" alt="Email received by friend"/>
+    <br>
+    Birthday Wishes received by the Friend via Email  
+</p>
+
+## Author
+
+[Vishal Patil](https://github.com/SpecTEviL)