ts3clientcontrol 1.1.2__tar.gz

ts3clientcontrol-1.1.2/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: ts3clientcontrol
+Version: 1.1.2
+Summary: Python Library for control TS3
+Author-email: TimoNiki <timonikivopros.team@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# my_ts3_control
+
+Python-библиотека для управления клиентом TeamSpeak 3 и создания автоответчиков/ботов.
+
+## Установка плагина
+Перед использованием установите официальный пакет плагина `my_plugin.ts3_plugin` в ваш TeamSpeak 3 Client.
+
+## Пример использования (Бот-автоответчик)
+
+```python
+import time
+from my_ts3_control import TS3Controller
+
+def main():
+    ts3 = TS3Controller()
+
+    # Создаем логику для обработки входящих ЛС
+    def handle_messages(sch_id, from_id, from_name, message):
+        print(f"Новое ЛС от {from_name}: {message}")
+        if message.lower() == "привет":
+            ts3.send_private_message(sch_id, from_id, "Привет! Я твой Python бот.")
+
+    # Регистрируем обработчик и подключаемся
+    ts3.on_pm_callback = handle_messages
+    ts3.connect()
+    
+    print("Бот успешно запущен...")
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        ts3.close()
+
+if __name__ == "__main__":
+    main()
+```

ts3clientcontrol-1.1.2/README.md

@@ -0,0 +1,36 @@
+# my_ts3_control
+
+Python-библиотека для управления клиентом TeamSpeak 3 и создания автоответчиков/ботов.
+
+## Установка плагина
+Перед использованием установите официальный пакет плагина `my_plugin.ts3_plugin` в ваш TeamSpeak 3 Client.
+
+## Пример использования (Бот-автоответчик)
+
+```python
+import time
+from my_ts3_control import TS3Controller
+
+def main():
+    ts3 = TS3Controller()
+
+    # Создаем логику для обработки входящих ЛС
+    def handle_messages(sch_id, from_id, from_name, message):
+        print(f"Новое ЛС от {from_name}: {message}")
+        if message.lower() == "привет":
+            ts3.send_private_message(sch_id, from_id, "Привет! Я твой Python бот.")
+
+    # Регистрируем обработчик и подключаемся
+    ts3.on_pm_callback = handle_messages
+    ts3.connect()
+    
+    print("Бот успешно запущен...")
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        ts3.close()
+
+if __name__ == "__main__":
+    main()
+```

ts3clientcontrol-1.1.2/TS3ClientControl/__init__.py

@@ -0,0 +1,3 @@
+from .client import TS3Controller
+
+__all__ = ["TS3Controller"]

ts3clientcontrol-1.1.2/TS3ClientControl/client.py

@@ -0,0 +1,97 @@
+import socket
+import threading
+from typing import Callable, Optional
+
+class TS3Controller:
+    """Класс для управления TeamSpeak 3 на macOS/Windows через TCP-плагин."""
+    
+    def __init__(self, host: str = "127.0.0.1", port: int = 12345):
+        self.host = host
+        self.port = port
+        self.socket: Optional[socket.socket] = None
+        self._listener_thread: Optional[threading.Thread] = None
+        self._is_running = False
+        
+        # Сюда пользователь будет передавать функцию-обработчик входящих ЛС
+        self.on_pm_callback: Optional[Callable[[int, int, str, str], None]] = None
+
+    def connect(self) -> None:
+        """Устанавливает двустороннее соединение с плагином TeamSpeak 3."""
+        try:
+            self.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            self.socket.connect((self.host, self.port))
+            self._is_running = True
+            
+            # Запускаем фоновый поток, который слушает события от TeamSpeak
+            self._listener_thread = threading.Thread(target=self._listen_loop, daemon=True)
+            self._listener_thread.start()
+        except ConnectionRefusedError:
+            self.socket = None
+            raise ConnectionRefusedError(
+                f"Не удалось подключиться к TeamSpeak 3 на {self.host}:{self.port}. "
+                "Убедитесь, что TeamSpeak запущен и плагин активен."
+            )
+
+    def _listen_loop(self) -> None:
+        """Фоновый метод чтения данных из сокета плагина."""
+        buffer = ""
+        while self._is_running and self.socket:
+            try:
+                data = self.socket.recv(4096).decode("utf-8")
+                if not data:
+                    break
+                buffer += data
+                while "\n" in buffer:
+                    line, buffer = buffer.split("\n", 1)
+                    if line.startswith("NEW_PM"):
+                        # Разбираем строку: NEW_PM schID fromID fromName текст
+                        parts = line.split(" ", 4)
+                        if len(parts) >= 5 and self.on_pm_callback:
+                            sch_id = int(parts[1])
+                            from_id = int(parts[2])
+                            from_name = parts[3]
+                            msg_text = parts[4]
+                            # Вызываем пользовательскую функцию
+                            self.on_pm_callback(sch_id, from_id, from_name, msg_text)
+            except socket.error:
+                break
+        self._is_running = False
+
+    def _send(self, command: str) -> None:
+        if not self.socket:
+            raise RuntimeError("Соединение не установлено. Сначала вызовите метод connect().")
+        try:
+            self.socket.sendall(f"{command}\n".encode("utf-8"))
+        except socket.error as e:
+            self.socket = None
+            raise BrokenPipeError("Соединение с TeamSpeak 3 было разорвано.") from e
+
+    def mute_self(self) -> None:
+        """Выключить микрофон в TeamSpeak 3."""
+        self._send("MUTE")
+
+    def unmute_self(self) -> None:
+        """Включить микрофон в TeamSpeak 3."""
+        self._send("UNMUTE")
+
+    def connect_to_server(self, address: str, password: str = "", label: str = "Python Server") -> None:
+        """Подключиться к новому серверу (откроется новая вкладка в TS3)."""
+        pass_str = password if password else "nopassword"
+        # Заменяем пробелы в названии вкладки на нижнее подчеркивание, чтобы не ломать парсер в C++
+        label_str = label.replace(" ", "_")
+        self._send(f"CONNECT {address} {pass_str} {label_str}")
+
+    def disconnect_all(self) -> None:
+        """Отключиться от всех активных серверов."""
+        self._send("DISCONNECT_ALL")
+
+    def send_private_message(self, sch_id: int, target_client_id: int, message: str) -> None:
+        """Отправить личное сообщение пользователю по его ID сессии и ID клиента."""
+        self._send(f"SEND_PM {sch_id} {target_client_id} {message}")
+
+    def close(self) -> None:
+        """Закрыть сетевое соединение."""
+        self._is_running = False
+        if self.socket:
+            self.socket.close()
+            self.socket = None

ts3clientcontrol-1.1.2/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["TS3ClientControl"]
+
+[project]
+name = "ts3clientcontrol"
+version = "1.1.2"
+authors = [
+  { name="TimoNiki", email="timonikivopros.team@gmail.com" },
+]
+description = "Python Library for control TS3"
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+]

ts3clientcontrol-1.1.2/setup.cfg

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

ts3clientcontrol-1.1.2/ts3clientcontrol.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: ts3clientcontrol
+Version: 1.1.2
+Summary: Python Library for control TS3
+Author-email: TimoNiki <timonikivopros.team@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# my_ts3_control
+
+Python-библиотека для управления клиентом TeamSpeak 3 и создания автоответчиков/ботов.
+
+## Установка плагина
+Перед использованием установите официальный пакет плагина `my_plugin.ts3_plugin` в ваш TeamSpeak 3 Client.
+
+## Пример использования (Бот-автоответчик)
+
+```python
+import time
+from my_ts3_control import TS3Controller
+
+def main():
+    ts3 = TS3Controller()
+
+    # Создаем логику для обработки входящих ЛС
+    def handle_messages(sch_id, from_id, from_name, message):
+        print(f"Новое ЛС от {from_name}: {message}")
+        if message.lower() == "привет":
+            ts3.send_private_message(sch_id, from_id, "Привет! Я твой Python бот.")
+
+    # Регистрируем обработчик и подключаемся
+    ts3.on_pm_callback = handle_messages
+    ts3.connect()
+    
+    print("Бот успешно запущен...")
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        ts3.close()
+
+if __name__ == "__main__":
+    main()
+```

ts3clientcontrol-1.1.2/ts3clientcontrol.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+TS3ClientControl/__init__.py
+TS3ClientControl/client.py
+ts3clientcontrol.egg-info/PKG-INFO
+ts3clientcontrol.egg-info/SOURCES.txt
+ts3clientcontrol.egg-info/dependency_links.txt
+ts3clientcontrol.egg-info/top_level.txt

ts3clientcontrol-1.1.2/ts3clientcontrol.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ts3clientcontrol-1.1.2/ts3clientcontrol.egg-info/top_level.txt

@@ -0,0 +1 @@
+TS3ClientControl