libapitelethon 1.0__py3-none-any.whl

libapitelethon/__init__.py

@@ -0,0 +1,6 @@
+from .client.api_telethon import ApiTelethon
+
+
+__all__: tuple[str] = (
+    'ApiTelethon',
+)

libapitelethon/client/api_telethon.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+from typing import Literal, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..types import UserId, UserUsername, UserIdOrUsername
+    from ..models import DictUser, DictUserAiogram
+
+from aiohttp import ClientSession
+
+from ..exceptions import ApiTelethonException
+
+
+class ApiTelethon:
+    def __init__(
+        self,
+        protocol: Literal['http', 'https'] = 'http',
+        url: str = '127.0.0.1:8000'
+    ) -> None:
+        self._url: str = protocol + '://' + url.rstrip('/') + '/'
+
+    @property
+    def _url_user(self) -> str:
+        return f'{self._url}user/'
+
+    @staticmethod
+    def _handle_error(data: dict) -> None:
+        error_message: str = ''
+
+        if 'error' in data['detail']:
+            error_message = data['detail']['error']['message']
+        else:
+            error_message = data['detail'][0]['msg']
+
+        raise ApiTelethonException(error_message)
+
+    @staticmethod
+    def _return_data(data: dict) -> dict:
+        if 'result' in data:
+            return data['result']
+        return data
+
+    async def _request(self, url: str) -> dict:
+        async with ClientSession() as session:
+            async with session.get(url) as response:
+                data = await response.json()
+
+                if response.status != 200:
+                    self._handle_error(data)
+
+                return self._return_data(data)
+
+
+    async def ping(self) -> bool:
+        url: str = self._url
+        return await self._request(url)
+
+
+    async def get_user(self, uid: UserIdOrUsername) -> DictUser:
+        url: str = self._url_user + str(uid)
+        return await self._request(url)
+
+    async def get_user_aiogram(self, uid: UserIdOrUsername) -> DictUserAiogram:
+        url: str = self._url_user + str(uid) + '/aiogram'
+        return await self._request(url)
+
+
+    async def get_user_id(self, username: UserUsername) -> UserId:
+        url: str = self._url_user + username + '/id'
+        return await self._request(url)
+
+    async def get_user_username(self, id: UserId) -> UserUsername:
+        url: str = self._url_user + str(id) + '/username'
+        return await self._request(url)
+
+    async def get_user_usernames(self, uid: UserIdOrUsername) -> list[UserUsername]:
+        url: str = self._url_user + str(uid) + '/usernames'
+        return await self._request(url)

libapitelethon/exceptions.py

@@ -0,0 +1,2 @@
+class ApiTelethonException(Exception):
+    pass

libapitelethon/models/__init__.py

@@ -0,0 +1,8 @@
+from .dict_user import DictUser
+from .dict_user_aiogram import DictUserAiogram
+
+
+__all__: tuple[str] = (
+    'DictUser',
+    'DictUserAiogram',
+)

libapitelethon/models/dict_user.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+from typing import TypedDict, NotRequired
+
+
+class _Status(TypedDict):
+    type: str
+    expires: NotRequired[float]
+    was_online: NotRequired[float]
+    by_me: NotRequired[bool]
+
+class DictUser(TypedDict):
+    id: int
+    is_self: bool | None
+    contact: bool | None
+    mutual_contact: bool | None
+    deleted: bool | None
+    bot: bool | None
+    bot_chat_history: bool | None
+    bot_nochats: bool | None
+    verified: bool | None
+    restricted: bool | None
+    min: bool | None
+    bot_inline_geo: bool | None
+    support: bool | None
+    scam: bool | None
+    apply_min_photo: bool | None
+    fake: bool | None
+    bot_attach_menu: bool | None
+    premium: bool | None
+    attach_menu_enabled: bool | None
+    bot_can_edit: bool | None
+    close_friend: bool | None
+    stories_hidden: bool | None
+    stories_unavailable: bool | None
+    contact_require_premium: bool | None
+    bot_business: bool | None
+    bot_has_main_app: bool | None
+    bot_forum_view: bool | None
+    bot_forum_can_manage_topics: bool | None
+    bot_can_manage_bots: bool | None
+    bot_guestchat: bool | None
+    bot_guard: bool | None
+    access_hash: int | None
+    first_name: str | None
+    last_name: str | None
+    username: str | None
+    phone: str | None
+    photo: int | None
+    status: _Status | None
+    bot_info_version: int | None
+    restriction_reason: list[str] | None
+    bot_inline_placeholder: str | None
+    lang_code: str | None
+    emoji_status: int | None
+    usernames: list[str] | None
+    stories_max_id: int | None
+    color: list[int] | None
+    profile_color: int | None
+    bot_active_users: int | None
+    bot_verification_icon: int | None
+    send_paid_messages_stars: int | None
+    linked_community_id: int | None

libapitelethon/models/dict_user_aiogram.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+from typing import TypedDict
+
+
+class DictUserAiogram(TypedDict):
+    id: int
+    is_bot: bool
+    first_name: str
+    last_name: str | None
+    username: str | None
+    language_code: str | None
+    is_premium: bool | None
+    added_to_attachment_menu: bool | None
+    can_join_groups: bool | None
+    can_read_all_group_messages: bool | None
+    supports_guest_queries: bool | None
+    supports_inline_queries: bool | None
+    can_connect_to_business: bool | None
+    has_main_web_app: bool | None
+    has_topics_enabled: bool | None
+    allows_users_to_create_topics: bool | None
+    can_manage_bots: bool | None
+    supports_join_request_queries: bool | None

libapitelethon/types/__init__.py

@@ -0,0 +1,10 @@
+from .user_id import UserId
+from .user_username import UserUsername
+from .user_id_or_username import UserIdOrUsername
+
+
+__all__: tuple[str] = (
+    'UserId',
+    'UserUsername',
+    'UserIdOrUsername',
+)

libapitelethon/types/user_id.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+from typing import TypeAlias
+
+
+UserId: TypeAlias = int

libapitelethon/types/user_id_or_username.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+from typing import TypeAlias
+
+from .user_id import UserId
+from .user_username import UserUsername
+
+
+UserIdOrUsername: TypeAlias = UserUsername | UserId

libapitelethon/types/user_username.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+from typing import TypeAlias
+
+
+UserUsername: TypeAlias = str

libapitelethon-1.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.3
+Name: libapitelethon
+Version: 1.0
+Summary: Асинхронный клиент для https://codeberg.org/ourempirecommunity/api_telethon
+Keywords: telegram,api,async,client
+Author: ibrvtk
+Author-email: ibrvtk <nicecock@disroot.org>
+License: GPL-3.0-or-later
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Framework :: AsyncIO
+Classifier: Typing :: Typed
+Requires-Dist: aiohttp
+Requires-Dist: aiogram>=3.0.0 ; extra == 'aiogram'
+Requires-Dist: telethon>=1.30.0 ; extra == 'telethon'
+Requires-Python: >=3.14
+Project-URL: Homepage, https://codeberg.org/ourempirecommunity/libapitelethon
+Project-URL: Repository, https://codeberg.org/ourempirecommunity/libapitelethon
+Project-URL: Issues, https://codeberg.org/ourempirecommunity/libapitelethon/issues
+Provides-Extra: aiogram
+Provides-Extra: telethon
+Description-Content-Type: text/markdown
+
+# libapitelethon
+

libapitelethon-1.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+libapitelethon/__init__.py,sha256=5TCykhShiYi3E0B8RYAMwpkZMcm403QiVMpAlLfol6I,91
+libapitelethon/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+libapitelethon/client/api_telethon.py,sha256=eniXzjsfu_0Oq5tZMxIIkrJcpSo8xePrBp-JVOtQE4I,2335
+libapitelethon/exceptions.py,sha256=uGbxZr9TogrogiUJ8AflZJy4xhgcwuFyfECuLWEQNTs,47
+libapitelethon/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+libapitelethon/models/__init__.py,sha256=HL49Pin1bpnXpoV9ZQlaqpIQyAX_6BL2JzYEOJ8kN6s,145
+libapitelethon/models/dict_user.py,sha256=6TgNIqjvXXga1tYjvRM_qpcp_SuF1prTznc9QvNgwQs,1769
+libapitelethon/models/dict_user_aiogram.py,sha256=tVnilYnrdcwK7sir5l-89FYQh2IBT6wDCLQ6xMvGwkM,696
+libapitelethon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+libapitelethon/types/__init__.py,sha256=9ReYsrPQ9XQfdKETtUW4nIEJR-ZxthPfj7rZUmXrqrE,203
+libapitelethon/types/user_id.py,sha256=_6eB786DJAgfQMZzsWa2tsNU3zP09BQaXaxGX6TZ_Vs,89
+libapitelethon/types/user_id_or_username.py,sha256=JqjZooejVwlX7paS8sWbS8Zx6W9L0unx_e_0Kop8mcw,186
+libapitelethon/types/user_username.py,sha256=u-eHkGYwfI1S8aheVcP7OGL3XzYqPpzojdWbMtN1G0U,95
+libapitelethon-1.0.dist-info/WHEEL,sha256=3NO1oYsF7mANFUWVdyEQLM-zmecczWWEmmF5rEbXrWk,80
+libapitelethon-1.0.dist-info/METADATA,sha256=KIN123MsSjpWjFTlMUhdrmwYILGfFJd7MoCFq2AtAFQ,1108
+libapitelethon-1.0.dist-info/RECORD,,

libapitelethon-1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.13.6
+Root-Is-Purelib: true
+Tag: py3-none-any