chesshome 0.1.0__tar.gz

chesshome-0.1.0/LICENSE

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

chesshome-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: chesshome
+Version: 0.1.0
+Summary: Python client for ChessHome platform API
+Author-email: ChessHome <noreply@chesshome.pro>
+License-Expression: MIT
+Project-URL: Homepage, https://chesshome.pro
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Dynamic: license-file
+
+# ♟️ ChessHome Python Client
+
+Официальный Python-клиент для платформы [Chess Home](https://chesshome.pro).  
+Позволяет взаимодействовать с API: управлять турнирами, форумом, клубами, решать задачи, отправлять личные сообщения и многое другое.
+
+---
+
+## 🚀 Установка
+
+```bash
+pip install chesshome
+```
+
+Или установка из исходников:
+
+```bash
+git clone https://github.com/your_username/chesshome-py.git
+cd chesshome-py
+pip install -e .
+```
+
+---
+
+## 📖 Быстрый старт
+
+```python
+from chesshome import ChessHomeClient
+
+# Создаём клиент и авторизуемся
+client = ChessHomeClient()
+client.login("ваш_логин", "ваш_пароль")
+
+# Получаем свой профиль
+me = client.get_me()
+print(f"Привет, {me.username}! Рейтинг: {me.rating}")
+
+# Список активных турниров
+tours = client.get_tournaments(status="active")
+for t in tours:
+    print(f"{t.name} — {t.participantsCount} участников")
+
+# Создаём тему на форуме
+result = client.create_forum_thread(
+    title="Моя первая тема",
+    body="Привет! Это тест через Python-клиент."
+)
+print(f"Тема создана: {result['thread']['slug']}")
+
+# Отправляем личное сообщение
+client.send_dm("friend", "Привет! Как дела?")
+```
+
+---
+
+## 📚 Документация по методам
+
+### 🔑 Авторизация
+
+| Метод | Описание |
+|-------|----------|
+| `login(username, password)` | Вход в аккаунт, возвращает клиент с токеном |
+
+### 👤 Пользователи
+
+| Метод | Описание |
+|-------|----------|
+| `get_me()` | Получить свой профиль (`User`) |
+| `get_user(username)` | Получить профиль другого пользователя |
+| `search_users(query)` | Поиск пользователей по нику |
+| `follow(username)` | Подписаться на пользователя |
+| `unfollow(username)` | Отписаться |
+| `check_follow(username)` | Проверить, подписан ли ты на пользователя |
+| `get_followers(username)` | Список подписчиков пользователя |
+| `get_following(username)` | Список подписок пользователя |
+| `get_online_friends()` | Друзья онлайн (на кого подписан и онлайн) |
+
+### 🏆 Турниры
+
+| Метод | Описание |
+|-------|----------|
+| `get_tournaments(status)` | Список турниров (`active`, `upcoming`, `finished`) |
+| `get_tournament(id)` | Детали турнира |
+| `join_tournament(id)` | Вступить в турнир |
+| `leave_tournament(id)` | Покинуть турнир |
+
+### 💬 Форум
+
+| Метод | Описание |
+|-------|----------|
+| `get_forum_threads(page, limit)` | Список тем |
+| `get_forum_thread(slug)` | Получить тему с ответами |
+| `create_forum_thread(title, body)` | Создать тему |
+| `reply_to_thread(thread_id, body)` | Ответить в тему |
+
+### 📰 Блог
+
+| Метод | Описание |
+|-------|----------|
+| `get_blog_posts(page, limit)` | Список постов |
+| `get_blog_post(post_id)` | Получить пост |
+| `like_blog_post(post_id, unlike)` | Поставить/снять лайк |
+
+### 🧩 Задачи (Puzzles)
+
+| Метод | Описание |
+|-------|----------|
+| `get_puzzles(topic, difficulty, limit, offset)` | Список задач |
+| `get_puzzle(puzzle_id)` | Детали задачи |
+| `attempt_puzzle(puzzle_id, correct, moves)` | Отправить результат решения |
+
+### ⚡ Storm
+
+| Метод | Описание |
+|-------|----------|
+| `get_storm_puzzles(topics)` | Получить набор задач для шторма |
+| `finish_storm(score, total_attempted, correct, wrong, time_bonus)` | Завершить забег |
+
+### 🏛️ Клубы
+
+| Метод | Описание |
+|-------|----------|
+| `get_clubs()` | Список всех клубов |
+| `get_club(club_id)` | Информация о клубе |
+| `create_club(name, description)` | Создать клуб (макс. 5 на пользователя) |
+| `join_club(club_id)` | Вступить в клуб |
+| `leave_club(club_id)` | Покинуть клуб |
+| `update_club(club_id, name, description)` | Обновить клуб (только админ) |
+| `get_club_chat(club_id)` | Чат клуба (только для участников) |
+
+### ✉️ Личные сообщения (DM)
+
+| Метод | Описание |
+|-------|----------|
+| `get_conversations()` | Список диалогов |
+| `get_messages(partner, since)` | История сообщений с пользователем |
+| `send_dm(to, text)` | Отправить сообщение |
+| `mark_dm_read(partner)` | Отметить все сообщения как прочитанные |
+| `block_user(username)` | Заблокировать пользователя |
+| `unblock_user(username)` | Разблокировать |
+
+### 🌐 Глобальный чат
+
+| Метод | Описание |
+|-------|----------|
+| `get_global_chat(limit)` | Последние сообщения глобального чата (только чтение) |
+
+### 📊 Статистика
+
+| Метод | Описание |
+|-------|----------|
+| `get_stats()` | Общая статистика платформы |
+
+---
+
+## 🧪 Примеры использования
+
+### Получение статистики
+
+```python
+stats = client.get_stats()
+print(f"Всего пользователей: {stats['totals']['users']}")
+print(f"Сыграно партий: {stats['totals']['games']}")
+```
+
+### Работа с клубами
+
+```python
+# Создать клуб
+new_club = client.create_club("Мой клуб", "Описание клуба")
+print(f"Клуб создан: {new_club.id}")
+
+# Вступить в клуб
+client.join_club(new_club.id)
+
+# Получить чат клуба
+chat = client.get_club_chat(new_club.id)
+for msg in chat.get('messages', []):
+    print(f"{msg['username']}: {msg['message']}")
+```
+
+### Задачи (Puzzles)
+
+```python
+# Получить задачи по теме "Мат в 1 ход"
+puzzles = client.get_puzzles(topic="mate1", limit=5)
+for p in puzzles:
+    print(p['title'], p['difficulty'])
+
+# Отправить результат решения (пример)
+# client.attempt_puzzle(puzzles[0]['id'], correct=True, moves=[...])
+```
+
+### Подписки
+
+```python
+# Подписаться на пользователя
+client.follow("username")
+
+# Проверить подписку
+is_following = client.check_follow("username")
+print(is_following)
+
+# Получить список подписчиков
+followers = client.get_followers("username")
+for f in followers:
+    print(f['username'])
+```
+
+---
+
+
+## 📄 Лицензия
+
+MIT License. См. файл [LICENSE](LICENSE).
+
+---
+
+**Разработано с ❤️ для сообщества Chess Home**

chesshome-0.1.0/README.md

@@ -0,0 +1,218 @@
+# ♟️ ChessHome Python Client
+
+Официальный Python-клиент для платформы [Chess Home](https://chesshome.pro).  
+Позволяет взаимодействовать с API: управлять турнирами, форумом, клубами, решать задачи, отправлять личные сообщения и многое другое.
+
+---
+
+## 🚀 Установка
+
+```bash
+pip install chesshome
+```
+
+Или установка из исходников:
+
+```bash
+git clone https://github.com/your_username/chesshome-py.git
+cd chesshome-py
+pip install -e .
+```
+
+---
+
+## 📖 Быстрый старт
+
+```python
+from chesshome import ChessHomeClient
+
+# Создаём клиент и авторизуемся
+client = ChessHomeClient()
+client.login("ваш_логин", "ваш_пароль")
+
+# Получаем свой профиль
+me = client.get_me()
+print(f"Привет, {me.username}! Рейтинг: {me.rating}")
+
+# Список активных турниров
+tours = client.get_tournaments(status="active")
+for t in tours:
+    print(f"{t.name} — {t.participantsCount} участников")
+
+# Создаём тему на форуме
+result = client.create_forum_thread(
+    title="Моя первая тема",
+    body="Привет! Это тест через Python-клиент."
+)
+print(f"Тема создана: {result['thread']['slug']}")
+
+# Отправляем личное сообщение
+client.send_dm("friend", "Привет! Как дела?")
+```
+
+---
+
+## 📚 Документация по методам
+
+### 🔑 Авторизация
+
+| Метод | Описание |
+|-------|----------|
+| `login(username, password)` | Вход в аккаунт, возвращает клиент с токеном |
+
+### 👤 Пользователи
+
+| Метод | Описание |
+|-------|----------|
+| `get_me()` | Получить свой профиль (`User`) |
+| `get_user(username)` | Получить профиль другого пользователя |
+| `search_users(query)` | Поиск пользователей по нику |
+| `follow(username)` | Подписаться на пользователя |
+| `unfollow(username)` | Отписаться |
+| `check_follow(username)` | Проверить, подписан ли ты на пользователя |
+| `get_followers(username)` | Список подписчиков пользователя |
+| `get_following(username)` | Список подписок пользователя |
+| `get_online_friends()` | Друзья онлайн (на кого подписан и онлайн) |
+
+### 🏆 Турниры
+
+| Метод | Описание |
+|-------|----------|
+| `get_tournaments(status)` | Список турниров (`active`, `upcoming`, `finished`) |
+| `get_tournament(id)` | Детали турнира |
+| `join_tournament(id)` | Вступить в турнир |
+| `leave_tournament(id)` | Покинуть турнир |
+
+### 💬 Форум
+
+| Метод | Описание |
+|-------|----------|
+| `get_forum_threads(page, limit)` | Список тем |
+| `get_forum_thread(slug)` | Получить тему с ответами |
+| `create_forum_thread(title, body)` | Создать тему |
+| `reply_to_thread(thread_id, body)` | Ответить в тему |
+
+### 📰 Блог
+
+| Метод | Описание |
+|-------|----------|
+| `get_blog_posts(page, limit)` | Список постов |
+| `get_blog_post(post_id)` | Получить пост |
+| `like_blog_post(post_id, unlike)` | Поставить/снять лайк |
+
+### 🧩 Задачи (Puzzles)
+
+| Метод | Описание |
+|-------|----------|
+| `get_puzzles(topic, difficulty, limit, offset)` | Список задач |
+| `get_puzzle(puzzle_id)` | Детали задачи |
+| `attempt_puzzle(puzzle_id, correct, moves)` | Отправить результат решения |
+
+### ⚡ Storm
+
+| Метод | Описание |
+|-------|----------|
+| `get_storm_puzzles(topics)` | Получить набор задач для шторма |
+| `finish_storm(score, total_attempted, correct, wrong, time_bonus)` | Завершить забег |
+
+### 🏛️ Клубы
+
+| Метод | Описание |
+|-------|----------|
+| `get_clubs()` | Список всех клубов |
+| `get_club(club_id)` | Информация о клубе |
+| `create_club(name, description)` | Создать клуб (макс. 5 на пользователя) |
+| `join_club(club_id)` | Вступить в клуб |
+| `leave_club(club_id)` | Покинуть клуб |
+| `update_club(club_id, name, description)` | Обновить клуб (только админ) |
+| `get_club_chat(club_id)` | Чат клуба (только для участников) |
+
+### ✉️ Личные сообщения (DM)
+
+| Метод | Описание |
+|-------|----------|
+| `get_conversations()` | Список диалогов |
+| `get_messages(partner, since)` | История сообщений с пользователем |
+| `send_dm(to, text)` | Отправить сообщение |
+| `mark_dm_read(partner)` | Отметить все сообщения как прочитанные |
+| `block_user(username)` | Заблокировать пользователя |
+| `unblock_user(username)` | Разблокировать |
+
+### 🌐 Глобальный чат
+
+| Метод | Описание |
+|-------|----------|
+| `get_global_chat(limit)` | Последние сообщения глобального чата (только чтение) |
+
+### 📊 Статистика
+
+| Метод | Описание |
+|-------|----------|
+| `get_stats()` | Общая статистика платформы |
+
+---
+
+## 🧪 Примеры использования
+
+### Получение статистики
+
+```python
+stats = client.get_stats()
+print(f"Всего пользователей: {stats['totals']['users']}")
+print(f"Сыграно партий: {stats['totals']['games']}")
+```
+
+### Работа с клубами
+
+```python
+# Создать клуб
+new_club = client.create_club("Мой клуб", "Описание клуба")
+print(f"Клуб создан: {new_club.id}")
+
+# Вступить в клуб
+client.join_club(new_club.id)
+
+# Получить чат клуба
+chat = client.get_club_chat(new_club.id)
+for msg in chat.get('messages', []):
+    print(f"{msg['username']}: {msg['message']}")
+```
+
+### Задачи (Puzzles)
+
+```python
+# Получить задачи по теме "Мат в 1 ход"
+puzzles = client.get_puzzles(topic="mate1", limit=5)
+for p in puzzles:
+    print(p['title'], p['difficulty'])
+
+# Отправить результат решения (пример)
+# client.attempt_puzzle(puzzles[0]['id'], correct=True, moves=[...])
+```
+
+### Подписки
+
+```python
+# Подписаться на пользователя
+client.follow("username")
+
+# Проверить подписку
+is_following = client.check_follow("username")
+print(is_following)
+
+# Получить список подписчиков
+followers = client.get_followers("username")
+for f in followers:
+    print(f['username'])
+```
+
+---
+
+
+## 📄 Лицензия
+
+MIT License. См. файл [LICENSE](LICENSE).
+
+---
+
+**Разработано с ❤️ для сообщества Chess Home**

chesshome-0.1.0/chesshome/__init__.py

@@ -0,0 +1,4 @@
+from .client import ChessHomeClient
+from .models import User, Tournament, ForumThread, BlogPost, Conversation, Message, Club
+
+__version__ = "0.1.0"

chesshome-0.1.0/chesshome/client.py

@@ -0,0 +1,176 @@
+import httpx
+from typing import Optional, Dict, Any, List
+from .models import User, Tournament, ForumThread, BlogPost, Conversation, Message, Club
+
+class ChessHomeClient:
+    BASE_URL = "https://chesshome.pro/api"
+
+    def __init__(self, token: Optional[str] = None, device_id: Optional[str] = None, verify_ssl: bool = True):
+        self.token = token
+        self.device_id = device_id or self._generate_device_id()
+        self._session = httpx.Client(
+            base_url=self.BASE_URL,
+            headers=self._default_headers(),
+            timeout=30.0,
+            verify=verify_ssl
+        )
+
+    def _default_headers(self) -> Dict[str, str]:
+        headers = {"X-Device-Id": self.device_id}
+        if self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+        return headers
+
+    def _generate_device_id(self) -> str:
+        import uuid
+        return f"py_{uuid.uuid4().hex[:12]}"
+
+    def _request(self, method: str, path: str, **kwargs) -> Any:
+        response = self._session.request(method, path, **kwargs)
+        response.raise_for_status()
+        return response.json()
+
+    # ========== AUTH ==========
+    def login(self, username: str, password: str) -> "ChessHomeClient":
+        data = {"username": username, "password": password}
+        resp = self._request("POST", "/login", json=data)
+        self.token = resp["token"]
+        self._session.headers.update({"Authorization": f"Bearer {self.token}"})
+        return self
+
+    # ========== USERS ==========
+    def get_me(self) -> User:
+        return User(**self._request("GET", "/me"))
+
+    def get_user(self, username: str) -> User:
+        return User(**self._request("GET", f"/users/{username}"))
+
+    def search_users(self, query: str) -> List[User]:
+        resp = self._request("GET", "/users/search", params={"q": query})
+        return [User(**u) for u in resp]
+
+    # ========== TOURNAMENTS ==========
+    def get_tournaments(self, status: Optional[str] = None) -> List[Tournament]:
+        params = {"status": status} if status else {}
+        resp = self._request("GET", "/tournaments", params=params)
+        return [Tournament(**t) for t in resp]
+
+    def get_tournament(self, tournament_id: str) -> Tournament:
+        return Tournament(**self._request("GET", f"/tournaments/{tournament_id}"))
+
+    def join_tournament(self, tournament_id: str) -> dict:
+        return self._request("POST", f"/tournaments/{tournament_id}/join")
+
+    def leave_tournament(self, tournament_id: str) -> dict:
+        return self._request("POST", f"/tournaments/{tournament_id}/leave")
+
+    # ========== FORUM ==========
+    def get_forum_threads(self, page: int = 0, limit: int = 20) -> List[ForumThread]:
+        resp = self._request("GET", "/forum/threads", params={"page": page, "limit": limit})
+        return [ForumThread(**t) for t in resp["threads"]]
+
+    def get_forum_thread(self, slug: str) -> dict:
+        return self._request("GET", f"/forum/threads/{slug}")
+
+    def create_forum_thread(self, title: str, body: str) -> dict:
+        return self._request("POST", "/forum/threads", json={"title": title, "body": body})
+
+    def reply_to_thread(self, thread_id: str, body: str) -> dict:
+        return self._request("POST", f"/forum/threads/{thread_id}/replies", json={"body": body})
+
+    # ========== BLOG ==========
+    def get_blog_posts(self, page: int = 0, limit: int = 20) -> List[BlogPost]:
+        resp = self._request("GET", "/blog", params={"page": page, "limit": limit})
+        return [BlogPost(**p) for p in resp["posts"]]
+
+    def get_blog_post(self, post_id: str) -> BlogPost:
+        return BlogPost(**self._request("GET", f"/blog/{post_id}"))
+
+    def like_blog_post(self, post_id: str, unlike: bool = False) -> dict:
+        return self._request("POST", f"/blog/{post_id}/like", json={"unlike": unlike})
+
+    # ========== PUZZLES ==========
+    def get_puzzles(self, topic: Optional[str] = None, difficulty: Optional[str] = None,
+                    limit: int = 20, offset: int = 0) -> List[dict]:
+        params = {"topic": topic, "difficulty": difficulty, "limit": limit, "offset": offset}
+        params = {k: v for k, v in params.items() if v is not None}
+        return self._request("GET", "/puzzles", params=params)
+
+    def get_puzzle(self, puzzle_id: str) -> dict:
+        return self._request("GET", f"/puzzles/{puzzle_id}")
+
+    def attempt_puzzle(self, puzzle_id: str, correct: bool, moves: Optional[list] = None) -> dict:
+        return self._request("POST", f"/puzzles/{puzzle_id}/attempt",
+                            json={"correct": correct, "moves": moves})
+
+    # ========== STORM ==========
+    def get_storm_puzzles(self, topics: str = "mate1,mate2") -> List[dict]:
+        return self._request("GET", "/storm/puzzles", params={"topics": topics})
+
+    def finish_storm(self, score: int, total_attempted: int, correct: int,
+                     wrong: int, time_bonus: int = 0) -> dict:
+        return self._request("POST", "/storm/finish", json={
+            "score": score,
+            "total_attempted": total_attempted,
+            "correct": correct,
+            "wrong": wrong,
+            "time_bonus": time_bonus
+        })
+
+    # ========== DM (ЛИЧНЫЕ СООБЩЕНИЯ) ==========
+    def get_conversations(self) -> List[Conversation]:
+        resp = self._request("GET", "/dm/conversations")
+        return [Conversation(**c) for c in resp]
+
+    def get_messages(self, partner: str, since: Optional[str] = None) -> List[Message]:
+        params = {"since": since} if since else {}
+        resp = self._request("GET", f"/dm/messages/{partner}", params=params)
+        return [Message(**m) for m in resp.get("messages", [])]
+
+    def send_dm(self, to: str, text: str) -> Message:
+        resp = self._request("POST", "/dm/send", json={"to": to, "text": text})
+        return Message(**resp)
+
+    def mark_dm_read(self, partner: str) -> dict:
+        return self._request("POST", "/dm/read", json={"partner": partner})
+
+    def block_user(self, username: str) -> dict:
+        return self._request("POST", "/dm/block", json={"username": username})
+
+    def unblock_user(self, username: str) -> dict:
+        return self._request("POST", "/dm/unblock", json={"username": username})
+
+    # ========== ГЛОБАЛЬНЫЙ ЧАТ (ТОЛЬКО ЧТЕНИЕ) ==========
+    def get_global_chat(self, limit: int = 50) -> List[dict]:
+        return self._request("GET", "/chat", params={"limit": limit})
+
+    # ========== КЛУБЫ ==========
+    def get_clubs(self) -> List[Club]:
+        resp = self._request("GET", "/clubs")
+        return [Club(**c) for c in resp]
+
+    def get_club(self, club_id: str) -> Club:
+        return Club(**self._request("GET", f"/clubs/{club_id}"))
+
+    def create_club(self, name: str, description: str = "") -> Club:
+        resp = self._request("POST", "/clubs", json={"name": name, "description": description})
+        return Club(**resp)
+
+    def join_club(self, club_id: str) -> dict:
+        return self._request("POST", f"/clubs/{club_id}/join")
+
+    def leave_club(self, club_id: str) -> dict:
+        return self._request("POST", f"/clubs/{club_id}/leave")
+
+    def update_club(self, club_id: str, name: Optional[str] = None, description: Optional[str] = None) -> Club:
+        payload = {}
+        if name is not None:
+            payload["name"] = name
+        if description is not None:
+            payload["description"] = description
+        resp = self._request("PATCH", f"/clubs/{club_id}", json=payload)
+        return Club(**resp)
+
+
+    def get_club_chat(self, club_id: str) -> dict:
+        return self._request("GET", f"/clubs/{club_id}/chat")

chesshome-0.1.0/chesshome/models.py

@@ -0,0 +1,115 @@
+from pydantic import BaseModel, Field
+from typing import Optional, List
+
+class User(BaseModel):
+    id: str
+    username: str
+    rating: int = 1200
+    games_played: Optional[int] = 0
+    wins: Optional[int] = 0
+    losses: Optional[int] = 0
+    draws: Optional[int] = 0
+    avatar: Optional[str] = None
+    role: str = "user"
+    banned: bool = False
+    ban_reason: Optional[str] = None
+    puzzle_rating: Optional[int] = 1200
+    puzzle_solved: Optional[int] = 0
+    puzzle_attempted: Optional[int] = 0
+    storm_best: Optional[int] = 0
+    storm_runs: Optional[int] = 0
+    emoji: str = ""
+    created_at: Optional[int] = None
+
+    class Config:
+        extra = "ignore"   # ← игнорируем любые дополнительные поля
+
+class Tournament(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    timeControl: str
+    durationMinutes: int
+    startsAt: int
+    endsAt: int
+    maxParticipants: int = 0
+    minRating: int = 0
+    maxRating: int = 9999
+    participantsCount: int = 0
+    createdBy: str
+    status: str
+    winner: Optional[str] = None
+    participants: Optional[List] = None
+    games: Optional[List] = None
+
+    class Config:
+        extra = "ignore"
+
+class ForumThread(BaseModel):
+    id: str
+    slug: str
+    author: str
+    title: str
+    body: str
+    createdAt: int
+    lastActivityAt: int
+    replyCount: int = 0
+    views: int = 0
+
+    class Config:
+        extra = "ignore"
+
+class BlogPost(BaseModel):
+    id: str
+    title: str
+    body: Optional[str] = None
+    author: str
+    status: str
+    views: int = 0
+    likes: int = 0
+    createdAt: int
+    updatedAt: Optional[int] = None
+    community: bool = False
+
+    class Config:
+        extra = "ignore"
+
+class Conversation(BaseModel):
+    partner: str
+    last_msg: str
+    last_ts: str
+    unread: int = 0
+    blocked: bool = False
+
+    class Config:
+        extra = "ignore"
+
+
+class Message(BaseModel):
+    id: str
+    text: str
+    ts: str
+    read: bool
+    from_: Optional[str] = Field(None, alias='from')
+    to: Optional[str] = None
+    from_user: Optional[str] = None
+    to_user: Optional[str] = None
+
+    class Config:
+        extra = "ignore"
+        populate_by_name = True
+
+
+class Club(BaseModel):
+    id: str
+    name: str
+    description: Optional[str] = None
+    memberCount: int = 0
+    admins: List[str] = []
+    members: List[str] = []
+    createdBy: str
+    createdAt: str
+    official: bool = False
+
+    class Config:
+        extra = "ignore"

chesshome-0.1.0/chesshome.egg-info/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: chesshome
+Version: 0.1.0
+Summary: Python client for ChessHome platform API
+Author-email: ChessHome <noreply@chesshome.pro>
+License-Expression: MIT
+Project-URL: Homepage, https://chesshome.pro
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Dynamic: license-file
+
+# ♟️ ChessHome Python Client
+
+Официальный Python-клиент для платформы [Chess Home](https://chesshome.pro).  
+Позволяет взаимодействовать с API: управлять турнирами, форумом, клубами, решать задачи, отправлять личные сообщения и многое другое.
+
+---
+
+## 🚀 Установка
+
+```bash
+pip install chesshome
+```
+
+Или установка из исходников:
+
+```bash
+git clone https://github.com/your_username/chesshome-py.git
+cd chesshome-py
+pip install -e .
+```
+
+---
+
+## 📖 Быстрый старт
+
+```python
+from chesshome import ChessHomeClient
+
+# Создаём клиент и авторизуемся
+client = ChessHomeClient()
+client.login("ваш_логин", "ваш_пароль")
+
+# Получаем свой профиль
+me = client.get_me()
+print(f"Привет, {me.username}! Рейтинг: {me.rating}")
+
+# Список активных турниров
+tours = client.get_tournaments(status="active")
+for t in tours:
+    print(f"{t.name} — {t.participantsCount} участников")
+
+# Создаём тему на форуме
+result = client.create_forum_thread(
+    title="Моя первая тема",
+    body="Привет! Это тест через Python-клиент."
+)
+print(f"Тема создана: {result['thread']['slug']}")
+
+# Отправляем личное сообщение
+client.send_dm("friend", "Привет! Как дела?")
+```
+
+---
+
+## 📚 Документация по методам
+
+### 🔑 Авторизация
+
+| Метод | Описание |
+|-------|----------|
+| `login(username, password)` | Вход в аккаунт, возвращает клиент с токеном |
+
+### 👤 Пользователи
+
+| Метод | Описание |
+|-------|----------|
+| `get_me()` | Получить свой профиль (`User`) |
+| `get_user(username)` | Получить профиль другого пользователя |
+| `search_users(query)` | Поиск пользователей по нику |
+| `follow(username)` | Подписаться на пользователя |
+| `unfollow(username)` | Отписаться |
+| `check_follow(username)` | Проверить, подписан ли ты на пользователя |
+| `get_followers(username)` | Список подписчиков пользователя |
+| `get_following(username)` | Список подписок пользователя |
+| `get_online_friends()` | Друзья онлайн (на кого подписан и онлайн) |
+
+### 🏆 Турниры
+
+| Метод | Описание |
+|-------|----------|
+| `get_tournaments(status)` | Список турниров (`active`, `upcoming`, `finished`) |
+| `get_tournament(id)` | Детали турнира |
+| `join_tournament(id)` | Вступить в турнир |
+| `leave_tournament(id)` | Покинуть турнир |
+
+### 💬 Форум
+
+| Метод | Описание |
+|-------|----------|
+| `get_forum_threads(page, limit)` | Список тем |
+| `get_forum_thread(slug)` | Получить тему с ответами |
+| `create_forum_thread(title, body)` | Создать тему |
+| `reply_to_thread(thread_id, body)` | Ответить в тему |
+
+### 📰 Блог
+
+| Метод | Описание |
+|-------|----------|
+| `get_blog_posts(page, limit)` | Список постов |
+| `get_blog_post(post_id)` | Получить пост |
+| `like_blog_post(post_id, unlike)` | Поставить/снять лайк |
+
+### 🧩 Задачи (Puzzles)
+
+| Метод | Описание |
+|-------|----------|
+| `get_puzzles(topic, difficulty, limit, offset)` | Список задач |
+| `get_puzzle(puzzle_id)` | Детали задачи |
+| `attempt_puzzle(puzzle_id, correct, moves)` | Отправить результат решения |
+
+### ⚡ Storm
+
+| Метод | Описание |
+|-------|----------|
+| `get_storm_puzzles(topics)` | Получить набор задач для шторма |
+| `finish_storm(score, total_attempted, correct, wrong, time_bonus)` | Завершить забег |
+
+### 🏛️ Клубы
+
+| Метод | Описание |
+|-------|----------|
+| `get_clubs()` | Список всех клубов |
+| `get_club(club_id)` | Информация о клубе |
+| `create_club(name, description)` | Создать клуб (макс. 5 на пользователя) |
+| `join_club(club_id)` | Вступить в клуб |
+| `leave_club(club_id)` | Покинуть клуб |
+| `update_club(club_id, name, description)` | Обновить клуб (только админ) |
+| `get_club_chat(club_id)` | Чат клуба (только для участников) |
+
+### ✉️ Личные сообщения (DM)
+
+| Метод | Описание |
+|-------|----------|
+| `get_conversations()` | Список диалогов |
+| `get_messages(partner, since)` | История сообщений с пользователем |
+| `send_dm(to, text)` | Отправить сообщение |
+| `mark_dm_read(partner)` | Отметить все сообщения как прочитанные |
+| `block_user(username)` | Заблокировать пользователя |
+| `unblock_user(username)` | Разблокировать |
+
+### 🌐 Глобальный чат
+
+| Метод | Описание |
+|-------|----------|
+| `get_global_chat(limit)` | Последние сообщения глобального чата (только чтение) |
+
+### 📊 Статистика
+
+| Метод | Описание |
+|-------|----------|
+| `get_stats()` | Общая статистика платформы |
+
+---
+
+## 🧪 Примеры использования
+
+### Получение статистики
+
+```python
+stats = client.get_stats()
+print(f"Всего пользователей: {stats['totals']['users']}")
+print(f"Сыграно партий: {stats['totals']['games']}")
+```
+
+### Работа с клубами
+
+```python
+# Создать клуб
+new_club = client.create_club("Мой клуб", "Описание клуба")
+print(f"Клуб создан: {new_club.id}")
+
+# Вступить в клуб
+client.join_club(new_club.id)
+
+# Получить чат клуба
+chat = client.get_club_chat(new_club.id)
+for msg in chat.get('messages', []):
+    print(f"{msg['username']}: {msg['message']}")
+```
+
+### Задачи (Puzzles)
+
+```python
+# Получить задачи по теме "Мат в 1 ход"
+puzzles = client.get_puzzles(topic="mate1", limit=5)
+for p in puzzles:
+    print(p['title'], p['difficulty'])
+
+# Отправить результат решения (пример)
+# client.attempt_puzzle(puzzles[0]['id'], correct=True, moves=[...])
+```
+
+### Подписки
+
+```python
+# Подписаться на пользователя
+client.follow("username")
+
+# Проверить подписку
+is_following = client.check_follow("username")
+print(is_following)
+
+# Получить список подписчиков
+followers = client.get_followers("username")
+for f in followers:
+    print(f['username'])
+```
+
+---
+
+
+## 📄 Лицензия
+
+MIT License. См. файл [LICENSE](LICENSE).
+
+---
+
+**Разработано с ❤️ для сообщества Chess Home**

chesshome-0.1.0/chesshome.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+chesshome/__init__.py
+chesshome/client.py
+chesshome/models.py
+chesshome.egg-info/PKG-INFO
+chesshome.egg-info/SOURCES.txt
+chesshome.egg-info/dependency_links.txt
+chesshome.egg-info/requires.txt
+chesshome.egg-info/top_level.txt

chesshome-0.1.0/chesshome.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chesshome-0.1.0/chesshome.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.24.0
+pydantic>=2.0.0

chesshome-0.1.0/chesshome.egg-info/top_level.txt

@@ -0,0 +1 @@
+chesshome

chesshome-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chesshome"
+version = "0.1.0"
+description = "Python client for ChessHome platform API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    {name = "ChessHome", email = "noreply@chesshome.pro"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://chesshome.pro"

chesshome-0.1.0/setup.cfg

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