jubcord 0.1.4__tar.gz

jubcord-0.1.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jubbio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jubcord-0.1.4/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: jubcord
+Version: 0.1.4
+Summary: Modern, asenkron ve güçlü Jubbio Python SDK kütüphanesi.
+Author-email: Jubbio Developers <info@jubbio.com>
+License-Expression: MIT
+Keywords: jubcord,jubbio,bot,sdk,api,asyncio,chat
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# Jubcord (Jubbio Python SDK) 🚀
+
+[![PyPI Version](https://img.shields.io/pypi/v/jubcord.svg)](https://pypi.org/project/jubcord/)
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**Jubcord**, Türk yapımı yeni nesil iletişim platformu [Jubbio](https://jubbio.com) için geliştirilmiş modern, tam asenkron, tip güvenli ve güçlü resmi Python SDK kütüphanesidir.
+
+---
+
+## ✨ Özellikler
+
+* ⚡ **Tam Asenkron Altyapı**: `asyncio`, `aiohttp` ve `websockets` tabanlı yüksek performans.
+* 🛡️ **Gelişmiş Komut Sistemi**: Hem klasik Prefix komutları (`!komut`) hem de modern Slash komutları (`/komut`).
+* 🧠 **Dahili Önbellek (LRU Cache Layer)**: Sunucu, kanal, üye ve mesajlar için düşük bellek tüketimli akıllı RAM önbelleği.
+* 🎨 **Zengin Görsel Bileşenler**: Embed kartları, Butonlar (`Button`), Açılır Menüler (`SelectMenu`) ve Modal Formları (`Modal`).
+* 📄 **Dahili Sayfalayıcı (Paginator)**: Uzun listeleri ve rehberleri butonlarla gezilebilir kılan hazır UI bileşeni.
+* ⏱️ **Zamanlanmış Görevler (Tasks Loop)**: Arka planda periyodik çalışan asenkron döngüler (`@tasks.loop`).
+* 🧩 **Modüler Eklenti (Plugin) Mimarisi**: Komutları ve dinleyicileri bağımsız dosyalara bölme desteği.
+* 🔍 **Tip Güvenliği & IntelliSense**: Tam tip desteği (`py.typed`) ve otomatik argüman dönüştürücüler (`converters`).
+
+---
+
+## 📦 Kurulum
+
+Python 3.10 veya daha yeni bir sürüm gereklidir:
+
+```bash
+pip install jubcord
+```
+
+---
+
+## 🚀 Hızlı Başlangıç
+
+### 1. Basit Bir Bot Oluşturma
+
+```python
+import jubcord
+from jubcord.builders import Embed
+
+# Bot istemcisini başlat
+bot = jubcord.Bot(
+    token="BOT_TOKENINIZI_BURAYA_YAZIN",
+    prefix="!",
+)
+
+# 1. Hazır Olma Olayı
+@bot.event
+async def on_ready(client: jubcord.Client):
+    print(f"🤖 {client.user.username} olarak oturum açıldı ve hazır!")
+
+# 2. Klasik Prefix Komutu (!ping)
+@bot.command(name="ping", description="Gecikme süresini gösterir")
+async def ping(ctx: jubcord.Context):
+    latency = bot.latency * 1000
+    await ctx.reply(f"🏓 Pong! Gecikme: `{latency:.1f}ms`")
+
+# 3. Zengin Embed Yanıtı (!bilgi)
+@bot.command(name="bilgi")
+async def info(ctx: jubcord.Context):
+    embed = Embed(
+        title="Jubcord Bot Bilgisi",
+        description="Jubcord ile geliştirilmiş örnek bot.",
+        color="blurple",
+        fields=[
+            ("👥 Sunucu", ctx.guild.name if ctx.guild else "Özel Mesaj", True),
+            ("📁 Kanal", f"#{ctx.channel.name}" if ctx.channel else "DM", True),
+        ],
+        footer=f"İsteyen: {ctx.author.username}",
+        timestamp=True,
+    )
+    await ctx.reply(embed=embed)
+
+# 4. Slash Komutu (/selam)
+@bot.slash(name="selam", description="Kullanıcıya özel selam verir")
+async def selam(interaction: jubcord.CommandInteraction, kisi: jubcord.User):
+    await interaction.reply(f"Merhaba {kisi.mention}! 👋", ephemeral=True)
+
+# Botu çalıştır
+bot.run()
+```
+
+---
+
+## 🎛️ Butonlar ve İnteraktif Görünümler (Views)
+
+```python
+import jubcord
+from jubcord.ui import View, button
+from jubcord.enums import ButtonStyle
+
+class OnayView(View):
+    @button(label="Evet", style=ButtonStyle.SUCCESS, emoji="✅")
+    async def on_yes(self, interaction: jubcord.ButtonInteraction):
+        await interaction.reply("İşlem onaylandı! 🎉", ephemeral=True)
+
+    @button(label="Hayır", style=ButtonStyle.DANGER, emoji="❌")
+    async def on_no(self, interaction: jubcord.ButtonInteraction):
+        await interaction.reply("İşlem iptal edildi.", ephemeral=True)
+
+@bot.command(name="onayla")
+async def confirm_cmd(ctx: jubcord.Context):
+    await ctx.reply("Bu işlemi onaylıyor musunuz?", view=OnayView())
+```
+
+---
+
+## 📚 Dokümantasyon
+
+Kapsamlı rehberler, API referansı ve mimari detaylar için [Jubcord Dokümantasyonu](docs/)'nu ziyaret edebilirsiniz:
+
+* [Hızlı Başlangıç Rehberi](docs/getting-started.md)
+* [Prefix Komutları Rehberi](docs/guides/commands.md)
+* [Slash Komutları Rehberi](docs/guides/slash-commands.md)
+* [Bileşenler ve Butonlar](docs/guides/components.md)
+* [Görünümler ve Sayfalayıcı (View & Paginator)](docs/guides/views.md)
+* [API Referansı (Client, Context, Models)](docs/api/client.md)
+
+---
+
+## 📄 Lisans
+
+Bu proje **MIT Lisansı** ile lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakabilirsiniz.

jubcord-0.1.4/README.md

@@ -0,0 +1,124 @@
+# Jubcord (Jubbio Python SDK) 🚀
+
+[![PyPI Version](https://img.shields.io/pypi/v/jubcord.svg)](https://pypi.org/project/jubcord/)
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+**Jubcord**, Türk yapımı yeni nesil iletişim platformu [Jubbio](https://jubbio.com) için geliştirilmiş modern, tam asenkron, tip güvenli ve güçlü resmi Python SDK kütüphanesidir.
+
+---
+
+## ✨ Özellikler
+
+* ⚡ **Tam Asenkron Altyapı**: `asyncio`, `aiohttp` ve `websockets` tabanlı yüksek performans.
+* 🛡️ **Gelişmiş Komut Sistemi**: Hem klasik Prefix komutları (`!komut`) hem de modern Slash komutları (`/komut`).
+* 🧠 **Dahili Önbellek (LRU Cache Layer)**: Sunucu, kanal, üye ve mesajlar için düşük bellek tüketimli akıllı RAM önbelleği.
+* 🎨 **Zengin Görsel Bileşenler**: Embed kartları, Butonlar (`Button`), Açılır Menüler (`SelectMenu`) ve Modal Formları (`Modal`).
+* 📄 **Dahili Sayfalayıcı (Paginator)**: Uzun listeleri ve rehberleri butonlarla gezilebilir kılan hazır UI bileşeni.
+* ⏱️ **Zamanlanmış Görevler (Tasks Loop)**: Arka planda periyodik çalışan asenkron döngüler (`@tasks.loop`).
+* 🧩 **Modüler Eklenti (Plugin) Mimarisi**: Komutları ve dinleyicileri bağımsız dosyalara bölme desteği.
+* 🔍 **Tip Güvenliği & IntelliSense**: Tam tip desteği (`py.typed`) ve otomatik argüman dönüştürücüler (`converters`).
+
+---
+
+## 📦 Kurulum
+
+Python 3.10 veya daha yeni bir sürüm gereklidir:
+
+```bash
+pip install jubcord
+```
+
+---
+
+## 🚀 Hızlı Başlangıç
+
+### 1. Basit Bir Bot Oluşturma
+
+```python
+import jubcord
+from jubcord.builders import Embed
+
+# Bot istemcisini başlat
+bot = jubcord.Bot(
+    token="BOT_TOKENINIZI_BURAYA_YAZIN",
+    prefix="!",
+)
+
+# 1. Hazır Olma Olayı
+@bot.event
+async def on_ready(client: jubcord.Client):
+    print(f"🤖 {client.user.username} olarak oturum açıldı ve hazır!")
+
+# 2. Klasik Prefix Komutu (!ping)
+@bot.command(name="ping", description="Gecikme süresini gösterir")
+async def ping(ctx: jubcord.Context):
+    latency = bot.latency * 1000
+    await ctx.reply(f"🏓 Pong! Gecikme: `{latency:.1f}ms`")
+
+# 3. Zengin Embed Yanıtı (!bilgi)
+@bot.command(name="bilgi")
+async def info(ctx: jubcord.Context):
+    embed = Embed(
+        title="Jubcord Bot Bilgisi",
+        description="Jubcord ile geliştirilmiş örnek bot.",
+        color="blurple",
+        fields=[
+            ("👥 Sunucu", ctx.guild.name if ctx.guild else "Özel Mesaj", True),
+            ("📁 Kanal", f"#{ctx.channel.name}" if ctx.channel else "DM", True),
+        ],
+        footer=f"İsteyen: {ctx.author.username}",
+        timestamp=True,
+    )
+    await ctx.reply(embed=embed)
+
+# 4. Slash Komutu (/selam)
+@bot.slash(name="selam", description="Kullanıcıya özel selam verir")
+async def selam(interaction: jubcord.CommandInteraction, kisi: jubcord.User):
+    await interaction.reply(f"Merhaba {kisi.mention}! 👋", ephemeral=True)
+
+# Botu çalıştır
+bot.run()
+```
+
+---
+
+## 🎛️ Butonlar ve İnteraktif Görünümler (Views)
+
+```python
+import jubcord
+from jubcord.ui import View, button
+from jubcord.enums import ButtonStyle
+
+class OnayView(View):
+    @button(label="Evet", style=ButtonStyle.SUCCESS, emoji="✅")
+    async def on_yes(self, interaction: jubcord.ButtonInteraction):
+        await interaction.reply("İşlem onaylandı! 🎉", ephemeral=True)
+
+    @button(label="Hayır", style=ButtonStyle.DANGER, emoji="❌")
+    async def on_no(self, interaction: jubcord.ButtonInteraction):
+        await interaction.reply("İşlem iptal edildi.", ephemeral=True)
+
+@bot.command(name="onayla")
+async def confirm_cmd(ctx: jubcord.Context):
+    await ctx.reply("Bu işlemi onaylıyor musunuz?", view=OnayView())
+```
+
+---
+
+## 📚 Dokümantasyon
+
+Kapsamlı rehberler, API referansı ve mimari detaylar için [Jubcord Dokümantasyonu](docs/)'nu ziyaret edebilirsiniz:
+
+* [Hızlı Başlangıç Rehberi](docs/getting-started.md)
+* [Prefix Komutları Rehberi](docs/guides/commands.md)
+* [Slash Komutları Rehberi](docs/guides/slash-commands.md)
+* [Bileşenler ve Butonlar](docs/guides/components.md)
+* [Görünümler ve Sayfalayıcı (View & Paginator)](docs/guides/views.md)
+* [API Referansı (Client, Context, Models)](docs/api/client.md)
+
+---
+
+## 📄 Lisans
+
+Bu proje **MIT Lisansı** ile lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakabilirsiniz.

jubcord-0.1.4/jubcord/__init__.py

@@ -0,0 +1,138 @@
+"""
+Jubcord Python SDK (jubcord)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Modern, asenkron ve güçlü Jubbio Bot ve API kütüphanesi.
+
+:copyright: (c) 2026 Jubcord Developers
+:license: MIT, bkz. LICENSE
+"""
+
+__title__ = "jubcord"
+__author__ = "Jubcord Developers"
+__license__ = "MIT"
+__copyright__ = "Copyright 2026 Jubcord"
+__version__ = "0.1.4"
+
+# ─── Alt Modüller (Submodules - Strict Namespaces) ───────────────────────────
+from . import core as core
+from . import models as models
+from . import builders as builders
+from . import ui as ui
+from . import enums as enums
+from . import permissions as permissions
+from . import exceptions as exceptions
+from . import utils as utils
+from . import rest as rest
+from . import gateway as gateway
+from . import tasks as tasks
+from .core import cache as cache
+from .core import checks as checks
+from .core import converters as converters
+from .core import cooldowns as cooldowns
+
+# ─── Çekirdek Sınıflar (Core Classes) ────────────────────────────────────────
+from .core import Bot as Bot
+from .core import Client as Client
+from .core import Plugin as Plugin
+from .core.cache import CacheFlags as CacheFlags
+from .core.cooldowns import BucketType as BucketType, cooldown as cooldown
+from .core.converters import Converter as Converter
+
+# ─── Veri Modelleri & İstisnalar ─────────────────────────────────────────────
+from .exceptions import JubcordException as JubcordException
+from .models.base import JubcordModel as JubcordModel
+from .models.context import Context as Context
+from .models.message import Message as Message
+from .models.user import User as User
+from .models.member import GuildMember as GuildMember
+from .models.guild import Guild as Guild
+from .models.channel import Channel as Channel, TextChannel as TextChannel
+from .models.role import Role as Role
+from .models.file import File as File
+from .models.interaction import (
+    BaseInteraction as BaseInteraction,
+    ButtonInteraction as ButtonInteraction,
+    CommandInteraction as CommandInteraction,
+    ModalSubmitInteraction as ModalSubmitInteraction,
+    SelectMenuInteraction as SelectMenuInteraction,
+)
+
+# ─── UI & Bileşen Builderları (Builders & UI) ────────────────────────────────
+from .ui.view import View as View
+from .ui.paginator import Paginator as Paginator
+from .builders.embed import Embed as Embed
+from .builders.components import ActionRow as ActionRow, Button as Button, SelectMenu as SelectMenu
+from .builders.modal import Modal as Modal, TextInput as TextInput
+from .builders.command import SlashCommandBuilder as SlashCommandBuilder, CommandOption as CommandOption
+
+# ─── Yetkiler, Enumlar & Yardımcılar ────────────────────────────────────────
+from .permissions import Permissions as Permissions, PermissionFlagsBits as PermissionFlagsBits
+from .enums import ButtonStyle as ButtonStyle, ChannelType as ChannelType, CommandOptionType as CommandOptionType, GatewayIntent as GatewayIntent
+from .utils.color import Color as Color, Colour as Colour
+
+__all__ = [
+    # Alt Modüller
+    "core",
+    "models",
+    "builders",
+    "ui",
+    "enums",
+    "permissions",
+    "exceptions",
+    "utils",
+    "rest",
+    "gateway",
+    "cache",
+    "tasks",
+    "checks",
+    "converters",
+    "cooldowns",
+    # Çekirdek
+    "Bot",
+    "Client",
+    "Plugin",
+    "CacheFlags",
+    "BucketType",
+    "cooldown",
+    "Converter",
+    # UI & View & Paginator
+    "View",
+    "Paginator",
+    # İstisnalar
+    "JubcordException",
+    # Modeller
+    "JubcordModel",
+    "Context",
+    "Message",
+    "User",
+    "GuildMember",
+    "Guild",
+    "Channel",
+    "TextChannel",
+    "Role",
+    "File",
+    "BaseInteraction",
+    "ButtonInteraction",
+    "CommandInteraction",
+    "ModalSubmitInteraction",
+    "SelectMenuInteraction",
+    # Builderlar
+    "Embed",
+    "ActionRow",
+    "Button",
+    "SelectMenu",
+    "Modal",
+    "TextInput",
+    "SlashCommandBuilder",
+    "CommandOption",
+    # Yetki & Enum & Utils
+    "Permissions",
+    "PermissionFlagsBits",
+    "ButtonStyle",
+    "ChannelType",
+    "CommandOptionType",
+    "GatewayIntent",
+    "Color",
+    "Colour",
+]

jubcord-0.1.4/jubcord/__init__.pyi

@@ -0,0 +1,113 @@
+"""Jubcord Python SDK (jubcord) — Type Stubs for Pylance/IntelliSense."""
+
+from typing import Any, Callable, Coroutine, Dict, List, Optional, Sequence, Set, Type, Union
+
+from . import core as core
+from . import models as models
+from . import builders as builders
+from . import ui as ui
+from . import enums as enums
+from . import permissions as permissions
+from . import exceptions as exceptions
+from . import utils as utils
+from . import rest as rest
+from . import gateway as gateway
+from . import tasks as tasks
+from .core import cache as cache
+from .core import checks as checks
+from .core import converters as converters
+from .core import cooldowns as cooldowns
+
+from .core import Bot as Bot
+from .core import Client as Client
+from .core import Plugin as Plugin
+from .core.cache import CacheFlags as CacheFlags
+from .core.cooldowns import BucketType as BucketType, cooldown as cooldown
+from .core.converters import Converter as Converter
+
+from .ui.view import View as View
+from .ui.paginator import Paginator as Paginator
+
+from .exceptions import JubcordException as JubcordException
+from .models.base import JubcordModel as JubcordModel
+from .models.context import Context as Context
+from .models.message import Message as Message
+from .models.user import User as User
+from .models.member import GuildMember as GuildMember
+from .models.guild import Guild as Guild
+from .models.channel import Channel as Channel, TextChannel as TextChannel
+from .models.role import Role as Role
+from .models.file import File as File
+from .models.interaction import (
+    BaseInteraction as BaseInteraction,
+    ButtonInteraction as ButtonInteraction,
+    CommandInteraction as CommandInteraction,
+    ModalSubmitInteraction as ModalSubmitInteraction,
+    SelectMenuInteraction as SelectMenuInteraction,
+)
+from .builders.embed import Embed as Embed
+from .builders.components import ActionRow as ActionRow, Button as Button, SelectMenu as SelectMenu
+from .builders.modal import Modal as Modal, TextInput as TextInput
+from .builders.command import SlashCommandBuilder as SlashCommandBuilder, CommandOption as CommandOption
+from .permissions import Permissions as Permissions, PermissionFlagsBits as PermissionFlagsBits
+from .enums import ButtonStyle as ButtonStyle, ChannelType as ChannelType, CommandOptionType as CommandOptionType, GatewayIntent as GatewayIntent
+from .utils.color import Color as Color, Colour as Colour
+
+__all__: List[str] = [
+    "core",
+    "models",
+    "builders",
+    "ui",
+    "enums",
+    "permissions",
+    "exceptions",
+    "utils",
+    "rest",
+    "gateway",
+    "cache",
+    "tasks",
+    "checks",
+    "converters",
+    "cooldowns",
+    "Bot",
+    "Client",
+    "Plugin",
+    "CacheFlags",
+    "BucketType",
+    "cooldown",
+    "Converter",
+    "View",
+    "Paginator",
+    "JubcordException",
+    "JubcordModel",
+    "Context",
+    "Message",
+    "User",
+    "GuildMember",
+    "Guild",
+    "Channel",
+    "TextChannel",
+    "Role",
+    "File",
+    "BaseInteraction",
+    "ButtonInteraction",
+    "CommandInteraction",
+    "ModalSubmitInteraction",
+    "SelectMenuInteraction",
+    "Embed",
+    "ActionRow",
+    "Button",
+    "SelectMenu",
+    "Modal",
+    "TextInput",
+    "SlashCommandBuilder",
+    "CommandOption",
+    "Permissions",
+    "PermissionFlagsBits",
+    "ButtonStyle",
+    "ChannelType",
+    "CommandOptionType",
+    "GatewayIntent",
+    "Color",
+    "Colour",
+]

jubcord-0.1.4/jubcord/builders/__init__.py

@@ -0,0 +1,21 @@
+from .embed import Embed
+from .components import (
+    Button,
+    SelectOption,
+    SelectMenu,
+    ActionRow,
+)
+from .modal import TextInput, Modal
+from .command import SlashCommandBuilder, CommandOption
+
+__all__ = [
+    "Embed",
+    "Button",
+    "SelectOption",
+    "SelectMenu",
+    "ActionRow",
+    "TextInput",
+    "Modal",
+    "SlashCommandBuilder",
+    "CommandOption",
+]