A CLI organizer that can help store contacts' phone numbers and birthday dates.
Run
pip install py_brigade_personal_assistant
to install the package and then
get-started
to get started.
Command | Values | Description |
---|---|---|
hi / hello / greeting |
- | to say hi to your favorite PA! |
contacts |
- | to enter the address book interface; |
notes |
- | to enter the notes interface; |
close / exit |
- | to exit the personal assistant; |
Command | Values | Description |
---|---|---|
🤙 Contact | ||
add |
name, phone | to add a contact and its phone number; |
find |
text | to search a contact from your list by name, phone, email, or address; |
delete / remove |
name | to delete the contact; |
num-contacts |
text | 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-phone |
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 |
number | to show a list of contacts with birthdays for the next n days, if specified; |
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; |
Command | Values | Description |
---|---|---|
📝 Notes | ||
add |
additional inputs | to create a note; |
search / seek / find / filter / grep |
name= / tag= / text= | to search a contact from your list by name, phone, email, or address; |
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 |
name= / tag= / 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; |
- Currently, it is not possible to add a contact with a name only. Both
name
and aphone number
must be provided; - Calling the command again with the same name will add another phone number to the same contact;
-
name
- a string with a minimum of 1 character and a maximum of 30 characters; -
phone number
- only numbers, 10 characters; -
birthday
- the format is DD.MM.YYYY; -
email
- a string, the format is example@example.com; -
address
- a string that may contain spaces, commas, periods, etc.; the address contains from 10 to 100 characters; -
text
- a string that can contain spaces, commas, periods, etc.; during note creation, it is assigned a ordinal number for management; - The PA saves the progress upon exiting; this does not apply to the cases when it is forcefully shut down (e.g. keyboard interrupt);
- The PA supports machine-learning enabled intent recognition for all the intents except for:
- show-phone
- num-contacts
- add-address
- change-address
- show-address
- delete-address
- these commands must be entered the way they are written above.