neko-speaker 0.1.0__tar.gz

neko_speaker-0.1.0/LICENSE

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

neko_speaker-0.1.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: neko-speaker
+Version: 0.1.0
+Summary: Асинхронный клиент VK API с удобной обёрткой для ботов сообществ для быстрого развертывания ботов
+Author-email: Fukuneko <lcotyt112@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/LuckyCot112/maneki2
+Keywords: vk,vk-api,bot,async,neko
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8
+Requires-Dist: typing-extensions
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: aresponses; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: python-dotenv; extra == "dev"
+Dynamic: license-file
+
+
+# neko-speaker
+
+Асинхронный клиент для работы с API социальных платформ. Библиотека предоставляет удобный интерфейс для взаимодействия с API VK и упрощает разработку ботов и интеграций. В будущем планируется поддержка дополнительных платформ.
+
+## Установка
+
+```bash
+pip install neko-speaker
+```
+
+Для разработки с тестовыми и вспомогательными инструментами:
+
+```bash
+pip install "neko-speaker[dev]"
+```
+Быстрый старт
+Вставьте сюда ваш пример кода для быстрого начала работы:
+
+```python
+# Пример использования
+import os
+import asyncio
+import aiohttp
+import logging
+
+from src.neko_speaker.auth import VkBotLongPoll
+
+# Create your own event handling file
+from example_handler import EventHandler
+
+from src.neko_speaker.exceptions import *
+from dotenv import load_dotenv
+load_dotenv()
+
+# use only if you need debugging
+logging.basicConfig(
+    level=logging.DEBUG,
+    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s"
+    )
+
+# create .env file with this constantas
+TOKEN = os.getenv("VkLongpollBotAPIToken")
+GROUP_ID = os.getenv("GroupID")
+
+async def main():
+    async with VkBotLongPoll(token=TOKEN, group_id=GROUP_ID) as bot:
+        await bot.update_longpoll_server()
+        print("LongPoll инициализирован")
+
+        while bot._is_work:
+            events = await bot.listen()
+            for event in events:
+                try:
+                    await EventHandler.event_handler(bot, event)
+                except Exception as e:
+                    print(f"Ошибка при обработке события: {e}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+
+Основные возможности
+Асинхронная работа на базе aiohttp.
+Структурированный доступ к методам API по разделам (сообщения, стена, фото и др.).
+Обработка ошибок и типовых сценариев ответов API.
+Типизированные интерфейсы для предсказуемой работы с данными.
+Тестирование
+Для запуска тестов используйте:
+
+```bash
+pytest
+```
+
+
+Инструменты для проверки стиля и типов (black, flake8, mypy) включены в группу зависимостей dev.
+
+Вклад в проект
+Предложения по улучшению, отчёты об ошибках и запросы на добавление функционала принимаются через систему Issues в репозитории. Для удобства используйте предоставленные шаблоны.
+https://github.com/LuckyCot112/maneki2/issues

neko_speaker-0.1.0/README.md

@@ -0,0 +1,82 @@
+
+# neko-speaker
+
+Асинхронный клиент для работы с API социальных платформ. Библиотека предоставляет удобный интерфейс для взаимодействия с API VK и упрощает разработку ботов и интеграций. В будущем планируется поддержка дополнительных платформ.
+
+## Установка
+
+```bash
+pip install neko-speaker
+```
+
+Для разработки с тестовыми и вспомогательными инструментами:
+
+```bash
+pip install "neko-speaker[dev]"
+```
+Быстрый старт
+Вставьте сюда ваш пример кода для быстрого начала работы:
+
+```python
+# Пример использования
+import os
+import asyncio
+import aiohttp
+import logging
+
+from src.neko_speaker.auth import VkBotLongPoll
+
+# Create your own event handling file
+from example_handler import EventHandler
+
+from src.neko_speaker.exceptions import *
+from dotenv import load_dotenv
+load_dotenv()
+
+# use only if you need debugging
+logging.basicConfig(
+    level=logging.DEBUG,
+    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s"
+    )
+
+# create .env file with this constantas
+TOKEN = os.getenv("VkLongpollBotAPIToken")
+GROUP_ID = os.getenv("GroupID")
+
+async def main():
+    async with VkBotLongPoll(token=TOKEN, group_id=GROUP_ID) as bot:
+        await bot.update_longpoll_server()
+        print("LongPoll инициализирован")
+
+        while bot._is_work:
+            events = await bot.listen()
+            for event in events:
+                try:
+                    await EventHandler.event_handler(bot, event)
+                except Exception as e:
+                    print(f"Ошибка при обработке события: {e}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+
+Основные возможности
+Асинхронная работа на базе aiohttp.
+Структурированный доступ к методам API по разделам (сообщения, стена, фото и др.).
+Обработка ошибок и типовых сценариев ответов API.
+Типизированные интерфейсы для предсказуемой работы с данными.
+Тестирование
+Для запуска тестов используйте:
+
+```bash
+pytest
+```
+
+
+Инструменты для проверки стиля и типов (black, flake8, mypy) включены в группу зависимостей dev.
+
+Вклад в проект
+Предложения по улучшению, отчёты об ошибках и запросы на добавление функционала принимаются через систему Issues в репозитории. Для удобства используйте предоставленные шаблоны.
+https://github.com/LuckyCot112/maneki2/issues

neko_speaker-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "neko-speaker"
+version = "0.1.0"
+description = "Асинхронный клиент VK API с удобной обёрткой для ботов сообществ для быстрого развертывания ботов"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+  { name = "Fukuneko", email = "lcotyt112@gmail.com" }
+]
+keywords = ["vk", "vk-api", "bot", "async", "neko"]
+dependencies = [
+  "aiohttp>=3.8",
+  "typing-extensions" 
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest",
+  "pytest-asyncio",
+  "aresponses",
+  "black",
+  "flake8",
+  "mypy",
+  "python-dotenv"   # ← только для разработки
+]
+
+[project.urls]
+Repository = "https://github.com/LuckyCot112/maneki2"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["neko_speaker*"]

neko_speaker-0.1.0/setup.cfg

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

neko_speaker-0.1.0/src/neko_speaker/auth.py

@@ -0,0 +1,188 @@
+import os
+import asyncio
+import aiohttp
+import src.neko_speaker.bot_types as Type
+from typing import Optional, Any, Dict, Union
+# from dotenv import load_dotenv
+# load_dotenv()
+
+from src.neko_speaker.utils import Message, Attachment, Group, User
+import logging
+
+logger = logging.getLogger("nekobot.longpoll")
+
+# API = os.getenv("VkApiAddress")
+
+
+class VkBotLongPoll(Type.VkBotProtocol):
+    def __init__(self, token, group_id, session: aiohttp.ClientSession | None = None, wait_time=25, preserve_original_params = True):
+        self._token = token
+        self._group_id = group_id
+        self._wait_time = wait_time
+
+        self._url = os.getenv("VkApiAddress")
+        self._key: Optional[str] = None
+        self._server: Optional[str] = None
+        self._ts: Optional[int] = None
+        self._is_work = True
+
+        # для метода message.edit. Если True, при редактировании будет сначала получать сообщение, сохраняя неуказанные при редактировании параметры. 
+        # Если передать в редактирование только текст, клавиатура, вложения и прочее сохранятся при True и удалятся при False. Значение можно передавать в метод, данный параметр отвечает за стандартное значение
+        self._preserve_original_params = preserve_original_params 
+        self._session = session
+
+        self.message = Message(self)
+        self.attachment = Attachment(self)
+        self.group = Group(self)
+        self.user = User(self)
+
+        if session is None:
+            self._session = None
+
+        # asyncio.create_task(self.update_longpoll_server())
+
+
+    async def __aenter__(self):
+        if self._session is None:
+            self._session = aiohttp.ClientSession()
+        return self
+
+
+    async def __aexit__(self, exc_type, exc, tb):
+        if self._session:
+            await self._session.close()
+
+
+    @property
+    def session(self) -> aiohttp.ClientSession:
+        if self._session is None:
+            raise RuntimeError(
+                f"Сессия не инициализирована в {self.__class__.__name__}. "
+                "Используйте async with VKBot(...) as bot:"
+            )
+        return self._session
+
+
+    # __slots__ = ('vk', 'wait', 'group_id', 'url', 'session', 'key', 'server', 'ts')
+
+
+    async def update_longpoll_server(self, update_ts=True) -> Dict[str, Any]:
+        """
+        Обновляет данные Long Poll сервера.
+
+        Args:
+            update_ts: Если True, обновляет self._ts из ответа VK.
+
+        Returns:
+            dict: Полный объект response от VK API.
+
+        Raises:
+            ValueError: Если VK вернул ошибку.
+            aiohttp.ClientError: При сетевых ошибках.
+            RuntimeError: При проблемах с JSON.
+        """
+
+        logger.debug("Starting update_longpoll_server (update_ts=%s)", update_ts)
+        url = f"{self._url}groups.getLongPollServer"
+        params = {
+            "access_token": self._token,
+            "group_id": self._group_id,
+            "v": "5.199",
+        }
+
+        async with self.session.get(url, params=params) as response:
+            response.raise_for_status()
+            data = await response.json()
+
+            if 'error' in data:
+                err = data["error"]
+                logger.error("VK API error in groups.getLongPollServer: %s (%s)",
+                         err.get('error_code'), err.get('error_msg'))
+                raise ValueError(f"VK API error: {err.get('error_code')} - {err.get('error_msg')}")
+
+            response = data['response']
+            self._key = response['key']
+            self._server = response['server']
+
+            if update_ts:
+                self._ts = response['ts']
+                logger.info("Long Poll server updated: key=%s, server=%s, ts=%s",
+                        self._key, self._server, self._ts)
+            else:
+                logger.info("Long Poll credentials updated (ts preserved): key=%s, server=%s",
+                        self._key, self._server)
+
+            return response
+
+
+    async def listen(self) -> Union[Type.VkEvent, Type.VkError]:
+        """
+        Запускает прослушивание событий сервера. 
+        Автоматически обновляет сервер при истечении времени ожидания и ошибках получения данных.
+
+        Returns:
+            dict: Полный объект события от VK API.
+
+        Raises:
+            ValueError: Если VK вернул ошибку.
+            aiohttp.ClientError: При сетевых ошибках.
+            RuntimeError: При проблемах с JSON.
+        """
+
+        logger.debug("Starting Long Poll request with ts=%s", self._ts)
+        params={
+                'act': 'a_check',
+                'key': self._key,
+                'ts': self._ts,
+                'wait': self._wait_time
+            }
+
+        try:
+            async with self.session.get(self._server, params=params, timeout=self._wait_time + 10) as response:
+                response.raise_for_status()
+                data: Union[Type.VkEvent, Type.VkError] = await response.json()
+        except aiohttp.ClientError as e:
+            logger.warning("Network error during Long Poll request: %s", e)
+            raise
+        except ValueError as e:
+            logger.error("JSON parsing error in Long Poll response: %s", e)
+            raise RuntimeError("Invalid JSON response from VK Long Poll server") from e
+
+        if 'error' in data:
+            err: Type.VkError = data['error']
+            logger.error("VK API error in Long Poll: %s (%s)", err.get('error_code'), err.get('error_msg'))
+            raise ValueError(f"VK API error: {err.get('error_code')} - {err.get('error_msg')}")
+
+        # self._ts = data["ts"]
+
+        failed = data.get('failed')
+    
+        if failed is None:
+            self._ts = data["ts"]
+            logger.debug("Long Poll succeeded, new ts=%s, updates count=%s", self._ts, len(data.get('updates', [])))
+            return data.get('updates', [])
+        
+        logger.info("Long Poll failed code=%s, handling recovery", failed)
+
+        if failed == 1:
+            self._ts = data.get('ts', self._ts)
+            logger.info("Key expired (failed=1), ts updated to %s", self._ts)
+        elif failed == 2:
+            await self.update_longpoll_server(update_ts=False)
+            logger.info("TS reset required (failed=2), server credentials updated")
+        elif failed == 3:
+            await self.update_longpoll_server()
+            logger.info("Server changed (failed=3), full Long Poll config updated")
+        else:
+            logger.warning("Unknown failed code=%s, skipping recovery logic", failed)
+        
+        logger.debug("Raw failed response: %s", data)
+        return []
+
+
+async def main():
+    print("auth.py not standalone")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())