Implement basic expense tracking

Author: codewithdhruba01

Personal-Expense-Tracker/README.md

@@ -0,0 +1,48 @@
+# Personal Expense Tracker CLI
+
+This is a basic command-line interface (CLI) application built with Python to help you track your daily expenses. It allows you to easily add your expenditures, categorize them, and view your spending patterns over different time periods.
+
+## Features
+
+* **Add New Expense:** Record new expenses by providing the amount, category (e.g., food, travel, shopping, bills), date, and an optional note.
+* **View Expenses:** Display your expenses for a specific day, week, month, or all recorded expenses.
+* **Filter by Category:** View expenses belonging to a particular category.
+* **Data Persistence:** Your expense data is saved to a plain text file (`expenses.txt`) so it's retained between sessions.
+* **Simple Command-Line Interface:** Easy-to-use text-based menu for interacting with the application.
+
+## Technologies Used
+
+* **Python:** The core programming language used for the application logic.
+* **File Handling:** Used to store and retrieve expense data from a text file.
+* **`datetime` module:** For handling and managing date information for expenses.
+
+## How to Run
+
+1.  Make sure you have Python installed on your system.
+2.  Save the `expense_tracker.py` file to your local machine.
+3.  Open your terminal or command prompt.
+4.  Navigate to the directory where you saved the file using the `cd` command.
+5.  Run the application by executing the command: `python expense_tracker.py`
+
+## Basic Usage
+
+1.  Run the script. You will see a menu with different options.
+2.  To add a new expense, choose option `1` and follow the prompts to enter the required information.
+3.  To view expenses, choose option `2` and select the desired time period (day, week, month, or all).
+4.  To filter expenses by category, choose option `3` and enter the category you want to view.
+5.  To save any new expenses (though the application automatically saves on exit as well), choose option `4`.
+6.  To exit the application, choose option `5`.
+
+## Potential Future Enhancements (Ideas for Expansion)
+
+* Implement a monthly budget feature with alerts.
+* Add a login system for multiple users.
+* Generate visual reports like pie charts for category-wise spending (using libraries like `matplotlib`).
+* Incorporate voice input for adding expenses (using `speech_recognition`).
+* Migrate data storage to a more structured database like SQLite.
+
+* Add functionality to export expense data to CSV files.
+
+---
+
+> This simple Personal Expense Tracker provides a basic yet functional way to manage your finances from the command line.

Personal-Expense-Tracker/expense_tracker.py

@@ -0,0 +1,112 @@
+import datetime
+
+def add_expense(expenses):
+    amount = float(input("Enter the expense amount: "))
+    category = input("Category (food, travel, shopping, bills, etc.): ")
+    date_str = input("Date (YYYY-MM-DD): ")
+    try:
+        date = datetime.datetime.strptime(date_str, "%Y-%m-%d").date()
+    except ValueError:
+        print("Incorrect date format. Please use YYYY-MM-DD format.")
+        return
+    note = input("(Optional) Note: ")
+    expenses.append({"amount": amount, "category": category, "date": date, "note": note})
+    print("Expense added!")
+
+def view_expenses(expenses, period="all", category_filter=None):
+    if not expenses:
+        print("No expenses recorded yet.")
+        return
+
+    filtered_expenses = expenses
+    if category_filter:
+        filtered_expenses = [e for e in filtered_expenses if e["category"] == category_filter]
+
+    if period == "day":
+        date_str = input("Enter the date to view expenses for (YYYY-MM-DD): ")
+        try:
+            date = datetime.datetime.strptime(date_str, "%Y-%m-%d").date()
+            filtered_expenses = [e for e in filtered_expenses if e["date"] == date]
+        except ValueError:
+            print("Incorrect date format.")
+            return
+    elif period == "week":
+        date_str = input("Enter the start date of the week (YYYY-MM-DD - first day of the week): ")
+        try:
+            start_date = datetime.datetime.strptime(date_str, "%Y-%m-%d").date()
+            end_date = start_date + datetime.timedelta(days=6)
+            filtered_expenses = [e for e in filtered_expenses if start_date <= e["date"] <= end_date]
+        except ValueError:
+            print("Incorrect date format.")
+            return
+    elif period == "month":
+        year = input("Enter the year for the month (YYYY): ")
+        month = input("Enter the month (MM): ")
+        try:
+            year = int(year)
+            month = int(month)
+            filtered_expenses = [e for e in filtered_expenses if e["date"].year == year and e["date"].month == month]
+        except ValueError:
+            print("Incorrect year or month format.")
+            return
+
+    if not filtered_expenses:
+        print("No expenses found for this period or category.")
+        return
+
+    print("\n--- Expenses ---")
+    total_spent = 0
+    for expense in filtered_expenses:
+        print(f"Amount: {expense['amount']}, Category: {expense['category']}, Date: {expense['date']}, Note: {expense['note']}")
+        total_spent += expense['amount']
+    print(f"\nTotal spent: {total_spent}")
+
+def save_expenses(expenses, filename="expenses.txt"):
+    with open(filename, "w") as f:
+        for expense in expenses:
+            f.write(f"{expense['amount']},{expense['category']},{expense['date']},{expense['note']}\n")
+    print("Expenses saved!")
+
+def load_expenses(filename="expenses.txt"):
+    expenses = []
+    try:
+        with open(filename, "r") as f:
+            for line in f:
+                amount, category, date_str, note = line.strip().split(',')
+                expenses.append({"amount": float(amount), "category": category, "date": datetime.datetime.strptime(date_str, "%Y-%m-%d").date(), "note": note})
+    except FileNotFoundError:
+        pass
+    return expenses
+
+def main():
+    expenses = load_expenses()
+
+    while True:
+        print("\n--- Personal Expense Tracker ---")
+        print("1. Add new expense")
+        print("2. View expenses")
+        print("3. Filter by category")
+        print("4. Save expenses")
+        print("5. Exit")
+
+        choice = input("Choose your option: ")
+
+        if choice == '1':
+            add_expense(expenses)
+        elif choice == '2':
+            period = input("View expenses by (day/week/month/all): ").lower()
+            view_expenses(expenses, period)
+        elif choice == '3':
+            category_filter = input("Enter the category to filter by: ")
+            view_expenses(expenses, category_filter=category_filter)
+        elif choice == '4':
+            save_expenses(expenses)
+        elif choice == '5':
+            save_expenses(expenses)
+            print("Thank you!")
+            break
+        else:
+            print("Invalid option. Please try again.")
+
+if __name__ == "__main__":
+    main()