jubbio 0.1.0__tar.gz

jubbio-0.1.0/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.

jubbio-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: jubbio
+Version: 0.1.0
+Summary: Modern, asenkron ve güçlü Jubbio Python SDK kütüphanesi.
+Author-email: Jubbio Developers <info@jubbio.com>
+License-Expression: MIT
+Keywords: 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
+
+# JubbioPY (Jubbio Python SDK & Prefix Bot) 🚀
+
+Modern, tam asenkron, zengin özellikli ve modüler **Jubbio Python SDK** kütüphanesi ve içerisinde gelen hazır **Prefix Komutlu Jubbio Botu**.
+
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+---
+
+## 🌟 Bot Komutları ve Özellikleri (Prefix: `!`)
+
+### 🛡️ Moderasyon Komutları
+* `!yasakla @kullanıcı [sebep]` (veya `!ban`): Kullanıcıyı sunucudan yasaklar.
+* `!at @kullanıcı [sebep]` (veya `!kick`): Kullanıcıyı sunucudan atar.
+* `!sustur @kullanıcı [dakika] [sebep]` (veya `!mute`): Kullanıcıyı belirlenen dakika kadar susturur.
+* `!susturma-ac @kullanıcı` (veya `!unmute`): Kullanıcının susturmasını kaldırır.
+* `!sil [adet]` (veya `!temizle`): Kanaldaki son mesajları toplu temizler.
+* `!rolver @kullanıcı @rol`: Kullanıcıya rol atar.
+* `!rolal @kullanıcı @rol`: Kullanıcıdan rol kaldırır.
+
+### ℹ️ Bilgi & Profil
+* `!ping`: Botun gecikme süresi ve bağlantı durumunu gösterir.
+* `!yardim` (veya `!help`, `!komutlar`): Şık komut listesi rehberi.
+* `!sunucu`: Sunucu istatistikleri ve bilgileri.
+* `!kullanici [@kullanıcı]`: Kullanıcı profil kartı.
+* `!avatar [@kullanıcı]` (veya `!pp`): Kullanıcının profil fotoğrafını büyük boyutta gösterir.
+* `!hakkinda`: JubbioPY kütüphane bilgisi.
+
+### ✨ İnteraktif Bileşenler (Butonlar & Modallar)
+* `!oylama <soru>`: Canlı Evet 👍 / Hayır 👎 / Kararsızım 🤔 butonlarıyla interaktif oylama başlatır.
+* `!rol-menusu`: Kullanıcıların açılır menüden (SelectMenu) rol seçebileceği panel gönderir.
+* `!destek`: Butonlu destek paneli gönderir (Tıklayınca açılır Form Modalı açılır).
+
+### 🎮 Eğlence & Şans
+* `!zar [yüzey]`: Zar atar (Örn: `!zar 20`).
+* `!yazitura`: Madeni para atar.
+* `!sec <seçenek 1, seçenek 2, ...>`: Seçenekler arasından rastgele birini seçer (Örn: `!sec pizza, burger, döner`).
+* `!echo <mesaj>`: Bot üzerinden mesaj gönderir.
+
+---
+
+## 🚀 Botu Başlatma
+
+### 1. Bot Klasörüne Geçin ve Sanal Ortamı Aktif Edin:
+
+```bash
+cd bot
+source .venv/bin/activate
+```
+
+---
+
+### 2. Tokeninizi Tanımlayın:
+
+`bot/.env` dosyasını açıp tokeninizi yazın:
+```env
+JUBBIO_BOT_TOKEN=buraya_jubbio_bot_tokeninizi_yazın
+BOT_PREFIX=!
+EMBED_COLOR=blurple
+```
+
+---
+
+### 3. Botu Çalıştırın:
+
+```bash
+python main.py
+```
+
+---
+
+## 🧪 SDK Testlerini Çalıştırma
+
+```bash
+bot/.venv/bin/python -m unittest discover tests
+```

jubbio-0.1.0/README.md

@@ -0,0 +1,76 @@
+# JubbioPY (Jubbio Python SDK & Prefix Bot) 🚀
+
+Modern, tam asenkron, zengin özellikli ve modüler **Jubbio Python SDK** kütüphanesi ve içerisinde gelen hazır **Prefix Komutlu Jubbio Botu**.
+
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+---
+
+## 🌟 Bot Komutları ve Özellikleri (Prefix: `!`)
+
+### 🛡️ Moderasyon Komutları
+* `!yasakla @kullanıcı [sebep]` (veya `!ban`): Kullanıcıyı sunucudan yasaklar.
+* `!at @kullanıcı [sebep]` (veya `!kick`): Kullanıcıyı sunucudan atar.
+* `!sustur @kullanıcı [dakika] [sebep]` (veya `!mute`): Kullanıcıyı belirlenen dakika kadar susturur.
+* `!susturma-ac @kullanıcı` (veya `!unmute`): Kullanıcının susturmasını kaldırır.
+* `!sil [adet]` (veya `!temizle`): Kanaldaki son mesajları toplu temizler.
+* `!rolver @kullanıcı @rol`: Kullanıcıya rol atar.
+* `!rolal @kullanıcı @rol`: Kullanıcıdan rol kaldırır.
+
+### ℹ️ Bilgi & Profil
+* `!ping`: Botun gecikme süresi ve bağlantı durumunu gösterir.
+* `!yardim` (veya `!help`, `!komutlar`): Şık komut listesi rehberi.
+* `!sunucu`: Sunucu istatistikleri ve bilgileri.
+* `!kullanici [@kullanıcı]`: Kullanıcı profil kartı.
+* `!avatar [@kullanıcı]` (veya `!pp`): Kullanıcının profil fotoğrafını büyük boyutta gösterir.
+* `!hakkinda`: JubbioPY kütüphane bilgisi.
+
+### ✨ İnteraktif Bileşenler (Butonlar & Modallar)
+* `!oylama <soru>`: Canlı Evet 👍 / Hayır 👎 / Kararsızım 🤔 butonlarıyla interaktif oylama başlatır.
+* `!rol-menusu`: Kullanıcıların açılır menüden (SelectMenu) rol seçebileceği panel gönderir.
+* `!destek`: Butonlu destek paneli gönderir (Tıklayınca açılır Form Modalı açılır).
+
+### 🎮 Eğlence & Şans
+* `!zar [yüzey]`: Zar atar (Örn: `!zar 20`).
+* `!yazitura`: Madeni para atar.
+* `!sec <seçenek 1, seçenek 2, ...>`: Seçenekler arasından rastgele birini seçer (Örn: `!sec pizza, burger, döner`).
+* `!echo <mesaj>`: Bot üzerinden mesaj gönderir.
+
+---
+
+## 🚀 Botu Başlatma
+
+### 1. Bot Klasörüne Geçin ve Sanal Ortamı Aktif Edin:
+
+```bash
+cd bot
+source .venv/bin/activate
+```
+
+---
+
+### 2. Tokeninizi Tanımlayın:
+
+`bot/.env` dosyasını açıp tokeninizi yazın:
+```env
+JUBBIO_BOT_TOKEN=buraya_jubbio_bot_tokeninizi_yazın
+BOT_PREFIX=!
+EMBED_COLOR=blurple
+```
+
+---
+
+### 3. Botu Çalıştırın:
+
+```bash
+python main.py
+```
+
+---
+
+## 🧪 SDK Testlerini Çalıştırma
+
+```bash
+bot/.venv/bin/python -m unittest discover tests
+```

jubbio-0.1.0/jubbio/__init__.py

@@ -0,0 +1,133 @@
+"""
+Jubbio Python SDK (JubbioPY)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Modern, asenkron ve güçlü Jubbio Bot ve API kütüphanesi.
+
+:copyright: (c) 2026 Jubbio
+:license: MIT, bkz. LICENSE
+"""
+
+__title__ = "jubbio"
+__author__ = "Jubbio Developers"
+__license__ = "MIT"
+__copyright__ = "Copyright 2026 Jubbio"
+__version__ = "0.1.0"
+
+# ─── 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 (Models) ────────────────────────────────────────────────
+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",
+    # Modeller
+    "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",
+]

jubbio-0.1.0/jubbio/__init__.pyi

@@ -0,0 +1,109 @@
+"""Jubbio Python SDK (JubbioPY) — 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 .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",
+    "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",
+]

jubbio-0.1.0/jubbio/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",
+]

jubbio-0.1.0/jubbio/builders/command.py

@@ -0,0 +1,175 @@
+from typing import Any, Dict, List, Optional, Union
+from ..enums import CommandOptionType
+
+
+class CommandOption:
+    """Slash komut parametre seçeneği."""
+
+    def __init__(
+        self,
+        name: str,
+        description: str,
+        *,
+        type: Union[CommandOptionType, int] = CommandOptionType.STRING,
+        required: bool = False,
+        choices: Optional[List[Dict[str, Any]]] = None,
+        autocomplete: bool = False,
+    ):
+        self.name: str = name.lower().strip()
+        self.description: str = description
+        self.type: int = int(type)
+        self.required: bool = required
+        self.choices: Optional[List[Dict[str, Any]]] = choices
+        self.autocomplete: bool = autocomplete
+
+    def add_choice(self, name: str, value: Union[str, int, float]) -> "CommandOption":
+        if self.choices is None:
+            self.choices = []
+        self.choices.append({"name": name, "value": value})
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        data: Dict[str, Any] = {
+            "name": self.name,
+            "description": self.description,
+            "type": self.type,
+            "required": self.required,
+        }
+        if self.choices:
+            data["choices"] = self.choices
+        if self.autocomplete:
+            data["autocomplete"] = True
+        return data
+
+
+class SlashCommandBuilder:
+    """Slash komut tanımlama oluşturucu."""
+
+    def __init__(
+        self,
+        name: str,
+        description: str,
+        *,
+        options: Optional[List[CommandOption]] = None,
+    ):
+        self.name: str = name.lower().strip()
+        self.description: str = description
+        self.options: List[CommandOption] = options or []
+
+    def add_option(self, option: CommandOption) -> "SlashCommandBuilder":
+        self.options.append(option)
+        return self
+
+    def add_string_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+        choices: Optional[List[Dict[str, Any]]] = None,
+        autocomplete: bool = False,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.STRING,
+                required=required,
+                choices=choices,
+                autocomplete=autocomplete,
+            )
+        )
+
+    def add_integer_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+        choices: Optional[List[Dict[str, Any]]] = None,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.INTEGER,
+                required=required,
+                choices=choices,
+            )
+        )
+
+    def add_boolean_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.BOOLEAN,
+                required=required,
+            )
+        )
+
+    def add_user_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.USER,
+                required=required,
+            )
+        )
+
+    def add_channel_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.CHANNEL,
+                required=required,
+            )
+        )
+
+    def add_role_option(
+        self,
+        name: str,
+        description: str,
+        *,
+        required: bool = False,
+    ) -> "SlashCommandBuilder":
+        return self.add_option(
+            CommandOption(
+                name,
+                description,
+                type=CommandOptionType.ROLE,
+                required=required,
+            )
+        )
+
+    def to_dict(self) -> Dict[str, Any]:
+        data: Dict[str, Any] = {
+            "name": self.name,
+            "description": self.description,
+        }
+        if self.options:
+            data["options"] = [opt.to_dict() for opt in self.options]
+        return data
+
+    def __repr__(self) -> str:
+        return f"<SlashCommandBuilder name={self.name!r} options={len(self.options)}>"