Metadata-Version: 2.4
Name: starkerak
Version: 0.2.1
Summary: StarKerak To'lov Monitoring API va Websocket Client
Author: StarKerak Jamoasi
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.8.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# StarKerak Python SDK

StarKerak xizmatining rasmiy Python kutubxonasi. Bu kutubxona orqali siz o'zingizning domensiz (VPS) ishlayotgan Python botlaringizga to'lov ma'lumotlarini (Telegramdan tushgan SMS cheklarni) Real-Time (Websocket) yordamida qabul qila olasiz.

## O'rnatish

Kutubxonani loyihangizga qo'shish uchun quyidagi buyruqni ishlating:
```bash
pip install starkerak
```

## Foydalanish (Sinxron oddiy usul)
Kodni alohida script tarzida yurgizish uchun:

```python
from starkerak import StarKerakClient

# API kalitni @CardHelpUzRoBot ga kirib, WebApp "Sozlamalar" bo'limidan olasiz
client = StarKerakClient("API_KALITINGIZ_SHU_YERDA")

@client.on_payment
def tolov_kelganda(payment):
    # To'lov ma'lumotlari JSON shaklida keladi
    print(f"🎉 Pul tushdi! {payment['amount']} UZS")
    print(f"Karta: {payment['card_last4']}")
    # Bu yerda foydalanuvchiga VIP maqomini berish yoki xizmatni yoqish kodingizni yozing

# Kutishni boshlash (bu kod scriptni kutish rejimiga o'tkazadi)
client.start_listening()
```

## Foydalanish (Asinxron - Aiogram bot bilan)
Agar sizda Aiogram bot bo'lsa va bot bilan birga parallel ishlashini xohlasangiz:

```python
import asyncio
from aiogram import Bot, Dispatcher
from starkerak import StarKerakClient

bot = Bot(token="Sizning_Bot_Tokeningiz")
dp = Dispatcher()

# StarKerak ulanishi
sk_client = StarKerakClient("API_KALITINGIZ_SHU_YERDA")

@sk_client.on_payment
async def tolov_kelganda(payment):
    print("Pul tushdi!", payment)
    # Masalan foydalanuvchiga xabar yuborish:
    # await bot.send_message(foydalanuvchi_id, f"Sizdan {payment['amount']} UZS to'lov olinib, VIP yoqildi!")

async def main():
    # Ham botni, ham StarKerakni parallel ishga tushirish
    await asyncio.gather(
        dp.start_polling(bot),
        sk_client.start_listening_async()
    )

if __name__ == "__main__":
    asyncio.run(main())
```

## Afzalliklari
- **0.1 soniyada** kelib tushadi (Websocket texnologiyasi asosida)
- Hech qanday Domen, Hosting yoki HTTPS SSL sertifikatlarni talab qilmaydi
- Serveringizga ortiqcha bosim tushmaydi.
