Metadata-Version: 2.4
Name: chidera-ledgerlite
Version: 0.1.0
Summary: 
Author: Chiboy1i
Author-email: chideraukegbu28@gmal.com
Requires-Python: >=3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: requests (>=2.34.2,<3.0.0)
Description-Content-Type: text/markdown

# Chidera LedgerLite

A lightweight SQLite-backed expense tracking ledger and CLI tool.

- **PyPI Package:** https://pypi.org/project/chidera-ledgerlite/

## Installation

```bash
pip install chidera-ledgerlite
```

## Usage

*CLI Command*
```bash
ledgerlite add 5000 NGN food
```

*Python Import*
```bash
from datetime import date

from chidera_ledgerlite.storage import Expense, Ledger

ledger = Ledger()
ledger.add(Expense(amount=5000, currency="NGN", category="food", date=date.today()))
```

## Caret Version Constraint (^)

In dependency configuration, the caret symbol **(^)** permits updates that do not modify the left-most non-zero digit.
For example, a constraint like ^2.34.2 allows updating to any version in the range >=2.34.2, <3.0.0.
This automatically pulls in non-breaking minor updates and patch bug fixes (such as 2.35.0 or 2.34.3).
Crucially, it prevents automatic upgrades to major versions (like 3.0.0) that could introduce breaking changes to your project.
