omnivybe.py 1.0.0__tar.gz

omnivybe_py-1.0.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: omnivybe.py
+Version: 1.0.0
+Summary: The official, fully-featured, and high-performance Python bot SDK for the OmniVybe platform.
+Author: OmniVybe Team
+License: MIT
+Project-URL: Homepage, https://omnivybe.com.tr
+Keywords: omnivybe,omni,omnivybe.py,bot,sdk,gateway,rest,chat
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+
+# omnivybe.py
+
+> The official, fully-featured, and high-performance Python bot SDK for the **OmniVybe** platform (1:1 feature parity with `omnivybe.js` + Next-Gen Python Extensions).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg?style=flat-square)](https://www.python.org/)
+
+---
+
+## 🚀 Kurulum
+
+```bash
+pip install -e .
+```
+veya doğrudan gereksinimleri yüklemek için:
+```bash
+pip install -r requirements.txt
+```
+
+---
+
+## ⚡ Temel & Yaratıcı Özellikler
+
+- 🎯 **Tam Bot ve Gateway Yaşam Döngüsü**: Otomatik heartbeat, yeniden bağlanma ve oturum yönetimi.
+- 🛠️ **`omnivybe.ext.commands`**: Prefix tabanlı komut sistemi, akıllı `Context` (`ctx.reply`, `ctx.send`), alias ve dinamik prefix desteği.
+- 🧩 **Sıcak Yeniden Yüklemeli Cog / Extension Desteği**: `bot.load_extension()` ve `bot.reload_extension()` ile botu kapatmadan canlı kod güncelleme.
+- ⏱️ **`omnivybe.ext.tasks`**: `@tasks.loop(seconds=..., minutes=...)` ile kolay arka plan zamanlayıcıları.
+- 📖 **`omnivybe.ext.paginator`**: Reaksiyon butonlu (◀️ ▶️ ⏹️) etkileşimli çok sayfalı Embed gezgini.
+- 🚦 **`RateLimiter`**: Token-bucket tabanlı 429 koruması ve akıllı istek kuyruğu.
+- 💎 **Gelişmiş Yapıcılar**: `EmbedBuilder`, `AttachmentBuilder`, `MessagePayload`.
+- 🔍 **Kolektörler**: `MessageCollector`, `ReactionCollector`.
+- 📂 **Model & Yapılar**: `User`, `GuildMember`, `Role`, `Message`, `TextChannel`, `VoiceChannel`, `CategoryChannel`, `ThreadChannel`, `Guild`.
+- 🛡️ **Bitfield ve Yetki Denetimi**: `PermissionsBitField`, `MessageFlagsBitField`, `UserFlagsBitField`, `GatewayIntentBits`.
+- 🌐 **CDN Yardımcıları**: `cdn_avatar_url`, `cdn_display_avatar_url`, `cdn_banner_url`, `cdn_emoji_url`, `cdn_sticker_url`, `cdn_guild_asset_url`.
+- 🎨 **Emoji & Markdown Araçları**: `parse_emoji`, `format_emoji`, `get_unicode_from_shortcode`, `escape_markdown`, `format_timestamp`, `resolve_color`.
+- 💻 **CLI Bot İskeleti**: `python -m omnivybe init` komutuyla tek tıkla hazır bot şablonu oluşturma.
+
+---
+
+## 📖 Hızlı Başlangıç
+
+### 1. `commands.Bot` ile Komut & Sayfalayıcı Örneği
+
+```python
+import os
+from omnivybe import GatewayIntentBits, EmbedBuilder
+from omnivybe.ext import commands, tasks
+from omnivybe.ext.paginator import Paginator
+
+bot = commands.Bot(
+    command_prefix="!",
+    intents=GatewayIntentBits.Guilds | GatewayIntentBits.GuildMessages | GatewayIntentBits.MessageContent
+)
+
+@bot.event
+async def on_ready():
+    print(f"🚀 Bot hazır: {bot.user.tag}")
+    durum_guncelleyici.start()
+
+@bot.command(name="ping")
+async def ping(ctx):
+    await ctx.reply("🏓 Pong! OmniVybe Framework çalışıyor.")
+
+@bot.command(name="yardim")
+async def yardim(ctx):
+    sayfa1 = EmbedBuilder().set_title("Yardım - Sayfa 1").set_description("Komut listesi başlangıcı...").set_color(0x5865F2)
+    sayfa2 = EmbedBuilder().set_title("Yardım - Sayfa 2").set_description("Moderasyon komutları...").set_color(0x57F287)
+
+    paginator = Paginator([sayfa1, sayfa2], timeout=30.0)
+    await paginator.start(ctx)
+
+@tasks.loop(seconds=60)
+async def durum_guncelleyici():
+    print("Durum kontrol ediliyor...")
+
+bot.run(os.environ.get("OMNIVYBE_BOT_TOKEN", "YOUR_BOT_TOKEN"))
+```
+
+### 2. CLI ile Proje Başlatma
+
+```bash
+python -m omnivybe init my_bot
+```
+
+---
+
+## 📄 Lisans
+
+Bu proje MIT lisansı altındadır.

omnivybe_py-1.0.0/README.md

@@ -0,0 +1,89 @@
+# omnivybe.py
+
+> The official, fully-featured, and high-performance Python bot SDK for the **OmniVybe** platform (1:1 feature parity with `omnivybe.js` + Next-Gen Python Extensions).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg?style=flat-square)](https://www.python.org/)
+
+---
+
+## 🚀 Kurulum
+
+```bash
+pip install -e .
+```
+veya doğrudan gereksinimleri yüklemek için:
+```bash
+pip install -r requirements.txt
+```
+
+---
+
+## ⚡ Temel & Yaratıcı Özellikler
+
+- 🎯 **Tam Bot ve Gateway Yaşam Döngüsü**: Otomatik heartbeat, yeniden bağlanma ve oturum yönetimi.
+- 🛠️ **`omnivybe.ext.commands`**: Prefix tabanlı komut sistemi, akıllı `Context` (`ctx.reply`, `ctx.send`), alias ve dinamik prefix desteği.
+- 🧩 **Sıcak Yeniden Yüklemeli Cog / Extension Desteği**: `bot.load_extension()` ve `bot.reload_extension()` ile botu kapatmadan canlı kod güncelleme.
+- ⏱️ **`omnivybe.ext.tasks`**: `@tasks.loop(seconds=..., minutes=...)` ile kolay arka plan zamanlayıcıları.
+- 📖 **`omnivybe.ext.paginator`**: Reaksiyon butonlu (◀️ ▶️ ⏹️) etkileşimli çok sayfalı Embed gezgini.
+- 🚦 **`RateLimiter`**: Token-bucket tabanlı 429 koruması ve akıllı istek kuyruğu.
+- 💎 **Gelişmiş Yapıcılar**: `EmbedBuilder`, `AttachmentBuilder`, `MessagePayload`.
+- 🔍 **Kolektörler**: `MessageCollector`, `ReactionCollector`.
+- 📂 **Model & Yapılar**: `User`, `GuildMember`, `Role`, `Message`, `TextChannel`, `VoiceChannel`, `CategoryChannel`, `ThreadChannel`, `Guild`.
+- 🛡️ **Bitfield ve Yetki Denetimi**: `PermissionsBitField`, `MessageFlagsBitField`, `UserFlagsBitField`, `GatewayIntentBits`.
+- 🌐 **CDN Yardımcıları**: `cdn_avatar_url`, `cdn_display_avatar_url`, `cdn_banner_url`, `cdn_emoji_url`, `cdn_sticker_url`, `cdn_guild_asset_url`.
+- 🎨 **Emoji & Markdown Araçları**: `parse_emoji`, `format_emoji`, `get_unicode_from_shortcode`, `escape_markdown`, `format_timestamp`, `resolve_color`.
+- 💻 **CLI Bot İskeleti**: `python -m omnivybe init` komutuyla tek tıkla hazır bot şablonu oluşturma.
+
+---
+
+## 📖 Hızlı Başlangıç
+
+### 1. `commands.Bot` ile Komut & Sayfalayıcı Örneği
+
+```python
+import os
+from omnivybe import GatewayIntentBits, EmbedBuilder
+from omnivybe.ext import commands, tasks
+from omnivybe.ext.paginator import Paginator
+
+bot = commands.Bot(
+    command_prefix="!",
+    intents=GatewayIntentBits.Guilds | GatewayIntentBits.GuildMessages | GatewayIntentBits.MessageContent
+)
+
+@bot.event
+async def on_ready():
+    print(f"🚀 Bot hazır: {bot.user.tag}")
+    durum_guncelleyici.start()
+
+@bot.command(name="ping")
+async def ping(ctx):
+    await ctx.reply("🏓 Pong! OmniVybe Framework çalışıyor.")
+
+@bot.command(name="yardim")
+async def yardim(ctx):
+    sayfa1 = EmbedBuilder().set_title("Yardım - Sayfa 1").set_description("Komut listesi başlangıcı...").set_color(0x5865F2)
+    sayfa2 = EmbedBuilder().set_title("Yardım - Sayfa 2").set_description("Moderasyon komutları...").set_color(0x57F287)
+
+    paginator = Paginator([sayfa1, sayfa2], timeout=30.0)
+    await paginator.start(ctx)
+
+@tasks.loop(seconds=60)
+async def durum_guncelleyici():
+    print("Durum kontrol ediliyor...")
+
+bot.run(os.environ.get("OMNIVYBE_BOT_TOKEN", "YOUR_BOT_TOKEN"))
+```
+
+### 2. CLI ile Proje Başlatma
+
+```bash
+python -m omnivybe init my_bot
+```
+
+---
+
+## 📄 Lisans
+
+Bu proje MIT lisansı altındadır.

omnivybe_py-1.0.0/omnivybe/__init__.py

@@ -0,0 +1,130 @@
+"""
+omnivybe.py
+~~~~~~~~~~~
+The official, high-performance Python bot SDK for the OmniVybe platform.
+Full feature parity with omni.js / omnivybe.js plus next-gen extensions.
+"""
+
+from .bitfields import (
+    BitField,
+    MessageFlags,
+    MessageFlagsBitField,
+    PermissionFlags,
+    PermissionsBitField,
+    PublicUserFlags,
+    UserFlagsBitField,
+)
+from .builders import AttachmentBuilder, EmbedBuilder, MessagePayload
+from .cdn import (
+    CDN_URL,
+    STATIC_CDN_URL,
+    cdn_avatar_url,
+    cdn_banner_url,
+    cdn_default_avatar_url,
+    cdn_display_avatar_url,
+    cdn_emoji_url,
+    cdn_guild_asset_url,
+    cdn_member_avatar_url,
+    cdn_member_banner_url,
+    cdn_sticker_url,
+)
+from .client import Client
+from .collectors import BaseCollector, MessageCollector, ReactionCollector
+from .constants import ChannelType, Constants, GatewayIntentBits, GatewayOpcodes
+from .gateway import GatewayManager
+from .ratelimit import RateLimiter
+from .rest import RESTManager
+from .structures import (
+    Base,
+    CategoryChannel,
+    Embed,
+    Guild,
+    GuildMember,
+    Message,
+    Role,
+    TextChannel,
+    ThreadChannel,
+    User,
+    VoiceChannel,
+)
+from .utils import (
+    ParsedEmoji,
+    escape_markdown,
+    format_color,
+    format_emoji,
+    format_timestamp,
+    get_unicode_from_shortcode,
+    parse_emoji,
+    parse_role_mention,
+    parse_user_mention,
+    resolve_color,
+)
+
+# Extension namespaces
+from . import ext
+
+__version__ = "1.1.0"
+__all__ = [
+    # Core
+    "Client",
+    "GatewayManager",
+    "RESTManager",
+    "RateLimiter",
+    "Constants",
+    "GatewayOpcodes",
+    "GatewayIntentBits",
+    "ChannelType",
+    # Structures
+    "Base",
+    "User",
+    "GuildMember",
+    "Role",
+    "Message",
+    "TextChannel",
+    "VoiceChannel",
+    "CategoryChannel",
+    "ThreadChannel",
+    "Guild",
+    "Embed",
+    # Builders & Payloads
+    "EmbedBuilder",
+    "AttachmentBuilder",
+    "MessagePayload",
+    # Collectors
+    "BaseCollector",
+    "MessageCollector",
+    "ReactionCollector",
+    # BitFields
+    "BitField",
+    "PermissionFlags",
+    "PermissionsBitField",
+    "MessageFlags",
+    "MessageFlagsBitField",
+    "PublicUserFlags",
+    "UserFlagsBitField",
+    # CDN
+    "CDN_URL",
+    "STATIC_CDN_URL",
+    "cdn_avatar_url",
+    "cdn_display_avatar_url",
+    "cdn_banner_url",
+    "cdn_member_avatar_url",
+    "cdn_member_banner_url",
+    "cdn_default_avatar_url",
+    "cdn_guild_asset_url",
+    "cdn_emoji_url",
+    "cdn_sticker_url",
+    # Utils
+    "ParsedEmoji",
+    "parse_emoji",
+    "format_emoji",
+    "get_unicode_from_shortcode",
+    "escape_markdown",
+    "resolve_color",
+    "format_color",
+    "format_timestamp",
+    "parse_role_mention",
+    "parse_user_mention",
+    # Extensions
+    "ext",
+]

omnivybe_py-1.0.0/omnivybe/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

omnivybe_py-1.0.0/omnivybe/bitfields.py

@@ -0,0 +1,126 @@
+from enum import IntFlag
+from typing import Any, List, Set, Union
+
+
+class BitField:
+    FLAGS: type = IntFlag
+
+    def __init__(self, bitfield: Union[int, List[Union[int, IntFlag]], IntFlag] = 0):
+        if isinstance(bitfield, list):
+            self.value = 0
+            for b in bitfield:
+                self.value |= int(b)
+        else:
+            self.value = int(bitfield)
+
+    def has(self, flag: Union[int, IntFlag]) -> bool:
+        val = int(flag)
+        return (self.value & val) == val
+
+    def add(self, *flags: Union[int, IntFlag]) -> None:
+        for f in flags:
+            self.value |= int(f)
+
+    def remove(self, *flags: Union[int, IntFlag]) -> None:
+        for f in flags:
+            self.value &= ~int(f)
+
+    def to_list(self) -> List[str]:
+        names: List[str] = []
+        for name, member in self.FLAGS.__members__.items():
+            if self.has(member.value):
+                names.append(name)
+        return names
+
+    def __int__(self) -> int:
+        return self.value
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__} value={self.value}>"
+
+
+class PermissionFlags(IntFlag):
+    CreateInstantInvite = 1 << 0
+    KickMembers = 1 << 1
+    BanMembers = 1 << 2
+    Administrator = 1 << 3
+    ManageChannels = 1 << 4
+    ManageGuild = 1 << 5
+    AddReactions = 1 << 6
+    ViewAuditLog = 1 << 7
+    PrioritySpeaker = 1 << 8
+    Stream = 1 << 9
+    ViewChannel = 1 << 10
+    SendMessages = 1 << 11
+    SendTTSMessages = 1 << 12
+    ManageMessages = 1 << 13
+    EmbedLinks = 1 << 14
+    AttachFiles = 1 << 15
+    ReadMessageHistory = 1 << 16
+    MentionEveryone = 1 << 17
+    UseExternalEmojis = 1 << 18
+    ViewGuildInsights = 1 << 19
+    Connect = 1 << 20
+    Speak = 1 << 21
+    MuteMembers = 1 << 22
+    DeafenMembers = 1 << 23
+    MoveMembers = 1 << 24
+    UseVAD = 1 << 25
+    ChangeNickname = 1 << 26
+    ManageNicknames = 1 << 27
+    ManageRoles = 1 << 28
+    ManageWebhooks = 1 << 29
+    ManageEmojisAndStickers = 1 << 30
+    UseApplicationCommands = 1 << 31
+    RequestToSpeak = 1 << 32
+    ManageEvents = 1 << 33
+    ManageThreads = 1 << 34
+    CreatePublicThreads = 1 << 35
+    CreatePrivateThreads = 1 << 36
+    UseExternalStickers = 1 << 37
+    SendMessagesInThreads = 1 << 38
+    ModerateMembers = 1 << 40
+
+
+class PermissionsBitField(BitField):
+    FLAGS = PermissionFlags
+
+
+class MessageFlags(IntFlag):
+    Crossposted = 1 << 0
+    IsCrosspost = 1 << 1
+    SuppressEmbeds = 1 << 2
+    SourceMessageDeleted = 1 << 3
+    Urgent = 1 << 4
+    HasThread = 1 << 5
+    Ephemeral = 1 << 6
+    Loading = 1 << 7
+    FailedToMentionSomeRolesInThread = 1 << 8
+    SuppressNotifications = 1 << 12
+    IsVoiceMessage = 1 << 13
+
+
+class MessageFlagsBitField(BitField):
+    FLAGS = MessageFlags
+
+
+class PublicUserFlags(IntFlag):
+    Staff = 1 << 0
+    Partner = 1 << 1
+    Hypesquad = 1 << 2
+    BugHunterLevel1 = 1 << 3
+    HypeSquadOnlineHouse1 = 1 << 6
+    HypeSquadOnlineHouse2 = 1 << 7
+    HypeSquadOnlineHouse3 = 1 << 8
+    PremiumEarlySupporter = 1 << 9
+    TeamPseudoUser = 1 << 10
+    BugHunterLevel2 = 1 << 14
+    VerifiedBot = 1 << 16
+    VerifiedDeveloper = 1 << 17
+    CertifiedModerator = 1 << 18
+    BotHTTPInteractions = 1 << 19
+    ActiveDeveloper = 1 << 22
+
+
+class UserFlagsBitField(BitField):
+    FLAGS = PublicUserFlags

omnivybe_py-1.0.0/omnivybe/builders.py

@@ -0,0 +1,176 @@
+from datetime import datetime
+import io
+import os
+from typing import Any, Dict, List, Optional, Union
+from .utils import resolve_color
+
+
+class AttachmentBuilder:
+    def __init__(
+        self,
+        data: Optional[Union[bytes, io.BytesIO, str]] = None,
+        *,
+        name: Optional[str] = None,
+        description: Optional[str] = None
+    ):
+        self.name: str = name or "file"
+        self.description: Optional[str] = description
+        self._data: Optional[Union[bytes, io.BytesIO, str]] = data
+
+    def set_name(self, name: str) -> "AttachmentBuilder":
+        self.name = name
+        return self
+
+    def set_description(self, description: str) -> "AttachmentBuilder":
+        self.description = description
+        return self
+
+    def set_file(self, data: Union[bytes, io.BytesIO, str]) -> "AttachmentBuilder":
+        self._data = data
+        return self
+
+    def get_bytes(self) -> bytes:
+        if self._data is None:
+            return b""
+        if isinstance(self._data, bytes):
+            return self._data
+        if isinstance(self._data, io.BytesIO):
+            return self._data.getvalue()
+        if isinstance(self._data, str):
+            if os.path.exists(self._data):
+                with open(self._data, "rb") as f:
+                    return f.read()
+            return self._data.encode("utf-8")
+        return b""
+
+    def to_dict(self, id_val: int = 0) -> Dict[str, Any]:
+        d: Dict[str, Any] = {
+            "id": id_val,
+            "filename": self.name
+        }
+        if self.description:
+            d["description"] = self.description
+        return d
+
+
+class EmbedBuilder:
+    def __init__(self):
+        self.title: Optional[str] = None
+        self.description: Optional[str] = None
+        self.url: Optional[str] = None
+        self.color: Optional[int] = None
+        self.timestamp: Optional[str] = None
+        self.footer: Optional[Dict[str, str]] = None
+        self.image: Optional[Dict[str, str]] = None
+        self.thumbnail: Optional[Dict[str, str]] = None
+        self.author: Optional[Dict[str, str]] = None
+        self.fields: List[Dict[str, Any]] = []
+
+    def set_title(self, title: str) -> "EmbedBuilder":
+        self.title = title
+        return self
+
+    def set_description(self, description: str) -> "EmbedBuilder":
+        self.description = description
+        return self
+
+    def set_url(self, url: str) -> "EmbedBuilder":
+        self.url = url
+        return self
+
+    def set_color(self, color: Union[int, str, List[int], tuple]) -> "EmbedBuilder":
+        self.color = resolve_color(color)
+        return self
+
+    def set_timestamp(self, timestamp: Optional[Union[datetime, str]] = None) -> "EmbedBuilder":
+        if timestamp is None:
+            self.timestamp = datetime.utcnow().isoformat() + "Z"
+        elif isinstance(timestamp, datetime):
+            self.timestamp = timestamp.isoformat() + "Z"
+        else:
+            self.timestamp = str(timestamp)
+        return self
+
+    def set_footer(self, *, text: str, icon_url: Optional[str] = None) -> "EmbedBuilder":
+        f = {"text": text}
+        if icon_url:
+            f["icon_url"] = icon_url
+        self.footer = f
+        return self
+
+    def set_image(self, url: str) -> "EmbedBuilder":
+        self.image = {"url": url}
+        return self
+
+    def set_thumbnail(self, url: str) -> "EmbedBuilder":
+        self.thumbnail = {"url": url}
+        return self
+
+    def set_author(self, *, name: str, icon_url: Optional[str] = None, url: Optional[str] = None) -> "EmbedBuilder":
+        a = {"name": name}
+        if icon_url:
+            a["icon_url"] = icon_url
+        if url:
+            a["url"] = url
+        self.author = a
+        return self
+
+    def add_field(self, *, name: str, value: str, inline: bool = False) -> "EmbedBuilder":
+        self.fields.append({"name": name, "value": value, "inline": inline})
+        return self
+
+    def to_dict(self) -> Dict[str, Any]:
+        data: Dict[str, Any] = {}
+        if self.title:
+            data["title"] = self.title
+        if self.description:
+            data["description"] = self.description
+        if self.url:
+            data["url"] = self.url
+        if self.color is not None:
+            data["color"] = self.color
+        if self.timestamp:
+            data["timestamp"] = self.timestamp
+        if self.footer:
+            data["footer"] = self.footer
+        if self.image:
+            data["image"] = self.image
+        if self.thumbnail:
+            data["thumbnail"] = self.thumbnail
+        if self.author:
+            data["author"] = self.author
+        if self.fields:
+            data["fields"] = self.fields
+        return data
+
+
+class MessagePayload:
+    @staticmethod
+    def create(
+        content: Optional[str] = None,
+        *,
+        embeds: Optional[List[Union[EmbedBuilder, Dict[str, Any]]]] = None,
+        files: Optional[List[AttachmentBuilder]] = None,
+        flags: Optional[int] = None,
+        reply_to_id: Optional[str] = None,
+        channel_id: Optional[str] = None,
+        guild_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        payload: Dict[str, Any] = {}
+        if content is not None:
+            payload["content"] = str(content)
+
+        if embeds:
+            payload["embeds"] = [e.to_dict() if hasattr(e, "to_dict") else e for e in embeds]
+
+        if flags is not None:
+            payload["flags"] = int(flags)
+
+        if reply_to_id and channel_id:
+            payload["message_reference"] = {
+                "message_id": str(reply_to_id),
+                "channel_id": str(channel_id),
+                "guild_id": str(guild_id) if guild_id else None
+            }
+
+        return payload