zeed 1.2.2__tar.gz

zeed-1.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 <Maxim Zhovner>
+
+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.

zeed-1.2.2/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: zeed
+Version: 1.2.2
+Summary: Fast, dependency-light Telegram Bot API framework built on urllib3
+Author-email: Maxim Zhovner <zovnercukmaksim197@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/fakeskyline/zeed
+Project-URL: Source, https://github.com/fakeskyline/zeed
+Project-URL: Issues, https://github.com/fakeskyline/zeed/issues
+Project-URL: Changelog, https://github.com/fakeskyline/zeed/blob/main/CHANGELOG.md
+Keywords: telegram,bot,api,urllib3,framework,async-free
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3>=2.0
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# zeed
+
+**Fast, dependency-light Telegram Bot API framework built on urllib3.**
+No aiohttp. No requests. No httpx.
+
+[![PyPI](https://img.shields.io/pypi/v/zeed.svg)](https://pypi.org/project/zeed/)
+[![Python](https://img.shields.io/pypi/pyversions/zeed.svg)](https://pypi.org/project/zeed/)
+[![License](https://img.shields.io/pypi/l/zeed.svg)](https://github.com/fakeskyline/zeed/blob/main/LICENSE)
+
+## Why zeed?
+
+Most Telegram Python libraries pull in `aiohttp` or `requests`. zeed
+talks directly to the Telegram Bot API through `urllib3` with a keep-alive
+connection pool. That means:
+
+- **Small** — no heavy dependencies, just `urllib3`
+- **Fast** — direct JSON requests, no middleware layers
+- **Sync** — simple, predictable, easy to debug
+
+## Install
+
+```bash
+pip install zeed
+```
+
+Requires Python 3.9+.
+
+## Quick start
+
+```python
+from zeed import Bot
+
+bot = Bot("YOUR_TOKEN", parse_mode="HTML")
+
+@bot.message_handler(commands=["start"])
+def start(msg):
+    bot.send_message(msg.chat.id, f"Hi, <b>{msg.from_user.first_name}</b>!")
+
+@bot.message_handler(content_types=["text"])
+def echo(msg):
+    bot.send_message(msg.chat.id, f"You said: <b>{msg.text}</b>")
+
+if __name__ == "__main__":
+    bot.run_polling()
+```
+
+## FSM example
+
+```python
+from zeed import Bot, RemoveKeyboard, State, StatesGroup
+
+bot = Bot("YOUR_TOKEN", parse_mode="HTML")
+
+class Form(StatesGroup):
+    name = State()
+    age = State()
+
+@bot.message_handler(commands=["start"])
+def start(msg, data):
+    data["state"].set_state(Form.name)
+    bot.send_message(msg.chat.id, "What's your name?")
+
+@bot.message_handler(state=Form.name)
+def on_name(msg, data):
+    data["state"].update_data(name=msg.text)
+    data["state"].set_state(Form.age)
+    bot.send_message(msg.chat.id, f"Nice to meet you, {msg.text}. How old are you?")
+
+@bot.message_handler(state=Form.age)
+def on_age(msg, data):
+    ctx = data["state"]
+    if not msg.text.isdigit():
+        bot.send_message(msg.chat.id, "Please enter a number.")
+        return
+    ctx.update_data(age=int(msg.text))
+    info = ctx.get_data()
+    ctx.clear()
+    bot.send_message(
+        msg.chat.id,
+        f"Done!\nName: {info['name']}\nAge: {info['age']}",
+        reply_markup=RemoveKeyboard(),
+    )
+
+bot.run_polling()
+```
+
+## Inline mode
+
+```python
+from zeed import Bot, InlineQueryResultArticle
+
+bot = Bot("YOUR_TOKEN")
+
+@bot.inline_query_handler()
+def on_inline(q):
+    results = [
+        InlineQueryResultArticle(
+            id="hello",
+            title="Send hello",
+            input_message_content={"message_text": "Hello!"},
+        ),
+    ]
+    bot.answer_inline_query(q.id, results)
+
+bot.run_polling()
+```
+
+## Middleware
+
+```python
+from zeed import Bot, LoggingMiddleware, ThrottlingMiddleware
+
+bot = Bot("YOUR_TOKEN")
+bot.middleware(LoggingMiddleware())
+bot.middleware(ThrottlingMiddleware(rate=0.5))
+
+@bot.message_handler(content_types=["text"])
+def echo(msg):
+    bot.send_message(msg.chat.id, msg.text)
+
+bot.run_polling(workers=4)
+```
+
+## Webhook
+
+```python
+from zeed import Bot, WebhookServer
+
+bot = Bot("YOUR_TOKEN")
+
+@bot.message_handler(commands=["start"])
+def start(msg):
+    bot.send_message(msg.chat.id, "Hello via webhook!")
+
+if __name__ == "__main__":
+    server = WebhookServer(
+        bot,
+        host="0.0.0.0",
+        port=8080,
+        path="/webhook",
+        secret_token="change-me-to-random-32-chars",
+    )
+    server.install("https://your-domain.com/webhook")
+    server.start(blocking=True)
+```
+
+## Features
+
+- Long-polling and webhook (pure stdlib `http.server`)
+- Inline mode: `@yourbot query` with results
+- FSM: `State`, `StatesGroup`, `MemoryStorage`, `FileStorage`, `SQLiteStorage`
+- Middleware: logging, throttling, timing
+- Filters: `Command`, `Text`, `Regexp`, `ContentTypes`, `ChatType`, `ChatId`, `UserId`, `CallbackData`, `CallbackDataPrefix`, `Func`
+- Filter operators: `&` (and), `|` (or), `~` (not)
+- File sending: photo, document, video, audio, voice, sticker
+- Extras: poll, location, contact, dice
+- Auto-split for long messages: `send_long_message`
+- Security: path traversal guard, size limits, ReDoS protection, token redaction, dedup, safe SQLite
+- Zero dependencies except `urllib3`
+
+## Performance
+
+Benchmarked on Termux (Android, same Wi-Fi, ~30 ms to Telegram, median of 3 trials):
+
+| Workload | zeed | pyTelegramBotAPI |
+|---|---|---|
+| 5 × sendMessage | 85 ms/msg | 89 ms/msg |
+| 3 × sendPhoto | 99 ms/msg | 116 ms/msg |
+
+Your results will vary with network latency.
+
+## Security
+
+- **Path traversal** — `safe_path()` rejects `/etc`, `/proc`, `/sys`, `/root`, `/dev`
+- **Upload size** — 50 MB limit enforced
+- **Callback data** — validated to ≤64 UTF-8 bytes
+- **ReDoS** — `compile_safe_regex()` rejects nested quantifiers
+- **Webhook forgery** — `hmac.compare_digest` on secret token
+- **Token leakage** — bot tokens redacted from logs
+- **Idempotency** — duplicate `update_id` dropped via LRU
+- **SQL injection** — parameterized queries only
+
+## Documentation
+
+Full beginner's guide: [ABOUT.md](https://github.com/fakeskyline/zeed/blob/main/ABOUT.md).
+
+Changelog: [CHANGELOG.md](https://github.com/fakeskyline/zeed/blob/main/CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](https://github.com/fakeskyline/zeed/blob/main/LICENSE).

zeed-1.2.2/README.md

@@ -0,0 +1,191 @@
+# zeed
+
+**Fast, dependency-light Telegram Bot API framework built on urllib3.**
+No aiohttp. No requests. No httpx.
+
+[![PyPI](https://img.shields.io/pypi/v/zeed.svg)](https://pypi.org/project/zeed/)
+[![Python](https://img.shields.io/pypi/pyversions/zeed.svg)](https://pypi.org/project/zeed/)
+[![License](https://img.shields.io/pypi/l/zeed.svg)](https://github.com/fakeskyline/zeed/blob/main/LICENSE)
+
+## Why zeed?
+
+Most Telegram Python libraries pull in `aiohttp` or `requests`. zeed
+talks directly to the Telegram Bot API through `urllib3` with a keep-alive
+connection pool. That means:
+
+- **Small** — no heavy dependencies, just `urllib3`
+- **Fast** — direct JSON requests, no middleware layers
+- **Sync** — simple, predictable, easy to debug
+
+## Install
+
+```bash
+pip install zeed
+```
+
+Requires Python 3.9+.
+
+## Quick start
+
+```python
+from zeed import Bot
+
+bot = Bot("YOUR_TOKEN", parse_mode="HTML")
+
+@bot.message_handler(commands=["start"])
+def start(msg):
+    bot.send_message(msg.chat.id, f"Hi, <b>{msg.from_user.first_name}</b>!")
+
+@bot.message_handler(content_types=["text"])
+def echo(msg):
+    bot.send_message(msg.chat.id, f"You said: <b>{msg.text}</b>")
+
+if __name__ == "__main__":
+    bot.run_polling()
+```
+
+## FSM example
+
+```python
+from zeed import Bot, RemoveKeyboard, State, StatesGroup
+
+bot = Bot("YOUR_TOKEN", parse_mode="HTML")
+
+class Form(StatesGroup):
+    name = State()
+    age = State()
+
+@bot.message_handler(commands=["start"])
+def start(msg, data):
+    data["state"].set_state(Form.name)
+    bot.send_message(msg.chat.id, "What's your name?")
+
+@bot.message_handler(state=Form.name)
+def on_name(msg, data):
+    data["state"].update_data(name=msg.text)
+    data["state"].set_state(Form.age)
+    bot.send_message(msg.chat.id, f"Nice to meet you, {msg.text}. How old are you?")
+
+@bot.message_handler(state=Form.age)
+def on_age(msg, data):
+    ctx = data["state"]
+    if not msg.text.isdigit():
+        bot.send_message(msg.chat.id, "Please enter a number.")
+        return
+    ctx.update_data(age=int(msg.text))
+    info = ctx.get_data()
+    ctx.clear()
+    bot.send_message(
+        msg.chat.id,
+        f"Done!\nName: {info['name']}\nAge: {info['age']}",
+        reply_markup=RemoveKeyboard(),
+    )
+
+bot.run_polling()
+```
+
+## Inline mode
+
+```python
+from zeed import Bot, InlineQueryResultArticle
+
+bot = Bot("YOUR_TOKEN")
+
+@bot.inline_query_handler()
+def on_inline(q):
+    results = [
+        InlineQueryResultArticle(
+            id="hello",
+            title="Send hello",
+            input_message_content={"message_text": "Hello!"},
+        ),
+    ]
+    bot.answer_inline_query(q.id, results)
+
+bot.run_polling()
+```
+
+## Middleware
+
+```python
+from zeed import Bot, LoggingMiddleware, ThrottlingMiddleware
+
+bot = Bot("YOUR_TOKEN")
+bot.middleware(LoggingMiddleware())
+bot.middleware(ThrottlingMiddleware(rate=0.5))
+
+@bot.message_handler(content_types=["text"])
+def echo(msg):
+    bot.send_message(msg.chat.id, msg.text)
+
+bot.run_polling(workers=4)
+```
+
+## Webhook
+
+```python
+from zeed import Bot, WebhookServer
+
+bot = Bot("YOUR_TOKEN")
+
+@bot.message_handler(commands=["start"])
+def start(msg):
+    bot.send_message(msg.chat.id, "Hello via webhook!")
+
+if __name__ == "__main__":
+    server = WebhookServer(
+        bot,
+        host="0.0.0.0",
+        port=8080,
+        path="/webhook",
+        secret_token="change-me-to-random-32-chars",
+    )
+    server.install("https://your-domain.com/webhook")
+    server.start(blocking=True)
+```
+
+## Features
+
+- Long-polling and webhook (pure stdlib `http.server`)
+- Inline mode: `@yourbot query` with results
+- FSM: `State`, `StatesGroup`, `MemoryStorage`, `FileStorage`, `SQLiteStorage`
+- Middleware: logging, throttling, timing
+- Filters: `Command`, `Text`, `Regexp`, `ContentTypes`, `ChatType`, `ChatId`, `UserId`, `CallbackData`, `CallbackDataPrefix`, `Func`
+- Filter operators: `&` (and), `|` (or), `~` (not)
+- File sending: photo, document, video, audio, voice, sticker
+- Extras: poll, location, contact, dice
+- Auto-split for long messages: `send_long_message`
+- Security: path traversal guard, size limits, ReDoS protection, token redaction, dedup, safe SQLite
+- Zero dependencies except `urllib3`
+
+## Performance
+
+Benchmarked on Termux (Android, same Wi-Fi, ~30 ms to Telegram, median of 3 trials):
+
+| Workload | zeed | pyTelegramBotAPI |
+|---|---|---|
+| 5 × sendMessage | 85 ms/msg | 89 ms/msg |
+| 3 × sendPhoto | 99 ms/msg | 116 ms/msg |
+
+Your results will vary with network latency.
+
+## Security
+
+- **Path traversal** — `safe_path()` rejects `/etc`, `/proc`, `/sys`, `/root`, `/dev`
+- **Upload size** — 50 MB limit enforced
+- **Callback data** — validated to ≤64 UTF-8 bytes
+- **ReDoS** — `compile_safe_regex()` rejects nested quantifiers
+- **Webhook forgery** — `hmac.compare_digest` on secret token
+- **Token leakage** — bot tokens redacted from logs
+- **Idempotency** — duplicate `update_id` dropped via LRU
+- **SQL injection** — parameterized queries only
+
+## Documentation
+
+Full beginner's guide: [ABOUT.md](https://github.com/fakeskyline/zeed/blob/main/ABOUT.md).
+
+Changelog: [CHANGELOG.md](https://github.com/fakeskyline/zeed/blob/main/CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](https://github.com/fakeskyline/zeed/blob/main/LICENSE).

zeed-1.2.2/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zeed"
+version = "1.2.2"
+description = "Fast, dependency-light Telegram Bot API framework built on urllib3"
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+    { name = "Maxim Zhovner", email = "zovnercukmaksim197@gmail.com" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["telegram", "bot", "api", "urllib3", "framework", "async-free"]
+dependencies = ["urllib3>=2.0"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/fakeskyline/zeed"
+Source = "https://github.com/fakeskyline/zeed"
+Issues = "https://github.com/fakeskyline/zeed/issues"
+Changelog = "https://github.com/fakeskyline/zeed/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["zeed*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

zeed-1.2.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+