Metadata-Version: 2.2
Name: libre-finance
Version: 0.0.1
Summary: This tool helps financial consumers freely utilize financial services by interest calculating.
Author-email: minwook-shin <minwook0106@gmail.com>
Project-URL: Homepage, https://github.com/minwook-shin/libre-finance
Project-URL: Bug Tracker, https://github.com/minwook-shin/libre-finance/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# LibreFinance

LibreFinance is a combination of the words "libre" and "finance". 

This tool helps financial consumers freely utilize financial services by interest calculating.

##  Important Notice

> In South Korea, the general interest income tax rate is 15.4% (14% interest income tax + 1.4% local tax). Please be aware of this when using the tool.

## Usage

1. Install the library using `pip install libre-finance`.
2. Import the library with `from libre_finance import LibreFinance`.

## Example

```python
from libre_finance import LibreFinance

# deposit example
lf = LibreFinance(amount=12000000, currency='KRW')
print(lf.calculate_deposit(month=6, annual_interest_rate=3.5))
print(f"amount: {lf.amount}")

# deposit example with non-taxable interest
lf = LibreFinance(amount=12000000, currency='KRW')
print(lf.calculate_deposit(month=6, annual_interest_rate=3.5, is_tax=False))
print(f"amount: {lf.amount}")

# savings example
lf = LibreFinance(amount=0, currency='KRW')
print(lf.calculate_savings(month=6, monthly_deposit=1000000, annual_interest_rate=3.5))
print(f"amount: {lf.amount}")

# savings example with non-taxable interest
lf = LibreFinance(amount=0, currency='KRW')
print(lf.calculate_savings(month=6, monthly_deposit=1000000, is_tax=False, annual_interest_rate=3.5))
print(f"amount: {lf.amount}")
```

## Features

- Deposit interest (taxable/non-taxable)
- Savings interest (taxable/non-taxable)

## ToDo List

- Bond interest
- RP interest

## License

MIT
