Metadata-Version: 2.4
Name: expenseutils
Version: 1.0.1
Summary: Utility functions for the CareCash expense tracker
Author: Amirthavarshini M
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-python
Dynamic: summary

# expenseutils

Utility functions for the **CareCash** expense tracker — a cloud-based personal finance app built on AWS.

## Functions

### `summarise(expenses)`
Groups a list of expense dictionaries by category and returns a dict of `{category: total}`.

```python
from expenseutils import summarise

expenses = [
    {'category': 'Food', 'amount': 20.0},
    {'category': 'Transport', 'amount': 10.0},
    {'category': 'Food', 'amount': 15.0},
]
print(summarise(expenses))
# {'Food': 35.0, 'Transport': 10.0}
```

### `check_budget(monthly_total, budget)`
Returns a status dict based on spending vs budget.

```python
from expenseutils import check_budget

result = check_budget(85.0, 100.0)
# {'status': 'warning', 'message': 'You are close to your budget limit.'}
```

**Status values:** `ok`, `warning`, `exceeded`

## Installation

```bash
pip install expenseutils
```

## Author
Amirthavarshini M — MSc Cloud Computing, NCI Dublin
