DzGram 3.0.26__tar.gz

dzgram-3.0.26/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+*.pyo
+dist/

dzgram-3.0.26/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to DzGram
+
+Thanks for your interest in contributing!
+
+## Development Setup
+
+This project uses [uv](https://docs.astral.sh/uv/) for package management and [poethepoet](https://github.com/nat-n/poethepoet) for task running.
+
+```bash
+git clone https://github.com/DownloaderZone/DzGram
+cd DzGram
+uv sync --frozen --extra dev
+uv run poe api
+```
+
+## Running Tests
+
+```bash
+uv run poe test
+```
+
+## Building Docs
+
+```bash
+uv run poe docs
+```
+
+## Available Tasks
+
+| Command | Description |
+|---------|-------------|
+| `uv run poe venv` | Sync frozen environment |
+| `uv run poe venv-dev` | Sync dev environment |
+| `uv run poe api` | Generate TL API types |
+| `uv run poe test` | Run tests |
+| `uv run poe docs` | Build documentation |
+| `uv run poe build` | Build sdist and wheel |
+| `uv run poe publish` | Publish to PyPI |
+| `uv run poe tag` | Create and push git tag |
+| `uv run poe clean` | Clean all generated files |
+
+## Submitting Changes
+
+1. Fork the repo
+2. Create a branch from `dev`
+3. Make your changes
+4. Run `uv run poe test` to verify
+5. Submit a pull request to `dev`
+
+## Code Style
+
+- Follow the existing Sphinx/reST docstring style for any new methods or types
+- Add type hints to all function signatures
+- Keep methods focused and well-documented

dzgram-3.0.26/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: DzGram
+Version: 3.0.26
+Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+Project-URL: Homepage, https://github.com/DownloaderZone/DzGram
+Project-URL: Documentation, https://downloaderzone.github.io/DzGram
+Project-URL: Source, https://github.com/DownloaderZone/DzGram
+Project-URL: Issues, https://github.com/DownloaderZone/DzGram/issues
+Author-email: Dan <dan@pyrogram.org>
+Maintainer: DownloaderZone
+License-Expression: LGPL-3.0-or-later
+Keywords: api,chat,client,library,messenger,mtproto,python,telegram
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Communications
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: pysocks>=1.7.1
+Requires-Dist: warpcrypto>=2.0.5
+Provides-Extra: dev
+Requires-Dist: jinja2>=3; extra == 'dev'
+Requires-Dist: poethepoet>=0.32; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: pyyaml>=6; extra == 'dev'
+Requires-Dist: twine>=5; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo>=2023; extra == 'docs'
+Requires-Dist: sphinx>=7; extra == 'docs'
+Provides-Extra: fast
+Requires-Dist: uvloop<=0.22.1; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
+Description-Content-Type: text/markdown
+
+# DzGram
+
+[![PyPI](https://img.shields.io/pypi/v/DzGram)](https://pypi.org/project/DzGram/)
+[![Python](https://img.shields.io/pypi/pyversions/DzGram)](https://pypi.org/project/DzGram/)
+[![Downloads](https://img.shields.io/pypi/dm/DzGram)](https://pypi.org/project/DzGram/)
+[![License](https://img.shields.io/github/license/DownloaderZone/DzGram)](COPYING.lesser)
+[![Documentation](https://img.shields.io/badge/docs-downloaderzone.github.io/blue)](https://downloaderzone.github.io/DzGram)
+
+> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+
+DzGram is a **drop-in replacement** for Pyrogram — your existing `from pyrogram import ...` code works without changes, with access to the latest Telegram features including **Gifts, Stories, Topics, Business Accounts**, and more.
+
+```python
+from pyrogram import Client, filters
+
+app = Client("my_account")
+
+
+@app.on_message(filters.private)
+async def hello(client, message):
+    await message.reply("Hello from DzGram!")
+
+
+app.run()
+```
+
+**DzGram** is a modern, elegant and asynchronous [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi) framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot identity (bot API alternative) using Python.
+
+### Key Features
+
+- **Drop-in Replacement** — Use `from pyrogram import ...`; existing codebases migrate with zero import changes.
+- **Up-to-Date** — Supports Gifts, Stories, Topics, Business Accounts, Giveaways, and the latest Telegram layer.
+- **Async Natively** — Fully `async`/`await` throughout. Also usable synchronously via `app.run()` for convenience.
+- **Type-hinted** — Every type and method is annotated for excellent editor support.
+- **Fast** — Boosted by [WarpCrypto](https://github.com/rjriajul/WarpCrypto), a high-performance cryptography library written in Rust.
+- **Powerful** — Full access to Telegram's API for any official client action and more.
+
+### Example with Inline Keyboard
+
+```python
+from pyrogram import Client, filters
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton
+
+app = Client("my_bot")
+
+
+@app.on_message(filters.command("start"))
+async def start(client, message):
+    await message.reply(
+        "Choose an option:",
+        reply_markup=InlineKeyboardMarkup([
+            [
+                InlineKeyboardButton("Website", url="https://example.com"),
+                InlineKeyboardButton("Help", callback_data="help"),
+            ],
+            [InlineKeyboardButton("About", callback_data="about")],
+        ])
+    )
+
+
+app.run()
+```
+
+### Installing
+
+```bash
+pip install DzGram
+```
+
+For better performance:
+
+```bash
+pip install DzGram[fast]
+```
+
+### Development
+
+```bash
+# Clone the repo
+git clone https://github.com/DownloaderZone/DzGram.git
+cd DzGram
+
+# Install uv (if not already)
+pip install uv
+
+# Create virtual environment with dev dependencies
+uv sync --frozen --extra dev
+
+# Generate TL API types
+uv run poe api
+
+# Run tests
+uv run poe test
+```
+
+### Documentation
+
+Full documentation at **[https://downloaderzone.github.io/DzGram](https://downloaderzone.github.io/DzGram)**
+
+### Resources
+
+- [Source code](https://github.com/DownloaderZone/DzGram)
+- [Documentation](https://downloaderzone.github.io/DzGram)
+- [Issue tracker](https://github.com/DownloaderZone/DzGram/issues)
+- [Contributing guide](CONTRIBUTING.md)

dzgram-3.0.26/README.md

@@ -0,0 +1,105 @@
+# DzGram
+
+[![PyPI](https://img.shields.io/pypi/v/DzGram)](https://pypi.org/project/DzGram/)
+[![Python](https://img.shields.io/pypi/pyversions/DzGram)](https://pypi.org/project/DzGram/)
+[![Downloads](https://img.shields.io/pypi/dm/DzGram)](https://pypi.org/project/DzGram/)
+[![License](https://img.shields.io/github/license/DownloaderZone/DzGram)](COPYING.lesser)
+[![Documentation](https://img.shields.io/badge/docs-downloaderzone.github.io/blue)](https://downloaderzone.github.io/DzGram)
+
+> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+
+DzGram is a **drop-in replacement** for Pyrogram — your existing `from pyrogram import ...` code works without changes, with access to the latest Telegram features including **Gifts, Stories, Topics, Business Accounts**, and more.
+
+```python
+from pyrogram import Client, filters
+
+app = Client("my_account")
+
+
+@app.on_message(filters.private)
+async def hello(client, message):
+    await message.reply("Hello from DzGram!")
+
+
+app.run()
+```
+
+**DzGram** is a modern, elegant and asynchronous [MTProto API](https://docs.pyrogram.org/topics/mtproto-vs-botapi) framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot identity (bot API alternative) using Python.
+
+### Key Features
+
+- **Drop-in Replacement** — Use `from pyrogram import ...`; existing codebases migrate with zero import changes.
+- **Up-to-Date** — Supports Gifts, Stories, Topics, Business Accounts, Giveaways, and the latest Telegram layer.
+- **Async Natively** — Fully `async`/`await` throughout. Also usable synchronously via `app.run()` for convenience.
+- **Type-hinted** — Every type and method is annotated for excellent editor support.
+- **Fast** — Boosted by [WarpCrypto](https://github.com/rjriajul/WarpCrypto), a high-performance cryptography library written in Rust.
+- **Powerful** — Full access to Telegram's API for any official client action and more.
+
+### Example with Inline Keyboard
+
+```python
+from pyrogram import Client, filters
+from pyrogram.types import InlineKeyboardMarkup, InlineKeyboardButton
+
+app = Client("my_bot")
+
+
+@app.on_message(filters.command("start"))
+async def start(client, message):
+    await message.reply(
+        "Choose an option:",
+        reply_markup=InlineKeyboardMarkup([
+            [
+                InlineKeyboardButton("Website", url="https://example.com"),
+                InlineKeyboardButton("Help", callback_data="help"),
+            ],
+            [InlineKeyboardButton("About", callback_data="about")],
+        ])
+    )
+
+
+app.run()
+```
+
+### Installing
+
+```bash
+pip install DzGram
+```
+
+For better performance:
+
+```bash
+pip install DzGram[fast]
+```
+
+### Development
+
+```bash
+# Clone the repo
+git clone https://github.com/DownloaderZone/DzGram.git
+cd DzGram
+
+# Install uv (if not already)
+pip install uv
+
+# Create virtual environment with dev dependencies
+uv sync --frozen --extra dev
+
+# Generate TL API types
+uv run poe api
+
+# Run tests
+uv run poe test
+```
+
+### Documentation
+
+Full documentation at **[https://downloaderzone.github.io/DzGram](https://downloaderzone.github.io/DzGram)**
+
+### Resources
+
+- [Source code](https://github.com/DownloaderZone/DzGram)
+- [Documentation](https://downloaderzone.github.io/DzGram)
+- [Issue tracker](https://github.com/DownloaderZone/DzGram/issues)
+- [Contributing guide](CONTRIBUTING.md)

dzgram-3.0.26/hatch_build.py

@@ -0,0 +1,19 @@
+import subprocess
+import sys
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+
+class CustomBuildHook(BuildHookInterface):
+    def initialize(self, version, build_data):
+        root = Path(self.root)
+        compilers = [
+            "compiler/api/compiler.py",
+            "compiler/errors/compiler.py",
+            "compiler/methods/compiler.py",
+        ]
+        for rel in compilers:
+            compiler_path = root / rel
+            if compiler_path.exists():
+                subprocess.run([sys.executable, str(compiler_path)], cwd=root, check=True)

dzgram-3.0.26/pyproject.toml

@@ -0,0 +1,125 @@
+[build-system]
+requires = ["hatchling", "pyyaml", "jinja2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "DzGram"
+dynamic = ["version"]
+description = "Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Dan", email = "dan@pyrogram.org" }]
+maintainers = [{ name = "DownloaderZone" }]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Internet",
+    "Topic :: Communications",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+dependencies = ["pysocks>=1.7.1", "warpcrypto>=2.0.5", "aiosqlite>=0.20.0"]
+license = "LGPL-3.0-or-later"
+license-files = ["COPYING", "COPYING.lesser"]
+keywords = [
+    "telegram",
+    "chat",
+    "messenger",
+    "mtproto",
+    "api",
+    "client",
+    "library",
+    "python",
+]
+
+[project.urls]
+Homepage = "https://github.com/DownloaderZone/DzGram"
+Documentation = "https://downloaderzone.github.io/DzGram"
+Source = "https://github.com/DownloaderZone/DzGram"
+Issues = "https://github.com/DownloaderZone/DzGram/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "pytest-cov>=5",
+    "twine>=5",
+    "pyyaml>=6",
+    "jinja2>=3",
+    "poethepoet>=0.32",
+]
+fast = [
+    "uvloop<=0.22.1; sys_platform == 'darwin' or sys_platform == 'linux'",
+]
+docs = [
+    "sphinx>=7",
+    "furo>=2023",
+]
+
+[tool.hatch.version]
+path = "pyrogram/__init__.py"
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    ".github/",
+    "docs/",
+    "tests/",
+    ".gitignore",
+]
+
+[tool.hatch.build.targets.wheel]
+ignore-vcs = true
+packages = ["pyrogram"]
+
+[tool.poe.tasks]
+test = "pytest --no-header -q"
+venv = "uv sync --frozen"
+venv-dev = "uv sync --frozen --extra dev"
+api = { shell = "uv run python3 compiler/api/compiler.py && uv run python3 compiler/errors/compiler.py && uv run python3 compiler/methods/compiler.py" }
+docs = { shell = "uv run python3 compiler/docs/compiler.py && uv run sphinx-build -b dirhtml docs/source docs/build -j auto" }
+docs-archive = { shell = "cd docs/build && zip -r docs.zip html/" }
+build = "uv build"
+publish = "uv publish"
+tag = { shell = "git tag v$(uv run python3 -c 'from pyrogram import __version__; print(__version__)') && git push origin --tags" }
+dtag = { shell = "git tag -d v$(uv run python3 -c 'from pyrogram import __version__; print(__version__)') && git push origin -d --tags" }
+
+[tool.poe.tasks.clean]
+sequence = ["clean-venv", "clean-build", "clean-api", "clean-docs"]
+
+[tool.poe.tasks.clean-venv]
+shell = "rm -rf .venv"
+
+[tool.poe.tasks.clean-build]
+shell = "rm -rf dist *.egg-info build"
+
+[tool.poe.tasks.clean-api]
+shell = "rm -rf pyrogram/errors/exceptions pyrogram/raw/all.py pyrogram/raw/base pyrogram/raw/functions pyrogram/raw/types"
+
+[tool.poe.tasks.clean-docs]
+shell = "rm -rf docs/build docs/source/api/bound-methods docs/source/api/methods docs/source/api/types docs/source/api/enums docs/source/telegram"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]

dzgram-3.0.26/pyrogram/__init__.py

@@ -0,0 +1,47 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+"""DzGram - Elegant, modern and asynchronous Telegram MTProto API framework.
+
+DzGram is a fork of Pyrogram providing support for the latest Telegram features
+including Gifts, Stories, Topics, Business Accounts, and more.
+"""
+
+__version__ = "3.0.26"
+__license__ = "GNU Lesser General Public License v3.0 (LGPL-3.0)"
+__copyright__ = "Copyright (C) 2017-present Dan <https://github.com/delivrance>"
+__fork__ = "DzGram by DownloaderZone <https://github.com/DownloaderZone/DzGram>"
+
+
+class StopTransmission(Exception):
+    pass
+
+
+class StopPropagation(StopAsyncIteration):
+    pass
+
+
+class ContinuePropagation(StopAsyncIteration):
+    pass
+
+
+from . import raw, types, filters, handlers, enums
+from .client import Client
+from .methods.utilities.idle import idle
+from .methods.utilities.compose import compose
+from .methods.rate_limiter import RateLimiter, TokenBucket