aldheeb-pytools 🛠️

PyPI version Python versions License: MIT

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
  • 📧 IMAP email utilities for fetching and parsing emails
  • 🌍 Country & phone utilities for region and number handling
  • 🧰 General utilities for parsing, validation, and data handling
  • 🧩 Fully typed codebase with strict type hints support

📦 Installation

Starting from v0.2.0, the library uses optional dependencies — install only what you need.

Minimal install (no optional dependencies)

pip install aldheeb-pytools

Install specific features

Extra Installs Use for
crypto cryptography Encryption & key derivation
mongo pymongo MongoDB utilities
phone phonenumbers Phone number parsing
country pycountry, phonenumbers Country info & region codes
tg kurigram Telegram automation
imap aioimaplib IMAP email fetching
bs4 beautifulsoup4 HTML email parsing
full everything above All features 
# Single feature
pip install "aldheeb-pytools[crypto]"

# Multiple features
pip install "aldheeb-pytools[crypto, mongo, phone]"

# Everything
pip install "aldheeb-pytools[full]"

Note: If you try to use a feature without its required packages installed, you'll get a clear ImportError with the exact install command needed.

Install the latest version from GitHub

To install directly from the main branch (ahead of the latest PyPI release):

pip install git+https://github.com/eeeob/aldheeb-pytools.git --force-reinstall

🚀 Quick Start

🔐 Encryption example

pip install "aldheeb-pytools[crypto]"

from pytools import encrypt, decrypt

key = "my-secure-key"

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

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

🗄️ MongoDB example

pip install "aldheeb-pytools[mongo]"

from pytools import MongoIndex

index = MongoIndex.from_dict({"key": {"field": 1}})

🤖 Telegram example

pip install "aldheeb-pytools[tg]"

from pytools import format_tg_username, mention_tg_user

username = format_tg_username("@myuser")
mention = mention_tg_user(123456789, "John")

🧪 Development Setup

git clone https://github.com/eeeob/aldheeb-pytools.git
cd aldheeb-pytools
pip install -e ".[full,dev]"

Running tests

pytest

Tests run in CI across every Python version listed in the classifiers above (3.10 through 3.14), both with the minimal (no-extras) install and with [full,dev].

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📬 Contact

Project links

Data verified by PyPI on Aug 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for eeeob from gravatar.com eeeob

Credits

Author: Abdullah

GitHub Statistics

Data verified by PyPI on Aug 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Requires

Python >=3.10

Provides Extra

bs4 country crypto dev full imap mongo phone tg

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aldheeb_pytools-0.3.3.tar.gz (62.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aldheeb_pytools-0.3.3-py3-none-any.whl (65.3 kB view details)

Uploaded Python 3

File details

Details for the file aldheeb_pytools-0.3.3.tar.gz.

File metadata

  • Download URL: aldheeb_pytools-0.3.3.tar.gz
  • Upload date:
  • Size: 62.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aldheeb_pytools-0.3.3.tar.gz
Algorithm Hash digest
SHA256 a7c47b1a44ac047480ee6b04df8e4aebae533aafa7c70b6df09e17a1c6263f2a
MD5 1d5f695f82d9c4216841edb84465365f
BLAKE2b-256 cc689c6c07c830ecf685dd81c32a58a5278a533ff582729c900955c37a12ab54

See more details on using hashes here.

Provenance

The following attestation bundles were made for aldheeb_pytools-0.3.3.tar.gz:

Publisher: pypi_release.yml on eeeob/aldheeb-pytools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aldheeb_pytools-0.3.3-py3-none-any.whl.

File metadata

File hashes

Hashes for aldheeb_pytools-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8ee5f6ce29785029be03c690c7bf16f7d27bd5e0aa44989800a89eff2ac814b5
MD5 9d2849a263cbd5994251af4ef94eba63
BLAKE2b-256 521e04be698548e809560149089652f7aed30053dc031e80fdaa18fe10235ba2

See more details on using hashes here.

Provenance

The following attestation bundles were made for aldheeb_pytools-0.3.3-py3-none-any.whl:

Publisher: pypi_release.yml on eeeob/aldheeb-pytools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.3.3 This release

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page