Metadata-Version: 2.4
Name: shyamanth-calculator
Version: 0.1.0
Summary: A Python package that provides essential mathematical operations (add, subtract, multiply, divide, modulo, power) with built-in error handling for safe calculations.
Author-email: Shyamanth-2005 <shyamanthreddy.m@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Shyamanth Calculator 🧮

A lightweight and beginner-friendly Python calculator library for basic arithmetic operations with built-in error handling.

---

## 🚀 Features

- ➕ **Addition** – Add two numbers
- ➖ **Subtraction** – Subtract two numbers
- ✖️ **Multiplication** – Multiply two numbers
- ➗ **Division** – Divide numbers with zero-division protection
- 🔢 **Modulo** – Calculate remainder safely
- 🔋 **Power** – Raise a number to a power

---

## 📦 Installation

Install from PyPI:

```bash
pip install shyamanth-calculator
```

## 🧑‍💻 Usage

```bash
from shyamanth_calculator import add, subtract, multiply, divide, mod, power
```

## Addition

```bash
result = add(5, 3)
print(result)  # Output: 8
```

## Subtraction

```bash
result = subtract(10, 4)
print(result)  # Output: 6
```

## Multiplication

```bash
result = multiply(6, 7)
print(result)  # Output: 42
```

## Division

```bash
result = divide(20, 4)
print(result)  # Output: 5.0
```

## Division by Zero (Handled)

```bash
result = divide(10, 0)
print(result)  # Output: Error: Division by zero is not allowed.
```

## Modulo

```bash
result = mod(17, 5)
print(result)  # Output: 2
```

## Power

```bash
result = power(2, 8)
print(result)  # Output: 256
```

## Requirements

- **Python >= 3.10**

## Author

**Shyamanth Reddy**

- 📧 Email: shyamanthreddy.m@gmail.com
- 🔗 GitHub: https://github.com/Shyamanth-2005

## 📄 License

This project is **open source** and free to use.

## 🏷️ Version

**Current Version**: 0.1.0
