Metadata-Version: 2.4
Name: math_tols
Version: 1.0.8
Summary: Ultimate full math tools library
Home-page: https://github.com/username/scrt
Author: Abolfazl
Author-email: your.email@example.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# math_tols

**math_tols** is a lightweight, fast, and dependency-free Python library that provides essential mathematical operations with a clean and simple API.
It is ideal for beginners, educational purposes, scripting, and projects that require basic math utilities without external dependencies.

---

## Why math_tols?

- Minimal and easy to use
- Zero external dependencies
- Clean and readable source code
- Suitable for learning and real-world usage
- PyPI-ready structure

---

## Features

- Addition
- Subtraction
- Multiplication
- Division
- Power calculation
- Square root calculation

---

## Installation

Install directly from PyPI using pip:

```bash
pip install math_tols
```

Upgrade to the latest version:

```bash
pip install --upgrade math_tols
```

---

## Quick Start

Import the library:

```python
import math_tols
```

Or import specific functions:

```python
from math_tols import jam, menha, zarb, taghsim, tavan, jazr
```

---

## Usage Examples

### Addition

```python
jam(5, 3)
```

**Output**
```text
8
```

---

### Subtraction

```python
menha(10, 4)
```

**Output**
```text
6
```

---

### Multiplication

```python
zarb(6, 7)
```

**Output**
```text
42
```

---

### Division

```python
taghsim(8, 2)
```

**Output**
```text
4.0
```

---

### Power

```python
tavan(2, 3)
```

**Output**
```text
8
```

---

### Square Root

```python
jazr(16)
```

**Output**
```text
4.0
```

---

## API Reference

| Function  | Description |
|---------|------------|
| `jam(x, y)` | Returns the sum of x and y |
| `menha(x, y)` | Returns the subtraction of y from x |
| `zarb(x, y)` | Returns the multiplication of x and y |
| `taghsim(x, y)` | Returns the division of x by y |
| `tavan(x, y)` | Returns x raised to the power y |
| `jazr(x)` | Returns the square root of x |

---

## Notes and Warnings

- Division by zero is not handled internally and will raise a Python error.
- Inputs must be numeric (`int` or `float`).

---

## Project Structure

```text
math_tols/
├── __init__.py
└── README.md
```

---

## License

This project is released under the MIT License.
You are free to use, modify, and distribute it.

---

## Author

Developed with Python and published for educational and practical use.
