Merge pull request #18 from Sneha-S-D/Personal-Finance-Tracker

Added personal finance tracker project

Author: king04aman

personal-finance-tracker/README.md

@@ -0,0 +1,30 @@
+Personal Finance Tracker
+
+Project Overview:
+The Personal Finance Tracker is a simple command-line application that helps users track their income, expenses, and savings goals. It also provides visualizations of spending patterns to better understand financial habits. The project uses SQLite for data storage and Matplotlib for creating various financial charts.
+
+Features:
+Add Income: Record income entries with descriptions and amounts.
+Add Expense: Record expenses, categorize them, and add descriptions.
+View Summary: View a summary of total income, expenses, and balance.
+Set Savings Goals: Define and track savings goals.
+Visualize Spending: Generate various charts (bar chart, pie chart, line chart, etc.) to better understand your spending habits.
+
+Technologies Used:
+Python: Core programming language.
+SQLite3: Local database for storing transaction records.
+Matplotlib: Python library for generating visualizations.
+
+
+To run the program:
+1] Clone the repository
+2] Navigate to Personal Finance Tracker folder
+3] Run the main.py file
+
+When you run the application, a menu will appear with the following options:
+
+Add Income: Enter the amount and description of your income.
+Add Expense: Enter the amount, category, and description of the expense.
+View Summary: See your total income, expenses, and remaining balance.
+Set Savings Goal: Set a savings goal to track progress.
+Visualize Spending: Choose from various charts to visualize your spending patterns.

personal-finance-tracker/database.py

@@ -0,0 +1,33 @@
+import sqlite3
+
+DB_FILE = "data/finance.db"
+
+def get_connection():
+    conn = sqlite3.connect(DB_FILE)
+    return conn
+
+def initialize_database():
+    conn = get_connection()
+    cursor = conn.cursor()
+
+    # Create income and expense table
+    cursor.execute('''
+        CREATE TABLE IF NOT EXISTS transactions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            type TEXT NOT NULL,
+            category TEXT NOT NULL,
+            amount REAL NOT NULL,
+            date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    ''')
+
+    # Create table for savings goal
+    cursor.execute('''
+        CREATE TABLE IF NOT EXISTS savings_goal (
+            id INTEGER PRIMARY KEY,
+            goal_amount REAL NOT NULL
+        )
+    ''')
+
+    conn.commit()
+    conn.close()

personal-finance-tracker/main.py

@@ -0,0 +1,36 @@
+import tracker
+import savings
+import visualization
+import database
+
+def main_menu():
+    while True:
+        print("\n--- Personal Finance Tracker ---")
+        print("1. Add Income")
+        print("2. Add Expense")
+        print("3. View Summary")
+        print("4. Set Savings Goal")
+        print("5. Visualize Spending")
+        print("6. Exit")
+        
+        choice = input("Choose an option: ")
+
+        if choice == "1":
+            tracker.add_income()
+        elif choice == "2":
+            tracker.add_expense()
+        elif choice == "3":
+            tracker.view_summary()
+        elif choice == "4":
+            savings.set_goal()
+        elif choice == "5":
+            visualization.visualize_data()
+        elif choice == "6":
+            print("Exiting...")
+            break
+        else:
+            print("Invalid option. Please try again.")
+
+if __name__ == "__main__":
+    database.initialize_database() 
+    main_menu()

personal-finance-tracker/savings.py

@@ -0,0 +1,31 @@
+from database import get_connection
+
+def set_goal():
+    goal_amount = float(input("Enter your savings goal: "))
+    
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("INSERT OR REPLACE INTO savings_goal (id, goal_amount) VALUES (1, ?)", (goal_amount,))
+    conn.commit()
+    conn.close()
+    
+    print(f"Savings goal of {goal_amount} set successfully!")
+
+def track_savings_progress(balance):
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("SELECT goal_amount FROM savings_goal WHERE id = 1")
+    goal_row = cursor.fetchone()
+    conn.close()
+    
+    if goal_row:
+        goal_amount = goal_row[0]
+        remaining = goal_amount - balance
+        if remaining > 0:
+            print(f"You need to save {remaining} more to reach your goal.")
+        else:
+            print(f"Congratulations! You've reached your savings goal.")
+    else:
+        print("No savings goal set.")

personal-finance-tracker/tracker.py

@@ -0,0 +1,48 @@
+import sqlite3
+from database import get_connection
+
+def add_income():
+    category = input("Enter income source (e.g., Salary, Freelance): ")
+    amount = float(input("Enter amount: "))
+    
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("INSERT INTO transactions (type, category, amount) VALUES (?, ?, ?)", 
+                   ("Income", category, amount))
+    conn.commit()
+    conn.close()
+    
+    print("Income added successfully!")
+
+def add_expense():
+    category = input("Enter expense category (e.g., Rent, Groceries): ")
+    amount = float(input("Enter amount: "))
+    
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("INSERT INTO transactions (type, category, amount) VALUES (?, ?, ?)", 
+                   ("Expense", category, amount))
+    conn.commit()
+    conn.close()
+    
+    print("Expense added successfully!")
+
+def view_summary():
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("SELECT SUM(amount) FROM transactions WHERE type = 'Income'")
+    total_income = cursor.fetchone()[0] or 0.0
+    
+    cursor.execute("SELECT SUM(amount) FROM transactions WHERE type = 'Expense'")
+    total_expenses = cursor.fetchone()[0] or 0.0
+    
+    balance = total_income - total_expenses
+    
+    conn.close()
+    
+    print(f"\nTotal Income: {total_income}")
+    print(f"Total Expenses: {total_expenses}")
+    print(f"Balance: {balance}")

personal-finance-tracker/visualization.py

@@ -0,0 +1,139 @@
+import matplotlib.pyplot as plt
+from database import get_connection
+
+def bar_chart_expense():
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("SELECT category, SUM(amount) FROM transactions WHERE type = 'Expense' GROUP BY category")
+    rows = cursor.fetchall()
+    conn.close()
+    
+    if rows:
+        categories = [row[0] for row in rows]
+        amounts = [row[1] for row in rows]
+        
+        plt.bar(categories, amounts)
+        plt.xlabel('Category')
+        plt.ylabel('Amount')
+        plt.title('Spending by Category')
+        plt.xticks(rotation=45)
+        plt.tight_layout()
+        plt.show()
+    else:
+        print("No expenses recorded yet.")
+
+def pie_chart_expense():
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("SELECT category, SUM(amount) FROM transactions WHERE type = 'Expense' GROUP BY category")
+    rows = cursor.fetchall()
+    conn.close()
+    
+    if rows:
+        categories = [row[0] for row in rows]
+        amounts = [row[1] for row in rows]
+        
+        plt.pie(amounts, labels=categories, autopct='%1.1f%%', startangle=90)
+        plt.title('Spending by Category')
+        plt.tight_layout()
+        plt.show()
+    else:
+        print("No expenses recorded yet.")
+
+def line_chart_expense_over_time():
+    conn = get_connection()
+    cursor = conn.cursor()
+    
+    cursor.execute("SELECT date, SUM(amount) FROM transactions WHERE type = 'Expense' GROUP BY date")
+    rows = cursor.fetchall()
+    conn.close()
+    
+    if rows:
+        dates = [row[0] for row in rows]
+        amounts = [row[1] for row in rows]
+        
+        plt.plot(dates, amounts, marker='o')
+        plt.xlabel('Date')
+        plt.ylabel('Amount')
+        plt.title('Expenses Over Time')
+        plt.xticks(rotation=45)
+        plt.tight_layout()
+        plt.show()
+    else:
+        print("No expenses recorded yet.")
+
+def stacked_bar_chart_income_expense():
+    conn = get_connection()
+    cursor = conn.cursor()
+
+    cursor.execute("SELECT date, SUM(amount) FROM transactions WHERE type = 'Income' GROUP BY date")
+    income_rows = cursor.fetchall()
+
+    cursor.execute("SELECT date, SUM(amount) FROM transactions WHERE type = 'Expense' GROUP BY date")
+    expense_rows = cursor.fetchall()
+    
+    conn.close()
+
+    if income_rows and expense_rows:
+        income_dates = [row[0] for row in income_rows]
+        income_amounts = [row[1] for row in income_rows]
+        expense_dates = [row[0] for row in expense_rows]
+        expense_amounts = [row[1] for row in expense_rows]
+
+        plt.bar(income_dates, income_amounts, label='Income')
+        plt.bar(expense_dates, expense_amounts, bottom=income_amounts, label='Expense')
+
+        plt.xlabel('Date')
+        plt.ylabel('Amount')
+        plt.title('Income vs Expenses Over Time')
+        plt.xticks(rotation=45)
+        plt.legend()
+        plt.tight_layout()
+        plt.show()
+    else:
+        print("Not enough data to generate this chart.")
+
+def histogram_expense_distribution():
+    conn = get_connection()
+    cursor = conn.cursor()
+
+    cursor.execute("SELECT amount FROM transactions WHERE type = 'Expense'")
+    rows = cursor.fetchall()
+    conn.close()
+
+    if rows:
+        amounts = [row[0] for row in rows]
+
+        plt.hist(amounts, bins=10)
+        plt.xlabel('Expense Amount')
+        plt.ylabel('Frequency')
+        plt.title('Expense Distribution')
+        plt.tight_layout()
+        plt.show()
+    else:
+        print("No expenses recorded yet.")
+
+def visualize_data():
+    print("\n--- Visualization Menu ---")
+    print("1. Bar Chart (Spending by Category)")
+    print("2. Pie Chart (Spending by Category)")
+    print("3. Line Chart (Expenses Over Time)")
+    print("4. Stacked Bar Chart (Income vs Expenses)")
+    print("5. Histogram (Expense Distribution)")
+    
+    choice = input("Select a visualization option (1-5): ")
+
+    if choice == "1":
+        bar_chart_expense()
+    elif choice == "2":
+        pie_chart_expense()
+    elif choice == "3":
+        line_chart_expense_over_time()
+    elif choice == "4":
+        stacked_bar_chart_income_expense()
+    elif choice == "5":
+        histogram_expense_distribution()
+    else:
+        print("Invalid choice. Please select a valid option.")