Contact-Manager

Contact Manager

A simple Python-based contact management system that allows users to add, search, and display contacts. This project demonstrates fundamental Python concepts like classes, functions, user input, and control flow, making it an excellent example for beginners looking to enhance their programming skills.

Table of Contents

1. Features
2. Installation
3. Usage
4. Examples
5. Contributing
6. License

Features

• Add Contacts: Easily add new contacts with a name, email, and phone number.
• Search Contacts: Search for a contact by name.
• Display Contacts: View all contacts currently stored in the system.
• Simple and Interactive: Easy-to-use command-line interface for managing contacts.

Installation

To get started with the Contact Manager, follow these steps:

1. Clone the Repository:

   git clone https://github.com/your-username/contact-manager.git
   

2. Navigate to the Directory:

   cd contact-manager
   

3. Run the Script:

   Make sure you have Python installed. Then, run the script using:

   python contact_manager.py
   

Usage

Once the script is running, follow the on-screen prompts to manage your contacts:

1. Add Contact: Enter contact details (name, email, phone number) to add a new contact.
2. Search Contact: Enter the name of the contact you want to search for.
3. Display All Contacts: View a list of all contacts currently stored.
4. Exit: Close the program.

Running the Program

To run the script, use the following command:

python contact_manager.py

Follow the prompts to add, search, and display contacts.

Examples

1. Adding a Contact

After selecting the “Add Contact” option, you will be prompted to enter the contact’s details:

Enter name: John Doe
Enter email: john.doe@example.com
Enter phone number: 123-456-7890

Output:

Contact 'John Doe' added successfully!

2. Searching for a Contact

Select the “Search Contact” option and enter the name of the contact:

Enter the name to search: John Doe

Output:

Contact Found: Name: John Doe, Email: john.doe@example.com, Phone: 123-456-7890

3. Displaying All Contacts

Select the “Display All Contacts” option to see a list of all contacts:

Output:

Contacts List:
Name: John Doe, Email: john.doe@example.com, Phone: 123-456-7890

Contributing

Contributions are welcome! If you have suggestions for new features or improvements, feel free to create a pull request or open an issue.

Steps to Contribute

1. Fork the Repository: Click on the ‘Fork’ button in the top right corner of this repository.

2. Clone Your Fork: Clone your forked repository to your local machine.

   git clone https://github.com/your-username/contact-manager.git
   

3. Create a Branch: Create a new branch for your feature or bugfix.

   git checkout -b feature/your-feature-name
   

4. Make Changes: Make your changes and commit them with a descriptive message.

   git commit -m "Add: feature description"
   

5. Push Changes: Push your changes to your forked repository.

   git push origin feature/your-feature-name
   

6. Create a Pull Request: Go to the original repository on GitHub and create a pull request.

License

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

---

Thank you for using the Contact Manager! If you have any questions or feedback, feel free to reach out. Happy coding! 😊

This site is open source. Improve this page.