kickzero 1.3.1__tar.gz

kickzero-1.3.1/MANIFEST.in

@@ -0,0 +1,36 @@
+# --- ANA DOSYALAR ---
+include LICENSE
+include README.md
+include MANIFEST.in
+
+# --- ÖRNEKLER ---
+# Kullanıcıların botu nasıl kuracağını öğrenmesi için şart
+recursive-include examples *.py
+
+# --- ANA MOTOR ---
+# Framework'ün kalbi (__init__.py) burada, kesinlikle dahil
+recursive-include kickzero *.py
+
+# --- 🚫 DIŞLANANLAR (SAKIN ALMA!) ---
+# 1. Özel Doğrulama Verileri (İsteğin üzerine çıkarıldı ⚓)
+exclude verification.json
+exclude verified.md
+
+# 2. Test Sahası
+# Dağınık notlar ve test dosyaları dışarıda
+recursive-exclude test *
+recursive-exclude * test_*.py
+
+# 3. Kişisel Notlar ve Anahtarlar
+exclude pip.key
+exclude Zoro.todoo
+
+# 4. Sistem Çöpleri
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]
+recursive-exclude * *$py.class
+
+# --- 🛡️ GİZLİLİK KALKANI ---
+# Tarayıcı oturumları ve gizli ayarlar asla sızmamalı
+recursive-exclude kick_session *
+recursive-exclude .env *

kickzero-1.3.1/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: kickzero
+Version: 1.3.1
+Summary: A modular and asynchronous framework for Kick.com chatbots.
+Home-page: https://github.com/SeymenSozen/KickZero
+Author: Seymen Sözen
+Project-URL: Bug Tracker, https://github.com/SeymenSozen/KickZero/issues
+Project-URL: Documentation, https://github.com/SeymenSozen/KickZero#readme
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp
+Requires-Dist: websockets
+Requires-Dist: colorama
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🏴‍☠️ KickZero Framework (v1.3.1)
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-Proprietary-red)
+![Maintainer](https://img.shields.io/badge/maintainer-Seymen%20S%C3%B6zen-orange)
+
+**KickZero**, Kick.com platformu için geliştirilmiş, modüler ve tamamen asenkron bir chatbot framework'üdür. Geliştiricilere karmaşık WebSocket trafiğiyle uğraşmadan, hızlı ve güçlü botlar üretme imkanı sağlar.
+
+---
+
+## 🚀 Özellikler / Features
+
+- **Asynchronous Engine:** `asyncio` ve `aiohttp` tabanlı, donma yapmayan hızlı yapı.
+- **Multi-Channel Support:** Aynı anda birden fazla kanalı tek bir botla yönetme.
+- **Easy Decoration:** `@bot.command`, `@bot.message` ve `@bot.timer_task` dekoratörleri ile kolay geliştirme.
+- **Smart Context:** Mesajın yetki, renk ve içerik bilgilerine tek noktadan (`ctx`) erişim.
+- **Reward Integration:** Kanal puanı (Reward) kullanımlarını anında yakalama.
+
+---
+
+## 📦 Kurulum / Installation
+
+Terminalinize şu komutu yazarak okyanusa açılabilirsiniz:
+
+```bash
+pip install kickzero

kickzero-1.3.1/README.md

@@ -0,0 +1,26 @@
+# 🏴‍☠️ KickZero Framework (v1.3.1)
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-Proprietary-red)
+![Maintainer](https://img.shields.io/badge/maintainer-Seymen%20S%C3%B6zen-orange)
+
+**KickZero**, Kick.com platformu için geliştirilmiş, modüler ve tamamen asenkron bir chatbot framework'üdür. Geliştiricilere karmaşık WebSocket trafiğiyle uğraşmadan, hızlı ve güçlü botlar üretme imkanı sağlar.
+
+---
+
+## 🚀 Özellikler / Features
+
+- **Asynchronous Engine:** `asyncio` ve `aiohttp` tabanlı, donma yapmayan hızlı yapı.
+- **Multi-Channel Support:** Aynı anda birden fazla kanalı tek bir botla yönetme.
+- **Easy Decoration:** `@bot.command`, `@bot.message` ve `@bot.timer_task` dekoratörleri ile kolay geliştirme.
+- **Smart Context:** Mesajın yetki, renk ve içerik bilgilerine tek noktadan (`ctx`) erişim.
+- **Reward Integration:** Kanal puanı (Reward) kullanımlarını anında yakalama.
+
+---
+
+## 📦 Kurulum / Installation
+
+Terminalinize şu komutu yazarak okyanusa açılabilirsiniz:
+
+```bash
+pip install kickzero

kickzero-1.3.1/examples/advenced_bot.py

@@ -0,0 +1,78 @@
+import asyncio
+import random
+from kickzero import kickbot, message_context, points_context
+
+# --- ⚓ AMİRAL GEMİSİ AYARLARI ---
+Zoro = kickbot(
+    user_name="BOT_NAME",
+    bearer_token="TOKEN_BURAYA",
+    app_key='APP_KEY_BURAYA',
+    prefix="!",
+    framework_lang="tr" # Hata ve loglar Türkçe gelsin
+)
+
+# --- 📡 ÇOKLU KANAL DESTEĞİ ---
+# Botu aynı anda birden fazla gemiye (kanala) radar olarak ekleyebilirsin
+Zoro.add_channel(name="ana_kanal", channel_id="111111", chat_id="222222")
+Zoro.add_channel(name="ikinci_kanal", channel_id="333333", chat_id="444444")
+
+# --- 🛡️ YETKİ KONTROLÜ ÖRNEĞİ ---
+@Zoro.command(name="ban")
+async def ban_komutu(ctx: message_context, args):
+    # Sadece yayıncı ve moderatörler bu komutu kullanabilsin
+    if not (ctx.is_broadcaster or ctx.is_mod):
+        await ctx.reply("❌ Bu komutu kullanmak için yetkin yok, tayfaya geri dön!")
+        return
+
+    if args:
+        target = args[0]
+        await ctx.send(f"⚔️ {target} kaptanın emriyle gemiden atıldı (Banlandı)!")
+        #V3.2 ile gelicek 
+    else:
+        await ctx.reply("❓ Kimi banlayacağımı söylemedin kaptan!")
+
+# --- 💎 KANAL PUANI (REWARD) YAKALAYICI ---
+# Kick panelinde belirlediğin ödül ismiyle birebir aynı olmalı
+@Zoro.on_rewards_redemption(title="Işıkları Kapat")
+async def isik_odulu(rctx: points_context):
+    print(f"🔥 Ödül Tetiklendi: {rctx.username} ışıkları kapattı!")
+    # r_ctx üzerinden kanala özel mesaj gönderebilirsin
+    await rctx.send(f"💡 @{rctx.username} ödülü kullandı, ortalık karardı!")
+
+@Zoro.on_rewards_redemption(title="Şarkı İste")
+async def sarki_istegi(rctx: points_context):
+    if rctx.input:
+        await rctx.reply(f"🎶 İstediğin '{rctx.input}' şarkısı listeye eklendi!")
+    else:
+        await rctx.reply("⚠️ Şarkı ismi yazmayı unuttun!")
+
+# --- 🔄 GENEL MESAJ İZLEYİCİ (LOGLAMA) ---
+@Zoro.on_message()
+async def mesaj_kaydedici(ctx: message_context):
+    # Botun kendi mesajlarını kaydetme (sonsuz döngü olmasın)
+    if ctx.is_bot:
+        return
+    
+    # Tüm chat trafiğini arkada bir dosyaya yazabilirsin
+    with open("chat_history.txt", "a", encoding="utf-8") as f:
+        f.write(f"[{ctx.channel.name}] {ctx.author}: {ctx.content}\n")
+
+# --- ⏱️ GELİŞMİŞ ZAMANLAYICI (DATABASE UPDATE SİMÜLASYONU) ---
+@Zoro.timer_task(hours=1)
+async def veritabani_yedekle():
+    # Bu görev parametre (ctx) almaz, sistem görevidir
+    print("💾 Veritabanı yedeği alınıyor...")
+    await asyncio.sleep(2)
+    print("✅ Yedekleme tamamlandı.")
+
+# --- ⚓ HAZIR OLDUĞUNDA ÇALIŞACAK GÖREVLER ---
+@Zoro.on_ready()
+async def bot_basladi():
+    print("🚢 Zoro okyanusa açıldı, radar aktif!")
+    # Belirli bir kanala bot açıldı mesajı atalım
+    ana_gemi = Zoro.find_channel("ana_kanal")
+    if ana_gemi:
+        await ana_gemi.send("⚓ Zoro Bot v1.3.1 artık görevinin başında!")
+
+if __name__ == "__main__":
+    Zoro.run()

kickzero-1.3.1/examples/basic_bot.py

@@ -0,0 +1,77 @@
+import asyncio
+import random
+from kickzero import kickbot, message_context
+
+# --- ⚓ KAPTANIN KONTROL PANELİ ---
+# NOT: Kendi bilgilerinizi girmeyi unutmayın!
+Zoro = kickbot(
+    user_name="BOT_ADINIZ",
+    bearer_token="TOKEN_BURAYA",
+    app_key='APP_KEY_BURAYA',
+    prefix="!",
+    framework_lang="tr"
+)
+
+# Sosyal Medya Linkleri
+SOCIAL_LINKS = {
+    "twitch": "https://www.twitch.tv/",
+    "kick": "https://kick.com/",
+    "youtube": "https://www.youtube.com/",
+    "donate": "https://donate.bynogame.com/",
+    "instagram": "https://www.instagram.com/",
+    "tiktok": "https://www.tiktok.com/"
+}
+
+# --- 📡 KANAL AYARLARI ---
+# Botun dinleyeceği kanalı ekliyoruz
+Zoro.add_channel(name="", channel_id="", chat_id="")
+
+# --- 💬 MESAJ TETİKLEYİCİLERİ ---
+
+@Zoro.message(content="sa")
+async def ase(ctx: message_context):
+    await ctx.reply("As helelelelele")
+
+@Zoro.message(content="helelele", exact=False)
+async def hele(ctx: message_context):
+    await ctx.reply("helelelele")
+
+# --- ⚔️ KOMUTLAR ---
+
+@Zoro.command(name="donate")
+async def donate(ctx: message_context):
+    await ctx.reply(f"Bağış Linki ==> {SOCIAL_LINKS['donate']}")
+
+@Zoro.command(name="twitch")
+async def twitch(ctx: message_context):
+    await ctx.reply(f"Twitch Linki ==> {SOCIAL_LINKS['twitch']}")
+
+@Zoro.command(name="kick")
+async def kick(ctx: message_context):
+    await ctx.reply(f"Kick Linki ==> {SOCIAL_LINKS['kick']}")
+
+@Zoro.command(name="youtube")
+async def youtube(ctx: message_context):
+    await ctx.reply(f"YouTube Linki ==> {SOCIAL_LINKS['youtube']}")
+
+@Zoro.command(name="instagram")
+async def instagram(ctx: message_context):
+    await ctx.reply(f"Instagram Linki ==> {SOCIAL_LINKS['instagram']}")
+
+# --- ⏱️ ZAMANLANMIŞ GÖREVLER (TIMERS) ---
+
+@Zoro.timer_task(minutes=10)
+async def tanitim(ctx: message_context):
+    await ctx.send(f"Şu anda her yerde yayındayız! Takip etmeyi unutma! | !twitch ve !youtube yazarak linklere ulaşabilirsin!")
+
+@Zoro.timer_task(minutes=15)
+async def eglenme(ctx: message_context):
+    mesajlar = [
+        "Beleş izleme, bir donate at helelelele!",
+        "Mega kutu açmamız lazım helelelele!"
+    ]
+    await ctx.send(random.choice(mesajlar))
+
+# --- 🚀 GEMİYİ ATEŞLE ---
+if __name__ == "__main__":
+    Zoro.run()