Expense Tracker - Effortlessly manage your expenses through a simple command-line interface.

Projects Leaderboard

Pitch

Description

Comments

Expense Tracker

oheyek

Effortlessly manage your expenses through a simple command-line interface.

Visit project

Pitch

Expense Tracker is a lightweight command-line tool for managing personal finances. Built with Python, it allows users to easily add, list, summarize, and delete expenses, making budgeting simple and efficient. With JSON-based storage, keep track of all spending with clear and organized data.

Description

Expense Tracker CLI

Expense Tracker CLI is a lightweight command-line tool designed for effortless expense management using Python. This solution enables efficient tracking of spending through seamless commands and stores data in a JSON format, ensuring both simplicity and clarity.

Features

Simple & Fast Operations: Execute commands to add, list, summarize, and delete expenses with ease.
Automatic ID Management: Each expense is assigned a unique, auto-incrementing ID for straightforward reference.
Date Tracking: Automatically records the date of each expense for accurate tracking.
Monthly Summaries: Quickly access total expenses for specific months or view comprehensive totals.
Human-Readable JSON Storage: All expenses are stored in a human-readable expenses.json file.
Flexible Filtering Options: Summarize expenses by month or view all entries at once.
Robust Error Handling: Includes input validation and detailed error messages to aid user experience.

Usage Examples

Adding Expenses
Use the following command to add expenses:

expense-tracker add --description "Lunch" --amount 20
expense-tracker add --description "Coffee" --amount 5.50
expense-tracker add --description "Gas" --amount 45.75

Listing Expenses
To view all recorded expenses, simply execute:

expense-tracker list

Summarizing Expenses
Obtain total expenses using:

expense-tracker summary
# Or for a specific month:
expense-tracker summary --month 8

Deleting Expenses
Remove an expense by its ID with:

expense-tracker delete --id 1

Command Reference

Command	Arguments	Description	Example
`add`	`--description <text> --amount <number>`	Add a new expense	`expense-tracker add --description "Groceries" --amount 85.50`
`list`	None	List all expenses	`expense-tracker list`
`summary`	`[--month <1-12>]`	Show total expenses by month or overall	`expense-tracker summary --month 3`
`delete`	`--id <number>`	Delete an expense by ID	`expense-tracker delete --id 5`

Performance and Technical Details

Programming Language: Python 3.8+
Storage Method: Persistent JSON file storage
Error Handling: Includes comprehensive input validation to enhance user interaction.
Date Format: Adheres to ISO format (YYYY-MM-DD), providing consistency across records.

Use Cases

Personal Finance Tracking: Efficiently log daily expenses and review weekly summaries.
Monthly Budget Management: Analyze monthly expenses and compare performance across months.
Categorizing Expenses: Identify spending patterns in specific areas, such as dining or transportation.

Expense Tracker CLI is an effective tool for individuals seeking to maintain control over their finances with minimal fuss. The intuitive design and efficient functionality cater to users looking for an accessible solution to expense tracking.