gengineapi 0.2.0__tar.gz → 0.2.2__tar.gz

{gengineapi-0.2.0 → gengineapi-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gengineapi
-Version: 0.2.0
+Version: 0.2.2
 Summary: G-Engine API Client
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
@@ -8,7 +8,7 @@ Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: aiohttp-socks>=0.7.1
 
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -28,44 +28,63 @@ Requires-Dist: aiohttp-socks>=0.7.1
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
+pip install aiohttp-socks
 ```
 
-## Структура проекта
+## Использование
 
-```
-src/
-└── gengineapi/
-    ├── __init__.py         # Экспорт основных классов
-    ├── client.py           # Основной класс клиента
-    ├── http.py             # HTTP клиент с поддержкой аутентификации
-    ├── exceptions.py       # Иерархия исключений API
-    ├── config.py           # Класс-конфигурация для настройки параметров
-    ├── farm.py             # Ферма клиентов для управления множеством клиентов
-    └── modules/            # Папка с модулями API
-        ├── __init__.py
-        ├── base.py         # Базовый класс для всех модулей
-        ├── payments.py     # Модуль для работы с платежами
-        ├── finances.py     # Модуль для работы с финансами
-        ├── auth.py         # Модуль для аутентификации
-        ├── users.py        # Модуль для работы с пользователями
-        ├── transactions.py # Модуль для работы с транзакциями
-        └── currencies.py   # Модуль для работы с валютами
-```
+### Быстрый старт
 
-## Использование
+```python
+import os
+import asyncio
+import logging
+from gengineapi import ClientFarm
+from dotenv import load_dotenv
+
+load_dotenv()
+
+GTOKEN = os.getenv("GTOKEN")
+
+# Настройка логирования
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger("gengine")
 
+gfarm = ClientFarm(logger=logger)
+
+gfarm.create_config(name="base",
+        base_url="https://b2b-api.ggsel.com/api/v2",
+        jwt_token=GTOKEN,
+        timeout=60,
+        max_retries=5,
+        proxy="socks5://username:password@host:port") # Прокси опциональные
+
+async def main():
+    client = await gfarm.get_client("base")
+
+    async with client:
+        me = await client.users.get_me()
+
+        logger.info(me)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
 ### Инициализация с существующим токеном
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -86,7 +105,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -121,7 +140,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -151,7 +170,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -196,7 +215,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+from gengineapi import ClientFarm
 
 async def main():
     # Создаем ферму клиентов
@@ -240,41 +259,62 @@ async def main():
 asyncio.run(main())
 ```
 
-### Экспорт и импорт конфигураций фермы
+### Работа с платежами
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+import uuid
+from decimal import Decimal
+from gengineapi import GEngineClient
 
 async def main():
-    # Создаем и настраиваем ферму
-    farm = ClientFarm()
-    
-    # Добавляем конфигурации
-    farm.create_config(name="client1", base_url="...", jwt_token="...", proxy="...")
-    farm.create_config(name="client2", base_url="...", jwt_token="...", proxy="...")
-    
-    # Экспортируем конфигурации в файл
-    await farm.export_configs("farm_config.json")
-    
-    # Импортируем конфигурации из файла
-    new_farm = await ClientFarm.import_configs("farm_config.json")
-    
-    # Используем импортированные конфигурации
-    client = await new_farm.get_next_client()
-    
-    # При завершении работы закрываем все клиенты
-    await new_farm.close_all()
+    async with GEngineClient(
+        base_url="https://api.example.com/api/v2",
+        jwt_token="your-jwt-token"
+    ) as client:
+        # Генерируем уникальный идентификатор транзакции
+        transaction_id = str(uuid.uuid4())
+        
+        # Создаем и верифицируем платеж
+        payment = await client.payments.verify(
+            transaction_id=transaction_id,
+            service_id=1,
+            account="user123",
+            amount=Decimal("10.99"),
+            currency="USD"
+        )
+        print(f"Создан платеж: {payment['transaction_id']}")
+        
+        # Выполняем платеж
+        result = await client.payments.execute(transaction_id=transaction_id)
+        print(f"Статус платежа: {result['status_code']}")
+        
+        # Получаем статус платежа
+        status = await client.payments.get_status(transaction_id=transaction_id)
+        print(f"Текущий статус платежа: {status['status_code']}")
 
 asyncio.run(main())
 ```
 
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
+
+## Дополнительная документация
+
+Ручки, которые дергаем - 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.2.0 → gengineapi-0.2.2}/README.md

@@ -1,4 +1,4 @@
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -18,44 +18,63 @@
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
+pip install aiohttp-socks
 ```
 
-## Структура проекта
+## Использование
 
-```
-src/
-└── gengineapi/
-    ├── __init__.py         # Экспорт основных классов
-    ├── client.py           # Основной класс клиента
-    ├── http.py             # HTTP клиент с поддержкой аутентификации
-    ├── exceptions.py       # Иерархия исключений API
-    ├── config.py           # Класс-конфигурация для настройки параметров
-    ├── farm.py             # Ферма клиентов для управления множеством клиентов
-    └── modules/            # Папка с модулями API
-        ├── __init__.py
-        ├── base.py         # Базовый класс для всех модулей
-        ├── payments.py     # Модуль для работы с платежами
-        ├── finances.py     # Модуль для работы с финансами
-        ├── auth.py         # Модуль для аутентификации
-        ├── users.py        # Модуль для работы с пользователями
-        ├── transactions.py # Модуль для работы с транзакциями
-        └── currencies.py   # Модуль для работы с валютами
-```
+### Быстрый старт
 
-## Использование
+```python
+import os
+import asyncio
+import logging
+from gengineapi import ClientFarm
+from dotenv import load_dotenv
+
+load_dotenv()
+
+GTOKEN = os.getenv("GTOKEN")
+
+# Настройка логирования
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger("gengine")
 
+gfarm = ClientFarm(logger=logger)
+
+gfarm.create_config(name="base",
+        base_url="https://b2b-api.ggsel.com/api/v2",
+        jwt_token=GTOKEN,
+        timeout=60,
+        max_retries=5,
+        proxy="socks5://username:password@host:port") # Прокси опциональные
+
+async def main():
+    client = await gfarm.get_client("base")
+
+    async with client:
+        me = await client.users.get_me()
+
+        logger.info(me)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
 ### Инициализация с существующим токеном
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -76,7 +95,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -111,7 +130,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -141,7 +160,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -186,7 +205,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+from gengineapi import ClientFarm
 
 async def main():
     # Создаем ферму клиентов
@@ -230,41 +249,62 @@ async def main():
 asyncio.run(main())
 ```
 
-### Экспорт и импорт конфигураций фермы
+### Работа с платежами
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+import uuid
+from decimal import Decimal
+from gengineapi import GEngineClient
 
 async def main():
-    # Создаем и настраиваем ферму
-    farm = ClientFarm()
-    
-    # Добавляем конфигурации
-    farm.create_config(name="client1", base_url="...", jwt_token="...", proxy="...")
-    farm.create_config(name="client2", base_url="...", jwt_token="...", proxy="...")
-    
-    # Экспортируем конфигурации в файл
-    await farm.export_configs("farm_config.json")
-    
-    # Импортируем конфигурации из файла
-    new_farm = await ClientFarm.import_configs("farm_config.json")
-    
-    # Используем импортированные конфигурации
-    client = await new_farm.get_next_client()
-    
-    # При завершении работы закрываем все клиенты
-    await new_farm.close_all()
+    async with GEngineClient(
+        base_url="https://api.example.com/api/v2",
+        jwt_token="your-jwt-token"
+    ) as client:
+        # Генерируем уникальный идентификатор транзакции
+        transaction_id = str(uuid.uuid4())
+        
+        # Создаем и верифицируем платеж
+        payment = await client.payments.verify(
+            transaction_id=transaction_id,
+            service_id=1,
+            account="user123",
+            amount=Decimal("10.99"),
+            currency="USD"
+        )
+        print(f"Создан платеж: {payment['transaction_id']}")
+        
+        # Выполняем платеж
+        result = await client.payments.execute(transaction_id=transaction_id)
+        print(f"Статус платежа: {result['status_code']}")
+        
+        # Получаем статус платежа
+        status = await client.payments.get_status(transaction_id=transaction_id)
+        print(f"Текущий статус платежа: {status['status_code']}")
 
 asyncio.run(main())
 ```
 
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
+
+## Дополнительная документация
+
+Ручки, которые дергаем - 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.2.0 → gengineapi-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gengineapi"
-version = "0.2.0"
+version = "0.2.2"
 description = "G-Engine API Client"
 readme = "README.md"
 requires-python = ">=3.13"

{gengineapi-0.2.0 → gengineapi-0.2.2}/src/gengineapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gengineapi
-Version: 0.2.0
+Version: 0.2.2
 Summary: G-Engine API Client
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
@@ -8,7 +8,7 @@ Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: aiohttp-socks>=0.7.1
 
-# G-Engine API Client
+# GEngineAPI
 
 Асинхронный модульный клиент для взаимодействия с API G-Engine.
 
@@ -28,44 +28,63 @@ Requires-Dist: aiohttp-socks>=0.7.1
 ## Установка
 
 ```bash
-pip install -r requirements.txt
+pip install gengineapi
 ```
 
-Или с помощью setup.py:
+Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
 
 ```bash
-pip install .
+pip install aiohttp-socks
 ```
 
-## Структура проекта
+## Использование
 
-```
-src/
-└── gengineapi/
-    ├── __init__.py         # Экспорт основных классов
-    ├── client.py           # Основной класс клиента
-    ├── http.py             # HTTP клиент с поддержкой аутентификации
-    ├── exceptions.py       # Иерархия исключений API
-    ├── config.py           # Класс-конфигурация для настройки параметров
-    ├── farm.py             # Ферма клиентов для управления множеством клиентов
-    └── modules/            # Папка с модулями API
-        ├── __init__.py
-        ├── base.py         # Базовый класс для всех модулей
-        ├── payments.py     # Модуль для работы с платежами
-        ├── finances.py     # Модуль для работы с финансами
-        ├── auth.py         # Модуль для аутентификации
-        ├── users.py        # Модуль для работы с пользователями
-        ├── transactions.py # Модуль для работы с транзакциями
-        └── currencies.py   # Модуль для работы с валютами
-```
+### Быстрый старт
 
-## Использование
+```python
+import os
+import asyncio
+import logging
+from gengineapi import ClientFarm
+from dotenv import load_dotenv
+
+load_dotenv()
+
+GTOKEN = os.getenv("GTOKEN")
+
+# Настройка логирования
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger("gengine")
 
+gfarm = ClientFarm(logger=logger)
+
+gfarm.create_config(name="base",
+        base_url="https://b2b-api.ggsel.com/api/v2",
+        jwt_token=GTOKEN,
+        timeout=60,
+        max_retries=5,
+        proxy="socks5://username:password@host:port") # Прокси опциональные
+
+async def main():
+    client = await gfarm.get_client("base")
+
+    async with client:
+        me = await client.users.get_me()
+
+        logger.info(me)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
 ### Инициализация с существующим токеном
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с существующим токеном
@@ -86,7 +105,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент без токена
@@ -121,7 +140,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineClient
+from gengineapi import GEngineClient
 
 async def main():
     # Создаем клиент с использованием SOCKS5 прокси
@@ -151,7 +170,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import GEngineConfig
+from gengineapi import GEngineConfig
 
 async def main():
     # Настройка параметров клиента
@@ -196,7 +215,7 @@ asyncio.run(main())
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+from gengineapi import ClientFarm
 
 async def main():
     # Создаем ферму клиентов
@@ -240,41 +259,62 @@ async def main():
 asyncio.run(main())
 ```
 
-### Экспорт и импорт конфигураций фермы
+### Работа с платежами
 
 ```python
 import asyncio
-from src.gengineapi import ClientFarm
+import uuid
+from decimal import Decimal
+from gengineapi import GEngineClient
 
 async def main():
-    # Создаем и настраиваем ферму
-    farm = ClientFarm()
-    
-    # Добавляем конфигурации
-    farm.create_config(name="client1", base_url="...", jwt_token="...", proxy="...")
-    farm.create_config(name="client2", base_url="...", jwt_token="...", proxy="...")
-    
-    # Экспортируем конфигурации в файл
-    await farm.export_configs("farm_config.json")
-    
-    # Импортируем конфигурации из файла
-    new_farm = await ClientFarm.import_configs("farm_config.json")
-    
-    # Используем импортированные конфигурации
-    client = await new_farm.get_next_client()
-    
-    # При завершении работы закрываем все клиенты
-    await new_farm.close_all()
+    async with GEngineClient(
+        base_url="https://api.example.com/api/v2",
+        jwt_token="your-jwt-token"
+    ) as client:
+        # Генерируем уникальный идентификатор транзакции
+        transaction_id = str(uuid.uuid4())
+        
+        # Создаем и верифицируем платеж
+        payment = await client.payments.verify(
+            transaction_id=transaction_id,
+            service_id=1,
+            account="user123",
+            amount=Decimal("10.99"),
+            currency="USD"
+        )
+        print(f"Создан платеж: {payment['transaction_id']}")
+        
+        # Выполняем платеж
+        result = await client.payments.execute(transaction_id=transaction_id)
+        print(f"Статус платежа: {result['status_code']}")
+        
+        # Получаем статус платежа
+        status = await client.payments.get_status(transaction_id=transaction_id)
+        print(f"Текущий статус платежа: {status['status_code']}")
 
 asyncio.run(main())
 ```
 
+## Доступные модули API
+
+- `payments` - создание и выполнение платежей
+- `finances` - работа с финансовыми данными
+- `auth` - аутентификация и управление токенами
+- `users` - работа с пользователями и их балансами
+- `transactions` - работа с транзакциями
+- `currencies` - работа с курсами валют
+
+## Дополнительная документация
+
+Ручки, которые дергаем - 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 прокси)
 
 ## Лицензия