embed-client 2.0.0.0__py3-none-any.whl → 3.1.0.1__py3-none-any.whl

embed_client-3.1.0.1.dist-info/METADATA

@@ -0,0 +1,256 @@
+Metadata-Version: 2.4
+Name: embed-client
+Version: 3.1.0.1
+Summary: Async client for Embedding Service API with comprehensive authentication, SSL/TLS, and mTLS support
+Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/vasilyvz/embed-client
+Project-URL: Repository, https://github.com/vasilyvz/embed-client
+Project-URL: Documentation, https://github.com/vasilyvz/embed-client#readme
+Project-URL: Bug Tracker, https://github.com/vasilyvz/embed-client/issues
+Keywords: embedding,async,client,api,authentication,ssl,tls,mtls
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: PyJWT>=2.0.0
+Requires-Dist: cryptography>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# embed-client
+
+Асинхронный клиент для Embedding Service API с поддержкой всех режимов безопасности.
+
+## Возможности
+
+- ✅ **Асинхронный API** - полная поддержка async/await
+- ✅ **Все режимы безопасности** - HTTP, HTTPS, mTLS
+- ✅ **Аутентификация** - API Key, JWT, Basic Auth, Certificate
+- ✅ **SSL/TLS поддержка** - полная интеграция с mcp_security_framework
+- ✅ **Конфигурация** - файлы конфигурации, переменные окружения, аргументы
+- ✅ **Обратная совместимость** - API формат не изменился, добавлена только безопасность
+- ✅ **Типизация** - 100% type-annotated код
+- ✅ **Тестирование** - 84+ тестов с полным покрытием
+
+## Quick Start: Примеры запуска
+
+### Базовое использование
+
+**Вариант 1: через аргументы командной строки**
+
+```sh
+# HTTP без аутентификации
+python embed_client/example_async_usage.py --base-url http://localhost --port 8001
+
+# HTTP с API ключом
+python embed_client/example_async_usage.py --base-url http://localhost --port 8001 \
+  --auth-method api_key --api-key admin_key_123
+
+# HTTPS с SSL
+python embed_client/example_async_usage.py --base-url https://localhost --port 9443 \
+  --ssl-verify-mode CERT_REQUIRED
+
+# mTLS с сертификатами
+python embed_client/example_async_usage.py --base-url https://localhost --port 9443 \
+  --cert-file certs/client.crt --key-file keys/client.key --ca-cert-file certs/ca.crt
+```
+
+**Вариант 2: через переменные окружения**
+
+```sh
+export EMBED_CLIENT_BASE_URL=http://localhost
+export EMBED_CLIENT_PORT=8001
+export EMBED_CLIENT_AUTH_METHOD=api_key
+export EMBED_CLIENT_API_KEY=admin_key_123
+python embed_client/example_async_usage.py
+```
+
+**Вариант 3: через файл конфигурации**
+
+```sh
+python embed_client/example_async_usage.py --config configs/https_token.json
+```
+
+### Режимы безопасности
+
+#### 1. HTTP (без аутентификации)
+```python
+from embed_client.async_client import EmbeddingServiceAsyncClient
+
+client = EmbeddingServiceAsyncClient(
+    base_url="http://localhost",
+    port=8001
+)
+```
+
+#### 2. HTTP + Token
+```python
+from embed_client.config import ClientConfig
+
+# API Key
+config = ClientConfig.create_http_token_config(
+    "http://localhost", 8001, {"user": "api_key_123"}
+)
+
+# JWT
+config = ClientConfig.create_http_jwt_config(
+    "http://localhost", 8001, "secret", "username", "password"
+)
+
+# Basic Auth
+config = ClientConfig.create_http_basic_config(
+    "http://localhost", 8001, "username", "password"
+)
+```
+
+#### 3. HTTPS
+```python
+config = ClientConfig.create_https_config(
+    "https://localhost", 9443,
+    ca_cert_file="certs/ca.crt"
+)
+```
+
+#### 4. mTLS (взаимная аутентификация)
+```python
+config = ClientConfig.create_mtls_config(
+    "https://localhost", 9443,
+    cert_file="certs/client.crt",
+    key_file="keys/client.key",
+    ca_cert_file="certs/ca.crt"
+)
+```
+
+### Программное использование
+
+```python
+import asyncio
+from embed_client.async_client import EmbeddingServiceAsyncClient
+from embed_client.config import ClientConfig
+
+async def main():
+    # Создание конфигурации
+    config = ClientConfig.create_http_token_config(
+        "http://localhost", 8001, {"user": "api_key_123"}
+    )
+    
+    # Использование клиента
+    async with EmbeddingServiceAsyncClient.from_config(config) as client:
+        # Проверка статуса
+        print(f"Аутентификация: {client.get_auth_method()}")
+        print(f"SSL включен: {client.is_ssl_enabled()}")
+        print(f"mTLS включен: {client.is_mtls_enabled()}")
+        
+        # Выполнение запроса
+        result = await client.cmd("embed", params={"texts": ["hello world"]})
+        
+        # Извлечение данных
+        embeddings = client.extract_embeddings(result)
+        texts = client.extract_texts(result)
+        tokens = client.extract_tokens(result)
+        bm25_tokens = client.extract_bm25_tokens(result)
+        
+        print(f"Эмбеддинги: {embeddings}")
+        print(f"Тексты: {texts}")
+        print(f"Токены: {tokens}")
+        print(f"BM25 токены: {bm25_tokens}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Установка
+
+```bash
+# Установка из PyPI
+pip install embed-client
+
+# Установка в режиме разработки
+git clone <repository>
+cd embed-client
+pip install -e .
+```
+
+## Зависимости
+
+- `aiohttp` - асинхронные HTTP запросы
+- `PyJWT>=2.0.0` - JWT токены
+- `cryptography>=3.0.0` - криптография и сертификаты
+- `pydantic>=2.0.0` - валидация конфигурации
+
+## Тестирование
+
+```bash
+# Запуск всех тестов
+pytest tests/
+
+# Запуск тестов с покрытием
+pytest tests/ --cov=embed_client
+
+# Запуск конкретных тестов
+pytest tests/test_async_client.py -v
+pytest tests/test_config.py -v
+pytest tests/test_auth.py -v
+pytest tests/test_ssl_manager.py -v
+```
+
+## Документация
+
+- [Формат API и режимы безопасности](docs/api_format.md)
+- [Примеры использования](embed_client/example_async_usage.py)
+- [Примеры на русском](embed_client/example_async_usage_ru.py)
+
+## Безопасность
+
+### Рекомендации
+
+1. **Используйте HTTPS** для продакшена
+2. **Включите проверку сертификатов** (CERT_REQUIRED)
+3. **Используйте mTLS** для критически важных систем
+4. **Регулярно обновляйте сертификаты**
+5. **Храните приватные ключи в безопасном месте**
+
+### Поддерживаемые протоколы
+
+- TLS 1.2
+- TLS 1.3
+- SSL 3.0 (устаревший, не рекомендуется)
+
+## Лицензия
+
+MIT License
+
+## Автор
+
+**Vasiliy Zdanovskiy**  
+Email: vasilyvz@gmail.com
+
+---
+
+**Важно:**
+- Используйте `--base-url` (через дефис), а не `--base_url` (через подчеркивание).
+- Значение base_url должно содержать `http://` или `https://`.
+- Аргументы должны быть отдельными (через пробел), а не через `=`.

embed_client-3.1.0.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+embed_client/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
+embed_client/async_client.py,sha256=Zf08g-i_2ylDj4tt9E1TO9swi-zcozFDr4mJdlfiGSI,40222
+embed_client/auth.py,sha256=MMk5XqFIY5htf3Bx0JA_8mJaAiLslpLUIVUaiO84XBw,18310
+embed_client/auth_examples.py,sha256=QX_QWaaeyBAqvSs9uOP1ZVdAe72gJ91e8AP1e7R-yzQ,7361
+embed_client/client_factory.py,sha256=-W2nvzMuyyQNu3_nNmALKHT9uL0Z9nMYTxyQ4bgVOFQ,14279
+embed_client/client_factory_examples.py,sha256=7A2JWkyGEJeOB7p84ijklh8rTyeRUeg2lCIPTfAtahc,11823
+embed_client/config.py,sha256=CzVmduJjuN82uiaxDyMyXJLS2tNOOlDBGwcO76SWjXg,19922
+embed_client/config_examples.py,sha256=9aEF8X4h9nbfSV_CORZLrlWM5KEwuwqW6AcQDPguQ7g,6175
+embed_client/example_async_usage.py,sha256=dndf79MIqZaHvWzbtKrZVwU7G4a5yNL1JPMnMBEdLBg,29803
+embed_client/example_async_usage_ru.py,sha256=3HeP5YoyGd49dRlxNC-2TAh_GbwSW4jJmoLXMpMIfFs,29899
+embed_client/ssl_examples.py,sha256=22lTGhK2bqGJ44uUCpc7v2egY4AP3_ar8RMaTb4KBwU,9346
+embed_client/ssl_manager.py,sha256=Ts6-hKxUUNHdW3yldnoykaDblxWtGbIwKdnzPw__30U,17247
+embed_client-3.1.0.1.dist-info/licenses/LICENSE,sha256=6KdtUcTwmTRbJrAmYjVn7e6S-V42ubeDJ-AiVEzZ510,1075
+embed_client-3.1.0.1.dist-info/METADATA,sha256=mvhUNvCDzryNQh68sFeSyGx9ZG9gyypnkPWrNYqxth4,8633
+embed_client-3.1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+embed_client-3.1.0.1.dist-info/top_level.txt,sha256=uG00A4d9o9DFrhiN7goObpeig72Pniby0E7UpDRgyXY,13
+embed_client-3.1.0.1.dist-info/RECORD,,

embed_client-3.1.0.1.dist-info/licenses/LICENSE

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

embed_client-2.0.0.0.dist-info/METADATA

@@ -1,9 +0,0 @@
-Metadata-Version: 2.4
-Name: embed-client
-Version: 2.0.0.0
-Summary: Async client for Embedding Service API
-Author: Your Name
-Requires-Dist: aiohttp
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-asyncio; extra == "test"

embed_client-2.0.0.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-embed_client/__init__.py,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
-embed_client/async_client.py,sha256=8jsDvHQhtoYNrQ4B2rGHqmniGPVMQeSsrzZZUyMx_J8,26357
-embed_client/example_async_usage.py,sha256=6oCDALFebTv1o5k7lB7UuiacP9Scvf2r3gVIVtIrsPk,6623
-embed_client/example_async_usage_ru.py,sha256=J9K3UpDJwwwy7gNQzy6G3clX4VoMleBmRk_9vymlIiw,5425
-embed_client-2.0.0.0.dist-info/METADATA,sha256=3_4NeyifJYxq9iQQHgmxgegFxeoNPvriW_UpWNsAOmI,254
-embed_client-2.0.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-embed_client-2.0.0.0.dist-info/top_level.txt,sha256=uG00A4d9o9DFrhiN7goObpeig72Pniby0E7UpDRgyXY,13
-embed_client-2.0.0.0.dist-info/RECORD,,