Expense-Tracker-and-Analysis

• Package pypi link: tdexpta

• How to install and use Video Click here

• Code coverage report screenshot -

Package: ExpenseTrackerAndAnalysis

This package is best used via the run.py file as an application. It will help users who want to get some insights into their spending habits from their credit card statements. This package will help them add expenses, categorize them, and aggregate them in different ways. To see how to run individual subpackages, inspect the driver.py. There is a sample csv file available.

Sub-Package: data

Module1: store_data

• add_csv: Adds a csv file [only td bank credit card statement in csv format is supported] to the dataframe. Arguments: filename
• add_expenses: add individual expense to dataframe. Arguments: category list [default], user_date, user_shopname, user_amount, user_category
• show_expenses: prints out all the expenses so the user can see it. Arguments: Default arguments are row index start = 0 and row index end = length of dataframe
• export_expenses: export the expenses into a new csv file. Arguments: newfilename
• delete_expenses: deletes a specific expense according to which row index. Argument: whichrow

Module2: categorize_data

• categorize_all: iterates over every item in the datafram that doesn't already have a category, prompting user to choose a category. Arguments: df, catlist(default), dict_cat_shop(default)
• categorize_item: Categorize a specific expense according to name or row index, prompts user. Arguments: df, catlist, dict_cat_shop
• update_category: Update a category name, prompts user. Arguments: df, catlist, dict_cat_shop
• add_category: Add a category, prompts user. Arguments: catlist

Sub-Package: analysis

Module1: search

• search_date: shows transactions from a user inputed day/month/year
• search_category: shows transactions from user input category
• search_amount: shows transactions from user input range of spending amount

Module2: analysis

• total_expense: returns the total expenses. Arguments: df
• income_expense_ratio: shows the user the ratio of their spending vs their income. Arguments: income
• category_percentage: shows the percentage of every category in total expenses. No arguments
• category_average: outputs the monthly averages of every category over a specified range of months. No arguments.