starkerak 0.1.0__tar.gz

starkerak-0.1.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: starkerak
+Version: 0.1.0
+Summary: StarKerak To'lov Monitoring API va Websocket Client
+Author: StarKerak Jamoasi
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

starkerak-0.1.0/README.md

@@ -0,0 +1,66 @@
+# 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
+
+# WebApp dagi "Sozlamalar" bo'limidan olingan API kalitni kiriting
+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.

starkerak-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

starkerak-0.1.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="starkerak",
+    version="0.1.0",
+    description="StarKerak To'lov Monitoring API va Websocket Client",
+    author="StarKerak Jamoasi",
+    packages=find_packages(),
+    py_modules=["starkerak"],
+    install_requires=[
+        "aiohttp>=3.8.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3.9",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.8',
+)

starkerak-0.1.0/starkerak.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: starkerak
+Version: 0.1.0
+Summary: StarKerak To'lov Monitoring API va Websocket Client
+Author: StarKerak Jamoasi
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

starkerak-0.1.0/starkerak.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+starkerak.py
+starkerak.egg-info/PKG-INFO
+starkerak.egg-info/SOURCES.txt
+starkerak.egg-info/dependency_links.txt
+starkerak.egg-info/requires.txt
+starkerak.egg-info/top_level.txt

starkerak-0.1.0/starkerak.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

starkerak-0.1.0/starkerak.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.8.0

starkerak-0.1.0/starkerak.egg-info/top_level.txt

@@ -0,0 +1 @@
+starkerak

starkerak-0.1.0/starkerak.py

@@ -0,0 +1,72 @@
+import asyncio
+import json
+import logging
+import aiohttp
+
+class StarKerakClient:
+    def __init__(self, api_key: str, wss_url: str = "wss://writing-corporations-nation-flow.trycloudflare.com/api/ws/payments"):
+        """
+        StarKerak Python Client
+        :param api_key: WebApp dagi 'Sozlamalar' bo'limidan olingan API Kalit
+        :param wss_url: Websocket server manzili (agar o'zgarsa)
+        """
+        self.api_key = api_key
+        self.wss_url = wss_url
+        self._on_payment_handler = None
+        self._running = False
+        self.logger = logging.getLogger("StarKerakClient")
+        
+        if not self.logger.handlers:
+            logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(name)s - %(message)s")
+
+    def on_payment(self, func):
+        """
+        Yangi to'lov tushganda ishga tushadigan funksiya (Decorator).
+        """
+        self._on_payment_handler = func
+        return func
+
+    async def _listen_loop(self):
+        """Websocket orqali serverga ulanish va kutish logikasi."""
+        url_with_auth = f"{self.wss_url}?api_key={self.api_key}"
+        
+        while self._running:
+            try:
+                self.logger.info("StarKerak serveriga ulanilmoqda...")
+                async with aiohttp.ClientSession() as session:
+                    async with session.ws_connect(url_with_auth, heartbeat=30.0) as ws:
+                        self.logger.info("✅ Muvaffaqiyatli ulandi! To'lovlarni kutmoqda...")
+                        
+                        async for msg in ws:
+                            if msg.type == aiohttp.WSMsgType.TEXT:
+                                data = json.loads(msg.data)
+                                if self._on_payment_handler:
+                                    # Handler asinxron bo'lsa kutamiz, sinxron bo'lsa to'g'ridan to'g'ri chaqiramiz
+                                    if asyncio.iscoroutinefunction(self._on_payment_handler):
+                                        await self._on_payment_handler(data)
+                                    else:
+                                        self._on_payment_handler(data)
+                            elif msg.type == aiohttp.WSMsgType.ERROR:
+                                self.logger.error(f"WebSocket xatosi: {ws.exception()}")
+                                break
+            except Exception as e:
+                self.logger.warning(f"Aloqa uzildi yoki ulanib bo'lmadi: {e}. 3 soniyadan so'ng qayta urinish...")
+                await asyncio.sleep(3)
+
+    def start_listening(self):
+        """
+        Dasturni ishga tushirish (Sinxron kodlar uchun, asosan oddiy scriptlar uchun).
+        """
+        self._running = True
+        try:
+            asyncio.run(self._listen_loop())
+        except KeyboardInterrupt:
+            self.logger.info("Dastur to'xtatildi.")
+            self._running = False
+
+    async def start_listening_async(self):
+        """
+        Dasturni ishga tushirish (Asinxron kodlar / Aiogram botlar bilan birga ishlatish uchun).
+        """
+        self._running = True
+        await self._listen_loop()