gengineapi 0.1.0__tar.gz → 0.2.1__tar.gz

{gengineapi-0.1.0 → gengineapi-0.2.1}/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.4
 Name: gengineapi
-Version: 0.1.0
-Summary: Add your description here
+Version: 0.2.1
+Summary: G-Engine API Client
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: aiohttp-socks>=0.7.1
-Requires-Dist: uv-publish
 
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -21,6 +20,7 @@ Requires-Dist: uv-publish
 - Автоматические повторные попытки для временных ошибок
 - Поддержка JWT-аутентификации
 - Поддержка прокси, включая SOCKS5
+- Ферма клиентов с балансировкой нагрузки и стратегиями ротации
 - Подробное логирование
 - Строгая типизация с помощью аннотаций типов
 - Класс-конфигурация для централизованной настройки и повторного использования
@@ -28,33 +28,13 @@ Requires-Dist: uv-publish
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
-```
-
-## Структура проекта
-
-```
-gengine_client/
-├── __init__.py            # Экспорт основных классов
-├── client.py              # Основной класс клиента
-├── http.py                # HTTP клиент с поддержкой аутентификации
-├── exceptions.py          # Иерархия исключений API
-├── config.py              # Класс-конфигурация для настройки параметров
-└── modules/               # Папка с модулями API
-    ├── __init__.py
-    ├── base.py            # Базовый класс для всех модулей
-    ├── payments.py        # Модуль для работы с платежами
-    ├── finances.py        # Модуль для работы с финансами
-    ├── auth.py            # Модуль для аутентификации
-    ├── users.py           # Модуль для работы с пользователями
-    ├── transactions.py    # Модуль для работы с транзакциями
-    └── currencies.py      # Модуль для работы с валютами
+pip install aiohttp-socks
 ```
 
 ## Использование
@@ -63,7 +43,7 @@ gengine_client/
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -84,7 +64,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -119,7 +99,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -149,7 +129,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -188,32 +168,52 @@ async def main():
 asyncio.run(main())
 ```
 
-### Загрузка конфигурации из переменных окружения
+### Использование фермы клиентов
+
+Ферма клиентов позволяет управлять множеством клиентов с разными конфигурациями и стратегиями ротации:
 
 ```python
 import asyncio
-import os
-from gengine_client import GEngineConfig
-
-# Установка переменных окружения
-os.environ["GENGINE_BASE_URL"] = "https://api.example.com/api/v2"
-os.environ["GENGINE_TOKEN"] = "env_jwt_token"
-os.environ["GENGINE_TIMEOUT"] = "45"
-os.environ["GENGINE_MAX_RETRIES"] = "5"
-os.environ["GENGINE_PROXY"] = "socks5://127.0.0.1:9050"  # Опционально - прокси
+from gengineapi import ClientFarm
 
 async def main():
-    # Загрузка настроек из переменных окружения
-    GEngineConfig.load_from_env()
+    # Создаем ферму клиентов
+    farm = ClientFarm()
     
-    # Получение клиента с настройками из переменных окружения
-    client = await GEngineConfig.get_client()
+    # Добавляем несколько конфигураций с разными прокси
+    farm.create_config(
+        name="client1",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token1",
+        proxy="socks5://user1:pass1@host1:port1",
+        tags=["group1", "production"]
+    )
     
-    # Использование клиента
-    # ...
+    farm.create_config(
+        name="client2",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token2",
+        proxy="socks5://user2:pass2@host2:port2",
+        tags=["group1", "backup"]
+    )
     
-    # При завершении приложения
-    await GEngineConfig.reset()
+    # Устанавливаем стратегию выбора клиента
+    farm.set_selection_strategy("round_robin")  # или "random", "least_errors", "least_recently_used"
+    
+    # Получаем клиент по имени
+    client1 = await farm.get_client("client1")
+    await client1.users.get_me()
+    
+    # Получаем следующий клиент согласно стратегии
+    client = await farm.get_next_client()
+    await client.currencies.get_rate(source="cb_rf", pair="USD:RUB")
+    
+    # Получаем клиент по тегу
+    client = await farm.get_next_client(tag="production")
+    await client.transactions.get_transactions(limit=5)
+    
+    # При завершении работы закрываем все клиенты
+    await farm.close_all()
 
 asyncio.run(main())
 ```
@@ -224,7 +224,7 @@ asyncio.run(main())
 import asyncio
 import uuid
 from decimal import Decimal
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     async with GEngineClient(
@@ -255,19 +255,25 @@ async def main():
 asyncio.run(main())
 ```
 
-## Примеры
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
 
-В репозитории есть примеры использования клиента с разными сценариями:
+## Дополнительная документация
 
-- `examples.py` - полный набор примеров использования, включая работу с прокси
-- `old_examples/` - директория с устаревшими примерами
+Ручки, которые дергаем - https://b2b-api.ggsel.com/api/v2/docs#
 
 ## Зависимости
 
 - Python 3.7+
 - aiohttp >= 3.8.0
 - typing-extensions >= 4.0.0
-- aiohttp-socks >= 0.7.1 (для поддержки SOCKS5 прокси)
+- aiohttp-socks >= 0.7.1 (опционально, для поддержки SOCKS5 прокси)
 
 ## Лицензия
 

{gengineapi-0.1.0 → gengineapi-0.2.1}/README.md

@@ -1,4 +1,4 @@
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -10,6 +10,7 @@
 - Автоматические повторные попытки для временных ошибок
 - Поддержка JWT-аутентификации
 - Поддержка прокси, включая SOCKS5
+- Ферма клиентов с балансировкой нагрузки и стратегиями ротации
 - Подробное логирование
 - Строгая типизация с помощью аннотаций типов
 - Класс-конфигурация для централизованной настройки и повторного использования
@@ -17,33 +18,13 @@
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
-```
-
-## Структура проекта
-
-```
-gengine_client/
-├── __init__.py            # Экспорт основных классов
-├── client.py              # Основной класс клиента
-├── http.py                # HTTP клиент с поддержкой аутентификации
-├── exceptions.py          # Иерархия исключений API
-├── config.py              # Класс-конфигурация для настройки параметров
-└── modules/               # Папка с модулями API
-    ├── __init__.py
-    ├── base.py            # Базовый класс для всех модулей
-    ├── payments.py        # Модуль для работы с платежами
-    ├── finances.py        # Модуль для работы с финансами
-    ├── auth.py            # Модуль для аутентификации
-    ├── users.py           # Модуль для работы с пользователями
-    ├── transactions.py    # Модуль для работы с транзакциями
-    └── currencies.py      # Модуль для работы с валютами
+pip install aiohttp-socks
 ```
 
 ## Использование
@@ -52,7 +33,7 @@ gengine_client/
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -73,7 +54,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -108,7 +89,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -138,7 +119,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -177,32 +158,52 @@ async def main():
 asyncio.run(main())
 ```
 
-### Загрузка конфигурации из переменных окружения
+### Использование фермы клиентов
+
+Ферма клиентов позволяет управлять множеством клиентов с разными конфигурациями и стратегиями ротации:
 
 ```python
 import asyncio
-import os
-from gengine_client import GEngineConfig
-
-# Установка переменных окружения
-os.environ["GENGINE_BASE_URL"] = "https://api.example.com/api/v2"
-os.environ["GENGINE_TOKEN"] = "env_jwt_token"
-os.environ["GENGINE_TIMEOUT"] = "45"
-os.environ["GENGINE_MAX_RETRIES"] = "5"
-os.environ["GENGINE_PROXY"] = "socks5://127.0.0.1:9050"  # Опционально - прокси
+from gengineapi import ClientFarm
 
 async def main():
-    # Загрузка настроек из переменных окружения
-    GEngineConfig.load_from_env()
+    # Создаем ферму клиентов
+    farm = ClientFarm()
     
-    # Получение клиента с настройками из переменных окружения
-    client = await GEngineConfig.get_client()
+    # Добавляем несколько конфигураций с разными прокси
+    farm.create_config(
+        name="client1",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token1",
+        proxy="socks5://user1:pass1@host1:port1",
+        tags=["group1", "production"]
+    )
     
-    # Использование клиента
-    # ...
+    farm.create_config(
+        name="client2",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token2",
+        proxy="socks5://user2:pass2@host2:port2",
+        tags=["group1", "backup"]
+    )
     
-    # При завершении приложения
-    await GEngineConfig.reset()
+    # Устанавливаем стратегию выбора клиента
+    farm.set_selection_strategy("round_robin")  # или "random", "least_errors", "least_recently_used"
+    
+    # Получаем клиент по имени
+    client1 = await farm.get_client("client1")
+    await client1.users.get_me()
+    
+    # Получаем следующий клиент согласно стратегии
+    client = await farm.get_next_client()
+    await client.currencies.get_rate(source="cb_rf", pair="USD:RUB")
+    
+    # Получаем клиент по тегу
+    client = await farm.get_next_client(tag="production")
+    await client.transactions.get_transactions(limit=5)
+    
+    # При завершении работы закрываем все клиенты
+    await farm.close_all()
 
 asyncio.run(main())
 ```
@@ -213,7 +214,7 @@ asyncio.run(main())
 import asyncio
 import uuid
 from decimal import Decimal
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     async with GEngineClient(
@@ -244,19 +245,25 @@ async def main():
 asyncio.run(main())
 ```
 
-## Примеры
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
 
-В репозитории есть примеры использования клиента с разными сценариями:
+## Дополнительная документация
 
-- `examples.py` - полный набор примеров использования, включая работу с прокси
-- `old_examples/` - директория с устаревшими примерами
+Ручки, которые дергаем - https://b2b-api.ggsel.com/api/v2/docs#
 
 ## Зависимости
 
 - Python 3.7+
 - aiohttp >= 3.8.0
 - typing-extensions >= 4.0.0
-- aiohttp-socks >= 0.7.1 (для поддержки SOCKS5 прокси)
+- aiohttp-socks >= 0.7.1 (опционально, для поддержки SOCKS5 прокси)
 
 ## Лицензия
 

{gengineapi-0.1.0 → gengineapi-0.2.1}/pyproject.toml

@@ -1,18 +1,11 @@
 [project]
 name = "gengineapi"
-version = "0.1.0"
-description = "Add your description here"
+version = "0.2.1"
+description = "G-Engine API Client"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
     "aiohttp>=3.8.0",     # Для асинхронных HTTP-запросов и WebSocket
     "typing-extensions>=4.0.0",  # Для расширенных типов аннотаций
     "aiohttp-socks>=0.7.1",
-    "uv-publish",
-]
-
-[[tool.uv.index]]
-name = "testpypi"
-url = "https://test.pypi.org/simple/"
-publish-url = "https://test.pypi.org/legacy/"
-explicit = true
+]

{gengineapi-0.1.0 → gengineapi-0.2.1}/src/gengineapi/__init__.py

@@ -19,6 +19,7 @@ from .exceptions import (
     ApiTimeoutError,
     ApiValidationError,
 )
+from .farm import ClientFarm, ClientConfig
 from .http import AsyncHttpClient
 
 __version__ = "1.0.0"
@@ -29,6 +30,9 @@ __all__ = [
     'GEngineConfig',
     # HTTP клиент
     'AsyncHttpClient',
+    # Ферма клиентов
+    'ClientFarm',
+    'ClientConfig',
     # Исключения
     'ApiError',
     'ApiConnectionError',

gengineapi-0.2.1/src/gengineapi/farm.py

@@ -0,0 +1,464 @@
+"""
+Модуль, предоставляющий функциональность для управления фермой клиентов G-Engine API.
+
+Позволяет создавать и управлять несколькими независимыми клиентами
+с различными конфигурациями, прокси и токенами аутентификации.
+"""
+import asyncio
+import logging
+import uuid
+from typing import Dict, Optional, List, Any
+
+from .client import GEngineClient
+
+
+class ClientConfig:
+    """
+    Класс конфигурации для отдельного клиента.
+    
+    Позволяет хранить и управлять параметрами для создания клиента.
+    
+    Attributes:
+        name: Уникальное имя конфигурации
+        base_url: Базовый URL для API
+        jwt_token: JWT токен для аутентификации
+        timeout: Таймаут для запросов в секундах
+        max_retries: Максимальное количество повторных попыток
+        logger: Логгер для записи информации
+        proxy: Прокси для запросов
+        client: Экземпляр клиента, если он был создан
+    """
+    
+    def __init__(
+        self,
+        base_url: str,
+        jwt_token: Optional[str] = None,
+        timeout: int = 30,
+        max_retries: int = 3,
+        logger: Optional[logging.Logger] = None,
+        proxy: Optional[str] = None,
+        name: Optional[str] = None,  # Уникальное имя конфига
+        tags: Optional[List[str]] = None,  # Теги для группировки и фильтрации
+    ) -> None:
+        """
+        Инициализация конфигурации клиента.
+        
+        Args:
+            base_url: Базовый URL для API
+            jwt_token: JWT токен для аутентификации (опционально)
+            timeout: Таймаут для запросов в секундах (по умолчанию 30)
+            max_retries: Максимальное количество повторных попыток (по умолчанию 3)
+            logger: Логгер для записи информации (опционально)
+            proxy: Прокси для запросов в формате 'socks5://user:pass@host:port' (опционально)
+            name: Уникальное имя конфигурации (опционально, генерируется автоматически)
+            tags: Список тегов для группировки и фильтрации (опционально)
+        """
+        self.base_url = base_url
+        self.jwt_token = jwt_token
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self.logger = logger
+        self.proxy = proxy
+        self.name = name or str(uuid.uuid4())
+        self.tags = tags or []
+        self.client: Optional[GEngineClient] = None
+        self.last_used: float = 0  # Время последнего использования (для ротации)
+        self.error_count: int = 0  # Счетчик ошибок
+        self.success_count: int = 0  # Счетчик успешных запросов
+        self.is_active: bool = True  # Флаг активности конфигурации
+
+    async def get_client(self) -> GEngineClient:
+        """
+        Возвращает клиент или создает новый, если он не существует.
+        
+        Returns:
+            GEngineClient: Экземпляр клиента API
+        """
+        if self.client is None:
+            self.client = GEngineClient(
+                base_url=self.base_url,
+                jwt_token=self.jwt_token,
+                timeout=self.timeout,
+                max_retries=self.max_retries,
+                logger=self.logger,
+                proxy=self.proxy
+            )
+        
+        # Обновляем время последнего использования
+        import time
+        self.last_used = time.time()
+        
+        return self.client
+    
+    async def close(self) -> None:
+        """Закрывает клиент."""
+        if self.client:
+            await self.client.close()
+            self.client = None
+    
+    def update_token(self, jwt_token: str) -> None:
+        """
+        Обновляет JWT токен в конфигурации и в клиенте, если он существует.
+        
+        Args:
+            jwt_token: Новый JWT токен
+        """
+        self.jwt_token = jwt_token
+        if self.client:
+            self.client.update_token(jwt_token)
+    
+    def update_proxy(self, proxy: Optional[str] = None) -> None:
+        """
+        Обновляет настройки прокси в конфигурации и в клиенте, если он существует.
+        
+        Args:
+            proxy: Новый прокси или None для отключения прокси
+        """
+        self.proxy = proxy
+        if self.client:
+            if hasattr(self.client, 'update_proxy'):
+                self.client.update_proxy(proxy)
+            else:
+                # Если клиент не поддерживает динамическое обновление прокси,
+                # закрываем его и создадим новый при следующем запросе
+                asyncio.create_task(self.close())
+    
+    def deactivate(self) -> None:
+        """Деактивирует конфигурацию."""
+        self.is_active = False
+    
+    def activate(self) -> None:
+        """Активирует конфигурацию."""
+        self.is_active = True
+    
+    def to_dict(self) -> Dict[str, Any]:
+        """
+        Преобразует конфигурацию в словарь.
+        
+        Returns:
+            Dict[str, Any]: Словарь с параметрами конфигурации
+        """
+        return {
+            "name": self.name,
+            "base_url": self.base_url,
+            "jwt_token": self.jwt_token,
+            "timeout": self.timeout,
+            "max_retries": self.max_retries,
+            "proxy": self.proxy,
+            "tags": self.tags,
+            "is_active": self.is_active,
+            "error_count": self.error_count,
+            "success_count": self.success_count,
+            "last_used": self.last_used,
+        }
+
+
+class ClientFarm:
+    """
+    Управляет фермой клиентов с разными конфигурациями.
+    
+    Позволяет создавать, хранить и использовать множество клиентов
+    с разными настройками, токенами и прокси.
+    """
+    
+    def __init__(self, logger: Optional[logging.Logger] = None) -> None:
+        """
+        Инициализация фермы клиентов.
+        
+        Args:
+            logger: Логгер для записи информации (опционально)
+        """
+        self.configs: Dict[str, ClientConfig] = {}
+        self.logger = logger or logging.getLogger(__name__)
+        self._selection_strategy: str = "round_robin"  # Стратегия выбора клиента
+        self._last_used_index: int = -1  # Индекс последнего использованного клиента
+    
+    def add_config(self, config: ClientConfig) -> None:
+        """
+        Добавляет конфигурацию в ферму.
+        
+        Args:
+            config: Конфигурация клиента
+        """
+        self.configs[config.name] = config
+        self.logger.info(f"Добавлена конфигурация: {config.name}")
+    
+    def create_config(self, **kwargs) -> ClientConfig:
+        """
+        Создает и добавляет новую конфигурацию.
+        
+        Args:
+            **kwargs: Параметры для создания конфигурации
+            
+        Returns:
+            ClientConfig: Созданная конфигурация
+        """
+        config = ClientConfig(**kwargs)
+        self.add_config(config)
+        return config
+    
+    async def get_client(self, name: str) -> Optional[GEngineClient]:
+        """
+        Возвращает клиент по имени конфигурации.
+        
+        Args:
+            name: Имя конфигурации
+            
+        Returns:
+            Optional[GEngineClient]: Экземпляр клиента или None, если конфигурация не найдена
+        """
+        config = self.configs.get(name)
+        if config and config.is_active:
+            return await config.get_client()
+        return None
+    
+    async def get_next_client(self, tag: Optional[str] = None) -> Optional[GEngineClient]:
+        """
+        Возвращает следующий клиент согласно выбранной стратегии.
+        
+        Args:
+            tag: Тег для фильтрации клиентов (опционально)
+            
+        Returns:
+            Optional[GEngineClient]: Экземпляр клиента или None, если нет доступных клиентов
+        """
+        active_configs = [
+            config for config in self.configs.values()
+            if config.is_active and (tag is None or tag in config.tags)
+        ]
+        
+        if not active_configs:
+            self.logger.warning("Нет доступных конфигураций клиентов")
+            return None
+        
+        if self._selection_strategy == "round_robin":
+            # Стратегия Round Robin
+            self._last_used_index = (self._last_used_index + 1) % len(active_configs)
+            config = active_configs[self._last_used_index]
+            return await config.get_client()
+        
+        elif self._selection_strategy == "random":
+            # Случайный выбор
+            import random
+            config = random.choice(active_configs)
+            return await config.get_client()
+        
+        elif self._selection_strategy == "least_errors":
+            # Выбираем клиент с наименьшим количеством ошибок
+            config = min(active_configs, key=lambda c: c.error_count)
+            return await config.get_client()
+        
+        elif self._selection_strategy == "least_recently_used":
+            # Выбираем наименее недавно использованный клиент
+            config = min(active_configs, key=lambda c: c.last_used)
+            return await config.get_client()
+        
+        else:
+            # По умолчанию используем Round Robin
+            self._last_used_index = (self._last_used_index + 1) % len(active_configs)
+            config = active_configs[self._last_used_index]
+            return await config.get_client()
+    
+    def set_selection_strategy(self, strategy: str) -> None:
+        """
+        Устанавливает стратегию выбора клиента.
+        
+        Args:
+            strategy: Стратегия выбора ('round_robin', 'random', 'least_errors', 'least_recently_used')
+        """
+        valid_strategies = ["round_robin", "random", "least_errors", "least_recently_used"]
+        if strategy not in valid_strategies:
+            raise ValueError(f"Недопустимая стратегия выбора: {strategy}. "
+                            f"Должна быть одна из: {', '.join(valid_strategies)}")
+        
+        self._selection_strategy = strategy
+        self.logger.info(f"Установлена стратегия выбора клиента: {strategy}")
+    
+    async def close_client(self, name: str) -> None:
+        """
+        Закрывает клиент по имени конфигурации.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        config = self.configs.get(name)
+        if config:
+            await config.close()
+            self.logger.info(f"Клиент закрыт: {name}")
+    
+    async def close_all(self) -> None:
+        """Закрывает все клиенты в ферме."""
+        for name, config in self.configs.items():
+            await config.close()
+            self.logger.info(f"Клиент закрыт: {name}")
+    
+    def remove_config(self, name: str) -> None:
+        """
+        Удаляет конфигурацию из фермы.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        if name in self.configs:
+            config = self.configs[name]
+            # Запустим задачу на закрытие клиента, если он существует
+            if config.client:
+                asyncio.create_task(config.close())
+            del self.configs[name]
+            self.logger.info(f"Конфигурация удалена: {name}")
+    
+    def get_configs_by_tag(self, tag: str) -> List[ClientConfig]:
+        """
+        Возвращает список конфигураций с указанным тегом.
+        
+        Args:
+            tag: Тег для фильтрации
+            
+        Returns:
+            List[ClientConfig]: Список конфигураций с указанным тегом
+        """
+        return [config for config in self.configs.values() if tag in config.tags]
+    
+    def get_active_configs(self) -> List[ClientConfig]:
+        """
+        Возвращает список активных конфигураций.
+        
+        Returns:
+            List[ClientConfig]: Список активных конфигураций
+        """
+        return [config for config in self.configs.values() if config.is_active]
+    
+    def deactivate_config(self, name: str) -> None:
+        """
+        Деактивирует конфигурацию.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        if name in self.configs:
+            self.configs[name].deactivate()
+            self.logger.info(f"Конфигурация деактивирована: {name}")
+    
+    def activate_config(self, name: str) -> None:
+        """
+        Активирует конфигурацию.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        if name in self.configs:
+            self.configs[name].activate()
+            self.logger.info(f"Конфигурация активирована: {name}")
+    
+    def register_error(self, name: str) -> None:
+        """
+        Регистрирует ошибку для указанной конфигурации.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        if name in self.configs:
+            self.configs[name].error_count += 1
+            
+            # Если превышен порог ошибок, деактивируем конфигурацию
+            if self.configs[name].error_count >= 10:  # Пример порога
+                self.configs[name].deactivate()
+                self.logger.warning(f"Конфигурация деактивирована из-за ошибок: {name}")
+    
+    def register_success(self, name: str) -> None:
+        """
+        Регистрирует успешное использование указанной конфигурации.
+        
+        Args:
+            name: Имя конфигурации
+        """
+        if name in self.configs:
+            self.configs[name].success_count += 1
+            
+            # Если клиент был деактивирован из-за ошибок, но успешно выполнил запрос,
+            # сбрасываем счетчик ошибок и активируем его снова
+            if not self.configs[name].is_active and self.configs[name].error_count > 0:
+                self.configs[name].error_count = 0
+                self.configs[name].activate()
+                self.logger.info(f"Конфигурация активирована после успешного запроса: {name}")
+    
+    def get_stats(self) -> Dict[str, Dict[str, Any]]:
+        """
+        Возвращает статистику по всем конфигурациям.
+        
+        Returns:
+            Dict[str, Dict[str, Any]]: Словарь со статистикой
+        """
+        return {name: config.to_dict() for name, config in self.configs.items()}
+    
+    async def export_configs(self, file_path: str) -> None:
+        """
+        Экспортирует конфигурации в JSON-файл.
+        
+        Args:
+            file_path: Путь к файлу для экспорта
+        """
+        import json
+        
+        # Закрываем все клиенты перед экспортом
+        await self.close_all()
+        
+        # Получаем данные конфигураций
+        configs_data = {name: config.to_dict() for name, config in self.configs.items()}
+        
+        # Сохраняем в файл
+        with open(file_path, "w") as f:
+            json.dump(configs_data, f, indent=2)
+        
+        self.logger.info(f"Конфигурации экспортированы в файл: {file_path}")
+    
+    @classmethod
+    async def import_configs(cls, file_path: str, logger: Optional[logging.Logger] = None) -> "ClientFarm":
+        """
+        Импортирует конфигурации из JSON-файла.
+        
+        Args:
+            file_path: Путь к файлу с конфигурациями
+            logger: Логгер для записи информации (опционально)
+            
+        Returns:
+            ClientFarm: Новый экземпляр фермы клиентов с импортированными конфигурациями
+        """
+        import json
+        
+        farm = cls(logger=logger)
+        
+        try:
+            # Загружаем данные из файла
+            with open(file_path, "r") as f:
+                configs_data = json.load(f)
+            
+            # Создаем конфигурации на основе данных
+            for name, data in configs_data.items():
+                # Извлекаем только параметры, необходимые для создания конфигурации
+                config_params = {
+                    "name": data.get("name"),
+                    "base_url": data.get("base_url"),
+                    "jwt_token": data.get("jwt_token"),
+                    "timeout": data.get("timeout"),
+                    "max_retries": data.get("max_retries"),
+                    "proxy": data.get("proxy"),
+                    "tags": data.get("tags", []),
+                }
+                
+                # Создаем конфигурацию
+                config = ClientConfig(**config_params)
+                
+                # Устанавливаем дополнительные параметры
+                config.is_active = data.get("is_active", True)
+                config.error_count = data.get("error_count", 0)
+                config.success_count = data.get("success_count", 0)
+                
+                # Добавляем конфигурацию в ферму
+                farm.add_config(config)
+        except Exception as e:
+            if logger:
+                logger.error(f"Ошибка при импорте конфигураций: {e}")
+            raise
+        
+        return farm

{gengineapi-0.1.0 → gengineapi-0.2.1}/src/gengineapi.egg-info/PKG-INFO

@@ -1,15 +1,14 @@
 Metadata-Version: 2.4
 Name: gengineapi
-Version: 0.1.0
-Summary: Add your description here
+Version: 0.2.1
+Summary: G-Engine API Client
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: aiohttp-socks>=0.7.1
-Requires-Dist: uv-publish
 
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -21,6 +20,7 @@ Requires-Dist: uv-publish
 - Автоматические повторные попытки для временных ошибок
 - Поддержка JWT-аутентификации
 - Поддержка прокси, включая SOCKS5
+- Ферма клиентов с балансировкой нагрузки и стратегиями ротации
 - Подробное логирование
 - Строгая типизация с помощью аннотаций типов
 - Класс-конфигурация для централизованной настройки и повторного использования
@@ -28,33 +28,13 @@ Requires-Dist: uv-publish
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
-```
-
-## Структура проекта
-
-```
-gengine_client/
-├── __init__.py            # Экспорт основных классов
-├── client.py              # Основной класс клиента
-├── http.py                # HTTP клиент с поддержкой аутентификации
-├── exceptions.py          # Иерархия исключений API
-├── config.py              # Класс-конфигурация для настройки параметров
-└── modules/               # Папка с модулями API
-    ├── __init__.py
-    ├── base.py            # Базовый класс для всех модулей
-    ├── payments.py        # Модуль для работы с платежами
-    ├── finances.py        # Модуль для работы с финансами
-    ├── auth.py            # Модуль для аутентификации
-    ├── users.py           # Модуль для работы с пользователями
-    ├── transactions.py    # Модуль для работы с транзакциями
-    └── currencies.py      # Модуль для работы с валютами
+pip install aiohttp-socks
 ```
 
 ## Использование
@@ -63,7 +43,7 @@ gengine_client/
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -84,7 +64,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -119,7 +99,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -149,7 +129,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from gengine_client import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -188,32 +168,52 @@ async def main():
 asyncio.run(main())
 ```
 
-### Загрузка конфигурации из переменных окружения
+### Использование фермы клиентов
+
+Ферма клиентов позволяет управлять множеством клиентов с разными конфигурациями и стратегиями ротации:
 
 ```python
 import asyncio
-import os
-from gengine_client import GEngineConfig
-
-# Установка переменных окружения
-os.environ["GENGINE_BASE_URL"] = "https://api.example.com/api/v2"
-os.environ["GENGINE_TOKEN"] = "env_jwt_token"
-os.environ["GENGINE_TIMEOUT"] = "45"
-os.environ["GENGINE_MAX_RETRIES"] = "5"
-os.environ["GENGINE_PROXY"] = "socks5://127.0.0.1:9050"  # Опционально - прокси
+from gengineapi import ClientFarm
 
 async def main():
-    # Загрузка настроек из переменных окружения
-    GEngineConfig.load_from_env()
+    # Создаем ферму клиентов
+    farm = ClientFarm()
     
-    # Получение клиента с настройками из переменных окружения
-    client = await GEngineConfig.get_client()
+    # Добавляем несколько конфигураций с разными прокси
+    farm.create_config(
+        name="client1",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token1",
+        proxy="socks5://user1:pass1@host1:port1",
+        tags=["group1", "production"]
+    )
     
-    # Использование клиента
-    # ...
+    farm.create_config(
+        name="client2",
+        base_url="https://api.example.com/api/v2",
+        jwt_token="token2",
+        proxy="socks5://user2:pass2@host2:port2",
+        tags=["group1", "backup"]
+    )
     
-    # При завершении приложения
-    await GEngineConfig.reset()
+    # Устанавливаем стратегию выбора клиента
+    farm.set_selection_strategy("round_robin")  # или "random", "least_errors", "least_recently_used"
+    
+    # Получаем клиент по имени
+    client1 = await farm.get_client("client1")
+    await client1.users.get_me()
+    
+    # Получаем следующий клиент согласно стратегии
+    client = await farm.get_next_client()
+    await client.currencies.get_rate(source="cb_rf", pair="USD:RUB")
+    
+    # Получаем клиент по тегу
+    client = await farm.get_next_client(tag="production")
+    await client.transactions.get_transactions(limit=5)
+    
+    # При завершении работы закрываем все клиенты
+    await farm.close_all()
 
 asyncio.run(main())
 ```
@@ -224,7 +224,7 @@ asyncio.run(main())
 import asyncio
 import uuid
 from decimal import Decimal
-from gengine_client import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     async with GEngineClient(
@@ -255,19 +255,25 @@ async def main():
 asyncio.run(main())
 ```
 
-## Примеры
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
 
-В репозитории есть примеры использования клиента с разными сценариями:
+## Дополнительная документация
 
-- `examples.py` - полный набор примеров использования, включая работу с прокси
-- `old_examples/` - директория с устаревшими примерами
+Ручки, которые дергаем - https://b2b-api.ggsel.com/api/v2/docs#
 
 ## Зависимости
 
 - Python 3.7+
 - aiohttp >= 3.8.0
 - typing-extensions >= 4.0.0
-- aiohttp-socks >= 0.7.1 (для поддержки SOCKS5 прокси)
+- aiohttp-socks >= 0.7.1 (опционально, для поддержки SOCKS5 прокси)
 
 ## Лицензия
 

{gengineapi-0.1.0 → gengineapi-0.2.1}/src/gengineapi.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ src/gengineapi/__init__.py
 src/gengineapi/client.py
 src/gengineapi/config.py
 src/gengineapi/exceptions.py
+src/gengineapi/farm.py
 src/gengineapi/http.py
 src/gengineapi.egg-info/PKG-INFO
 src/gengineapi.egg-info/SOURCES.txt

{gengineapi-0.1.0 → gengineapi-0.2.1}/src/gengineapi.egg-info/requires.txt

@@ -1,4 +1,3 @@
 aiohttp>=3.8.0
 typing-extensions>=4.0.0
 aiohttp-socks>=0.7.1
-uv-publish