hypergram 1.1.6__tar.gz → 1.2.0__tar.gz

hypergram-1.2.0/Makefile

@@ -0,0 +1,74 @@
+VENV := venv
+PYTHON := $(VENV)/bin/python
+PIP := $(PYTHON) -m pip
+TAG = v$(shell grep -E '__version__ = ".*"' hypergram/__init__.py | cut -d\" -f2)
+
+RM := rm -rf
+
+GREEN  := \033[0;32m
+RED    := \033[0;31m
+YELLOW := \033[0;33m
+BLUE   := \033[0;34m
+BOLD   := \033[1m
+RESET  := \033[0m
+
+.PHONY: venv venv-docs clean-venv clean-build clean-api clean-docs clean api docs docs-archive build tag dtag
+
+venv:
+	@if [ ! -d "$(VENV)" ]; then \
+		python3 -m venv $(VENV); \
+		$(PIP) install -U pip wheel setuptools; \
+	fi
+
+	$(PIP) install -U -e .
+	@printf "$(YELLOW)Created venv with %s$(RESET)\n" "$$($(PYTHON) --version)"
+
+venv-docs:
+	@if [ ! -d "$(VENV)" ]; then \
+		python3 -m venv $(VENV); \
+		$(PIP) install -U pip wheel setuptools; \
+	fi
+
+	$(PIP) install -U -e .[docs]
+	@printf "$(YELLOW)Created docs venv with %s$(RESET)\n" "$$($(PYTHON) --version)"
+
+clean-venv:
+	$(RM) $(VENV)
+	@printf "$(YELLOW)Cleaned venv directory$(RESET)\n"
+
+clean-build:
+	$(RM) *.egg-info build dist
+	@printf "$(YELLOW)Cleaned build directory$(RESET)\n"
+
+clean-api:
+	$(RM) hypergram/errors/exceptions hypergram/raw/all.py hypergram/raw/base hypergram/raw/functions hypergram/raw/types
+	@printf "$(YELLOW)Cleaned api directory$(RESET)\n"
+
+clean-docs:
+	$(RM) docs/build docs/source/api/bound-methods docs/source/api/methods docs/source/api/types docs/source/api/enums docs/source/telegram
+	@printf "$(YELLOW)Cleaned docs directory$(RESET)\n"
+
+clean: clean-venv clean-build clean-api clean-docs
+	@printf "$(GREEN)Cleaned all directories$(RESET)\n"
+
+api:
+	cd compiler/api && ../../$(PYTHON) compiler.py
+	cd compiler/errors && ../../$(PYTHON) compiler.py
+
+docs:
+	cd compiler/docs && ../../$(PYTHON) compiler.py
+	$(VENV)/bin/sphinx-build -b dirhtml "docs/source" "docs/build/html" -j auto
+
+docs-archive:
+	cd docs/build/html && zip -r ../docs.zip ./
+
+build:
+	hatch build
+
+tag:
+	git tag $(TAG)
+	git push origin $(TAG)
+
+dtag:
+	git tag -d $(TAG)
+	git push origin -d $(TAG)

hypergram-1.2.0/NOTICE

@@ -0,0 +1,17 @@
+hypergram - Telegram MTProto API Client Library for Python
+Copyright (C) 2017-present Dan <https://github.com/delivrance>
+
+This file is part of hypergram.
+
+hypergram 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.
+
+hypergram 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 hypergram.  If not, see <http://www.gnu.org/licenses/>.

hypergram-1.2.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: hypergram
+Version: 1.2.0
+Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+Project-URL: Homepage, https://hypergram.icu
+Project-URL: Documentation, https://docs.hypergram.icu
+Project-URL: Source, https://github.com/Shadowc89/hypergram
+Project-URL: Issues, https://github.com/Shadowc89/hypergram/issues
+Project-URL: Community, https://t.me/hypergram_chat
+Author-email: Saif <Saif@hypergram.org>
+Maintainer: hypergram
+License-Expression: LGPL-3.0-or-later
+License-File: COPYING
+License-File: COPYING.lesser
+Keywords: hypergram,hypergrambots,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.8
+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: Programming Language :: Python :: 3.13
+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.8
+Requires-Dist: pyaes<=1.6.1
+Requires-Dist: python-socks[asyncio]<=2.8.1
+Provides-Extra: dev
+Requires-Dist: hatch<=1.17.0; extra == 'dev'
+Requires-Dist: keyring<=25.7.0; extra == 'dev'
+Requires-Dist: pytest-asyncio<=1.4.0; extra == 'dev'
+Requires-Dist: pytest-cov<=7.1.0; extra == 'dev'
+Requires-Dist: pytest<=9.1.1; extra == 'dev'
+Requires-Dist: twine<=6.2.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: pygments<=2.20.0; extra == 'docs'
+Requires-Dist: shibuya<=2026.5.19; extra == 'docs'
+Requires-Dist: sphinx-autobuild<=2025.8.25; extra == 'docs'
+Requires-Dist: sphinx-copybutton<=0.5.2; extra == 'docs'
+Requires-Dist: sphinx-design<=0.7.0; extra == 'docs'
+Requires-Dist: sphinx-iconify<=0.3.0; extra == 'docs'
+Requires-Dist: sphinx<=9.1.0; extra == 'docs'
+Provides-Extra: fast
+Requires-Dist: tgcrypto<=1.2.5; extra == 'fast'
+Requires-Dist: uvloop<=0.22.1; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
+Description-Content-Type: text/markdown
+
+<p align="center">
+    <a href="https://github.com/hypergram/hypergram">
+        <img src="https://github.com/Shadowc89/Hypergram/blob/main/Hypergram.jpg" alt="hypergram" width="128">
+    </a>
+    <br>
+    <b>Telegram MTProto API Framework for Python</b>
+    <br>
+    <a href="https://hypergram.icu">
+        Homepage
+    </a>
+    •
+    <a href="https://docs.hypergram.icu">
+        Documentation
+    </a>
+    •
+    <a href="https://t.me/hypergram_news">
+        News
+    </a>
+    •
+    <a href="https://t.me/hypergram_chat">
+        Chat
+    </a>
+    
+
+## hypergram
+
+> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+
+hypergram is an actively maintained hypergram fork for Python designed as a drop-in replacement for hypergram, hypergram provides support for the latest Telegram features including Gifts, Stories, Topics, Business Accounts, and more.
+
+```python
+from hypergram import Client, filters
+
+app = Client("my_account")
+
+
+@app.on_message(filters.private)
+async def hello(client, message):
+    await message.reply("Hello from hypergram!")
+
+
+app.run()
+```
+
+**hypergram** is a modern, elegant and asynchronous [MTProto API](https://docs.hypergram.icu/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
+
+- **Ready**: Install hypergram with pip and start building your applications right away.
+- **Easy**: Makes the Telegram API simple and intuitive, while still allowing advanced usages.
+- **Elegant**: Low-level details are abstracted and re-presented in a more convenient way.
+- **Type-hinted**: Types and methods are all type-hinted, enabling excellent editor support.
+- **Async**: Fully asynchronous (also usable synchronously if wanted, for convenience).
+- **Powerful**: Full access to Telegram's API to execute any official client action and more.
+
+### Installing
+
+Stable version
+
+``` bash
+pip install hypergram
+```
+
+Dev version
+
+``` bash
+pip install hypergram --force-reinstall
+```
+
+### Resources
+
+- Check out the [docs](https://docs.hypergram.icu) to learn more about hypergram, get started right
+away and discover more in-depth material for building your client applications.
+- Join the [official channel](https://t.me/hypergram_news) and stay tuned for news, updates and announcements.
+- Join the [official chat](https://t.me/hypergram_chat) to communicate with people.

hypergram-1.2.0/README.md

@@ -0,0 +1,78 @@
+<p align="center">
+    <a href="https://github.com/hypergram/hypergram">
+        <img src="https://github.com/Shadowc89/Hypergram/blob/main/Hypergram.jpg" alt="hypergram" width="128">
+    </a>
+    <br>
+    <b>Telegram MTProto API Framework for Python</b>
+    <br>
+    <a href="https://hypergram.icu">
+        Homepage
+    </a>
+    •
+    <a href="https://docs.hypergram.icu">
+        Documentation
+    </a>
+    •
+    <a href="https://t.me/hypergram_news">
+        News
+    </a>
+    •
+    <a href="https://t.me/hypergram_chat">
+        Chat
+    </a>
+    
+
+## hypergram
+
+> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
+
+hypergram is an actively maintained hypergram fork for Python designed as a drop-in replacement for hypergram, hypergram provides support for the latest Telegram features including Gifts, Stories, Topics, Business Accounts, and more.
+
+```python
+from hypergram import Client, filters
+
+app = Client("my_account")
+
+
+@app.on_message(filters.private)
+async def hello(client, message):
+    await message.reply("Hello from hypergram!")
+
+
+app.run()
+```
+
+**hypergram** is a modern, elegant and asynchronous [MTProto API](https://docs.hypergram.icu/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
+
+- **Ready**: Install hypergram with pip and start building your applications right away.
+- **Easy**: Makes the Telegram API simple and intuitive, while still allowing advanced usages.
+- **Elegant**: Low-level details are abstracted and re-presented in a more convenient way.
+- **Type-hinted**: Types and methods are all type-hinted, enabling excellent editor support.
+- **Async**: Fully asynchronous (also usable synchronously if wanted, for convenience).
+- **Powerful**: Full access to Telegram's API to execute any official client action and more.
+
+### Installing
+
+Stable version
+
+``` bash
+pip install hypergram
+```
+
+Dev version
+
+``` bash
+pip install hypergram --force-reinstall
+```
+
+### Resources
+
+- Check out the [docs](https://docs.hypergram.icu) to learn more about hypergram, get started right
+away and discover more in-depth material for building your client applications.
+- Join the [official channel](https://t.me/hypergram_news) and stay tuned for news, updates and announcements.
+- Join the [official chat](https://t.me/hypergram_chat) to communicate with people.

hypergram-1.2.0/compiler/__init__.py

@@ -0,0 +1,17 @@
+#  hypergram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of hypergram.
+#
+#  hypergram 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.
+#
+#  hypergram 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 hypergram.  If not, see <http://www.gnu.org/licenses/>.

hypergram-1.2.0/compiler/api/__init__.py

@@ -0,0 +1,17 @@
+#  hypergram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of hypergram.
+#
+#  hypergram 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.
+#
+#  hypergram 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 hypergram.  If not, see <http://www.gnu.org/licenses/>.