expenteto

A simple command-line expense tracker that stores your expenses in a JSON file.

Project made for: https://roadmap.sh/projects/expense-tracker

Installation

git clone https://github.com/yourusername/expenteto.git
cd expenteto
pip install -e .

Usage

expenteto <action> [options]

Actions

Add an expense

expenteto add -d <description> -a <amount>

Flag	Description
-d, --description	Short description of the expense (required)
-a, --amount	Amount of the expense in whole numbers (required)

Example:

expenteto add -d "Grocery shopping" -a 50

---

List expenses

expenteto list [options]

Flag	Description
-s, --summary	Show total sum instead of full list
-m, --month	Filter by month number (1-12)

Examples:

# List all expenses
expenteto list

# Show total of all expenses
expenteto list --summary

# List expenses for March
expenteto list --month 3

# Show total for March
expenteto list --month 3 --summary

---

Update an expense

expenteto update --id <id> [options]

Flag	Description
--id	ID of the expense to update (required)
-d, --description	New description
-a, --amount	New amount

At least one of --description or --amount must be provided.

Example:

expenteto update --id 3 -d "Supermarket" -a 60

---

Delete an expense

expenteto delete --id <id>

Flag	Description
--id	ID of the expense to delete (required)

Example:

expenteto delete --id 3

---

Data Storage

Expenses are stored locally in a JSON file. Each expense contains an ID, description, amount, and date.