itdpy 1.0.2__tar.gz → 1.0.4__tar.gz

itdpy-1.0.4/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: itdpy
+Version: 1.0.4
+Summary: Production-ready Python SDK for ITD API
+Author: Gam5510
+License: MIT
+Project-URL: Homepage, https://github.com/Gam5510/ITDpy
+Project-URL: Repository, https://github.com/Gam5510/ITDpy
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: sseclient-py>=1.8.0
+Dynamic: license-file
+
+# ITDpy
+
+<p align="center">
+  <img src="https://i.postimg.cc/gJ9z8RDk/ITDpy-(1)-pixian-ai.png" width="700">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/itdpy?nocache=1" alt="PyPI version">
+  <img src="https://static.pepy.tech/badge/itdpy?nocache=1" alt="Downloads">
+  <img src="https://img.shields.io/github/license/Gam5510/ITDpy" alt="License">
+  <a href="https://gam5510.github.io/ITDpy/">
+    <img src="https://img.shields.io/badge/docs-online-blue" alt="Docs">
+  </a>
+</p>
+
+Python SDK для социальной сети итд.com.
+
+> Неофициальный API-клиент.
+> SDK предназначен для клиентских приложений, интеграций и сервисов, работающих в рамках правил платформы.
+
+## Безопасность и позиция проекта
+
+ITDpy не поддерживает спам, массовую автоматизацию, накрутку, ботов для злоупотреблений и другие сценарии, нарушающие правила платформы.
+
+Библиотека ориентирована на:
+
+- клиентские приложения
+- внутренние сервисы
+- интеграции
+- тестирование API
+
+## User-Agent
+
+По умолчанию библиотека использует браузерный User-Agent:
+
+```text
+Mozilla/5.0 (Linux; Android 11; SM-G991B)
+AppleWebKit/537.36 (KHTML, like Gecko)
+Chrome/120.0.6099.144 Mobile Safari/537.36
+```
+
+Это сделано для обеспечения стабильной работы, так как некоторые эндпоинты API могут некорректно обрабатывать нестандартные клиенты.
+
+Библиотека не использует User-Agent для обхода ограничений и ориентирована на корректное использование API.
+
+## Установка
+
+```bash
+pip install itdpy
+```
+
+### Через git
+
+```bash
+git clone https://github.com/Gam5510/ITDpy
+cd ITDpy
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Документация
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://gam5510.github.io/ITDpy/)
+
+Ссылка: [https://gam5510.github.io/ITDpy/](https://gam5510.github.io/ITDpy/) 
+
+## Быстрый старт
+
+> ![Получение токена](https://i.ibb.co/DH1m8GL7/Assistant.png)
+> Как получить токен
+
+- Открой `итд.com` в браузере и войди в аккаунт.
+- Открой DevTools (F12).
+- Перейди в `Application` -> `Cookies`.
+- Найди cookie `refresh_token`.
+- Скопируй её значение.
+
+```python
+from itdpy import ITDClient
+
+client = ITDClient(refresh_token="YOUR_REFRESH_TOKEN")
+
+me = client.users.me()
+print(me.id)
+print(me.username)
+```
+
+## Конфигурация
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    timeout=30,
+    upload_timeout=180,
+    max_retries=5,
+    backoff_factor=2.0,
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+## Кастомный User-Agent
+
+Если нужен полностью свой `User-Agent`, можно передать его через `Config.custom_user_agent`:
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    custom_user_agent="my-app/2.0",
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+Если `custom_user_agent` не задан, библиотека использует стандартный стартовый браузерный `User-Agent`.
+
+## User-Agent с данными пользователя
+
+Если нужно после авторизации переключиться на `User-Agent` с данными SDK и пользователя, включи `use_user_data_in_user_agent=True`:
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    service="my_app",
+    use_user_data_in_user_agent=True,
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+По умолчанию этот режим выключен.
+
+Шаблон можно переопределить через `Config.user_agent_template`:
+
+```python
+from itdpy import Config
+
+config = Config(
+    use_user_data_in_user_agent=True,
+    user_agent_template="itdpy/{sdk_version} ({parts})",
+)
+```
+
+Доступные поля шаблона:
+
+- `{sdk_version}`
+- `{parts}`
+- `{user_id}`
+- `{service}`
+
+## Примеры
+
+### Получить пост
+
+```python
+post = client.posts.get("POST_ID")
+print(post.id)
+print(post.to_dict())
+```
+
+### Лента постов
+
+```python
+posts = client.posts.list(limit=10)
+print(len(posts))
+print(posts[0].id)
+```
+
+### Создать пост
+
+```python
+client.posts.create(
+    content="Привет из ITDpy",
+)
+```
+
+### Markdown и HTML
+
+```python
+client.posts.create(
+    content="**Жирный** текст",
+    parse_md=True,
+)
+
+client.posts.create(
+    content="<b>Жирный</b> текст",
+    parse_html=True,
+)
+```
+
+### SSE streaming
+
+```python
+stream = client.notifications.stream()
+
+@stream.on("notification")
+def on_notification(event):
+    print(event.data)
+
+stream.run()
+```
+
+### keep_online
+
+```python
+client.keep_online(
+    on_event=lambda event_type, data: print(event_type, data),
+    background=True,
+)
+```
+
+### Обработка ошибок
+
+```python
+from itdpy import APIError, NotFoundError, RateLimitError, ValidationError
+
+try:
+    client.posts.get("invalid")
+except NotFoundError:
+    print("Не найдено")
+except ValidationError as e:
+    print(e.message)
+except RateLimitError as e:
+    print(e.retry_after)
+except APIError as e:
+    print(e.message)
+```
+
+## Прочее
+
+Проект активно развивается. Если у вас есть предложения или pull request, создавайте issue в репозитории.
+Мой телеграм для обратной связи: [@gam5510](https://t.me/gam5510)

itdpy-1.0.4/README.md

@@ -0,0 +1,244 @@
+# ITDpy
+
+<p align="center">
+  <img src="https://i.postimg.cc/gJ9z8RDk/ITDpy-(1)-pixian-ai.png" width="700">
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/pypi/v/itdpy?nocache=1" alt="PyPI version">
+  <img src="https://static.pepy.tech/badge/itdpy?nocache=1" alt="Downloads">
+  <img src="https://img.shields.io/github/license/Gam5510/ITDpy" alt="License">
+  <a href="https://gam5510.github.io/ITDpy/">
+    <img src="https://img.shields.io/badge/docs-online-blue" alt="Docs">
+  </a>
+</p>
+
+Python SDK для социальной сети итд.com.
+
+> Неофициальный API-клиент.
+> SDK предназначен для клиентских приложений, интеграций и сервисов, работающих в рамках правил платформы.
+
+## Безопасность и позиция проекта
+
+ITDpy не поддерживает спам, массовую автоматизацию, накрутку, ботов для злоупотреблений и другие сценарии, нарушающие правила платформы.
+
+Библиотека ориентирована на:
+
+- клиентские приложения
+- внутренние сервисы
+- интеграции
+- тестирование API
+
+## User-Agent
+
+По умолчанию библиотека использует браузерный User-Agent:
+
+```text
+Mozilla/5.0 (Linux; Android 11; SM-G991B)
+AppleWebKit/537.36 (KHTML, like Gecko)
+Chrome/120.0.6099.144 Mobile Safari/537.36
+```
+
+Это сделано для обеспечения стабильной работы, так как некоторые эндпоинты API могут некорректно обрабатывать нестандартные клиенты.
+
+Библиотека не использует User-Agent для обхода ограничений и ориентирована на корректное использование API.
+
+## Установка
+
+```bash
+pip install itdpy
+```
+
+### Через git
+
+```bash
+git clone https://github.com/Gam5510/ITDpy
+cd ITDpy
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Документация
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://gam5510.github.io/ITDpy/)
+
+Ссылка: [https://gam5510.github.io/ITDpy/](https://gam5510.github.io/ITDpy/) 
+
+## Быстрый старт
+
+> ![Получение токена](https://i.ibb.co/DH1m8GL7/Assistant.png)
+> Как получить токен
+
+- Открой `итд.com` в браузере и войди в аккаунт.
+- Открой DevTools (F12).
+- Перейди в `Application` -> `Cookies`.
+- Найди cookie `refresh_token`.
+- Скопируй её значение.
+
+```python
+from itdpy import ITDClient
+
+client = ITDClient(refresh_token="YOUR_REFRESH_TOKEN")
+
+me = client.users.me()
+print(me.id)
+print(me.username)
+```
+
+## Конфигурация
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    timeout=30,
+    upload_timeout=180,
+    max_retries=5,
+    backoff_factor=2.0,
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+## Кастомный User-Agent
+
+Если нужен полностью свой `User-Agent`, можно передать его через `Config.custom_user_agent`:
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    custom_user_agent="my-app/2.0",
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+Если `custom_user_agent` не задан, библиотека использует стандартный стартовый браузерный `User-Agent`.
+
+## User-Agent с данными пользователя
+
+Если нужно после авторизации переключиться на `User-Agent` с данными SDK и пользователя, включи `use_user_data_in_user_agent=True`:
+
+```python
+from itdpy import ITDClient, Config
+
+config = Config(
+    service="my_app",
+    use_user_data_in_user_agent=True,
+)
+
+client = ITDClient(
+    refresh_token="YOUR_REFRESH_TOKEN",
+    config=config,
+)
+```
+
+По умолчанию этот режим выключен.
+
+Шаблон можно переопределить через `Config.user_agent_template`:
+
+```python
+from itdpy import Config
+
+config = Config(
+    use_user_data_in_user_agent=True,
+    user_agent_template="itdpy/{sdk_version} ({parts})",
+)
+```
+
+Доступные поля шаблона:
+
+- `{sdk_version}`
+- `{parts}`
+- `{user_id}`
+- `{service}`
+
+## Примеры
+
+### Получить пост
+
+```python
+post = client.posts.get("POST_ID")
+print(post.id)
+print(post.to_dict())
+```
+
+### Лента постов
+
+```python
+posts = client.posts.list(limit=10)
+print(len(posts))
+print(posts[0].id)
+```
+
+### Создать пост
+
+```python
+client.posts.create(
+    content="Привет из ITDpy",
+)
+```
+
+### Markdown и HTML
+
+```python
+client.posts.create(
+    content="**Жирный** текст",
+    parse_md=True,
+)
+
+client.posts.create(
+    content="<b>Жирный</b> текст",
+    parse_html=True,
+)
+```
+
+### SSE streaming
+
+```python
+stream = client.notifications.stream()
+
+@stream.on("notification")
+def on_notification(event):
+    print(event.data)
+
+stream.run()
+```
+
+### keep_online
+
+```python
+client.keep_online(
+    on_event=lambda event_type, data: print(event_type, data),
+    background=True,
+)
+```
+
+### Обработка ошибок
+
+```python
+from itdpy import APIError, NotFoundError, RateLimitError, ValidationError
+
+try:
+    client.posts.get("invalid")
+except NotFoundError:
+    print("Не найдено")
+except ValidationError as e:
+    print(e.message)
+except RateLimitError as e:
+    print(e.retry_after)
+except APIError as e:
+    print(e.message)
+```
+
+## Прочее
+
+Проект активно развивается. Если у вас есть предложения или pull request, создавайте issue в репозитории.
+Мой телеграм для обратной связи: [@gam5510](https://t.me/gam5510)

{itdpy-1.0.2 → itdpy-1.0.4}/itdpy/client.py

@@ -40,14 +40,7 @@ class ITDClient:
             name="refresh_token",
             value=self._refresh_token,
             domain="xn--d1ah4a.com",
-            path="/api",
-        )
-
-        self._request_handler.session.headers.update(
-            {
-                "Origin": self.config.base_url,
-                "Referer": f"{self.config.base_url}/",
-            }
+            path="/",
         )
 
     def _authenticate(self) -> None:
@@ -73,6 +66,14 @@ class ITDClient:
         self._update_user_agent()
 
     def _update_user_agent(self) -> None:
+        if self.config.custom_user_agent:
+            self._request_handler.session.headers["User-Agent"] = self.config.custom_user_agent
+            return
+
+        if not self.config.use_user_data_in_user_agent:
+            self._request_handler.session.headers["User-Agent"] = self.config.initial_user_agent
+            return
+
         parts = [f"platform=python"]
         if self._user_id:
             parts.insert(0, f"userid={self._user_id}")
@@ -81,7 +82,12 @@ class ITDClient:
         if self.config.service:
             parts.append(f"service={self.config.service}")
 
-        user_agent = f"itdpy/{self.config.sdk_version} ({'; '.join(parts)})"
+        user_agent = self.config.user_agent_template.format(
+            sdk_version=self.config.sdk_version,
+            parts="; ".join(parts),
+            user_id=self._user_id or "",
+            service=self.config.service or "",
+        )
         self._request_handler.session.headers["User-Agent"] = user_agent
 
     @property

itdpy-1.0.4/itdpy/config.py

@@ -0,0 +1,20 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class Config:
+    base_url: str = "https://xn--d1ah4a.com"
+    timeout: int = 20
+    upload_timeout: int = 120
+    max_retries: int = 3
+    backoff_factor: float = 1.5
+    sdk_version: str = "1.0.2"
+    service: str | None = None
+    initial_user_agent: str = (
+        "Mozilla/5.0 (Linux; Android 11; SM-G991B)"
+        "AppleWebKit/537.36 (KHTML, like Gecko)"
+        "Chrome/120.0.6099.144 Mobile Safari/537.36"
+    )
+    custom_user_agent: str | None = None
+    user_agent_template: str = "itdpy/{sdk_version} ({parts})"
+    use_user_data_in_user_agent: bool = False

{itdpy-1.0.2 → itdpy-1.0.4}/itdpy/enums.py

@@ -60,6 +60,7 @@ class NotificationType(str, Enum):
     REPLY = "reply"
     REPOST = "repost"
     FOLLOW = "follow"
+    WALL_POST = "wall_post"
 
 
 class NotificationTargetType(str, Enum):

{itdpy-1.0.2 → itdpy-1.0.4}/itdpy/request.py

@@ -37,8 +37,22 @@ class RequestHandler:
         adapter = HTTPAdapter(max_retries=retry_strategy)
         session.mount("http://", adapter)
         session.mount("https://", adapter)
+
+        session.headers.update(self._build_default_headers())
         
         return session
+
+    def _build_default_headers(self) -> dict[str, str]:
+        return {
+            "User-Agent": self._build_initial_user_agent(),
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+            "Origin": self.config.base_url,
+            "Referer": f"{self.config.base_url}/",
+        }
+
+    def _build_initial_user_agent(self) -> str:
+        return self.config.custom_user_agent or self.config.initial_user_agent
     
     def request(
         self,

{itdpy-1.0.2 → itdpy-1.0.4}/itdpy/streaming.py

@@ -45,6 +45,7 @@ class NotificationStream:
         self._stopped = False
         self._last_event_id: str | None = None
         self._handlers: dict[str, list[_HandlerSubscription]] = {}
+        self._active_response: requests.Response | None = None
 
     def on(
         self,
@@ -64,17 +65,23 @@ class NotificationStream:
 
     def stop(self) -> None:
         self._stopped = True
+        self._close_active_response()
 
     def run(self) -> None:
-        for _ in self:
-            pass
+        try:
+            for _ in self:
+                pass
+        except KeyboardInterrupt:
+            self.stop()
 
     def __iter__(self) -> Iterator[StreamEvent]:
         backoff = 1
 
         while not self._stopped:
+            response: requests.Response | None = None
             try:
                 response = self._connect()
+                self._active_response = response
                 backoff = 1
 
                 client = self._create_sse_client(response)
@@ -89,7 +96,9 @@ class NotificationStream:
 
                     self._dispatch(parsed_event)
                     yield parsed_event
-
+            except KeyboardInterrupt:
+                self.stop()
+                return
             except requests.RequestException as exc:
                 error_event = StreamEvent(event="error", data={"message": str(exc)})
                 self._dispatch(error_event)
@@ -98,6 +107,11 @@ class NotificationStream:
                 error_event = StreamEvent(event="error", data={"message": str(exc)})
                 self._dispatch(error_event)
                 yield error_event
+            finally:
+                if response is not None:
+                    response.close()
+                if self._active_response is response:
+                    self._active_response = None
 
             if self._stopped:
                 break
@@ -105,7 +119,11 @@ class NotificationStream:
             reconnect_event = StreamEvent(event="reconnecting", data={"delay": backoff})
             self._dispatch(reconnect_event)
             yield reconnect_event
-            time.sleep(backoff)
+            try:
+                time.sleep(backoff)
+            except KeyboardInterrupt:
+                self.stop()
+                break
             backoff = min(self._next_backoff(backoff), self._max_backoff)
 
     def _connect(self) -> requests.Response:
@@ -189,3 +207,12 @@ class NotificationStream:
         if current < 5:
             return 5
         return current * 2
+
+    def _close_active_response(self) -> None:
+        if self._active_response is None:
+            return
+
+        try:
+            self._active_response.close()
+        finally:
+            self._active_response = None