itd-sdk 2.4.3__tar.gz → 2.5.0__tar.gz

{itd_sdk-2.4.3 → itd_sdk-2.5.0}/PKG-INFO

@@ -1,23 +1,25 @@
 Metadata-Version: 2.4
 Name: itd-sdk
-Version: 2.4.3
+Version: 2.5.0
 Summary: ITD client for python
 Keywords: itd,itdsocial
-Author: firedotguy
-Author-email: firedotguy <nta16022013@gmail.com>
+Author: fi-res
+Author-email: fi-res <nta16022013@gmail.com>
 License-Expression: MIT
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Natural Language :: Russian
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Framework :: Pydantic :: 2
-Requires-Dist: requests~=2.32.5
+Requires-Dist: requests>=2.32.5,<2.35.0
 Requires-Dist: pydantic>=2.12.5,<2.14.0
 Requires-Dist: sseclient-py~=1.9.0
+Requires-Dist: telegramify-markdown>=0.5.4
+Requires-Dist: lxml>=6.1.1
 Requires-Dist: dateparser>=1.2.2 ; extra == 'date'
 Requires-Dist: filetype>=1.2.0 ; extra == 'filetype'
 Requires-Dist: rich>=15.0.0 ; extra == 'logs'
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Project-URL: Homepage, https://itdsdk.qzz.io
 Project-URL: Documentation, https://itdsdk.qzz.io/docs
 Provides-Extra: date
@@ -25,107 +27,108 @@ Provides-Extra: filetype
 Provides-Extra: logs
 Description-Content-Type: text/markdown
 
-# itd-sdk
-Клиент ITD для python  
-Документация (beta): https://itdsdk.qzz.io/docs
-
-## Установка
-
-```bash
-pip install itd-sdk
-```
-
-## Пример
-
-```python
-from itd import ITDClient, Me
-
-c = ITDClient('token')
-print(Me())
-```
-<!--
-> [!NOTE]
-> Берите refresh_token из запроса /auth/refresh. В остальных запросах нету refresh_token
-> ![cookie](cookie-screen.png) -->
-
-### Получение cookies
-
-Для получения access_token требуются cookies с `refresh_token`. Как их получить:
-
-1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
-2. Откройте DevTools (F12)
-3. Перейдите на вкладку **Network**
-4. Обновите страницу
-5. Найдите запрос к `/auth/refresh`
-6. Скопируйте значение **refresh_token** из **Cookie** из Request Headers
-
-![cookie](cookie-screen.png)
-
-
-## API
-```python
-from itd import Me, User, Post, Posts, File, Hashtag, Notifications
-
-me = Me() # получить себя
-me.privacy.update(is_private=True)
-
-user = User('itd_sdk') # получить пользователя
-user.follow()
-
-post = Post('725681ba-2aaa-42d8-87fb-490c0f44e162') # получить пост
-post.like()
-post.add_comment('тест комент 6 7')
-
-posts = Posts() # получить посты из ленты
-for i, post in enumerate(Posts()):
-    post.like() # встроенные защиты, из-за которых рейт-лимит будет получить сложнее + авто ожидание окончания рейт лимита
-    if i > 10:
-        break
-
-post = user.posts[5] # индексация, авто-получение до нужного значения
-post.repost()
-
-file = File.from_path('1.jpg') # загрузка файлов
-Post.new('всем привет!', attachments=file) # attachments может быть списком, файлом, или UUID
-
-hashtag = Hashtag('тестапи') # получить данные хэштэга
-print(hashtag.posts_count)
-hashtag.posts[0].like()
-
-notifications = Notifications() # получить уведы
-notifications[30].read()
-notifications.read_all()
-for notification in notifications.stream(): # SSE уведомлений
-    print(notification.type.value)
-    break
-
-def on_like(notification):
-    print('лайк от', notification.actor.username)
-    notifications.stop_stream()
-notifications.on_like = on_like
-stream = notifications.stream_bg() # background SSE
-
-Post('02bcbba4-f365-4b98-9291-d0bc1fb36fe4').poll.vote('тест') # голосования в опросах
-
-```
-
-### Кастомные запросы
-
-```python
-from itd.request import fetch
-
-fetch(c, 'метод', 'эндпоинт', {'данные': 'данные'})
-```
-Из методов поддерживается `get`, `post`, `put` итд, которые есть в `requests`
-К названию эндпоинта добавляется домен итд и `api`, то есть в этом примере отправится `https://xn--d1ah4a.com/api/эндпоинт`.
-
-> [!NOTE]
-> `xn--d1ah4a.com` - punycode от "итд.com"
-
-## Прочее
- - Лицезия: [MIT](./LICENSE)
- - Автор:
-   - ИТД: [@itd_sdk](https://xn--d1ah4a.com/@itd_sdk) или [@fdg](https://xn--d1ah4a.com/@pingbot)
-   - ТГ: [@desicars](https://t.me/desicars)
-
-[![Star History Chart](https://api.star-history.com/chart?repos=itd-sdk/itd-sdk&type=date&legend=top-left)](https://www.star-history.com/?repos=itd-sdk%2Fitd-sdk&type=date&legend=top-left)
+# itd-sdk
+
+[![ncruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/fi-res/ncruff)
+
+SDK для работы с [https://xn--d1ah4a.com](итд.com) на python.
+
+Документация: https://itdsdk.qzz.io/docs (wip)
+
+## Установка
+
+```bash
+uv add itd-sdk
+```
+
+или через pip:
+
+```bash
+pip install itd-sdk
+```
+
+## Вход
+
+Сейчас есть 3 способа авторизации в SDK:
+
+1. Без авторизации. Доступен поиск и хэштэги.
+2. Авторизация через `access_token`. Доступны все запросы кроме тех, которые связаны с авторизацией. Токен действует 15 минут.
+3. Авторизация через `refresh_token`. Доступны все запросы. Токен действует 7 дней.
+
+### Получение `refresh_token`
+
+1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
+4. Обновите страницу
+5. Найдите запрос к `/v1/auth/refresh`
+6. Скопируйте значение **refresh_token** из **Cookies** \ **Куки**
+
+![token](get-rtoken.png)
+
+### Получение `access_token`
+
+1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
+4. Откройте любой запрос (если запросов нету, подождите 1-3сек - итд постоянно посылает запросы на обновление статистики постов)
+5. Скопируйте значение **authozation** из **Request headers** \ **Заголовки запроса**
+
+![token](get-atoken.png)
+
+## API
+
+```python
+from itd import Me, User, Post, Posts, File, Hashtag, Notifications
+
+me = Me() # получить себя
+me.privacy.update(is_private=True)
+
+user = User('itd_sdk') # получить пользователя
+user.follow()
+
+post = Post('725681ba-2aaa-42d8-87fb-490c0f44e162') # получить пост
+post.like()
+post.add_comment('тест комент 6 7')
+Post('02bcbba4-f365-4b98-9291-d0bc1fb36fe4').poll.vote('тест') # голосования в опросах
+
+posts = Posts() # получить посты из ленты
+for i, post in enumerate(Posts()):
+    post.like() # встроенные защиты, из-за которых рейт-лимит будет получить сложнее + авто ожидание окончания рейт лимита
+    if i > 10:
+        break
+
+post = user.posts[5] # индексация, авто-получение до нужного значения
+post.repost()
+
+file = File.from_path('1.jpg') # загрузка файлов
+Post.new('всем привет!', attachments=file) # attachments может быть списком, файлом, или UUID
+
+hashtag = Hashtag('тестапи') # получить данные хэштэга
+print(hashtag.posts_count)
+hashtag.posts[0].like()
+
+notifications = Notifications() # получить уведы
+notifications[30].read()
+notifications.read_all()
+for notification in notifications.stream(): # SSE уведомлений
+    print(notification.type.value)
+    break
+
+def on_like(notification):
+    print('лайк от', notification.actor.username)
+    notifications.stop_stream()
+notifications.on_like = on_like
+stream = notifications.stream_bg() # background SSE
+```
+
+Весь API - https://itdsdk.qzz.io/docs/
+
+## Прочее
+
+- Лицезия: [MIT](./LICENSE)
+- Автор:
+    - ИТД: [@itd_sdk](https://xn--d1ah4a.com/@itd_sdk) или [@fdg](https://xn--d1ah4a.com/@pingbot)
+    - ТГ: [@desicars](https://t.me/desicars)
+
+[![Star History Chart](https://api.star-history.com/chart?repos=itd-sdk/itd-sdk&type=date&legend=top-left)](https://www.star-history.com/?repos=itd-sdk%2Fitd-sdk&type=date&legend=top-left)

{itd_sdk-2.4.3 → itd_sdk-2.5.0}/README.md

@@ -1,104 +1,105 @@
-# itd-sdk
-Клиент ITD для python  
-Документация (beta): https://itdsdk.qzz.io/docs
-
-## Установка
-
-```bash
-pip install itd-sdk
-```
-
-## Пример
-
-```python
-from itd import ITDClient, Me
-
-c = ITDClient('token')
-print(Me())
-```
-<!--
-> [!NOTE]
-> Берите refresh_token из запроса /auth/refresh. В остальных запросах нету refresh_token
-> ![cookie](cookie-screen.png) -->
-
-### Получение cookies
-
-Для получения access_token требуются cookies с `refresh_token`. Как их получить:
-
-1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
-2. Откройте DevTools (F12)
-3. Перейдите на вкладку **Network**
-4. Обновите страницу
-5. Найдите запрос к `/auth/refresh`
-6. Скопируйте значение **refresh_token** из **Cookie** из Request Headers
-
-![cookie](cookie-screen.png)
-
-
-## API
-```python
-from itd import Me, User, Post, Posts, File, Hashtag, Notifications
-
-me = Me() # получить себя
-me.privacy.update(is_private=True)
-
-user = User('itd_sdk') # получить пользователя
-user.follow()
-
-post = Post('725681ba-2aaa-42d8-87fb-490c0f44e162') # получить пост
-post.like()
-post.add_comment('тест комент 6 7')
-
-posts = Posts() # получить посты из ленты
-for i, post in enumerate(Posts()):
-    post.like() # встроенные защиты, из-за которых рейт-лимит будет получить сложнее + авто ожидание окончания рейт лимита
-    if i > 10:
-        break
-
-post = user.posts[5] # индексация, авто-получение до нужного значения
-post.repost()
-
-file = File.from_path('1.jpg') # загрузка файлов
-Post.new('всем привет!', attachments=file) # attachments может быть списком, файлом, или UUID
-
-hashtag = Hashtag('тестапи') # получить данные хэштэга
-print(hashtag.posts_count)
-hashtag.posts[0].like()
-
-notifications = Notifications() # получить уведы
-notifications[30].read()
-notifications.read_all()
-for notification in notifications.stream(): # SSE уведомлений
-    print(notification.type.value)
-    break
-
-def on_like(notification):
-    print('лайк от', notification.actor.username)
-    notifications.stop_stream()
-notifications.on_like = on_like
-stream = notifications.stream_bg() # background SSE
-
-Post('02bcbba4-f365-4b98-9291-d0bc1fb36fe4').poll.vote('тест') # голосования в опросах
-
-```
-
-### Кастомные запросы
-
-```python
-from itd.request import fetch
-
-fetch(c, 'метод', 'эндпоинт', {'данные': 'данные'})
-```
-Из методов поддерживается `get`, `post`, `put` итд, которые есть в `requests`
-К названию эндпоинта добавляется домен итд и `api`, то есть в этом примере отправится `https://xn--d1ah4a.com/api/эндпоинт`.
-
-> [!NOTE]
-> `xn--d1ah4a.com` - punycode от "итд.com"
-
-## Прочее
- - Лицезия: [MIT](./LICENSE)
- - Автор:
-   - ИТД: [@itd_sdk](https://xn--d1ah4a.com/@itd_sdk) или [@fdg](https://xn--d1ah4a.com/@pingbot)
-   - ТГ: [@desicars](https://t.me/desicars)
-
-[![Star History Chart](https://api.star-history.com/chart?repos=itd-sdk/itd-sdk&type=date&legend=top-left)](https://www.star-history.com/?repos=itd-sdk%2Fitd-sdk&type=date&legend=top-left)
+# itd-sdk
+
+[![ncruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/fi-res/ncruff)
+
+SDK для работы с [https://xn--d1ah4a.com](итд.com) на python.
+
+Документация: https://itdsdk.qzz.io/docs (wip)
+
+## Установка
+
+```bash
+uv add itd-sdk
+```
+
+или через pip:
+
+```bash
+pip install itd-sdk
+```
+
+## Вход
+
+Сейчас есть 3 способа авторизации в SDK:
+
+1. Без авторизации. Доступен поиск и хэштэги.
+2. Авторизация через `access_token`. Доступны все запросы кроме тех, которые связаны с авторизацией. Токен действует 15 минут.
+3. Авторизация через `refresh_token`. Доступны все запросы. Токен действует 7 дней.
+
+### Получение `refresh_token`
+
+1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
+4. Обновите страницу
+5. Найдите запрос к `/v1/auth/refresh`
+6. Скопируйте значение **refresh_token** из **Cookies** \ **Куки**
+
+![token](get-rtoken.png)
+
+### Получение `access_token`
+
+1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
+4. Откройте любой запрос (если запросов нету, подождите 1-3сек - итд постоянно посылает запросы на обновление статистики постов)
+5. Скопируйте значение **authozation** из **Request headers** \ **Заголовки запроса**
+
+![token](get-atoken.png)
+
+## API
+
+```python
+from itd import Me, User, Post, Posts, File, Hashtag, Notifications
+
+me = Me() # получить себя
+me.privacy.update(is_private=True)
+
+user = User('itd_sdk') # получить пользователя
+user.follow()
+
+post = Post('725681ba-2aaa-42d8-87fb-490c0f44e162') # получить пост
+post.like()
+post.add_comment('тест комент 6 7')
+Post('02bcbba4-f365-4b98-9291-d0bc1fb36fe4').poll.vote('тест') # голосования в опросах
+
+posts = Posts() # получить посты из ленты
+for i, post in enumerate(Posts()):
+    post.like() # встроенные защиты, из-за которых рейт-лимит будет получить сложнее + авто ожидание окончания рейт лимита
+    if i > 10:
+        break
+
+post = user.posts[5] # индексация, авто-получение до нужного значения
+post.repost()
+
+file = File.from_path('1.jpg') # загрузка файлов
+Post.new('всем привет!', attachments=file) # attachments может быть списком, файлом, или UUID
+
+hashtag = Hashtag('тестапи') # получить данные хэштэга
+print(hashtag.posts_count)
+hashtag.posts[0].like()
+
+notifications = Notifications() # получить уведы
+notifications[30].read()
+notifications.read_all()
+for notification in notifications.stream(): # SSE уведомлений
+    print(notification.type.value)
+    break
+
+def on_like(notification):
+    print('лайк от', notification.actor.username)
+    notifications.stop_stream()
+notifications.on_like = on_like
+stream = notifications.stream_bg() # background SSE
+```
+
+Весь API - https://itdsdk.qzz.io/docs/
+
+## Прочее
+
+- Лицезия: [MIT](./LICENSE)
+- Автор:
+    - ИТД: [@itd_sdk](https://xn--d1ah4a.com/@itd_sdk) или [@fdg](https://xn--d1ah4a.com/@pingbot)
+    - ТГ: [@desicars](https://t.me/desicars)
+
+[![Star History Chart](https://api.star-history.com/chart?repos=itd-sdk/itd-sdk&type=date&legend=top-left)](https://www.star-history.com/?repos=itd-sdk%2Fitd-sdk&type=date&legend=top-left)

itd_sdk-2.5.0/itd/__init__.py

@@ -0,0 +1,65 @@
+#                      ######################              ####
+####               ##   ######################           ########
+####             ####            ####                   ####  ####
+####           ######            ####                  ####    ####
+####          #######            ####                 ####      ####
+####        #########            ####                ####        ####
+####      #####  ####            ####               ####          ####
+####    #####    ####            ####              ####            ####
+####  #####      ####            ####             ####              ####
+#########        ####            ####            ####                ####            +----  +----\   |  /
+#######          ####            ####       ##################################       |      |     |  | /
+#####            ####            ####      ####################################  -   +---+  |     |  ++
+###              ####            ####      ####                            ####          |  |     |  | \
+#                ####            ###       ####                            ####      ----+  +----/   |  \
+"""
+|]]]]<<<<<]]<<]]]]]]]]]]]]]]<<<<<]]
+
+|]]]]<<<]]]]]]<<<<<]]<<<<<<<]]<]]
+
+|]]]]<]]]]<]]]]<<<<<]]<<<<<<]]<<<]]
+
+|]]]]]]<<<]]]]<<<<<]]<<<]]]]]]]]]]]]]]]]]]]]]]
+
+|]]<<<<<]]]]<<<<<]]<<<]]<<<<<<<<]]
+"""
+
+from importlib.metadata import version
+
+__version__ = version("itd-sdk")
+
+from itd.clan import Clan, TopClans
+from itd.client import Client as ITDClient
+from itd.client import Config as ITDConfig
+from itd.file import File
+from itd.hashtag import Hashtag, Hashtags
+from itd.notification import Notifications
+from itd.poll import NewPoll
+from itd.post import HashtagPosts, LikedPosts, Post, Posts, UserPosts
+from itd.session import Sessions
+from itd.user import Me, User, Users, get_follow_status
+from itd.version import Apps, Changelog
+
+__all__ = [
+    'Changelog',
+    'Apps',
+    'ITDClient',
+    'ITDConfig',
+    'Clan',
+    'TopClans',
+    'File',
+    'Hashtag',
+    'Hashtags',
+    'Notifications',
+    'Post',
+    'Posts',
+    'UserPosts',
+    'HashtagPosts',
+    'LikedPosts',
+    'NewPoll',
+    'Sessions',
+    'User',
+    'Me',
+    'Users',
+    'get_follow_status'
+]

{itd_sdk-2.4.3 → itd_sdk-2.5.0}/itd/_default.py

@@ -1,17 +1,19 @@
-from __future__ import annotations
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from itd.client import Client
-
-_default_client: Client | None = None
-
-def get_default_client() -> Client:
-    global _default_client
-    if _default_client is None:
-        raise
-    return _default_client
-
-def set_default_client(client: Client):
-    global _default_client
-    _default_client = client
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from itd.client import Client
+
+_default_client: Client | None = None
+
+
+def get_default_client() -> Client:
+    global _default_client
+    if _default_client is None:
+        raise
+    return _default_client
+
+
+def set_default_client(client: Client):
+    global _default_client
+    _default_client = client

{itd_sdk-2.4.3 → itd_sdk-2.5.0}/itd/api/auth.py

@@ -1,35 +1,45 @@
-from __future__ import annotations
-from typing import TYPE_CHECKING
-
-from requests import Response
-
-from itd.base import catch_errors, rate_limit
-from itd.enums import AuthLevel
-from itd.exceptions import (
-    InvalidPasswordError, SamePasswordError, InvalidOldPasswordError, SessionNotFoundError,
-    SessionExpiredError, SessionRevokedError, InvalidCredentials, CaptchaFailedError,
-    EmailDomainNotAllowed
-)
-if TYPE_CHECKING:
-    from itd.client import Client
-
-@rate_limit()
-@catch_errors(SessionExpiredError(), SessionNotFoundError(), SessionRevokedError())
-def refresh_token(client: Client) -> Response:
-    return client.request('post', 'v1/auth/refresh', level=AuthLevel.REFRESH)
-
-@rate_limit()
-@catch_errors(InvalidPasswordError(), SamePasswordError(), InvalidOldPasswordError())
-def change_password(client: Client, old: str, new: str) -> Response:
-    return client.request('post', 'v1/auth/change-password', {'newPassword': new, 'oldPassword': old})
-
-@rate_limit()
-@catch_errors()
-def logout(client: Client) -> Response:
-    return client.request('post', 'v1/auth/logout', level=AuthLevel.REFRESH)
-
-
-@rate_limit()
-@catch_errors(InvalidCredentials(), CaptchaFailedError(), EmailDomainNotAllowed())
-def sign_in(client: Client, email: str, password: str, turnstile: str):
-    return client.request('post', 'v1/auth/sign-in', {'email': email, 'password': password, 'turnstileToken': turnstile}, level=AuthLevel.NO)
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+from requests import Response
+
+from itd.base import catch_errors, rate_limit
+from itd.enums import AuthLevel
+from itd.exceptions import (
+    InvalidPasswordError,
+    SamePasswordError,
+    InvalidOldPasswordError,
+    SessionNotFoundError,
+    SessionExpiredError,
+    SessionRevokedError,
+    InvalidCredentials,
+    CaptchaFailedError,
+    EmailDomainNotAllowed
+)
+
+if TYPE_CHECKING:
+    from itd.client import Client
+
+
+@rate_limit()
+@catch_errors(SessionExpiredError(), SessionNotFoundError(), SessionRevokedError())
+def refresh_token(client: Client) -> Response:
+    return client.request('post', 'v1/auth/refresh', level=AuthLevel.REFRESH)
+
+
+@rate_limit()
+@catch_errors(InvalidPasswordError(), SamePasswordError(), InvalidOldPasswordError())
+def change_password(client: Client, old: str, new: str) -> Response:
+    return client.request('post', 'v1/auth/change-password', {'newPassword': new, 'oldPassword': old})
+
+
+@rate_limit()
+@catch_errors()
+def logout(client: Client) -> Response:
+    return client.request('post', 'v1/auth/logout', level=AuthLevel.REFRESH)
+
+
+@rate_limit()
+@catch_errors(InvalidCredentials(), CaptchaFailedError(), EmailDomainNotAllowed())
+def sign_in(client: Client, email: str, password: str, turnstile: str):
+    return client.request('post', 'v1/auth/sign-in', {'email': email, 'password': password, 'turnstileToken': turnstile}, level=AuthLevel.NO)