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

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

@@ -1,19 +1,21 @@
 Metadata-Version: 2.4
 Name: itd-sdk
-Version: 2.4.4
+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'
@@ -26,43 +28,56 @@ Provides-Extra: logs
 Description-Content-Type: text/markdown
 
 # itd-sdk
-Клиент ITD для python  
-Документация (beta): https://itdsdk.qzz.io/docs
+
+[![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
-pip install itd-sdk
+uv add itd-sdk
 ```
 
-## Пример
-
-```python
-from itd import ITDClient, Me
+или через pip:
 
-c = ITDClient('token')
-print(Me())
+```bash
+pip install itd-sdk
 ```
-<!--
-> [!NOTE]
-> Берите refresh_token из запроса /auth/refresh. В остальных запросах нету refresh_token
-> ![cookie](cookie-screen.png) -->
 
-### Получение cookies
+## Вход
+
+Сейчас есть 3 способа авторизации в SDK:
 
-Для получения access_token требуются cookies с `refresh_token`. Как их получить:
+1. Без авторизации. Доступен поиск и хэштэги.
+2. Авторизация через `access_token`. Доступны все запросы кроме тех, которые связаны с авторизацией. Токен действует 15 минут.
+3. Авторизация через `refresh_token`. Доступны все запросы. Токен действует 7 дней.
+
+### Получение `refresh_token`
 
 1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
-2. Откройте DevTools (F12)
-3. Перейдите на вкладку **Network**
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
 4. Обновите страницу
-5. Найдите запрос к `/auth/refresh`
-6. Скопируйте значение **refresh_token** из **Cookie** из Request Headers
+5. Найдите запрос к `/v1/auth/refresh`
+6. Скопируйте значение **refresh_token** из **Cookies** \ **Куки**
+
+![token](get-rtoken.png)
+
+### Получение `access_token`
 
-![cookie](cookie-screen.png)
+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
 
@@ -75,6 +90,7 @@ 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()):
@@ -104,28 +120,15 @@ def on_like(notification):
     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"
+Весь 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)
+- Лицезия: [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.4 → itd_sdk-2.5.0}/README.md

@@ -1,41 +1,54 @@
 # itd-sdk
-Клиент ITD для python  
-Документация (beta): https://itdsdk.qzz.io/docs
+
+[![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
-pip install itd-sdk
+uv add itd-sdk
 ```
 
-## Пример
-
-```python
-from itd import ITDClient, Me
+или через pip:
 
-c = ITDClient('token')
-print(Me())
+```bash
+pip install itd-sdk
 ```
-<!--
-> [!NOTE]
-> Берите refresh_token из запроса /auth/refresh. В остальных запросах нету refresh_token
-> ![cookie](cookie-screen.png) -->
 
-### Получение cookies
+## Вход
+
+Сейчас есть 3 способа авторизации в SDK:
 
-Для получения access_token требуются cookies с `refresh_token`. Как их получить:
+1. Без авторизации. Доступен поиск и хэштэги.
+2. Авторизация через `access_token`. Доступны все запросы кроме тех, которые связаны с авторизацией. Токен действует 15 минут.
+3. Авторизация через `refresh_token`. Доступны все запросы. Токен действует 7 дней.
+
+### Получение `refresh_token`
 
 1. Откройте [итд.com](https://xn--d1ah4a.com) в браузере
-2. Откройте DevTools (F12)
-3. Перейдите на вкладку **Network**
+2. Откройте DevTools (<kbd>F12</kbd>)
+3. Перейдите на вкладку **"Network"** \ **"Сеть"**
 4. Обновите страницу
-5. Найдите запрос к `/auth/refresh`
-6. Скопируйте значение **refresh_token** из **Cookie** из Request Headers
+5. Найдите запрос к `/v1/auth/refresh`
+6. Скопируйте значение **refresh_token** из **Cookies** \ **Куки**
+
+![token](get-rtoken.png)
+
+### Получение `access_token`
 
-![cookie](cookie-screen.png)
+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
 
@@ -48,6 +61,7 @@ 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()):
@@ -77,28 +91,15 @@ def on_like(notification):
     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"
+Весь 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)
+- Лицезия: [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.4 → itd_sdk-2.5.0}/itd/api/comments.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
-from uuid import UUID
+
 from typing import TYPE_CHECKING
+from uuid import UUID
 
 from itd.base import catch_errors, rate_limit
-from itd.exceptions import ValidationError, NotFoundError, AlreadyDeletedError, BannedWordError, ForbiddenError, RequiresSubscriptionError
+from itd.exceptions import AlreadyDeletedError, BannedWordError, ForbiddenError, NotFoundError, RequiresSubscriptionError, ValidationError
 
 if TYPE_CHECKING:
     from itd.client import Client
@@ -62,5 +63,5 @@ def delete_comment(client: Client, comment_id: UUID):
 
 @rate_limit()
 @catch_errors(ValidationError(), NotFoundError('Comment'))
-def get_replies(client: Client, comment_id: UUID, page: int = 1, limit: int = 50, sort: str = 'oldest'):
-    return client.request('get', f'comments/{comment_id}/replies', {'page': page, 'limit': limit, 'sort': sort})
+def get_replies(client: Client, comment_id: UUID, page: int = 1, limit: int = 50):
+    return client.request('get', f'comments/{comment_id}/replies', {'page': page, 'limit': limit})

{itd_sdk-2.4.4 → itd_sdk-2.5.0}/itd/api/hashtags.py

@@ -1,22 +1,29 @@
 from __future__ import annotations
-from uuid import UUID
+
 from typing import TYPE_CHECKING
+from uuid import UUID
 
-from itd.exceptions import TooLargeError, NotFoundError
 from itd.base import catch_errors, rate_limit
 from itd.enums import AuthLevel
+from itd.exceptions import NotFoundError, TooLargeError, ValidationError
 
 if TYPE_CHECKING:
     from itd.client import Client
 
 
 @rate_limit()
-@catch_errors()
+@catch_errors(ValidationError())
+def search_hashtags(client: Client, query: str, limit: int = 10):
+    return client.request('get', 'hashtags', {'q': query, 'limit': limit}, level=AuthLevel.NO)
+
+
+@rate_limit()
+@catch_errors(ValidationError())
 def get_hashtags(client: Client, limit: int = 10):
     return client.request('get', 'hashtags/trending', {'limit': limit}, level=AuthLevel.NO)
 
 
 @rate_limit()
-@catch_errors(TooLargeError('Hashtag'), NotFoundError('Hashtag', json_check=lambda json: json.get('data', {}).get('hashtag', '') is None))
+@catch_errors(TooLargeError('Hashtag'), NotFoundError('Hashtag', json_check=lambda json: json.get('data', {}).get('hashtag', '') is None), ValidationError())
 def get_posts_by_hashtag(client: Client, hashtag: str, cursor: UUID | None = None, limit: int = 20):
     return client.request('get', f'hashtags/{hashtag}/posts', {'limit': limit, 'cursor': cursor}, level=AuthLevel.NO)

{itd_sdk-2.4.4 → itd_sdk-2.5.0}/itd/api/notifications.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
-from uuid import UUID
+
 from typing import TYPE_CHECKING
+from uuid import UUID
 
-from itd.request import fetch_stream
 from itd.base import catch_errors, rate_limit
 from itd.exceptions import NotFoundError
 

{itd_sdk-2.4.4 → itd_sdk-2.5.0}/itd/api/posts.py

@@ -1,22 +1,23 @@
 from __future__ import annotations
+
 from datetime import datetime
-from uuid import UUID
 from typing import TYPE_CHECKING
+from uuid import UUID
 
+from itd.base import catch_errors, rate_limit
 from itd.enums import PostsTab, UserPostSorting
-from itd.poll import NewPoll
 from itd.exceptions import (
-    NotFoundError,
-    ForbiddenError,
-    RequiresSubscriptionError,
-    ValidationError,
     AlreadyRepostedError,
+    BannedWordError,
     CantRepostYourselfError,
-    NotPinnedError,
     EditExpiredError,
-    BannedWordError
+    ForbiddenError,
+    NotFoundError,
+    NotPinnedError,
+    RequiresSubscriptionError,
+    ValidationError
 )
-from itd.base import rate_limit, catch_errors
+from itd.poll import NewPoll
 
 if TYPE_CHECKING:
     from itd.client import Client
@@ -54,7 +55,7 @@ def create_post(
 @rate_limit()
 @catch_errors(ValidationError())
 def get_posts(client: Client, cursor: str | datetime | None = None, limit: int = 20, tab: PostsTab = PostsTab.POPULAR):
-    data = {'limit': limit, 'tab': tab.value}
+    data: dict = {'limit': limit, 'tab': tab.value}
     if cursor is not None:
         data['cursor'] = cursor
     return client.request('get', 'posts', data)

{itd_sdk-2.4.4 → itd_sdk-2.5.0}/itd/api/users.py

@@ -1,25 +1,26 @@
 from __future__ import annotations
-from uuid import UUID
+
 from typing import TYPE_CHECKING
+from uuid import UUID
 
-from itd.enums import Unset, UNSET, AccessType
+from itd.base import catch_errors, rate_limit
+from itd.enums import UNSET, AccessType, Unset
 from itd.exceptions import (
-    NotFoundError,
-    TooLargeError,
-    ValidationError,
-    RequiresVerificationError,
-    UsernameTakenError,
-    AlreadyFollowingError,
-    AlreadyDeletedError,
-    NotDeletedError,
     AlreadyBlockedError,
-    NotBlockedError,
+    AlreadyDeletedError,
+    AlreadyFollowingError,
+    CantBlockYourselfError,
     CantFollowYourselfError,
+    NotBlockedError,
+    NotDeletedError,
+    NotFoundError,
+    RequiresVerificationError,
+    TargetUserBannedError,
+    TooLargeError,
     UserBlockedError,
-    CantBlockYourselfError,
-    TargetUserBannedError
+    UsernameTakenError,
+    ValidationError
 )
-from itd.base import catch_errors, rate_limit
 
 if TYPE_CHECKING:
     from itd.client import Client
@@ -93,14 +94,14 @@ def unfollow(client: Client, username_or_id: str | UUID):
 
 @rate_limit()
 @catch_errors(NotFoundError('User'), ValidationError(), TooLargeError('Username'), TargetUserBannedError())
-def get_followers(client: Client, username_or_id: str | UUID, page: int = 1):  # !! page not works if not me
-    return client.request('get', f'users/{username_or_id}/followers', {'page': page})
+def get_followers(client: Client, username_or_id: str | UUID, page: int = 1, limit: int = 20):  # !! page not works if not me
+    return client.request('get', f'users/{username_or_id}/followers', {'page': page, 'limit': limit})
 
 
 @rate_limit()
 @catch_errors(NotFoundError('User'), ValidationError(), TooLargeError('Username'), TargetUserBannedError())
-def get_following(client: Client, username_or_id: str | UUID, page: int = 1):  # !! page not works if not me
-    return client.request('get', f'users/{username_or_id}/following', {'page': page})
+def get_following(client: Client, username_or_id: str | UUID, page: int = 1, limit: int = 20):  # !! page not works if not me
+    return client.request('get', f'users/{username_or_id}/following', {'page': page, 'limit': limit})
 
 
 @rate_limit()
@@ -137,3 +138,9 @@ def get_blocked(client: Client, page: int = 1, limit: int = 20):
 @catch_errors()
 def get_follow_status(client: Client, user_ids: list[UUID]):
     return client.request('post', 'users/follow-status', {'userIds': list(map(str, user_ids))})
+
+
+@rate_limit()
+@catch_errors()
+def search_users(client: Client, query: str, limit: int = 10):
+    return client.request('get', 'users/search', {'q': query, 'limit': limit})