Metadata-Version: 2.4
Name: aldheeb-pytools
Version: 0.1.8
Summary: Python Tools library for some services
Project-URL: Homepage, https://github.com/eeeob/aldheeb-pytools
Author-email: Abdullah <aldheeb01@gmail.com>
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: aiologic>=0.16.0
Requires-Dist: beautifulsoup4>=4.14.3
Requires-Dist: cryptography>=46.0.4
Requires-Dist: kurigram[fast]>=2.2.23
Requires-Dist: phonenumbers>=9.0.21
Requires-Dist: pycountry>=26.2.16
Requires-Dist: pydantic>=2.0
Requires-Dist: pymongo>=4.16.0
Provides-Extra: dev
Requires-Dist: hatch<=1.16.5; extra == 'dev'
Requires-Dist: twine<=6.2.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: aioimaplib>=2.0.1; extra == 'full'
Description-Content-Type: text/markdown

# aldheeb-pytools 🛠️

[![PyPI version](https://img.shields.io/pypi/v/aldheeb-pytools?dummy=1)](https://pypi.org/project/aldheeb-pytools/)
[![Python versions](https://img.shields.io/pypi/pyversions/aldheeb-pytools?dummy=1)](https://pypi.org/project/aldheeb-pytools/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

**aldheeb-pytools** is a modern Python utilities library providing async-ready helpers for backend systems, databases, cryptography, and Telegram automation.

---

## ✨ Features

* ⚡ **Async-first design** built for modern `asyncio` applications
* 🗄️ **MongoDB utilities** for cleaner and safer database operations
* 🔐 **Cryptography helpers** (AES-GCM, secure key derivation)
* 🤖 **Telegram utilities** using Kurigram integration
* 🧰 **General utilities** for parsing, validation, and data handling
* 🧩 **Fully typed codebase** with strict type hints support

---

## 📦 Installation

### Basic install

```bash
pip install aldheeb-pytools
```

### With optional dependencies

```bash
pip install "aldheeb-pytools[full]"
```

---

## 🚀 Quick Start

### 🔐 Encryption example

```python
from pytools import encrypt, decrypt

key = "my-secure-key"

encrypted = encrypt("secret data", key)
print(encrypted)

decrypted = decrypt(encrypted, key)
print(decrypted)
```

---

## 🧪 Development Setup

```bash
git clone https://github.com/eeeob/aldheeb-pytools.git
cd aldheeb-pytools
pip install -e .[dev]
```

---

## 📄 License

This project is licensed under the **MIT License**.
See the [LICENSE](LICENSE) file for details.

---

## 📬 Contact

* Email: [aldheeb01@gmail.com](mailto:aldheeb01@gmail.com)
* GitHub: https://github.com/eeeob/aldheeb-pytools

---
