gengineapi 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gengineapi
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: G-Engine API Client
5
5
  Requires-Python: >=3.13
6
6
  Description-Content-Type: text/markdown
@@ -8,7 +8,7 @@ Requires-Dist: aiohttp>=3.8.0
8
8
  Requires-Dist: typing-extensions>=4.0.0
9
9
  Requires-Dist: aiohttp-socks>=0.7.1
10
10
 
11
- # G-Engine API Client
11
+ # GEngineAPI
12
12
 
13
13
  Асинхронный модульный клиент для взаимодействия с API G-Engine.
14
14
 
@@ -28,35 +28,13 @@ Requires-Dist: aiohttp-socks>=0.7.1
28
28
  ## Установка
29
29
 
30
30
  ```bash
31
- pip install -r requirements.txt
31
+ pip install gengineapi
32
32
  ```
33
33
 
34
- Или с помощью setup.py:
34
+ Для поддержки SOCKS5 прокси убедитесь, что установлен пакет `aiohttp-socks`:
35
35
 
36
36
  ```bash
37
- pip install .
38
- ```
39
-
40
- ## Структура проекта
41
-
42
- ```
43
- src/
44
- └── gengineapi/
45
- ├── __init__.py # Экспорт основных классов
46
- ├── client.py # Основной класс клиента
47
- ├── http.py # HTTP клиент с поддержкой аутентификации
48
- ├── exceptions.py # Иерархия исключений API
49
- ├── config.py # Класс-конфигурация для настройки параметров
50
- ├── farm.py # Ферма клиентов для управления множеством клиентов
51
- └── modules/ # Папка с модулями API
52
- ├── __init__.py
53
- ├── base.py # Базовый класс для всех модулей
54
- ├── payments.py # Модуль для работы с платежами
55
- ├── finances.py # Модуль для работы с финансами
56
- ├── auth.py # Модуль для аутентификации
57
- ├── users.py # Модуль для работы с пользователями
58
- ├── transactions.py # Модуль для работы с транзакциями
59
- └── currencies.py # Модуль для работы с валютами
37
+ pip install aiohttp-socks
60
38
  ```
61
39
 
62
40
  ## Использование
@@ -65,7 +43,7 @@ src/
65
43
 
66
44
  ```python
67
45
  import asyncio
68
- from src.gengineapi import GEngineClient
46
+ from gengineapi import GEngineClient
69
47
 
70
48
  async def main():
71
49
  # Создаем клиент с существующим токеном
@@ -86,7 +64,7 @@ asyncio.run(main())
86
64
 
87
65
  ```python
88
66
  import asyncio
89
- from src.gengineapi import GEngineClient
67
+ from gengineapi import GEngineClient
90
68
 
91
69
  async def main():
92
70
  # Создаем клиент без токена
@@ -121,7 +99,7 @@ asyncio.run(main())
121
99
 
122
100
  ```python
123
101
  import asyncio
124
- from src.gengineapi import GEngineClient
102
+ from gengineapi import GEngineClient
125
103
 
126
104
  async def main():
127
105
  # Создаем клиент с использованием SOCKS5 прокси
@@ -151,7 +129,7 @@ asyncio.run(main())
151
129
 
152
130
  ```python
153
131
  import asyncio
154
- from src.gengineapi import GEngineConfig
132
+ from gengineapi import GEngineConfig
155
133
 
156
134
  async def main():
157
135
  # Настройка параметров клиента
@@ -196,7 +174,7 @@ asyncio.run(main())
196
174
 
197
175
  ```python
198
176
  import asyncio
199
- from src.gengineapi import ClientFarm
177
+ from gengineapi import ClientFarm
200
178
 
201
179
  async def main():
202
180
  # Создаем ферму клиентов
@@ -240,41 +218,62 @@ async def main():
240
218
  asyncio.run(main())
241
219
  ```
242
220
 
243
- ### Экспорт и импорт конфигураций фермы
221
+ ### Работа с платежами
244
222
 
245
223
  ```python
246
224
  import asyncio
247
- from src.gengineapi import ClientFarm
225
+ import uuid
226
+ from decimal import Decimal
227
+ from gengineapi import GEngineClient
248
228
 
249
229
  async def main():
250
- # Создаем и настраиваем ферму
251
- farm = ClientFarm()
252
-
253
- # Добавляем конфигурации
254
- farm.create_config(name="client1", base_url="...", jwt_token="...", proxy="...")
255
- farm.create_config(name="client2", base_url="...", jwt_token="...", proxy="...")
256
-
257
- # Экспортируем конфигурации в файл
258
- await farm.export_configs("farm_config.json")
259
-
260
- # Импортируем конфигурации из файла
261
- new_farm = await ClientFarm.import_configs("farm_config.json")
262
-
263
- # Используем импортированные конфигурации
264
- client = await new_farm.get_next_client()
265
-
266
- # При завершении работы закрываем все клиенты
267
- await new_farm.close_all()
230
+ async with GEngineClient(
231
+ base_url="https://api.example.com/api/v2",
232
+ jwt_token="your-jwt-token"
233
+ ) as client:
234
+ # Генерируем уникальный идентификатор транзакции
235
+ transaction_id = str(uuid.uuid4())
236
+
237
+ # Создаем и верифицируем платеж
238
+ payment = await client.payments.verify(
239
+ transaction_id=transaction_id,
240
+ service_id=1,
241
+ account="user123",
242
+ amount=Decimal("10.99"),
243
+ currency="USD"
244
+ )
245
+ print(f"Создан платеж: {payment['transaction_id']}")
246
+
247
+ # Выполняем платеж
248
+ result = await client.payments.execute(transaction_id=transaction_id)
249
+ print(f"Статус платежа: {result['status_code']}")
250
+
251
+ # Получаем статус платежа
252
+ status = await client.payments.get_status(transaction_id=transaction_id)
253
+ print(f"Текущий статус платежа: {status['status_code']}")
268
254
 
269
255
  asyncio.run(main())
270
256
  ```
271
257
 
258
+ ## Доступные модули API
259
+
260
+ - `payments` - создание и выполнение платежей
261
+ - `finances` - работа с финансовыми данными
262
+ - `auth` - аутентификация и управление токенами
263
+ - `users` - работа с пользователями и их балансами
264
+ - `transactions` - работа с транзакциями
265
+ - `currencies` - работа с курсами валют
266
+
267
+ ## Дополнительная документация
268
+
269
+ Ручки, которые дергаем - https://b2b-api.ggsel.com/api/v2/docs#
270
+
272
271
  ## Зависимости
273
272
 
274
273
  - Python 3.7+
275
274
  - aiohttp >= 3.8.0
276
275
  - typing-extensions >= 4.0.0
277
- - aiohttp-socks >= 0.7.1 (для поддержки SOCKS5 прокси)
276
+ - aiohttp-socks >= 0.7.1 (опционально, для поддержки SOCKS5 прокси)
278
277
 
279
278
  ## Лицензия
280
279
 
@@ -12,7 +12,7 @@ gengineapi/modules/finances.py,sha256=fwOWo1LI56ZC3qlTG-tv_cqbI7RyCPYQSNOT5r6VzT
12
12
  gengineapi/modules/payments.py,sha256=dwOqQcwsq256OQKzXJUn8a0H6krsf3Rb73KdAaRcEnw,4634
13
13
  gengineapi/modules/transactions.py,sha256=QUtTxzTFsLesqog9Da6H-pdq5DP0sgh9w2cIlZQiKCk,2932
14
14
  gengineapi/modules/users.py,sha256=WQyI37MVBAzqDE3i1LPpV2G5g_1cGvQh0vLomTF4vkI,4291
15
- gengineapi-0.2.0.dist-info/METADATA,sha256=ITliNO5hqOBbTEQW276ie5GcMBfQWFzqjSGzpprW5l8,10732
16
- gengineapi-0.2.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
17
- gengineapi-0.2.0.dist-info/top_level.txt,sha256=mYdcVWOxFzj4EzoczGzeT-ccVrNEjNI98w2JW51wnfk,11
18
- gengineapi-0.2.0.dist-info/RECORD,,
15
+ gengineapi-0.2.1.dist-info/METADATA,sha256=71x8AJT5gNd2w6ULVBR_APLwpBiYpKFMAkqVdW_5xoc,10261
16
+ gengineapi-0.2.1.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
17
+ gengineapi-0.2.1.dist-info/top_level.txt,sha256=mYdcVWOxFzj4EzoczGzeT-ccVrNEjNI98w2JW51wnfk,11
18
+ gengineapi-0.2.1.dist-info/RECORD,,