Merge pull request #2 from Infinitode/feature/python-project-ideas

Feat: Add new Python project ideas and update README

Author: Infinitode

Beginner/14_address_book.py

@@ -0,0 +1,62 @@
+import json
+import os
+
+CONTACTS_FILE = "contacts.json"
+
+def load_contacts():
+    if os.path.exists(CONTACTS_FILE):
+        with open(CONTACTS_FILE, "r") as f:
+            return json.load(f)
+    return {}
+
+def save_contacts(contacts):
+    with open(CONTACTS_FILE, "w") as f:
+        json.dump(contacts, f, indent=4)
+
+def add_contact(contacts):
+    name = input("Enter name: ")
+    phone = input("Enter phone number: ")
+    email = input("Enter email address: ")
+    contacts[name] = {"phone": phone, "email": email}
+    save_contacts(contacts)
+    print(f"Contact '{name}' added.")
+
+def view_contacts(contacts):
+    if not contacts:
+        print("No contacts found.")
+        return
+    for name, info in contacts.items():
+        print(f"Name: {name}, Phone: {info['phone']}, Email: {info['email']}")
+
+def delete_contact(contacts):
+    name = input("Enter the name of the contact to delete: ")
+    if name in contacts:
+        del contacts[name]
+        save_contacts(contacts)
+        print(f"Contact '{name}' deleted.")
+    else:
+        print("Contact not found.")
+
+def main():
+    contacts = load_contacts()
+    while True:
+        print("\nAddress Book Menu:")
+        print("1. Add Contact")
+        print("2. View Contacts")
+        print("3. Delete Contact")
+        print("4. Exit")
+        choice = input("Enter your choice: ")
+
+        if choice == "1":
+            add_contact(contacts)
+        elif choice == "2":
+            view_contacts(contacts)
+        elif choice == "3":
+            delete_contact(contacts)
+        elif choice == "4":
+            break
+        else:
+            print("Invalid choice. Please try again.")
+
+if __name__ == "__main__":
+    main()

Beginner/15_pomodoro_timer.py

@@ -0,0 +1,30 @@
+import time
+
+def countdown(minutes):
+    seconds = minutes * 60
+    while seconds > 0:
+        mins, secs = divmod(seconds, 60)
+        timer = f"{mins:02d}:{secs:02d}"
+        print(timer, end="\r")
+        time.sleep(1)
+        seconds -= 1
+
+def main():
+    print("Pomodoro Timer")
+    while True:
+        try:
+            work_minutes = int(input("Enter work duration in minutes: "))
+            break_minutes = int(input("Enter break duration in minutes: "))
+            break
+        except ValueError:
+            print("Invalid input. Please enter a number.")
+
+    while True:
+        print("Work session started.")
+        countdown(work_minutes)
+        print("Work session finished. Take a break!")
+        countdown(break_minutes)
+        print("Break finished. Time to get back to work!")
+
+if __name__ == "__main__":
+    main()

Beginner/16_budget_tracker.py

@@ -0,0 +1,74 @@
+import json
+import os
+
+BUDGET_FILE = "budget.json"
+
+def load_data():
+    if os.path.exists(BUDGET_FILE):
+        with open(BUDGET_FILE, "r") as f:
+            return json.load(f)
+    return {"income": [], "expenses": []}
+
+def save_data(data):
+    with open(BUDGET_FILE, "w") as f:
+        json.dump(data, f, indent=4)
+
+def add_transaction(data, transaction_type):
+    try:
+        amount = float(input("Enter amount: "))
+        description = input("Enter description: ")
+        data[transaction_type].append({"amount": amount, "description": description})
+        save_data(data)
+        print(f"{transaction_type.capitalize()} added.")
+    except ValueError:
+        print("Invalid amount. Please enter a number.")
+
+def view_transactions(data):
+    print("\n--- Income ---")
+    if not data["income"]:
+        print("No income recorded.")
+    else:
+        for item in data["income"]:
+            print(f"${item['amount']:.2f}: {item['description']}")
+
+    print("\n--- Expenses ---")
+    if not data["expenses"]:
+        print("No expenses recorded.")
+    else:
+        for item in data["expenses"]:
+            print(f"${item['amount']:.2f}: {item['description']}")
+
+def calculate_balance(data):
+    total_income = sum(item["amount"] for item in data["income"])
+    total_expenses = sum(item["amount"] for item in data["expenses"])
+    balance = total_income - total_expenses
+    print(f"\nTotal Income: ${total_income:.2f}")
+    print(f"Total Expenses: ${total_expenses:.2f}")
+    print(f"Balance: ${balance:.2f}")
+
+def main():
+    data = load_data()
+    while True:
+        print("\nBudget Tracker Menu:")
+        print("1. Add Income")
+        print("2. Add Expense")
+        print("3. View Transactions")
+        print("4. View Balance")
+        print("5. Exit")
+        choice = input("Enter your choice: ")
+
+        if choice == "1":
+            add_transaction(data, "income")
+        elif choice == "2":
+            add_transaction(data, "expenses")
+        elif choice == "3":
+            view_transactions(data)
+        elif choice == "4":
+            calculate_balance(data)
+        elif choice == "5":
+            break
+        else:
+            print("Invalid choice. Please try again.")
+
+if __name__ == "__main__":
+    main()

Intermediate/2_adventure_game.py

@@ -0,0 +1,57 @@
+import time
+
+def print_slow(text):
+    for char in text:
+        print(char, end='', flush=True)
+        time.sleep(0.03)
+    print()
+
+def get_choice(choices):
+    while True:
+        for i, choice in enumerate(choices, 1):
+            print(f"{i}. {choice}")
+        try:
+            choice = int(input("Enter your choice: "))
+            if 1 <= choice <= len(choices):
+                return choice
+            else:
+                print("Invalid choice. Please try again.")
+        except ValueError:
+            print("Invalid input. Please enter a number.")
+
+def intro():
+    print_slow("You wake up in a dark, cold room.")
+    print_slow("You see a door in front of you.")
+    print_slow("What do you do?")
+    choice = get_choice(["Open the door", "Look for a light switch"])
+    if choice == 1:
+        open_door()
+    else:
+        light_switch()
+
+def open_door():
+    print_slow("The door is locked.")
+    print_slow("You need a key.")
+    intro()
+
+def light_switch():
+    print_slow("You find a light switch and flick it on.")
+    print_slow("The room is empty except for a small key on the floor.")
+    print_slow("What do you do?")
+    choice = get_choice(["Pick up the key", "Go back to the door"])
+    if choice == 1:
+        pick_up_key()
+    else:
+        open_door()
+
+def pick_up_key():
+    print_slow("You pick up the key.")
+    print_slow("You go back to the door and unlock it.")
+    print_slow("You have escaped the room!")
+    print_slow("Congratulations!")
+
+def main():
+    intro()
+
+if __name__ == "__main__":
+    main()

README.md

@@ -470,6 +470,69 @@ These projects are ideal for those new to Python. Each project includes a descri
 
     </details>
 
+### 14. Address Book
+- **Description**: A simple command-line contact manager.
+- **Solution**: https://github.com/Infinitode/Python-Projects/blob/main/Beginner/14_address_book.py
+- **Steps**:
+  1. Create functions to add, view, and delete contacts.
+  2. Store contacts in a file (e.g., JSON).
+  3. Create a main loop to interact with the user.
+- **Tips:**
+
+    </summary>
+    <details><summary>Tip 1:</summary>
+
+    Use a dictionary to store contact information.
+
+    </details>
+    <details><summary>Tip 2:</summary>
+
+    Use the `json` module to save and load contacts from a file.
+
+    </details>
+
+### 15. Pomodoro Timer
+- **Description**: A time management tool to help you stay focused.
+- **Solution**: https://github.com/Infinitode/Python-Projects/blob/main/Beginner/15_pomodoro_timer.py
+- **Steps**:
+  1. Create a function to run a countdown timer.
+  2. Prompt the user for work and break durations.
+  3. Alternate between work and break sessions.
+- **Tips:**
+
+    </summary>
+    <details><summary>Tip 1:</summary>
+
+    Use the `time` module to pause execution.
+
+    </details>
+    <details><summary>Tip 2:</summary>
+
+    Use a loop to alternate between work and break sessions.
+
+    </details>
+
+### 16. Budget Tracker
+- **Description**: A tool to track your income and expenses.
+- **Solution**: https://github.com/Infinitode/Python-Projects/blob/main/Beginner/16_budget_tracker.py
+- **Steps**:
+  1. Create functions to add income and expenses.
+  2. Store transactions in a file (e.g., JSON).
+  3. Calculate and display the current balance.
+- **Tips:**
+
+    </summary>
+    <details><summary>Tip 1:</summary>
+
+    Use lists of dictionaries to store income and expense transactions.
+
+    </details>
+    <details><summary>Tip 2:</summary>
+
+    Use the `json` module to save and load transaction data.
+
+    </details>
+
 ## Intermediate Projects
 These projects are ideal for those with experience in Python. Each project includes a description, steps to follow, and tips for completing it.
 
@@ -505,6 +568,27 @@ These projects are ideal for those with experience in Python. Each project inclu
 > [!NOTE]
 > Working code solutions are in the `/Intermediate` folder.
 
+### 2. Text-based Adventure Game
+- **Description**: An interactive fiction game where you can explore and make choices.
+- **Solution**: https://github.com/Infinitode/Python-Projects/blob/main/Intermediate/2_adventure_game.py
+- **Steps**:
+  1. Create a story with different rooms and choices.
+  2. Use functions to represent different parts of the story.
+  3. Get user input to navigate through the story.
+- **Tips:**
+
+    </summary>
+    <details><summary>Tip 1:</summary>
+
+    Use a dictionary to define the game world, with rooms, descriptions, and choices.
+
+    </details>
+    <details><summary>Tip 2:</summary>
+
+    Use a loop to keep the game running until the player reaches an end state.
+
+    </details>
+
 ## Contributing
 Contributions are welcome! If you have project ideas or improvements, feel free to fork the repository and open a pull request.