Metadata-Version: 2.4
Name: Calcly
Version: 1.2.0
Summary: A real-world Python calculation utility library — finance, geometry, unit conversion
Project-URL: Homepage, https://github.com/yourusername/Calcly
Project-URL: Documentation, https://github.com/yourusername/Calcly#readme
Project-URL: Repository, https://github.com/yourusername/Calcly
Project-URL: Bug Tracker, https://github.com/yourusername/Calcly/issues
Author-email: Calcly Team <contact@example.com>
License: MIT
License-File: LICENSE.txt
Keywords: bangladesh,bdt,calculator,converter,discount,emi,finance,geometry,math,tax,utility
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Calcly

> A real-world Python calculation utility library — **zero dependencies**, **pure Python**, **Bangladesh-friendly**.

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![PyPI version](https://img.shields.io/pypi/v/Calcly.svg)](https://pypi.org/project/Calcly/)

## ইনস্টলেশন

```bash
pip install Calcly
```

## কী কী আছে?

| Module | বিবরণ |
|--------|--------|
| `basic` | যোগ, বিয়োগ, গুণ, ভাগ, গড়, clamp |
| `advanced` | EMI, tax, discount, সুদ, লাভ-ক্ষতি, bill split |
| `converter` | তাপমাত্রা, দূরত্ব, ওজন, BDT/USD, storage |
| `geometry` | ক্ষেত্রফল, পরিমিতি, আয়তন |

---

## Quick Start

```python
from Calcly import tax, emi, discount, area_circle

# ভ্যাট হিসাব
print(tax(1000, 15))
# {'base': 1000, 'tax_rate': 15, 'tax_amount': 150.0, 'total': 1150.0}

# EMI হিসাব (৫ লক্ষ টাকা, ১২% সুদ, ২৪ মাস)
result = emi(500000, 12, 24)
print(f"মাসিক EMI: ৳{result['monthly_emi']:,.2f}")

# ছাড় হিসাব
print(discount(2000, 20))
# {'original': 2000, 'discount_percent': 20, 'discount_amount': 400.0,
#  'final_price': 1600.0, 'savings': 400.0}

# বৃত্তের ক্ষেত্রফল
print(area_circle(7))  # 153.938
```

---

## Financial Examples

```python
from Calcly import compound_interest, profit_loss, split_bill, simple_interest

# চক্রবৃদ্ধি সুদ (১ লক্ষ টাকা, ১০%, ৫ বছর, মাসিক)
ci = compound_interest(100000, 10, 5)
print(f"মোট: ৳{ci['total_amount']:,}")       # ৳164,530.88
print(f"সুদ: ৳{ci['interest_earned']:,}")    # ৳64,530.88

# লাভ-ক্ষতি
pl = profit_loss(cost_price=45000, selling_price=54000)
print(f"{pl['type']}: {pl['percent']}%")    # profit: 20.0%

# রেস্টুরেন্ট বিল ৪ জনে ভাগ (১০% tip সহ)
bill = split_bill(1200, 4, tip_pct=10)
print(f"জনপ্রতি: ৳{bill['per_person']}")    # ৳330.0
```

---

## Unit Converter Examples

```python
from Calcly import (
    celsius_to_fahrenheit, km_to_miles,
    bdt_to_usd, usd_to_bdt, kg_to_lbs, mb_to_gb
)

print(celsius_to_fahrenheit(37))     # 98.6 (জ্বর)
print(km_to_miles(100))              # 62.1371
print(bdt_to_usd(11000, rate=110))   # 100.0
print(usd_to_bdt(100, rate=110))     # 11000.0
print(kg_to_lbs(70))                 # 154.3234
print(mb_to_gb(2048))                # 2.0
```

---

## Geometry Examples

```python
from Calcly import (
    area_rectangle, area_triangle, volume_sphere,
    volume_cylinder, hypotenuse
)

room = area_rectangle(12, 8)         # 96 বর্গমিটার
triangle = area_triangle(10, 6)      # 30.0
ball = volume_sphere(5)              # 523.5988
tank = volume_cylinder(1.5, 3)       # 21.2058
c = hypotenuse(3, 4)                 # 5.0
```

---

## সম্পূর্ণ Function List

### basic
`add`, `subtract`, `multiply`, `divide`, `power`, `modulo`, `average`, `clamp`

### advanced
`percentage`, `percentage_of`, `add_percentage`, `tax`, `discount`,
`emi`, `simple_interest`, `compound_interest`, `profit_loss`, `split_bill`

### converter
`celsius_to_fahrenheit`, `fahrenheit_to_celsius`, `km_to_miles`, `miles_to_km`,
`cm_to_inches`, `inches_to_cm`, `kg_to_lbs`, `lbs_to_kg`, `grams_to_oz`, `oz_to_grams`,
`bdt_to_usd`, `usd_to_bdt`, `currency_convert`, `liters_to_gallons`, `gallons_to_liters`,
`mb_to_gb`, `gb_to_tb`, `kb_to_mb`, `bytes_to_kb`

### geometry
`area_circle`, `area_rectangle`, `area_square`, `area_triangle`, `area_trapezoid`, `area_ellipse`,
`perimeter_circle`, `perimeter_rectangle`, `perimeter_square`, `perimeter_triangle`,
`volume_cube`, `volume_box`, `volume_sphere`, `volume_cylinder`, `volume_cone`, `hypotenuse`

---

## Contributing

PR এবং Issues স্বাগত। দেখুন [CONTRIBUTING.md](CONTRIBUTING.md)।

## License

[MIT](LICENSE) © Calcly Team