https://github.com/sahaavi/expense-tracker-and-analysis

One can Analyze TD Bank statement (.csv) using this package,
https://github.com/sahaavi/expense-tracker-and-analysis

beginner-friendly beginner-project expense-tracker expense-tracker-app package project python3

Last synced: about 10 hours ago
JSON representation

One can Analyze TD Bank statement (.csv) using this package,

• Host: GitHub
• URL: https://github.com/sahaavi/expense-tracker-and-analysis
• Owner: sahaavi
• License: mit
• Created: 2022-12-01T20:32:04.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-01-15T04:04:56.000Z (almost 2 years ago)
• Last Synced: 2024-10-28T22:17:08.793Z (9 days ago)
• Topics: beginner-friendly, beginner-project, expense-tracker, expense-tracker-app, package, project, python3
• Language: Python
• Homepage:
• Size: 310 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Expense-Tracker-and-Analysis

[![Release][release-shield]][release-url]

[![Forks][forks-shield]][forks-url]

[![Downloads][downloads-shield]][downloads-url]

[![Stargazers][stars-shield]][stars-url]

[![MIT License][license-shield]][license-url]

[release-shield]: https://img.shields.io/github/v/release/sahaavi/Expense-Tracker-and-Analysis.svg?style=flat-square

[release-url]: https://github.com/sahaavi/Expense-Tracker-and-Analysis/releases

[forks-shield]: https://img.shields.io/github/forks/sahaavi/Expense-Tracker-and-Analysis.svg?style=flat-square

[forks-url]: https://github.com/sahaavi/Expense-Tracker-and-Analysis/network/members

[downloads-shield]: https://img.shields.io/github/downloads/sahaavi/Expense-Tracker-and-Analysis/total.svg?style=flat-square

[downloads-url]: https://github.com/sahaavi/Expense-Tracker-and-Analysis

[stars-shield]: https://img.shields.io/github/stars/sahaavi/Expense-Tracker-and-Analysis.svg?style=flat-square

[stars-url]: https://github.com/sahaavi/Expense-Tracker-and-Analysis/stargazers

[license-shield]: https://img.shields.io/github/license/sahaavi/Expense-Tracker-and-Analysis.svg?style=flat-square

[license-url]: https://github.com/sahaavi/Expense-Tracker-and-Analysis/blob/master/LICENSE

[![Build Status](https://app.travis-ci.com/sahaavi/Expense-Tracker-and-Analysis.svg?branch=main)](https://app.travis-ci.com/sahaavi/Expense-Tracker-and-Analysis)

- Package pypi link: [tdexpta]

[tdexpta]: https://pypi.org/project/tdexpta/

- How to install and use Video [Click here]

[Click here]: https://youtu.be/yd25D19YSLc

- Code coverage report screenshot - 

![My Image](https://raw.githubusercontent.com/sahaavi/Expense-Tracker-and-Analysis/main/tests/coverage_report.jpg)

# 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.