herokutl 2.0.5__tar.gz

herokutl-2.0.5/.gitignore

@@ -0,0 +1,23 @@
+# Generated code
+/telethon/tl/functions/
+/telethon/tl/types/
+/telethon/tl/alltlobjects.py
+/telethon/errors/rpcerrorlist.py
+
+# User session
+*.session
+/usermedia/
+
+# Builds and testing
+__pycache__/
+/dist/
+/build/
+/*.egg-info/
+/readthedocs/_build/
+/.tox/
+
+# API reference docs
+/docs/
+
+# File used to manually test new changes, contains sensitive data
+/example.py

herokutl-2.0.5/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2026 - 2030 Codrago
+
+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.

herokutl-2.0.5/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: herokutl
+Version: 2.0.5
+Summary: This library is built for the Heroku userbot and is based on Telethon.
+Project-URL: Homepage, https://github.com/coddrago/heroku-tl
+Project-URL: Source, https://github.com/coddrago/heroku-tl
+Project-URL: Download, https://pypi.org/project/herokutl/
+Project-URL: Documentation, https://docs.telethon.dev
+Project-URL: Reference, https://tl.telethon.dev
+Author-email: Codrago <codrago@xyecoc.com>
+License-Expression: MIT
+License-File: LICENSE.md
+Keywords: api,chat,client,library,messaging,mtproto,telegram
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.5
+Requires-Dist: bs4==0.0.2
+Requires-Dist: pyaes
+Requires-Dist: rsa
+Provides-Extra: cryptg
+Requires-Dist: cryptg; extra == 'cryptg'
+Description-Content-Type: text/markdown
+
+# Herokutl
+
+> ⭐️ Thanks **everyone** who has starred the project, it means a lot!
+
+![logo](logo.svg) **Telethon** is an [asyncio](https://docs.python.org/3/library/asyncio.html) **Python 3** [MTProto](https://core.telegram.org/mtproto) library to interact with [Telegram](https://telegram.org)'s API as a user or through a bot account (bot API alternative).
+
+> **Important**: If you have code using Telethon before its 1.0 version, you must read [Compatibility and Convenience](https://docs.telethon.dev/en/stable/misc/compatibility-and-convenience.html) to learn how to migrate. As with any third-party library for Telegram, be careful not to break [Telegram's ToS](https://core.telegram.org/api/terms) or [Telegram can ban the account](https://docs.telethon.dev/en/stable/quick-references/faq.html#my-account-was-deleted-limited-when-using-the-library).
+
+## What is this?
+
+Telegram is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Telegram. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application.
+
+## Installing
+
+```sh
+pip3 install herokutl
+```
+
+## Creating a client
+
+```python
+from herokutl import TelegramClient, events, sync
+
+# These example values won't work. You must get your own api_id and
+# api_hash from https://my.telegram.org, under API Development.
+api_id = 12345
+api_hash = '0123456789abcdef0123456789abcdef'
+
+client = TelegramClient('session_name', api_id, api_hash)
+client.start()
+```
+
+## Doing stuff
+
+```python
+print(client.get_me().stringify())
+
+client.send_message('username', 'Hello! Talking to you from Telethon')
+client.send_file('username', '/home/myself/Pictures/holidays.jpg')
+
+client.download_profile_photo('me')
+messages = client.get_messages('username')
+messages[0].download_media()
+
+@client.on(events.NewMessage(pattern='(?i)hi|hello'))
+async def handler(event):
+    await event.respond('Hey!')
+```
+
+## Next steps
+
+Do you like how Telethon looks? Check out [Read The Docs](https://docs.telethon.dev) for a more in-depth explanation, with examples, troubleshooting issues, and more useful information.

herokutl-2.0.5/README.rst

@@ -0,0 +1,52 @@
+# Herokutl
+
+> ⭐️ Thanks **everyone** who has starred the project, it means a lot!
+
+![logo](logo.svg) **Telethon** is an [asyncio](https://docs.python.org/3/library/asyncio.html) **Python 3** [MTProto](https://core.telegram.org/mtproto) library to interact with [Telegram](https://telegram.org)'s API as a user or through a bot account (bot API alternative).
+
+> **Important**: If you have code using Telethon before its 1.0 version, you must read [Compatibility and Convenience](https://docs.telethon.dev/en/stable/misc/compatibility-and-convenience.html) to learn how to migrate. As with any third-party library for Telegram, be careful not to break [Telegram's ToS](https://core.telegram.org/api/terms) or [Telegram can ban the account](https://docs.telethon.dev/en/stable/quick-references/faq.html#my-account-was-deleted-limited-when-using-the-library).
+
+## What is this?
+
+Telegram is a popular messaging application. This library is meant to make it easy for you to write Python programs that can interact with Telegram. Think of it as a wrapper that has already done the heavy job for you, so you can focus on developing an application.
+
+## Installing
+
+```sh
+pip3 install herokutl
+```
+
+## Creating a client
+
+```python
+from herokutl import TelegramClient, events, sync
+
+# These example values won't work. You must get your own api_id and
+# api_hash from https://my.telegram.org, under API Development.
+api_id = 12345
+api_hash = '0123456789abcdef0123456789abcdef'
+
+client = TelegramClient('session_name', api_id, api_hash)
+client.start()
+```
+
+## Doing stuff
+
+```python
+print(client.get_me().stringify())
+
+client.send_message('username', 'Hello! Talking to you from Telethon')
+client.send_file('username', '/home/myself/Pictures/holidays.jpg')
+
+client.download_profile_photo('me')
+messages = client.get_messages('username')
+messages[0].download_media()
+
+@client.on(events.NewMessage(pattern='(?i)hi|hello'))
+async def handler(event):
+    await event.respond('Hey!')
+```
+
+## Next steps
+
+Do you like how Telethon looks? Check out [Read The Docs](https://docs.telethon.dev) for a more in-depth explanation, with examples, troubleshooting issues, and more useful information.

herokutl-2.0.5/hatch_build.py

@@ -0,0 +1,133 @@
+"""Custom Hatch build hook to generate Python from .tl definitions."""
+
+import itertools
+import shutil
+import sys
+from pathlib import Path
+from typing import Any
+
+_BuildHookInterface: Any
+try:
+    from hatchling.builders.hooks.plugin.interface import (
+        BuildHookInterface as _BuildHookInterface,
+    )
+except ImportError:
+
+    class _FallbackBuildHookInterface:
+        pass
+
+    _BuildHookInterface = _FallbackBuildHookInterface
+
+
+BuildHookInterface: Any = _BuildHookInterface
+
+
+# Needed since we're importing local files
+GENERATOR_DIR = Path("telethon_generator")
+LIBRARY_DIR = Path("herokutl")
+
+ERRORS_IN = GENERATOR_DIR / "data/errors.csv"
+ERRORS_OUT = LIBRARY_DIR / "errors/rpcerrorlist.py"
+
+METHODS_IN = GENERATOR_DIR / "data/methods.csv"
+
+# Which raw API methods are covered by *friendly* methods in the client?
+FRIENDLY_IN = GENERATOR_DIR / "data/friendly.csv"
+
+TLOBJECT_IN_TLS = [Path(x) for x in GENERATOR_DIR.glob("data/*.tl")]
+TLOBJECT_OUT = LIBRARY_DIR / "tl"
+IMPORT_DEPTH = 2
+
+
+class CustomBuildHook(BuildHookInterface):
+    def _root(self) -> Path:
+        return Path(self.root)
+
+    def _build_dir(self) -> Path:
+        return Path(self.directory)
+
+    def _clean_generated_artifacts(self) -> None:
+        build_dir = self._build_dir().resolve()
+        root = self._root().resolve()
+        generated_package = build_dir / LIBRARY_DIR
+
+        if build_dir == root:
+            clean_tl_dir = root / TLOBJECT_OUT
+            clean_errors_file = root / ERRORS_OUT
+        else:
+            clean_tl_dir = generated_package / "tl"
+            clean_errors_file = generated_package / "errors/rpcerrorlist.py"
+
+        from telethon_generator.generators import clean_tlobjects
+
+        clean_tlobjects(clean_tl_dir)
+        if clean_errors_file.is_file():
+            clean_errors_file.unlink()
+
+        if build_dir != root and generated_package.is_dir():
+            shutil.rmtree(generated_package)
+
+    def clean(self, versions: list[str]) -> None:
+        if self.root not in sys.path:
+            sys.path.insert(0, self.root)
+
+        self._clean_generated_artifacts()
+
+    def initialize(self, version: str, build_data: dict[str, Any]) -> None:
+        if self.root not in sys.path:
+            sys.path.insert(0, self.root)
+
+        self.clean([])
+        if self.target_name == "sdist":
+            return
+
+        from telethon_generator.parsers import (
+            parse_errors,
+            parse_methods,
+            parse_tl,
+            find_layer,
+        )
+
+        from telethon_generator.generators import generate_errors, generate_tlobjects
+
+        root = self._root()
+        build_dir = self._build_dir()
+        generated_tl_dir = build_dir / TLOBJECT_OUT
+        generated_errors = build_dir / ERRORS_OUT
+
+        layer = next(filter(None, map(lambda p: find_layer(root / p), TLOBJECT_IN_TLS)))
+        errors = list(parse_errors(root / ERRORS_IN))
+        methods = list(
+            parse_methods(
+                root / METHODS_IN,
+                root / FRIENDLY_IN,
+                {e.str_code: e for e in errors},
+            )
+        )
+
+        tlobjects = list(
+            itertools.chain(
+                *(parse_tl(root / file, layer, methods) for file in TLOBJECT_IN_TLS)
+            )
+        )
+
+        generate_tlobjects(tlobjects, layer, IMPORT_DEPTH, generated_tl_dir)
+        generated_errors.parent.mkdir(parents=True, exist_ok=True)
+        with generated_errors.open("w") as file:
+            generate_errors(errors, file)
+
+        build_data["force_include"][str(generated_tl_dir / "functions")] = str(
+            TLOBJECT_OUT / "functions"
+        )
+        build_data["force_include"][str(generated_tl_dir / "types")] = str(
+            TLOBJECT_OUT / "types"
+        )
+        build_data["force_include"][str(generated_tl_dir / "alltlobjects.py")] = str(
+            TLOBJECT_OUT / "alltlobjects.py"
+        )
+        build_data["force_include"][str(generated_errors)] = str(ERRORS_OUT)
+
+    def finalize(
+        self, version: str, build_data: dict[str, Any], artifact_path: str
+    ) -> None:
+        self.clean([])

herokutl-2.0.5/herokutl/__init__.py

@@ -0,0 +1,13 @@
+from .client.telegramclient import TelegramClient
+from .network import connection
+from .tl.custom import Button
+from .tl import patched as _  # import for its side-effects
+from . import version, events, utils, errors, types, functions, custom
+
+__version__ = version.__version__
+
+__all__ = [
+    'TelegramClient', 'Button',
+    'types', 'functions', 'custom', 'errors',
+    'events', 'utils', 'connection'
+]

herokutl-2.0.5/herokutl/_updates/__init__.py

@@ -0,0 +1,3 @@
+from .entitycache import EntityCache
+from .messagebox import MessageBox, GapError, PrematureEndReason
+from .session import SessionState, ChannelState, Entity, EntityType

herokutl-2.0.5/herokutl/_updates/entitycache.py

@@ -0,0 +1,59 @@
+from .session import EntityType, Entity
+
+
+_sentinel = object()
+
+
+class EntityCache:
+    def __init__(
+        self,
+        hash_map: dict = _sentinel,
+        self_id: int = None,
+        self_bot: bool = None
+    ):
+        self.hash_map = {} if hash_map is _sentinel else hash_map
+        self.self_id = self_id
+        self.self_bot = self_bot
+
+    def set_self_user(self, id, bot, hash):
+        self.self_id = id
+        self.self_bot = bot
+        if hash:
+            self.hash_map[id] = (hash, EntityType.BOT if bot else EntityType.USER)
+
+    def get(self, id):
+        try:
+            hash, ty = self.hash_map[id]
+            return Entity(ty, id, hash)
+        except KeyError:
+            return None
+
+    def extend(self, users, chats):
+        # See https://core.telegram.org/api/min for "issues" with "min constructors".
+        self.hash_map.update(
+            (u.id, (
+                u.access_hash,
+                EntityType.BOT if u.bot else EntityType.USER,
+            ))
+            for u in users
+            if getattr(u, 'access_hash', None) and not u.min
+        )
+        self.hash_map.update(
+            (c.id, (
+                c.access_hash,
+                EntityType.MEGAGROUP if c.megagroup else (
+                    EntityType.GIGAGROUP if getattr(c, 'gigagroup', None) else EntityType.CHANNEL
+                ),
+            ))
+            for c in chats
+            if getattr(c, 'access_hash', None) and not getattr(c, 'min', None)
+        )
+
+    def put(self, entity):
+        self.hash_map[entity.id] = (entity.hash, entity.ty)
+
+    def retain(self, filter):
+        self.hash_map = {k: v for k, v in self.hash_map.items() if filter(k)}
+
+    def __len__(self):
+        return len(self.hash_map)