aldheeb-pytools 0.1.0__tar.gz

aldheeb_pytools-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdullah (github.com/eeeob)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aldheeb_pytools-0.1.0/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: aldheeb-pytools
+Version: 0.1.0
+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: 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'

aldheeb_pytools-0.1.0/README.md

@@ -0,0 +1,78 @@
+# aldheeb-pytools 🛠️
+
+[![PyPI version](https://img.shields.io/pypi/v/aldheeb-pytools.svg)](https://pypi.org/project/aldheeb-pytools/)
+[![Python versions](https://img.shields.io/pypi/pyversions/aldheeb-pytools.svg)](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.crypto 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
+
+---

aldheeb_pytools-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "aldheeb-pytools"
+dynamic = ["version"]
+description = "Python Tools library for some services"
+requires-python = ">=3.12"
+authors = [{ name = "Abdullah", email = "aldheeb01@gmail.com" }]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "pydantic>=2.0", 
+    "aiologic>=0.16.0", 
+    "pymongo>=4.16.0", 
+    "pycountry>=26.2.16", 
+    "cryptography>=46.0.4", 
+    "beautifulsoup4>=4.14.3", 
+    "phonenumbers>=9.0.21", 
+    "kurigram[fast]>=2.2.23", 
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/eeeob/aldheeb-pytools"
+
+[project.optional-dependencies]
+dev = [
+    "hatch<=1.16.5",
+    "twine<=6.2.0",
+]
+
+full = [
+    "aioimaplib>=2.0.1", 
+]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    ".github/",
+]
+
+[tool.hatch.version]
+path = "pytools/__meta__.py"
+
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+ignore-vcs = true
+packages = ["pytools"]

aldheeb_pytools-0.1.0/pytools/__init__.py

@@ -0,0 +1,38 @@
+
+from .validate_tools import *
+from .date_tools import *
+from .num_tools import *
+from .files_tools import *
+from .iter_tools import *
+from .text_tools import *
+from .async_tools import *
+from .misc_tools import *
+from .tg_tools import *
+from .phone_tools import *
+from .country_tools import *
+from .crypto_tools import *
+from .data_tools import *
+from .callable_tools import *
+from .logging_tools import *
+from .email_tools import *
+from .classes import *
+
+__all__ = (
+    *validate_tools.__all__, 
+    *date_tools.__all__, 
+    *num_tools.__all__, 
+    *files_tools.__all__, 
+    *iter_tools.__all__, 
+    *text_tools.__all__, 
+    *async_tools.__all__, 
+    *misc_tools.__all__, 
+    *tg_tools.__all__, 
+    *phone_tools.__all__, 
+    *country_tools.__all__, 
+    *crypto_tools.__all__, 
+    *data_tools.__all__, 
+    *callable_tools.__all__, 
+    *classes.__all__, 
+    *logging_tools.__all__, 
+    *email_tools.__all__, 
+)

aldheeb_pytools-0.1.0/pytools/__meta__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"