itdpy 0.1.2__tar.gz

itdpy-0.1.2/LICENSE

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

itdpy-0.1.2/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: itdpy
+Version: 0.1.2
+Summary: Python SDK for ИТД.com 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
+Dynamic: license-file
+
+# ITDpy
+
+Python SDK для социальной сети ITD.
+Упрощает работу с SDK API и позволяет быстро писать ботов и автоматизации.
+
+
+## Установка без pip
+
+Пока библиотека не опубликована в PyPI, можно установить её вручную.
+
+### Через git
+
+```bash
+git clone https://github.com/Gam5510/ITDpy
+cd itdpy
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Быстрый старт
+
+> Blockquote ![Получение токена](https://i.ibb.co/DH1m8GL7/Assistant.png)
+Как получить токен
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  get_me
+
+client  =  ITDClient(refresh_token="Ваш refresh token")
+
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+  
+me  =  get_me(client)
+print(me.id)
+print(me.username)
+```
+
+### Скрипт на обновление имени
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile
+from  datetime  import  datetime
+import  time
+
+client = ITDClient(refresh_token="Ваш_токен")
+auth = AuthManager(client)
+
+auth.refresh_access_token()
+
+while  True:
+	update_profile(client,  display_name=f"Фазлиддин |{datetime.now().strftime('%m.%d %H:%M:%S')}|")
+	time.sleep(1)
+```
+
+### Скрипт на обновление баннера 
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile, upload_file
+from  datetime  import  datetime
+import  time
+
+client  =  ITDClient(refresh_token="Ваш_токен")
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+
+file  =  upload_file(client,  "matrix-rain-effect-animation-photoshop-editor.gif")
+print(file.id)
+update  =  update_profile(client,  banner_id=file.id)
+print(update.banner)
+```
+
+# Костомные запросы  
+
+## ✅ Базовый пример кастомного GET
+```python
+response = client.get("/api/users/me")
+data = response.json() 
+print(data)
+```
+### Можно добавить любой эндпоинт
+----------
+
+## ✅ POST с JSON
+```python
+response = client.post( 
+		"/api/posts",
+    json={ "content": "Привет из кастомного запроса" }
+) 
+print(response.status_code) 
+print(response.json())
+```
+----------
+
+## ✅ PUT / PATCH
+```python
+response = client.patch( "/api/profile",
+    json={ "displayName": "Фазлиддин 😎" }
+)
+```
+----------
+
+## ✅ DELETE
+```python
+client.delete("/api/posts/POST_ID") 
+```
+----------
+
+## ✅ Передача query-параметров
+```python
+response = client.get( "/api/posts",
+    params={ "limit": 50, "sort": "popular" }
+)
+```
+
+## Планы
+
+- Асинхронная версия библиотеки (`aioitd`)
+- Улучшенная обработка и форматирование ошибок
+- Логирование (через `logging`)
+- Расширение объектной модели (Post, Comment, User и др.)
+- Дополнительные API-эндпоинты по мере появления
+- Улучшение документации и примеров
+
+
+## Прочее
+
+Проект активно развивается.
+Если у вас есть идеи или предложения — создавайте issue или pull request.

itdpy-0.1.2/README.md

@@ -0,0 +1,133 @@
+# ITDpy
+
+Python SDK для социальной сети ITD.
+Упрощает работу с SDK API и позволяет быстро писать ботов и автоматизации.
+
+
+## Установка без pip
+
+Пока библиотека не опубликована в PyPI, можно установить её вручную.
+
+### Через git
+
+```bash
+git clone https://github.com/Gam5510/ITDpy
+cd itdpy
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Быстрый старт
+
+> Blockquote ![Получение токена](https://i.ibb.co/DH1m8GL7/Assistant.png)
+Как получить токен
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  get_me
+
+client  =  ITDClient(refresh_token="Ваш refresh token")
+
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+  
+me  =  get_me(client)
+print(me.id)
+print(me.username)
+```
+
+### Скрипт на обновление имени
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile
+from  datetime  import  datetime
+import  time
+
+client = ITDClient(refresh_token="Ваш_токен")
+auth = AuthManager(client)
+
+auth.refresh_access_token()
+
+while  True:
+	update_profile(client,  display_name=f"Фазлиддин |{datetime.now().strftime('%m.%d %H:%M:%S')}|")
+	time.sleep(1)
+```
+
+### Скрипт на обновление баннера 
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile, upload_file
+from  datetime  import  datetime
+import  time
+
+client  =  ITDClient(refresh_token="Ваш_токен")
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+
+file  =  upload_file(client,  "matrix-rain-effect-animation-photoshop-editor.gif")
+print(file.id)
+update  =  update_profile(client,  banner_id=file.id)
+print(update.banner)
+```
+
+# Костомные запросы  
+
+## ✅ Базовый пример кастомного GET
+```python
+response = client.get("/api/users/me")
+data = response.json() 
+print(data)
+```
+### Можно добавить любой эндпоинт
+----------
+
+## ✅ POST с JSON
+```python
+response = client.post( 
+		"/api/posts",
+    json={ "content": "Привет из кастомного запроса" }
+) 
+print(response.status_code) 
+print(response.json())
+```
+----------
+
+## ✅ PUT / PATCH
+```python
+response = client.patch( "/api/profile",
+    json={ "displayName": "Фазлиддин 😎" }
+)
+```
+----------
+
+## ✅ DELETE
+```python
+client.delete("/api/posts/POST_ID") 
+```
+----------
+
+## ✅ Передача query-параметров
+```python
+response = client.get( "/api/posts",
+    params={ "limit": 50, "sort": "popular" }
+)
+```
+
+## Планы
+
+- Асинхронная версия библиотеки (`aioitd`)
+- Улучшенная обработка и форматирование ошибок
+- Логирование (через `logging`)
+- Расширение объектной модели (Post, Comment, User и др.)
+- Дополнительные API-эндпоинты по мере появления
+- Улучшение документации и примеров
+
+
+## Прочее
+
+Проект активно развивается.
+Если у вас есть идеи или предложения — создавайте issue или pull request.

itdpy-0.1.2/itdpy/api/__init__.py

@@ -0,0 +1,47 @@
+# posts
+from .posts import (
+    get_post,
+    get_posts,
+    create_post,
+    update_post,
+    delete_post,
+    like_post,
+    unlike_post,
+    repost_post,
+    get_user_posts,
+)
+
+# comments
+from .comments import (
+    create_comment,
+    reply_to_comment,
+    like_comment,
+    unlike_comment,
+    delete_comment,
+)
+
+# users
+from .users import (
+    get_me,
+    get_user,
+    get_followers,
+    get_following,
+    follow_user,
+    unfollow_user,
+)
+
+# notifications
+from .notifications import (
+    get_notifications,
+    mark_notification_read,
+    mark_all_notification_read,
+)
+
+# clans
+from .clans import get_top_clans
+
+# files
+from .files import upload_file
+
+# profile
+from .profile import update_profile

itdpy-0.1.2/itdpy/api/clans.py

@@ -0,0 +1,3 @@
+def get_top_clans(client):
+    r = client.get("/api/users/stats/top-clans")
+    return r.json()

itdpy-0.1.2/itdpy/api/comments.py

@@ -0,0 +1,64 @@
+from ..models import Comment
+
+def create_comment(client, post_id: str, content: str, attachment_ids: list[str] | str | None = None):
+    if attachment_ids is None:
+        attachment_ids = []
+    elif isinstance(attachment_ids, str):
+        attachment_ids = [attachment_ids]
+
+    payload = {
+        "content": content,
+        "attachmentIds": attachment_ids
+    }
+
+    r = client.post(
+        f"/api/posts/{post_id}/comments",
+        json=payload
+    )
+
+    r.raise_for_status()
+    return Comment(r.json())
+
+def reply_to_comment(client, comment_id: str, content: str, attachment_ids: list[str] | str | None = None):
+    
+    if attachment_ids is None:
+        attachment_ids = []
+    elif isinstance(attachment_ids, str):
+        attachment_ids = [attachment_ids]
+
+    payload = {
+        "content": content,
+        "attachmentIds": attachment_ids
+    }
+
+    r = client.post(
+        f"/api/comments/{comment_id}/replies",
+        json=payload
+    )
+
+    r.raise_for_status()
+    return Comment(r.json())
+
+def delete_comment(client, comment_id: str) -> bool:
+    r = client.delete(f"/api/comments/{comment_id}")
+
+    if r.status_code == 204:
+        return True
+
+    r.raise_for_status()
+    return False
+
+def like_comment(client, comment_id: str):
+    r = client.post(f"/api/comments/{comment_id}/like")
+    r.raise_for_status()
+    if r.status_code == 200:
+        return True
+    return False
+
+
+def unlike_comment(client, comment_id: str):
+    r = client.delete(f"/api/comments/{comment_id}/like")
+    r.raise_for_status()
+    if r.status_code == 200:
+        return True
+    return False

itdpy-0.1.2/itdpy/api/files.py

@@ -0,0 +1,11 @@
+from ..models import Attachment
+
+def upload_file(client, file_path: str):
+    with open(file_path, "rb") as f:
+        r = client.post(
+            "/api/files/upload",
+            files={"file": f}
+        )
+
+    r.raise_for_status()
+    return Attachment(r.json())

itdpy-0.1.2/itdpy/api/notifications.py

@@ -0,0 +1,39 @@
+from ..models.notifications import Notifications
+
+
+def get_notifications(client, offset: int = 0, limit: int = 20):
+    r = client.get(
+        f"/api/notifications/?offset={offset}&limit={limit}"
+    )
+    r.raise_for_status()
+
+    return Notifications(r.json())
+
+
+def mark_notification_read(client, notification_id: str) -> bool:
+    r = client.post(
+        f"/api/notifications/{notification_id}/read"
+    )
+    r.raise_for_status()
+
+    data = r.json()
+    return data.get("success", False)
+
+def mark_all_notification_read(client, notification_ids: list[str]) -> int:
+
+    if not notification_ids:
+        return 0
+    
+    if notification_ids is None:
+        notification_ids = []
+    elif isinstance(notification_ids, str):
+        notification_ids = [notification_ids]
+
+    r = client.post(
+        "/api/notifications/read-batch",
+        json=notification_ids
+    )
+    r.raise_for_status()
+
+    data = r.json()
+    return data.get("count", 0)

itdpy-0.1.2/itdpy/api/posts.py

@@ -0,0 +1,83 @@
+from ..models import Posts, Post
+
+def get_posts(client, limit: int = 20, tab: str = "popular"):
+    r = client.get(f"/api/posts?limit={limit}&tab={tab}")
+    r.raise_for_status()
+
+    return Posts(r.json())
+
+def get_post(client, post_id: str):
+    r = client.get(f"/api/posts/{post_id}")
+    return Post(r.json())
+
+def create_post(client,content: str = "",attachment_ids: list[str] | str | None = None,wall_recipient_id: str | None = None):
+
+    if attachment_ids is None:
+        attachment_ids = []
+    elif isinstance(attachment_ids, str):
+        attachment_ids = [attachment_ids]
+
+    payload = {
+        "content": content,
+        "attachmentIds": attachment_ids
+    }
+
+    if wall_recipient_id is not None:
+        payload["wallRecipientId"] = wall_recipient_id
+
+    r = client.post(
+        "/api/posts",
+        json=payload
+    )
+
+    r.raise_for_status()
+    return Post(r.json())
+
+def update_post(client, post_id: str, content: str):
+    payload = {
+        "content": content
+    }
+
+    r = client.put(
+        f"/api/posts/{post_id}",
+        json=payload
+    )
+
+    r.raise_for_status()
+    return r.json()
+
+def delete_post(client, post_id: str) -> bool:
+    r = client.delete(f"/api/posts/{post_id}")
+
+    if r.status_code == 204:
+        return True
+
+    r.raise_for_status()
+    return False
+
+def like_post(client, post_id: str):
+    r = client.post(f"/api/posts/{post_id}/like")
+    r.raise_for_status()
+    if r.status_code == 200:
+        return True
+    return False
+
+def unlike_post(client, post_id: str):
+    r = client.delete(f"/api/posts/{post_id}/like")
+    r.raise_for_status()
+    if r.status_code == 200:
+        return True
+    return False
+
+def repost_post(client, post_id: str):
+    r = client.post(f"/api/posts/{post_id}/repost")
+    r.raise_for_status()
+    return True
+
+def get_user_posts(client, username: str, limit: int = 20, sort: str = "new"):# new | popular
+    r = client.get(
+        f"/api/posts/user/{username}?limit={limit}&sort={sort}"
+    )
+    r.raise_for_status()
+
+    return Posts(r.json())

itdpy-0.1.2/itdpy/api/profile.py

@@ -0,0 +1,26 @@
+from ..models.me import Me
+
+
+def update_profile(client, *, display_name: str | None = None, username: str | None = None, bio: str | None = None, banner_id: str | None = None) -> Me:
+    payload = {}
+
+    if display_name is not None:
+        payload["displayName"] = display_name
+
+    if username is not None:
+        payload["username"] = username
+
+    if bio is not None:
+        payload["bio"] = bio
+
+    if banner_id is not None:
+        payload["bannerId"] = banner_id
+
+    if not payload:
+        raise ValueError("No profile fields provided to update")
+
+    r = client.put("/api/users/me", json=payload)
+    r.raise_for_status()
+
+    return Me(r.json())
+

itdpy-0.1.2/itdpy/api/users.py

@@ -0,0 +1,33 @@
+from ..models import User, Me, Users
+
+def get_me(client):
+    r = client.get("/api/users/me")
+    return Me(r.json())
+
+def get_user(client, username):
+    r = client.get(f"/api/users/{username}")
+    return User(r.json())
+
+def follow_user(client, username: str):
+    r = client.post(f"/api/users/{username}/follow")
+    r.raise_for_status()
+    return True
+
+def unfollow_user(client, username: str):
+    r = client.delete(f"/api/users/{username}/follow")
+    r.raise_for_status()
+    return True
+
+def get_followers(client, username: str, page: int = 1, limit: int = 30):
+    r = client.get(
+        f"/api/users/{username}/followers?page={page}&limit={limit}"
+    )
+    r.raise_for_status()
+    return Users(r.json())
+
+def get_following(client, username: str, page: int = 1, limit: int = 30):
+    r = client.get(
+        f"/api/users/{username}/following?page={page}&limit={limit}"
+    )
+    r.raise_for_status()
+    return Users(r.json())

itdpy-0.1.2/itdpy/auth.py

@@ -0,0 +1,41 @@
+from .client import ITDClient
+
+
+class AuthManager:
+    def __init__(self, client: ITDClient):
+        self.client = client
+        self.client._bind_auth_manager(self)
+
+    def _has_refresh_token(self) -> bool:
+        return any(
+            c.name == "refresh_token"
+            for c in self.client.session.cookies
+        )
+
+    def refresh_access_token(self) -> str | None:
+
+        if not self._has_refresh_token():
+            raise RuntimeError("refresh_token not found in cookies")
+
+        r = self.client.post("/api/v1/auth/refresh")
+        if r.status_code != 200:
+            return None
+
+        token = r.json().get("accessToken")
+        if not token:
+            return None
+
+        self.client._set_access_token(token)
+
+        self._bootstrap_identity()
+
+        return token
+
+    def _bootstrap_identity(self):
+        r = self.client.get("/api/users/me")
+        if r.status_code != 200:
+            return
+
+        user_id = r.json().get("id")
+        if user_id:
+            self.client._set_user_id(user_id)

itdpy-0.1.2/itdpy/client.py

@@ -0,0 +1,105 @@
+import requests
+
+
+class ITDClient:
+
+    _DEFAULT_TIMEOUT = 15
+    _UPLOAD_TIMEOUT = 3600
+    _SDK_NAME = "itd-sdk-python"
+    _SDK_VERSION = "0.1"
+    _PLATFORM = "python"
+    
+
+    def __init__(self, refresh_token: str):
+        self.base_url = "https://xn--d1ah4a.com"
+        self.session = requests.Session()
+
+        self._access_token = None
+        self._user_id = None
+        self._auth_manager = None
+
+        self.session.headers.update({
+            "Origin": self.base_url,
+            "Referer": self.base_url + "/"
+        })
+
+        self.session.cookies.set(
+            name="refresh_token",
+            value=refresh_token,
+            domain="xn--d1ah4a.com",
+            path="/api"
+        )
+
+        self._apply_user_agent(initial=True)
+
+    def _bind_auth_manager(self, auth_manager):
+        self._auth_manager = auth_manager
+
+    def _set_access_token(self, token: str):
+        self._access_token = token
+        self.session.headers["Authorization"] = f"Bearer {token}"
+
+    def _set_user_id(self, user_id: str):
+        self._user_id = user_id
+        self._apply_user_agent()
+
+    def _build_user_agent(self, initial: bool = False) -> str:
+        if initial or not self._user_id:
+            return (
+                f"{self._SDK_NAME}/{self._SDK_VERSION} "
+                f"(initial; platform={self._PLATFORM})"
+            )
+
+        return (
+            f"{self._SDK_NAME}/{self._SDK_VERSION} "
+            f"(userid={self._user_id}; platform={self._PLATFORM})"
+        )
+
+    def _apply_user_agent(self, initial: bool = False):
+        # всегда перезаписываем — анти-подмена
+        self.session.headers["User-Agent"] = self._build_user_agent(initial)
+
+    def _request(self, method: str, path: str, retry: bool = True, **kwargs):
+        self._apply_user_agent()
+
+        if not path.startswith("/"):
+            path = "/" + path
+
+        url = self.base_url + path
+
+        timeout = kwargs.pop("timeout", None)
+        if timeout is None:
+            if path.startswith("/api/files"):
+                timeout = self._UPLOAD_TIMEOUT
+            else:
+                timeout = self._DEFAULT_TIMEOUT
+
+        response = self.session.request(
+            method,
+            url,
+            timeout=timeout,
+            **kwargs
+        )
+
+        if response.status_code == 401 and retry and self._auth_manager:
+            refreshed = self._auth_manager.refresh_access_token()
+            if refreshed:
+                return self._request(method, path, retry=False, **kwargs)
+
+        return response
+
+
+    def get(self, path: str, **kwargs):
+        return self._request("GET", path, **kwargs)
+
+    def post(self, path: str, **kwargs):
+        return self._request("POST", path, **kwargs)
+
+    def put(self, path: str, **kwargs):
+        return self._request("PUT", path, **kwargs)
+
+    def patch(self, path: str, **kwargs):
+        return self._request("PATCH", path, **kwargs)
+
+    def delete(self, path: str, **kwargs):
+        return self._request("DELETE", path, **kwargs)

itdpy-0.1.2/itdpy/models/__init__.py

@@ -0,0 +1,8 @@
+from .user import User
+from .me import Me
+from .user_lite import UserLite
+from .post import Post
+from .comment import Comment
+from .attachment import Attachment
+from .posts import Posts
+from .users import Users

itdpy-0.1.2/itdpy/models/actor.py

@@ -0,0 +1,9 @@
+class Actor:
+    def __init__(self, data: dict):
+        self.id = data.get("id")
+        self.username = data.get("username")
+        self.displayName = data.get("displayName")
+        self.avatar = data.get("avatar")
+
+    def __repr__(self):
+        return f"<Actor @{self.username}>"

itdpy-0.1.2/itdpy/models/attachment.py

@@ -0,0 +1,12 @@
+import json
+
+class Attachment:
+    def __init__(self, data: dict):
+        self._data = data
+        self.id = data.get("id")
+        self.url = data.get("url")
+        self.filename = data.get("filename")
+        self.mimeType = data.get("mimeType")
+        self.size = data.get("size")
+    def __str__(self):
+        return json.dumps(self._data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/base.py

@@ -0,0 +1,6 @@
+class BaseModel:
+    def __init__(self, data: dict):
+        self._data = data
+
+    def to_dict(self):
+        return self._data

itdpy-0.1.2/itdpy/models/comment.py

@@ -0,0 +1,26 @@
+from .user_lite import UserLite
+from .attachment import Attachment
+import json
+
+class Comment:
+    def __init__(self, data: dict):
+        self.id = data.get("id")
+        self.content = data.get("content")
+        self.likesCount = data.get("likesCount")
+        self.repliesCount = data.get("repliesCount")
+        self.isLiked = data.get("isLiked")
+        self.createdAt = data.get("createdAt")
+
+        self.author = UserLite(data.get("author"))
+        self.attachments = [
+            Attachment(a) for a in data.get("attachments", [])
+        ]
+
+        self.replies = [
+            Comment(r) for r in data.get("replies", [])
+        ]
+
+        self.data = data
+    
+    def __str__(self):
+        return json.dumps(self.data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/me.py

@@ -0,0 +1,12 @@
+from .user import User
+import json
+
+class Me(User):
+    def __init__(self, data: dict):
+        super().__init__(data)
+        self.data = data
+
+        self.isPrivate = data.get("isPrivate")
+
+    def __str__(self):
+        return json.dumps(self.data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/notification.py

@@ -0,0 +1,19 @@
+from .actor import Actor
+
+class Notification:
+    def __init__(self, data: dict):
+        self.id = data.get("id")
+        self.type = data.get("type")              # comment | like | follow | reply
+        self.target_type = data.get("targetType") # post | None
+        self.target_id = data.get("targetId")
+        self.preview = data.get("preview")
+
+        self.read = data.get("read")
+        self.read_at = data.get("readAt")
+        self.created_at = data.get("createdAt")
+
+        actor_data = data.get("actor")
+        self.actor = Actor(actor_data) if actor_data else None
+
+    def __repr__(self):
+        return f"<Notification {self.type} from @{self.actor.username if self.actor else '?'}>"

itdpy-0.1.2/itdpy/models/notifications.py

@@ -0,0 +1,21 @@
+from .notification import Notification
+
+
+class Notifications:
+    def __init__(self, response: dict):
+        items = response.get("notifications", [])
+
+        self._items = [Notification(n) for n in items]
+        self.has_more = response.get("hasMore", False)
+
+    def __getitem__(self, index):
+        return self._items[index]
+
+    def __len__(self):
+        return len(self._items)
+
+    def __iter__(self):
+        return iter(self._items)
+
+    def __repr__(self):
+        return f"<Notifications count={len(self)}>"

itdpy-0.1.2/itdpy/models/post.py

@@ -0,0 +1,47 @@
+from .user_lite import UserLite
+from .attachment import Attachment
+from .comment import Comment
+import json
+
+class Post:
+    def __init__(self, data: dict):
+
+        if "data" in data:
+            data = data["data"]
+
+        self._data = data
+
+        self.id = data.get("id")
+        self.content = data.get("content")
+        self.likesCount = data.get("likesCount")
+        self.commentsCount = data.get("commentsCount")
+        self.repostsCount = data.get("repostsCount")
+        self.viewsCount = data.get("viewsCount")
+        self.isLiked = data.get("isLiked")
+        self.isReposted = data.get("isReposted")
+        self.isViewed = data.get("isViewed")
+        self.isOwner = data.get("isOwner")
+        self.createdAt = data.get("createdAt")
+
+        self.author = UserLite(data.get("author"))
+
+        self.attachments = [
+            Attachment(a) for a in data.get("attachments", [])
+        ]
+
+        self.comments = [
+            Comment(c) for c in data.get("comments", [])
+        ]
+
+        # wall
+        self.wallRecipientId = data.get("wallRecipientId")
+        self.wallRecipient = (
+            UserLite(data["wallRecipient"])
+            if data.get("wallRecipient") else None
+        )
+
+    def __repr__(self):
+        return f"<Post {self.id}>"
+    
+    def __str__(self):
+        return json.dumps(self._data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/posts.py

@@ -0,0 +1,40 @@
+from .post import Post
+import json
+
+class Posts:
+    def __init__(self, response: dict):
+        data = response.get("data")
+        self._data = data 
+
+        if isinstance(data, list):
+            items = data
+            pagination = {}
+
+        elif isinstance(data, dict):
+            items = data.get("posts", [])
+            pagination = data.get("pagination", {})
+
+        else:
+            items = []
+            pagination = {}
+
+        self._items = [Post(item) for item in items]
+
+        self.limit = pagination.get("limit")
+        self.next_cursor = pagination.get("nextCursor")
+        self.has_more = pagination.get("hasMore")
+
+    def __getitem__(self, index):
+        return self._items[index]
+
+    def __len__(self):
+        return len(self._items)
+
+    def __iter__(self):
+        return iter(self._items)
+
+    def __repr__(self):
+        return f"<Posts count={len(self)}>"
+    
+    def __str__(self):
+        return json.dumps(self._data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/user.py

@@ -0,0 +1,23 @@
+import json
+from .user_lite import UserLite
+
+
+class User(UserLite):
+    def __init__(self, data: dict):
+        super().__init__(data)
+
+        self.banner = data.get("banner")
+        self.bio = data.get("bio")
+        self.pinnedPostId = data.get("pinnedPostId")
+        self.wallClosed = data.get("wallClosed")
+        self.followersCount = data.get("followersCount")
+        self.followingCount = data.get("followingCount")
+        self.postsCount = data.get("postsCount")
+        self.isFollowing = data.get("isFollowing")
+        self.isFollowedBy = data.get("isFollowedBy")
+        self.createdAt = data.get("createdAt")
+
+        self._data = data
+
+    def __str__(self):
+        return json.dumps(self._data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/user_lite.py

@@ -0,0 +1,18 @@
+import json
+
+class UserLite:
+    def __init__(self, data: dict):
+        self._data = data or {}
+
+        self.id = data.get("id")
+        self.username = data.get("username")
+        self.displayName = data.get("displayName")
+        self.avatar = data.get("avatar")
+        self.verified = data.get("verified")
+        self.isFollowing = data.get("isFollowing")
+
+    def __repr__(self):
+        return f"<UserLite @{self.username}>"
+    
+    def __str__(self):
+        return json.dumps(self._data, ensure_ascii=False)

itdpy-0.1.2/itdpy/models/users.py

@@ -0,0 +1,26 @@
+from .user_lite import UserLite
+
+
+class Users:
+    def __init__(self, response: dict):
+        data = response.get("data", {})
+
+        self._items = [UserLite(u) for u in data.get("users", [])]
+
+        pagination = data.get("pagination", {})
+        self.page = pagination.get("page")
+        self.limit = pagination.get("limit")
+        self.total = pagination.get("total")
+        self.has_more = pagination.get("hasMore")
+
+    def __getitem__(self, index):
+        return self._items[index]
+
+    def __len__(self):
+        return len(self._items)
+
+    def __iter__(self):
+        return iter(self._items)
+
+    def __repr__(self):
+        return f"<Users count={len(self)}>"

itdpy-0.1.2/itdpy/validate.py

@@ -0,0 +1,15 @@
+from .auth import AuthManager
+
+def validate_and_refresh(auth: AuthManager) -> bool:
+    if not auth.client.access_token:
+        return False
+
+    r = auth.client.get("/api/users/me")
+
+    if r.status_code == 200:
+        return True
+
+    if r.status_code == 401:
+        return bool(auth.refresh_access_token())
+
+    return False

itdpy-0.1.2/itdpy.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: itdpy
+Version: 0.1.2
+Summary: Python SDK for ИТД.com 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
+Dynamic: license-file
+
+# ITDpy
+
+Python SDK для социальной сети ITD.
+Упрощает работу с SDK API и позволяет быстро писать ботов и автоматизации.
+
+
+## Установка без pip
+
+Пока библиотека не опубликована в PyPI, можно установить её вручную.
+
+### Через git
+
+```bash
+git clone https://github.com/Gam5510/ITDpy
+cd itdpy
+pip install -r requirements.txt
+pip install -e .
+```
+
+## Быстрый старт
+
+> Blockquote ![Получение токена](https://i.ibb.co/DH1m8GL7/Assistant.png)
+Как получить токен
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  get_me
+
+client  =  ITDClient(refresh_token="Ваш refresh token")
+
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+  
+me  =  get_me(client)
+print(me.id)
+print(me.username)
+```
+
+### Скрипт на обновление имени
+
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile
+from  datetime  import  datetime
+import  time
+
+client = ITDClient(refresh_token="Ваш_токен")
+auth = AuthManager(client)
+
+auth.refresh_access_token()
+
+while  True:
+	update_profile(client,  display_name=f"Фазлиддин |{datetime.now().strftime('%m.%d %H:%M:%S')}|")
+	time.sleep(1)
+```
+
+### Скрипт на обновление баннера 
+```python
+from  itdpy.client  import  ITDClient
+from  itdpy.auth  import  AuthManager
+from  itdpy.api  import  update_profile, upload_file
+from  datetime  import  datetime
+import  time
+
+client  =  ITDClient(refresh_token="Ваш_токен")
+auth  =  AuthManager(client)
+auth.refresh_access_token()
+
+file  =  upload_file(client,  "matrix-rain-effect-animation-photoshop-editor.gif")
+print(file.id)
+update  =  update_profile(client,  banner_id=file.id)
+print(update.banner)
+```
+
+# Костомные запросы  
+
+## ✅ Базовый пример кастомного GET
+```python
+response = client.get("/api/users/me")
+data = response.json() 
+print(data)
+```
+### Можно добавить любой эндпоинт
+----------
+
+## ✅ POST с JSON
+```python
+response = client.post( 
+		"/api/posts",
+    json={ "content": "Привет из кастомного запроса" }
+) 
+print(response.status_code) 
+print(response.json())
+```
+----------
+
+## ✅ PUT / PATCH
+```python
+response = client.patch( "/api/profile",
+    json={ "displayName": "Фазлиддин 😎" }
+)
+```
+----------
+
+## ✅ DELETE
+```python
+client.delete("/api/posts/POST_ID") 
+```
+----------
+
+## ✅ Передача query-параметров
+```python
+response = client.get( "/api/posts",
+    params={ "limit": 50, "sort": "popular" }
+)
+```
+
+## Планы
+
+- Асинхронная версия библиотеки (`aioitd`)
+- Улучшенная обработка и форматирование ошибок
+- Логирование (через `logging`)
+- Расширение объектной модели (Post, Comment, User и др.)
+- Дополнительные API-эндпоинты по мере появления
+- Улучшение документации и примеров
+
+
+## Прочее
+
+Проект активно развивается.
+Если у вас есть идеи или предложения — создавайте issue или pull request.

itdpy-0.1.2/itdpy.egg-info/SOURCES.txt

@@ -0,0 +1,32 @@
+LICENSE
+README.md
+pyproject.toml
+itdpy/auth.py
+itdpy/client.py
+itdpy/validate.py
+itdpy.egg-info/PKG-INFO
+itdpy.egg-info/SOURCES.txt
+itdpy.egg-info/dependency_links.txt
+itdpy.egg-info/requires.txt
+itdpy.egg-info/top_level.txt
+itdpy/api/__init__.py
+itdpy/api/clans.py
+itdpy/api/comments.py
+itdpy/api/files.py
+itdpy/api/notifications.py
+itdpy/api/posts.py
+itdpy/api/profile.py
+itdpy/api/users.py
+itdpy/models/__init__.py
+itdpy/models/actor.py
+itdpy/models/attachment.py
+itdpy/models/base.py
+itdpy/models/comment.py
+itdpy/models/me.py
+itdpy/models/notification.py
+itdpy/models/notifications.py
+itdpy/models/post.py
+itdpy/models/posts.py
+itdpy/models/user.py
+itdpy/models/user_lite.py
+itdpy/models/users.py

itdpy-0.1.2/itdpy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

itdpy-0.1.2/itdpy.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

itdpy-0.1.2/itdpy.egg-info/top_level.txt

@@ -0,0 +1 @@
+itdpy

itdpy-0.1.2/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "itdpy"
+version = "0.1.2"
+description = "Python SDK for ИТД.com API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "Gam5510" }
+]
+
+dependencies = [
+  "requests>=2.28.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/Gam5510/ITDpy"
+Repository = "https://github.com/Gam5510/ITDpy"

itdpy-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+