Metadata-Version: 2.4
Name: pyutil-kit-madiha
Version: 1.0.0
Summary: A lightweight Python utility library with math, string, and list helpers.
Author: Madiha Umar
License: MIT
Project-URL: Homepage, https://github.com/your-username/pyutil-kit
Keywords: utilities,math,string,list,helpers
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# pyutil-kit

A lightweight Python utility library with three modules covering math, string, and list operations.

## Installation

```bash
pip install pyutil-kit
```

## Modules

### `mathutils`
| Function | Description |
|---|---|
| `mean(numbers)` | Arithmetic mean of a list |
| `is_prime(n)` | Check if a number is prime |
| `factorial(n)` | Factorial of a non-negative integer |
| `clamp(value, min, max)` | Clamp a number within a range |
| `percentage(part, total)` | Compute what % part is of total |

### `strutils`
| Function | Description |
|---|---|
| `reverse(text)` | Reverse a string |
| `count_words(text)` | Count words in a string |
| `is_palindrome(text)` | Check if string is a palindrome |
| `truncate(text, max_length)` | Truncate string with suffix |
| `slug(text)` | Convert string to URL-friendly slug |

### `listutils`
| Function | Description |
|---|---|
| `flatten(nested)` | Flatten a nested list |
| `chunk(lst, size)` | Split list into chunks |
| `unique(lst)` | Remove duplicates, preserve order |
| `frequency(lst)` | Count occurrences of each element |

## Usage

```python
from pyutil_kit import mean, is_prime, is_palindrome, flatten

print(mean([10, 20, 30]))         # 20.0
print(is_prime(17))               # True
print(is_palindrome("racecar"))   # True
print(flatten([1, [2, [3, 4]]]))  # [1, 2, 3, 4]
```

## License
MIT
