snegurova / project-magicdev

MIT License
0 stars 0 forks source link

Assistant Bot

Assistant Bot is a console-based application written in Python. It serves as a personal assistant for managing contacts and notes efficiently.

Features

Getting Started

  1. Clone the repository:

git clone https://github.com/snegurova/project-magicdev.git

  1. Navigate to the project directory:

cd project-magicdev

  1. Install the required dependencies:

pip install -r requirements.txt

  1. Install the application (see instructions below)

  2. Run the application:

magicdev

Installation Instructions for Mac

These instructions will guide you through the process of installing the bot on your MacOs computer.

Run commands in the terminal in the project folder

python3 -m venv env

source env/bin/activate

pip install -r requirements.txt

pip install .

Run the application:

magicdev

Installation Instructions for Windows

These instructions will guide you through the process of installing the bot on your Windows computer.

  1. Open Terminal.

  2. Type cmd to launch the Windows Command Prompt.

  3. Enter the following command to create a Python virtual environment: py -m venv <DIR>

    Replace <DIR> with the name of the folder where you want to save the virtual environment (e.g., env, vene, myenv, etc.).

  4. Once the virtual environment is created, activate it by entering the following command: <DIR>\Scripts\activate

  5. Install 'pip' and 'setuptools' by running the following command:

    py -m pip install pip setuptools

  6. Install the bot by running the following command:

    py -m pip install -e .

  7. After successful installation, you can start the bot by entering the following command: magicdev

Usage

The application accepts various commands to perform different actions. Here are the available commands:

Command Description
hello Say Hi to Bot and it will start work.
help List of all bot commands. You`re already here.
add [name] [phone] Add a new contact.
change [name] [old phone] [new phone] Change contact information.
phone [name] Find phone number of a contact.
add-email [name] [email] Add email to a contact.
change-email [old email] [new email] Change email of a contact.
add-birthday [name] [birthday-date] Add birthday to a contact.
change-birthday [name] [new birthday] Change birthday of a contact.
show-birthday [name] Show birthday of a contact.
birthdays [day] Show birthdays within a range of days.
add-address [name] [address] Add address to a contact. Address argument should not contain spaces.
change-address [name] [new address] Change address of a contact.
search [keyword] Give back list of contacts by keyword (phone, name etc) with partial coincidence.
all Show all contacts.
delete [name] Delete a contacts.
add-note [title] Create a note.
change-note [title] Change a note description.
find-note [title] Find a note by title.
search-note [keyword] Give back list of notes by keyword (tag or title) with partial coincidence.
delete-note [title] Delete a note.
all-notes Show all Notes.
add-tag [note-title] Add a tag to a note.
remove-tag [note-title] Remove tag from note.
close/exit Close the program with saving data.

License

This project is licensed under the MIT License - see the LICENSE file for details.