Metadata-Version: 2.1
Name: procenty
Version: 0.3.1
Summary: Biblioteka Python do symulacji finansowych: kredyty, lokaty, inflacja, stopy procentowe, RRSO.
Home-page: https://github.com/szalaj/procenty
License: MIT
Keywords: finanse,kredyt,rrso,inflacja,lokata,stopy-procentowe
Author: szalaj
Author-email: mszalajski@gmail.com
Requires-Python: >=3.10
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Provides-Extra: mcp
Requires-Dist: loguru (>=0.7.2,<0.8.0)
Requires-Dist: mcp (>=1.0.0) ; extra == "mcp"
Requires-Dist: pandas (>=2.2.2,<3.0.0)
Requires-Dist: pendulum (>=2.1.2)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Requires-Dist: scipy (>=1.11.4,<2.0.0)
Project-URL: Repository, https://github.com/szalaj/procenty
Description-Content-Type: text/markdown

# Procenty

Biblioteka Python do symulacji finansowych: kredyty hipoteczne, lokaty, inflacja, stopy procentowe.

## Instalacja

```bash
pip install procenty
# lub w trybie deweloperskim:
poetry install
```

## Moduły

| Moduł | Opis |
|-------|------|
| `kredyt` | Symulacja kredytów hipotecznych (raty równe/malejące, nadpłaty, wakacje, transze, zmienne stopy) |
| `inwestycja` | Lokaty, XIRR, XNPV, IRR, RRSO, MPKK |
| `inflacja` | Urealnianie wartości pieniądza w czasie, interpolacja CPI |
| `stopy` | Krzywa stóp procentowych (cubic spline) |
| `miary` | Dni odsetkowe z uwzględnieniem lat przestępnych, klasa Zloty |
| `konto` | System księgowy z podwójnym zapisem, agenci, wymiana zasobów |

## Szybki start

```python
from procenty.kredyt import Kredyt
from decimal import Decimal
from datetime import datetime

# Kredyt 400k PLN, 35 lat, raty równe
k = Kredyt(
    K=Decimal(400000), N=420,
    r=Decimal("0.076"), marza=Decimal("0.04"),
    start=datetime(2021, 10, 13), rodzajRat='rowne'
)
print(f"XIRR: {k.xirr:.4f}")
print(f"Suma odsetek: {k.podsumowanie['info']['suma_odsetek']} PLN")
```

## Przykłady

Katalog `przyklady/` zawiera skrypty demonstracyjne:
- `kredyt1.py` - kredyty z nadpłatami i porównania
- `inflacja_przyklad.py` - urealnianie wartości
- `gospodarka.py` - model IS-LM + kredyt
- `zasoby.py` - grafy zasobów (prototyp)

## Rozwój

Ocena stanu projektu i kierunki rozwoju: [ROADMAP.md](ROADMAP.md).

## Zastrzeżenie

**Użytkowanie na własną odpowiedzialność.** Ta biblioteka jest narzędziem edukacyjnym i symulacyjnym. Wyniki obliczeń mogą zawierać błędy i nie powinny stanowić podstawy do podejmowania decyzji finansowych. Autor nie ponosi odpowiedzialności za jakiekolwiek straty wynikające z użycia tego oprogramowania. Przed podjęciem decyzji finansowych skonsultuj się z wykwalifikowanym doradcą.

## Licencja

MIT - patrz [LICENSE](LICENSE).

## Autor

szalaj (mszalajski@gmail.com)

