'Events' Class Description:

This is a Python script that defines a class Events, which is designed to extract information from text representing an event invitation.

The class has several methods that use regular expressions to extract the event name, date, time, location, and sender's email and phone number from the text. These methods include:

• eventName: Returns the name of the event, using a regular expression that matches any sequence of one or more word characters (letters, numbers, or underscores) surrounded by double quotes.

• eventDate: Returns a tuple of a datetime.date object and a datetime.time object representing the date and time of the event, respectively. It uses two regular expressions to extract the date and time components from the text, and then converts them to the appropriate data types.

• eventLocation: Returns the location of the event, using a regular expression that matches any text that follows the word "Location:" in the input text.

• eventSender: Returns a tuple of the sender's email address and phone number, using two regular expressions that match email addresses and phone numbers in various formats.

The class also has several other methods:

• find: This method is used by the other methods to search the input text for a regular expression pattern, and returns the first match found (or the string "Not Found" if no match is found).

• textSummary: This method returns a string summarizing the properties of the Events object, excluding the full input text. It is used to generate a summary of all the events in a list, which can then be written to a text file using the write_txtfile method.

• dictSummary: This method returns a dictionary summarizing the properties of the Events object, including the full input text. It is used to generate a summary of a single event, which can then be written to a CSV file using the write_csvfile method.

• write_txtfile: This method takes a list of Events objects or a single Events object, and writes a summary of each object to a text file.

• write_csvfile: This method takes a dictionary summary of an Events object and writes it to a CSV file.

• create_schedule: This method creates an appointment in Microsoft Outlook using the win32com.client library. It uses the dictSummary method to extract the necessary information from the Events object and sets the appropriate properties of the appointment object before saving it to the Outlook calendar.

Main Program Description:

• read(): checks if summary files already exist for invitations (in either CSV or text format) and if so, asks the user if they want to read them. If the user agrees, the function prints out the contents of the file.
• folderChange(): prompts the user to enter the name of a new folder to search for invitations in. If the folder exists, it returns the folder name. If it doesn't exist, it prints an error message and asks the user to enter a new folder name.
• exit(): prints a goodbye message and exits the program.
• main(): prints a menu of options to the user and prompts the user to choose an option. If the user chooses to create a new summary, it calls start_extract() to extract information from the invitation files. If the user chooses to change the folder name, it calls folderChange() to prompt the user for a new folder name. If the user chooses to exit, it calls exit() to exit the program.
• start_extract(folder_path="Invitations"): extracts information from invitation files in the specified folder (default is "Invitations"). It first creates a list of Events objects by iterating over the files in the folder and extracting information from each file using the Events class. It then prompts the user to sort the events by date, and if the user chooses to do so, it sorts the event list. Finally, it presents a menu of options to the user, allowing them to print out the summary of the events, save the summary as a text or CSV file, create a schedule in an Outlook calendar, or exit the program.