tts-api-client 0.1.0__tar.gz

tts_api_client-0.1.0/LICENSE

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

tts_api_client-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: tts-api-client
+Version: 0.1.0
+Summary: Клиент для собственного TTS API (Edge TTS / Google Translate TTS)
+Author-email: Denis Bisekeev <bisekeevdenis@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/<ты>/tts-api-client
+Project-URL: Source, https://github.com/<ты>/tts-api-client
+Project-URL: Issues, https://github.com/<ты>/tts-api-client/issues
+Keywords: tts,text-to-speech,audio,mp3,voice
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# tts-api-client
+
+Python-клиент для [TTS API](https://github.com/<ты>/tts-api) — синтез речи в MP3,
+выбор мужского/женского голоса, сохранение в любую папку.
+
+## Установка
+
+```bash
+pip install tts-api-client
+```
+
+## Быстрый старт
+
+```python
+from tts_api_client import TTS_API
+
+api = TTS_API("tts_xxxxxxxxxxxxxxxxxxxxxxxx")
+
+# Сохранит в текущую папку → ./voice_message.mp3
+path = api.get_voice("Привет, мир!")
+print(path)
+
+# Мужской голос + своя папка
+api.get_voice("Привет", voice="male", save_dir="cache", filename="hi.mp3")
+
+# Полный путь
+api.get_voice("Привет", out_path="/tmp/hello.mp3")
+```
+
+## API
+
+### `TTS_API(token, api_url=DEFAULT_API_URL, user_agent="tts_api_client/1.0", timeout=30)`
+
+Создаёт клиент. Токен получается на лендинге твоего TTS API (`POST /api/register`).
+
+### `TTS_API.get_voice(...)`
+
+| Параметр   | Тип            | По умолчанию           | Описание                          |
+|------------|----------------|------------------------|-----------------------------------|
+| `text`     | `str`          | —                      | Текст, до 200 символов            |
+| `lang`     | `str`          | `"ru"`                 | Язык                              |
+| `out_path` | `Optional[str]`| `None`                 | Полный путь к файлу               |
+| `save_dir` | `Optional[str]`| `None`                 | Папка (с `filename`)              |
+| `filename` | `str`          | `"voice_message.mp3"`  | Имя файла                         |
+| `voice`    | `str`          | `"female"`             | `female` или `male`               |
+| `timeout`  | `Optional[int]`| `None`                 | Таймаут (переопределяет дефолт)   |
+
+Возвращает **абсолютный путь** к сохранённому MP3.
+
+### `TTSError`
+
+Ловится отдельно. Поле `kind` — `tts_down`, `tts_invalid` или `tts_limit`.
+
+```python
+from tts_api_client import TTS_API, TTSError
+
+try:
+    TTS_API("tts_xxx").get_voice("Привет")
+except TTSError as e:
+    print(e.kind, e.message)
+```
+
+## Лицензия
+
+MIT

tts_api_client-0.1.0/README.md

@@ -0,0 +1,65 @@
+# tts-api-client
+
+Python-клиент для [TTS API](https://github.com/<ты>/tts-api) — синтез речи в MP3,
+выбор мужского/женского голоса, сохранение в любую папку.
+
+## Установка
+
+```bash
+pip install tts-api-client
+```
+
+## Быстрый старт
+
+```python
+from tts_api_client import TTS_API
+
+api = TTS_API("tts_xxxxxxxxxxxxxxxxxxxxxxxx")
+
+# Сохранит в текущую папку → ./voice_message.mp3
+path = api.get_voice("Привет, мир!")
+print(path)
+
+# Мужской голос + своя папка
+api.get_voice("Привет", voice="male", save_dir="cache", filename="hi.mp3")
+
+# Полный путь
+api.get_voice("Привет", out_path="/tmp/hello.mp3")
+```
+
+## API
+
+### `TTS_API(token, api_url=DEFAULT_API_URL, user_agent="tts_api_client/1.0", timeout=30)`
+
+Создаёт клиент. Токен получается на лендинге твоего TTS API (`POST /api/register`).
+
+### `TTS_API.get_voice(...)`
+
+| Параметр   | Тип            | По умолчанию           | Описание                          |
+|------------|----------------|------------------------|-----------------------------------|
+| `text`     | `str`          | —                      | Текст, до 200 символов            |
+| `lang`     | `str`          | `"ru"`                 | Язык                              |
+| `out_path` | `Optional[str]`| `None`                 | Полный путь к файлу               |
+| `save_dir` | `Optional[str]`| `None`                 | Папка (с `filename`)              |
+| `filename` | `str`          | `"voice_message.mp3"`  | Имя файла                         |
+| `voice`    | `str`          | `"female"`             | `female` или `male`               |
+| `timeout`  | `Optional[int]`| `None`                 | Таймаут (переопределяет дефолт)   |
+
+Возвращает **абсолютный путь** к сохранённому MP3.
+
+### `TTSError`
+
+Ловится отдельно. Поле `kind` — `tts_down`, `tts_invalid` или `tts_limit`.
+
+```python
+from tts_api_client import TTS_API, TTSError
+
+try:
+    TTS_API("tts_xxx").get_voice("Привет")
+except TTSError as e:
+    print(e.kind, e.message)
+```
+
+## Лицензия
+
+MIT

tts_api_client-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tts-api-client"
+version = "0.1.0"
+description = "Клиент для собственного TTS API (Edge TTS / Google Translate TTS)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Denis Bisekeev", email = "bisekeevdenis@gmail.com" }]
+keywords = ["tts", "text-to-speech", "audio", "mp3", "voice"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Sound/Audio :: Speech",
+]
+dependencies = ["requests>=2.25"]
+
+[project.urls]
+Homepage = "https://github.com/<ты>/tts-api-client"
+Source   = "https://github.com/<ты>/tts-api-client"
+Issues   = "https://github.com/<ты>/tts-api-client/issues"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]

tts_api_client-0.1.0/setup.cfg

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

tts_api_client-0.1.0/src/tts_api_client/__init__.py

@@ -0,0 +1,4 @@
+from .client import TTS_API, TTSError, DEFAULT_API_URL
+
+__all__ = ["TTS_API", "TTSError", "DEFAULT_API_URL"]
+__version__ = "0.1.0"

tts_api_client-0.1.0/src/tts_api_client/client.py

@@ -0,0 +1,137 @@
+"""HTTP-клиент для TTS API (https://github.com/<ты>/tts-api)."""
+from __future__ import annotations
+
+import os
+from typing import Optional
+
+import requests
+
+__all__ = ["TTS_API", "TTSError"]
+
+DEFAULT_API_URL = "http://84.21.173.179:3000/tts"
+
+
+class TTSError(Exception):
+    """Ошибка при обращении к TTS API.
+
+    Атрибуты:
+        kind: короткий код ошибки — ``tts_down``, ``tts_invalid``, ``tts_limit``.
+        message: человекочитаемое описание.
+    """
+
+    def __init__(self, kind: str, message: str) -> None:
+        self.kind = kind
+        self.message = message
+        super().__init__(message)
+
+
+def _json_err(resp: requests.Response) -> str:
+    try:
+        return resp.json().get("error", resp.text)
+    except ValueError:
+        return resp.text
+
+
+class TTS_API:
+    """Клиент TTS API.
+
+    Пример:
+        >>> from tts_api_client import TTS_API
+        >>> api = TTS_API("tts_xxx")
+        >>> api.get_voice("Привет", voice="male")
+        'C:/path/voice_message.mp3'
+    """
+
+    def __init__(
+        self,
+        token: str,
+        api_url: str = DEFAULT_API_URL,
+        user_agent: str = "tts_api_client/1.0",
+        timeout: int = 30,
+    ) -> None:
+        if not token:
+            raise ValueError("token не должен быть пустым")
+
+        self.token = token
+        self.api_url = api_url
+        self.timeout = timeout
+        self._session = requests.Session()
+        self._session.headers.update({"User-Agent": user_agent})
+
+    def get_voice(
+        self,
+        text: str,
+        lang: str = "ru",
+        out_path: Optional[str] = None,
+        save_dir: Optional[str] = None,
+        filename: str = "voice_message.mp3",
+        voice: str = "female",
+        timeout: Optional[int] = None,
+    ) -> str:
+        """Синтезирует текст в MP3 и сохраняет файл.
+
+        Приоритет путей:
+            1. ``out_path``  — полный путь к файлу (папка создаётся).
+            2. ``save_dir``  — папка + ``filename``.
+            3. ничего        — текущая рабочая папка + ``filename``.
+
+        Args:
+            text: Текст для озвучки (до 200 символов).
+            lang: Язык, по умолчанию ``ru``.
+            out_path: Полный путь к итоговому MP3.
+            save_dir: Папка для сохранения.
+            filename: Имя файла, если задан ``save_dir``.
+            voice: ``female`` (по умолчанию) или ``male``.
+            timeout: Таймаут запроса в секундах (переопределяет значение из конструктора).
+
+        Returns:
+            Абсолютный путь к сохранённому файлу.
+
+        Raises:
+            TTSError: при ошибке сети или ответа API.
+        """
+        # 1. Определяем итоговый путь
+        if out_path:
+            final_path = os.path.abspath(out_path)
+        elif save_dir:
+            final_path = os.path.abspath(os.path.join(save_dir, filename))
+        else:
+            final_path = os.path.abspath(os.path.join(os.getcwd(), filename))
+
+        os.makedirs(os.path.dirname(final_path) or ".", exist_ok=True)
+
+        # 2. Запрос
+        params = {
+            "text": text,
+            "lang": lang,
+            "token": self.token,
+            "voice": voice,
+        }
+
+        try:
+            resp = self._session.get(
+                self.api_url,
+                params=params,
+                timeout=timeout or self.timeout,
+            )
+        except requests.RequestException as exc:
+            raise TTSError("tts_down", f"сеть: {exc}") from exc
+
+        # 3. Обработка статусов
+        if resp.status_code in (401, 403):
+            raise TTSError("tts_invalid", _json_err(resp))
+        if resp.status_code == 429:
+            raise TTSError("tts_limit", _json_err(resp))
+        if resp.status_code >= 500:
+            raise TTSError("tts_down", _json_err(resp))
+        if resp.status_code != 200:
+            raise TTSError("tts_invalid", f"{resp.status_code}: {_json_err(resp)}")
+
+        if "audio" not in resp.headers.get("Content-Type", ""):
+            raise TTSError("tts_invalid", "ожидался audio/*")
+
+        # 4. Сохранение
+        with open(final_path, "wb") as f:
+            f.write(resp.content)
+
+        return final_path

tts_api_client-0.1.0/src/tts_api_client.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: tts-api-client
+Version: 0.1.0
+Summary: Клиент для собственного TTS API (Edge TTS / Google Translate TTS)
+Author-email: Denis Bisekeev <bisekeevdenis@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/<ты>/tts-api-client
+Project-URL: Source, https://github.com/<ты>/tts-api-client
+Project-URL: Issues, https://github.com/<ты>/tts-api-client/issues
+Keywords: tts,text-to-speech,audio,mp3,voice
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# tts-api-client
+
+Python-клиент для [TTS API](https://github.com/<ты>/tts-api) — синтез речи в MP3,
+выбор мужского/женского голоса, сохранение в любую папку.
+
+## Установка
+
+```bash
+pip install tts-api-client
+```
+
+## Быстрый старт
+
+```python
+from tts_api_client import TTS_API
+
+api = TTS_API("tts_xxxxxxxxxxxxxxxxxxxxxxxx")
+
+# Сохранит в текущую папку → ./voice_message.mp3
+path = api.get_voice("Привет, мир!")
+print(path)
+
+# Мужской голос + своя папка
+api.get_voice("Привет", voice="male", save_dir="cache", filename="hi.mp3")
+
+# Полный путь
+api.get_voice("Привет", out_path="/tmp/hello.mp3")
+```
+
+## API
+
+### `TTS_API(token, api_url=DEFAULT_API_URL, user_agent="tts_api_client/1.0", timeout=30)`
+
+Создаёт клиент. Токен получается на лендинге твоего TTS API (`POST /api/register`).
+
+### `TTS_API.get_voice(...)`
+
+| Параметр   | Тип            | По умолчанию           | Описание                          |
+|------------|----------------|------------------------|-----------------------------------|
+| `text`     | `str`          | —                      | Текст, до 200 символов            |
+| `lang`     | `str`          | `"ru"`                 | Язык                              |
+| `out_path` | `Optional[str]`| `None`                 | Полный путь к файлу               |
+| `save_dir` | `Optional[str]`| `None`                 | Папка (с `filename`)              |
+| `filename` | `str`          | `"voice_message.mp3"`  | Имя файла                         |
+| `voice`    | `str`          | `"female"`             | `female` или `male`               |
+| `timeout`  | `Optional[int]`| `None`                 | Таймаут (переопределяет дефолт)   |
+
+Возвращает **абсолютный путь** к сохранённому MP3.
+
+### `TTSError`
+
+Ловится отдельно. Поле `kind` — `tts_down`, `tts_invalid` или `tts_limit`.
+
+```python
+from tts_api_client import TTS_API, TTSError
+
+try:
+    TTS_API("tts_xxx").get_voice("Привет")
+except TTSError as e:
+    print(e.kind, e.message)
+```
+
+## Лицензия
+
+MIT

tts_api_client-0.1.0/src/tts_api_client.egg-info/SOURCES.txt

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

tts_api_client-0.1.0/src/tts_api_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tts_api_client-0.1.0/src/tts_api_client.egg-info/requires.txt

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

tts_api_client-0.1.0/src/tts_api_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+tts_api_client