Metadata-Version: 2.4
Name: akhmshare
Version: 0.1.0
Summary: Universal Telegram bot mailing SDK
Home-page: https://github.com/sk1llpy/akhmshare
Author: Akhmads Media
Author-email: skilldevv@icloud.com
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
License-File: LICENSE
Requires-Dist: requests>=2.25.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AKHMShare

**AKHMShare** is a universal Python library for Telegram bot mailing.  
It allows bot creators to send broadcast messages to Telegram users in a safe, scalable way.  

The library uses the Telegram Bot API directly and handles all background polling.  
The bot creator only needs to provide a `get_user_ids()` function and their bot credentials.

---

## Features

- Single main class: `AKHMShare`  
- Bot creator only provides `BOT_TOKEN`, `API_KEY`, `API_URL`, and `get_user_ids()`  
- Validates that the function returns a list/set of Telegram user IDs  
- Background polling (non-blocking)  
- Automatic duplicate message prevention  
- Direct Telegram Bot API integration (no external bot libraries required)

---

## Installation

Clone the repository and install:

```bash
git clone https://github.com/sk1llpy/akhmshare
cd akhmshare
pip install .
