personal-assistant-py-br 0.0.1

A personal assistant.

CLI Personal Assistant

Description

A CLI organizer that can help store contacts' phone numbers and birthday dates.

Get Started

Run pip install personal_assistant to install the package and then get-started to get started.

The list of available commands is as follows:

• hi or hello or greeting - to say hi to your favorite PA!
• contacts - to enter the address book interface;
• notes - to enter the notes interface;
• close or exit - to exit the personal assistant;

Contacts Interface

• add + name + phone - to add a contact and its phone number;
• delete / remove + name - to delete the contact;
• find + name - to search a contact from your list by name, phone, email, or address;
• entries - to show the number of contacts;
• all - to list all the contacts and their phone numbers;
• help - to show the list of available commands for the address book;
• back / return / - - to exit the address book;

Phone

• show-phone + name - to list all the phone numbers associated with the contact;
• change + name + old phone + new phone - to change the phone number;
• delete-phone / remove-phone + name + phone - to remove the phone number;

Birthday

• add-birthday + name + DD.MM.YYYY - to add birthday;
• show-birthday + name - to show birthday associate with the contact;
• birthdays (+ n)? - to show a list of contacts with birthdays for the next n days, if specified;

Email

• add-email + name + email - to add email;
• show-email + name - to show email associate with the contact;
• change-email + name + old email + new email - to change the email;
• delete-email + name - to remove the email;

Address

• add-address + name + address - to add address;
• show-address + name - to show address associate with the contact;
• change-address + name + new address - to change the address;
• delete-address name - to remove the address;

Notes Interface

• add + additional inputs - to create a note;
• search / seek / find / filter / grep + additional name=<text> / tag=<text> / text=<text> - to show one note;
• edit / upd / update / change / ch + additional inputs - to change one note;
• remove / delete / del / rm + additional inputs - to remove one note by ordinal number;
• find + additional name=<text> / tag=<text> / text=<text> - to show all notes that contain the keyword;
• show / all / list / ls - to list all notes with a ordinal number and note text;
• help - to show the list of available commands for notes;
• back / return / - - to exit notes;

Additional Notes

1. Currently, it is not possible to add a contact with a name only. Both name and a phone number must be provided;
2. Calling the command again with the same name will add another phone number to the same contact;
3. name - a string with a minimum of 1 character and a maximum of 30 characters;
4. phone number - only numbers, 10 characters;
5. birthday - the format is DD.MM.YYYY or DD-MM-YYYY;
6. email - a string, the format is [e-mail];
7. address - a string that may contain spaces, commas, periods, etc.; the address contains from 10 to 100 characters;
8. text - a string that can contain spaces, commas, periods, etc.; during note creation, it is assigned a ordinal number for management;
9. The PA saves the progress upon exiting; this does not apply to the cases when it is forcefully shut down (e.g. keyboard interrupt);