itd-sdk 0.1.0__py3-none-any.whl

itd/__init__.py

@@ -0,0 +1 @@
+from itd.client import Client as ITDClient

itd/client.py

@@ -0,0 +1,193 @@
+from requests.exceptions import HTTPError
+
+from itd.users import get_user, update_profile, follow, unfollow, get_followers, get_following
+from itd.etc import get_top_clans, get_who_to_follow, get_platform_status
+from itd.comments import get_comments, add_comment, delete_comment, like_comment, unlike_comment
+from itd.hashtags import get_hastags, get_posts_by_hastag
+from itd.notifications import get_notifications, mark_as_read, mark_all_as_read, get_unread_notifications_count
+from itd.posts import create_post, get_posts, get_post, edit_post, delete_post, pin_post, repost, view_post
+from itd.reports import report
+from itd.search import search
+from itd.request import refresh_auth
+
+
+def refresh_on_error(func):
+    def wrapper(self, *args, **kwargs):
+        try:
+            return func(self, *args, **kwargs)
+        except HTTPError as e:
+            if '401' in str(e):
+                self.refresh_auth()
+                return func(self, *args, **kwargs)
+            raise e
+    return wrapper
+
+
+class Client:
+    def __init__(self, token: str | None, cookies: str | None = None):
+        self.cookies = cookies
+
+        if token:
+            self.token = token.replace('Bearer ', '')
+        elif self.cookies:
+            self.refresh_auth()
+        else:
+            raise ValueError('Provide token or cookie')
+
+    @refresh_on_error
+    def refresh_auth(self):
+        if self.cookies:
+            self.token = refresh_auth(self.cookies)
+        else:
+            print('no cookies!')
+
+    @refresh_on_error
+    def get_user(self, username: str) -> dict:
+        return get_user(self.token, username)
+
+    @refresh_on_error
+    def get_me(self) -> dict:
+        return self.get_user('me')
+
+    @refresh_on_error
+    def update_profile(self, username: str | None = None, display_name: str | None = None, bio: str | None = None) -> dict:
+        return update_profile(self.token, bio, display_name, username)
+
+    @refresh_on_error
+    def follow(self, username: str) -> dict:
+        return follow(self.token, username)
+
+    @refresh_on_error
+    def unfollow(self, username: str) -> dict:
+        return unfollow(self.token, username)
+
+    @refresh_on_error
+    def get_followers(self, username: str) -> dict:
+        return get_followers(self.token, username)
+
+    @refresh_on_error
+    def get_following(self, username: str) -> dict:
+        return get_following(self.token, username)
+
+
+    @refresh_on_error
+    def get_who_to_follow(self) -> dict:
+        return get_who_to_follow(self.token)
+
+    @refresh_on_error
+    def get_top_clans(self) -> dict:
+        return get_top_clans(self.token)
+
+    @refresh_on_error
+    def get_platform_status(self) -> dict:
+        return get_platform_status(self.token)
+
+
+    @refresh_on_error
+    def add_comment(self, post_id: str, content: str, reply_comment_id: str | None = None):
+        return add_comment(self.token, post_id, content, reply_comment_id)
+
+    @refresh_on_error
+    def get_comments(self, post_id: str, limit: int = 20, cursor: int = 0, sort: str = 'popular'):
+        return get_comments(self.token, post_id, limit, cursor, sort)
+
+    @refresh_on_error
+    def like_comment(self, id: str):
+        return like_comment(self.token, id)
+
+    @refresh_on_error
+    def unlike_comment(self, id: str):
+        return unlike_comment(self.token, id)
+
+    @refresh_on_error
+    def delete_comment(self, id: str):
+        return delete_comment(self.token, id)
+
+
+    @refresh_on_error
+    def get_hastags(self, limit: int = 10):
+        return get_hastags(self.token, limit)
+
+    @refresh_on_error
+    def get_posts_by_hashtag(self, hashtag: str, limit: int = 20, cursor: int = 0):
+        return get_posts_by_hastag(self.token, hashtag, limit, cursor)
+
+
+    @refresh_on_error
+    def get_notifications(self, limit: int = 20, cursor: int = 0, type: str | None = None):
+        return get_notifications(self.token, limit, cursor, type)
+
+    @refresh_on_error
+    def mark_as_read(self, id: str):
+        return mark_as_read(self.token, id)
+
+    @refresh_on_error
+    def mark_all_as_read(self):
+        return mark_all_as_read(self.token)
+
+    @refresh_on_error
+    def get_unread_notifications_count(self):
+        return get_unread_notifications_count(self.token)
+
+
+    @refresh_on_error
+    def create_post(self, content: str, wall_recipient_id: int | None = None, attach_ids: list[str] = []):
+        return create_post(self.token, content, wall_recipient_id, attach_ids)
+
+    @refresh_on_error
+    def get_posts(self, username: str | None = None, limit: int = 20, cursor: int = 0, sort: str = '', tab: str = ''):
+        return get_posts(self.token, username, limit, cursor, sort, tab)
+
+    @refresh_on_error
+    def get_post(self, id: str):
+        return get_post(self.token, id)
+
+    @refresh_on_error
+    def edit_post(self, id: str, content: str):
+        return edit_post(self.token, id, content)
+
+    @refresh_on_error
+    def delete_post(self, id: str):
+        return delete_post(self.token, id)
+
+    @refresh_on_error
+    def pin_post(self, id: str):
+        return pin_post(self.token, id)
+
+    @refresh_on_error
+    def repost(self, id: str, content: str | None = None):
+        return repost(self.token, id, content)
+
+    @refresh_on_error
+    def view_post(self, id: str):
+        return view_post(self.token, id)
+
+
+    @refresh_on_error
+    def report(self, id: str, type: str = 'post', reason: str = 'other', description: str = ''):
+        return report(self.token, id, type, reason, description)
+
+    @refresh_on_error
+    def report_user(self, id: str, reason: str = 'other', description: str = ''):
+        return report(self.token, id, 'user', reason, description)
+
+    @refresh_on_error
+    def report_post(self, id: str, reason: str = 'other', description: str = ''):
+        return report(self.token, id, 'post', reason, description)
+
+    @refresh_on_error
+    def report_comment(self, id: str, reason: str = 'other', description: str = ''):
+        return report(self.token, id, 'comment', reason, description)
+
+
+    @refresh_on_error
+    def search(self, query: str, user_limit: int = 5, hashtag_limit: int = 5):
+        return search(self.token, query, user_limit, hashtag_limit)
+
+    @refresh_on_error
+    def search_user(self, query: str, limit: int = 5):
+        return search(self.token, query, limit, 0)
+
+    @refresh_on_error
+    def search_hashtag(self, query: str, limit: int = 5):
+        return search(self.token, query, 0, limit)

itd/comments.py

@@ -0,0 +1,19 @@
+from itd.request import fetch
+
+def add_comment(token: str, post_id: str, content: str, reply_comment_id: str | None = None):
+    data = {'content': content}
+    if reply_comment_id:
+        data['replyTo'] = str(reply_comment_id)
+    return fetch(token, 'post', f'posts/{post_id}/comments', data)
+
+def get_comments(token: str, post_id: str, limit: int = 20, cursor: int = 0, sort: str = 'popular'):
+    return fetch(token, 'get', f'posts/{post_id}/comments', {'limit': limit, 'sort': sort, 'cursor': cursor})
+
+def like_comment(token: str, comment_id: str):
+    return fetch(token, 'post', f'comments/{comment_id}/like')
+
+def unlike_comment(token: str, comment_id: str):
+    return fetch(token, 'delete', f'comments/{comment_id}/like')
+
+def delete_comment(token: str, comment_id: str):
+    return fetch(token, 'delete', f'comments/{comment_id}')

itd/etc.py

@@ -0,0 +1,10 @@
+from itd.request import fetch
+
+def get_top_clans(token: str):
+    return fetch(token, 'get', 'users/stats/top-clans')
+
+def get_who_to_follow(token: str):
+    return fetch(token, 'get', 'users/suggestions/who-to-follow')
+
+def get_platform_status(token: str):
+    return fetch(token, 'get', 'platform/status')

itd/hashtags.py

@@ -0,0 +1,7 @@
+from itd.request import fetch
+
+def get_hastags(token: str, limit: int = 10):
+    return fetch(token, 'get', 'hashtags/trending', {'limit': limit})
+
+def get_posts_by_hastag(token: str, hashtag: str, limit: int = 20, cursor: int = 0):
+    return fetch(token, 'get', f'hashtags/{hashtag}/posts', {'limit': limit, 'cursor': cursor})

itd/notifications.py

@@ -0,0 +1,16 @@
+from itd.request import fetch
+
+def get_notifications(token: str, limit: int = 20, cursor: int = 0, type: str | None = None):
+    data = {'limit': str(limit), 'cursor': str(cursor)}
+    if type:
+        data['type'] = type
+    return fetch(token, 'get', 'notifications', data)
+
+def mark_as_read(token: str, id: str):
+    return fetch(token, 'post', f'notification/{id}/read')
+
+def mark_all_as_read(token: str):
+    return fetch(token, 'post', f'notification/read-all')
+
+def get_unread_notifications_count(token: str):
+    return fetch(token, 'get', 'notifications/count')

itd/posts.py

@@ -0,0 +1,42 @@
+from itd.request import fetch
+
+def create_post(token: str, content: str, wall_recipient_id: int | None = None, attach_ids: list[str] = []):
+    data: dict = {'content': content}
+    if wall_recipient_id:
+        data['wallRecipientId'] = wall_recipient_id
+    if attach_ids:
+        data['attachmentIds'] = attach_ids
+
+    return fetch(token, 'post', 'posts', data)
+
+def get_posts(token: str, username: str | None = None, limit: int = 20, cursor: int = 0, sort: str = '', tab: str = ''):
+    data: dict = {'limit': limit, 'cursor': cursor}
+    if username:
+        data['username'] = username
+    if sort:
+        data['sort'] = sort
+    if tab:
+        data['tab'] = tab
+
+    return fetch(token, 'get', 'posts', data)
+
+def get_post(token: str, id: str):
+    return fetch(token, 'get', f'posts/{id}')
+
+def edit_post(token: str, id: str, content: str):
+    return fetch(token, 'put', f'posts/{id}', {'content': content})
+
+def delete_post(token: str, id: str):
+    return fetch(token, 'delete', f'posts/{id}')
+
+def pin_post(token: str, id: str):
+    return fetch(token, 'post', f'posts/{id}/pin')
+
+def repost(token: str, id: str, content: str | None = None):
+    data = {}
+    if content:
+        data['content'] = content
+    return fetch(token, 'post', f'posts/{id}/repost', data)
+
+def view_post(token: str, id: str):
+    return fetch(token, 'post', f'posts/{id}/view')

itd/reports.py

@@ -0,0 +1,4 @@
+from itd.request import fetch
+
+def report(token: str, id: str, type: str = 'post', reason: str = 'other', description: str = ''):
+    return fetch(token, 'post', 'reports', {'targetId': id, 'targetType': type, 'reason': reason, 'description': description})

itd/request.py

@@ -0,0 +1,54 @@
+from requests import Session
+
+s = Session()
+
+
+def fetch(token: str, method: str, url: str, params: dict = {}):
+    res = eval(f's.{method}')(f'https://xn--d1ah4a.com/api/{url}', timeout=20, params=params, headers={
+        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "Accept-Language": "ru-RU,ru;q=0.8,en-US;q=0.5,en;q=0.3",
+        "Accept-Encoding": "gzip, deflate, br, zstd",
+        "Authorization": 'Bearer ' + token,
+        "Sec-GPC": "1",
+        "Upgrade-Insecure-Requests": "1",
+        "Sec-Fetch-Dest": "document",
+        "Sec-Fetch-Mode": "navigate",
+        "Sec-Fetch-Site": "none",
+        "Sec-Fetch-User": "?1",
+        "Priority": "u=0, i",
+        "Pragma": "no-cache",
+        "Cache-Control": "no-cache",
+        "TE": "trailers"
+    })
+    res.raise_for_status()
+    return res.json()
+
+def set_cookies(cookies: str):
+    for cookie in cookies.split('; '):
+        s.cookies.set(cookie.split('=')[0], cookie.split('=')[-1], path='/', domain='xn--d1ah4a.com.com')
+
+def refresh_auth(cookies: str):
+    print('refresh')
+    res = s.post(f'https://xn--d1ah4a.com/api/v1/auth/refresh', timeout=10, headers={
+        "Host": "xn--d1ah4a.com",
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:140.0) Gecko/20100101 Firefox/140.0",
+        "Accept": "*/*",
+        "Accept-Language": "ru-RU,ru;q=0.8,en-US;q=0.5,en;q=0.3",
+        "Accept-Encoding": "gzip, deflate, br, zstd",
+        "Referer": "https://xn--d1ah4a.com/",
+        "Content-Type": "application/json",
+        "Origin": "https://xn--d1ah4a.com",
+        "Sec-GPC": "1",
+        "Connection": "keep-alive",
+        "Cookie": cookies,
+        "Sec-Fetch-Dest": "empty",
+        "Sec-Fetch-Mode": "cors",
+        "Sec-Fetch-Site": "same-origin",
+        "Priority": "u=4",
+        "Pragma": "no-cache",
+        "Cache-Control": "no-cache",
+        "Content-Length": "0",
+        "TE": "trailers",
+    })
+    res.raise_for_status()
+    return res.json()['accessToken']

itd/search.py

@@ -0,0 +1,4 @@
+from itd.request import fetch
+
+def search(token: str, query: str, user_limit: int = 5, hashtag_limit: int = 5):
+    return fetch(token, 'get', 'search', {'userLimit': user_limit, 'hashtagLimit': hashtag_limit, 'q': query})

itd/users.py

@@ -0,0 +1,27 @@
+from itd.request import fetch
+
+
+def get_user(token: str, username: str):
+    return fetch(token, 'get', f'users/{username}')
+
+def update_profile(token: str, bio: str | None = None, display_name: str | None = None, username: str | None = None):
+    data = {}
+    if bio:
+        data['bio'] = bio
+    if display_name:
+        data['displayName'] = display_name
+    if username:
+        data['username'] = username
+    return fetch(token, 'put', 'users/me', data)
+
+def follow(token: str, username: str):
+    return fetch(token, 'post', f'users/{username}/follow')
+
+def unfollow(token: str, username: str):
+    return fetch(token, 'delete', f'users/{username}/follow')
+
+def get_followers(token: str, username: str, limit: int = 30, page: int = 1):
+    return fetch(token, 'get', f'users/{username}/followers', {'limit': limit, 'page': page})
+
+def get_following(token: str, username: str, limit: int = 30, page: int = 1):
+    return fetch(token, 'get', f'users/{username}/following', {'limit': limit, 'page': page})

itd_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: itd-sdk
+Version: 0.1.0
+Summary: ITD client for python
+Author-email: firedotguy <nta16022013@gmail.com>
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: license-file
+Dynamic: requires-python
+
+# pyITDclient
+Клиент ITD для python
+
+
+## Установка
+
+```bash
+pip install pyITDclient
+```
+
+## Пример
+
+```python
+from itd import ITDClient
+
+c = ITDClient('TOKEN', 'refresh_token=...; __ddg1_=...; __ddgid_=...; is_auth=1; __ddg2_=...; ddg_last_challenge=...; __ddg8_=...; __ddg10_=...; __ddg9_=...')
+# можно указать только токен, тогда после просрочки перестанет работать, либо только куки чтобы токен сразу подтянулся, либо оба сразу
+
+print(c.get_me())
+```
+
+### Встроенные запросы
+Существуют встроенные эндпоинты для комментариев, хэштэгов, уведомлений, постов, репортов, поиска, пользователей, итд.
+```python
+c.get_user('ITD_API') # получение данных пользователя
+c.get_me() # получение своих данных (me)
+c.update_profile(display_name='22:26') # изменение данных профиля, например имя, био итд
+c.create_post('тест1') # создание постов
+# итд
+```
+
+### Кастомные запросы
+
+```python
+from itd.request import fetch
+
+fetch(c.token, 'метод', 'эндпоинт', {'данные': 'данные'})
+```
+Из методов поддерживается `get`, `post`, `put` итд, которые есть в `requests`
+К названию эндпоинта добавляется домен итд и `api`, то есть в этом примере отпарвится `https://xn--d1ah4a.com/api/эндпоинт`.
+
+> ![INFO]
+> `xn--d1ah4a.com` - punycode от "итд.com"
+
+## прочее
+Лицезия: [MIT](./LICENSE)
+Идея (и часть эндпоинтов): https://github.com/FriceKa/ITD-SDK-js
+ - По сути этот проект является реворком, просто на другом языке
+
+Автор: [SizedBox](https://xn--d1ah4a.com/SizedBox) (в итд) [@desicars](https://t.me/desicars) (в тг)

itd_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+itd/__init__.py,sha256=aw5IL4oMiYMByyb3dies4cFtalvbwIhK5l8UZIY33CU,42
+itd/client.py,sha256=e0anfjZkaUZjm9M1sRKuQb7eIVxrWNQQjIRtCyaxc3U,6438
+itd/comments.py,sha256=K1D-oB7sP3cu6Nlvwv01AoHW2MQ_hTHzdY-6wJCVS5Q,845
+itd/etc.py,sha256=qpvmfZnxmjn_qEGF6RfdZB7JqXb6X24xAIdIpsR9BLg,307
+itd/hashtags.py,sha256=8J_FZoYrVWUOO7YVZHNYgKtm-FhfsltlNGpuk2jjjV4,329
+itd/notifications.py,sha256=VOByurp1L_zTjOppNMb4w9ooClaLpFxQUgoRLlb3emY,570
+itd/posts.py,sha256=RvSGWs5H0PmU7dyh0QH1D_w9p-D3dRQ6zeIDQgUsMRA,1369
+itd/reports.py,sha256=PQN7G_ZlqHiP_QAfJbv1Tr_RR2-4dYq4Em5wxHj6ozY,256
+itd/request.py,sha256=M8p5G694FP79yht98KWu9UQk1-axHW6280IJo9MHH6s,2004
+itd/search.py,sha256=_VDm2mzV33SqknscB5shL1mYnqPb5U64OCETDwz_maQ,222
+itd/users.py,sha256=U_nMol2j2D0M-E3Xgp2_COBmLg-UlFLpKzTcjGgv3JY,1012
+itd_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=_lEsNh_HklWcRHDJ7hk7P08s5__iwsGCHXyFUyT4GEw,1088
+itd_sdk-0.1.0.dist-info/METADATA,sha256=vTajYGI88ew7d1t2E0LrkXcxI8pQlYf8-2kR40WEC_g,2482
+itd_sdk-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+itd_sdk-0.1.0.dist-info/top_level.txt,sha256=pN5yGtQiWeh0Kox8lh1b_Cp5azwV71qEEGnTIXMH7fE,4
+itd_sdk-0.1.0.dist-info/RECORD,,

itd_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

itd_sdk-0.1.0.dist-info/licenses/LICENSE

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

itd_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+itd