discord-py-help-lib 0.0.1__tar.gz

discord_py_help_lib-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hashimotok
+
+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.

discord_py_help_lib-0.0.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.2
+Name: discord-py-help-lib
+Version: 0.0.1
+Summary: A library to assist with Discord.py development
+Home-page: https://github.com/hashimotok-ecsv/discord-py-help-lib
+Download-URL: https://github.com/hashimotok-ecsv/discord-py-help-lib
+Author: hashimotok
+Author-email: contact@hashimotok.dev
+License: MIT
+Project-URL: Documentation, https://discord-py-help-lib.readthedocs.io/
+Project-URL: Source, https://github.com/hashimotok-ecsv/discord-py-help-lib
+Project-URL: Tracker, https://github.com/hashimotok-ecsv/discord-py-help-lib/issues
+Keywords: discord.py help library
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord.py>=2.5.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Auxiliary for discord.py Library
+
+![PyPI version](https://img.shields.io/pypi/v/discord-py-auxiliary-lib.svg)
+![Python version](https://img.shields.io/pypi/pyversions/discord-py-auxiliary-lib.svg)
+![License](https://img.shields.io/pypi/l/discord-py-auxiliary-lib.svg)
+
+---
+
+## 📦 概要
+
+`discord-py-auxiliary-lib` は、discord.pyで役職パネルを簡単に実装するための Python ライブラリです。
+
+主な機能は以下のとおりです：
+
+- 後日更新
+
+---
+
+## ✨ 特徴
+
+- ✅ 簡単に使用が可能
+
+---
+
+## 🔧 インストール
+
+### PyPIからインストール：
+```bash
+pip install discord-py-auxiliary-lib
+```
+### githubからインストール：
+```bash
+pip install git+https://github.com/hashimotok-ecsv/discord_py_auxiliary_lib.git
+```
+## 使い方
+```python
+# 後日更新
+```
+#### 管理者用
+##### 更新方法
+```bash
+py setup.py sdist
+py setup.py bdist_wheel
+py -m twine upload --repository testpypi dist/*
+py -m twine upload --repository pypi dist/*
+```

discord_py_help_lib-0.0.1/README.md

@@ -0,0 +1,46 @@
+# Auxiliary for discord.py Library
+
+![PyPI version](https://img.shields.io/pypi/v/discord-py-auxiliary-lib.svg)
+![Python version](https://img.shields.io/pypi/pyversions/discord-py-auxiliary-lib.svg)
+![License](https://img.shields.io/pypi/l/discord-py-auxiliary-lib.svg)
+
+---
+
+## 📦 概要
+
+`discord-py-auxiliary-lib` は、discord.pyで役職パネルを簡単に実装するための Python ライブラリです。
+
+主な機能は以下のとおりです：
+
+- 後日更新
+
+---
+
+## ✨ 特徴
+
+- ✅ 簡単に使用が可能
+
+---
+
+## 🔧 インストール
+
+### PyPIからインストール：
+```bash
+pip install discord-py-auxiliary-lib
+```
+### githubからインストール：
+```bash
+pip install git+https://github.com/hashimotok-ecsv/discord_py_auxiliary_lib.git
+```
+## 使い方
+```python
+# 後日更新
+```
+#### 管理者用
+##### 更新方法
+```bash
+py setup.py sdist
+py setup.py bdist_wheel
+py -m twine upload --repository testpypi dist/*
+py -m twine upload --repository pypi dist/*
+```

discord_py_help_lib-0.0.1/discord_py_help_lib/__init__.py

@@ -0,0 +1,4 @@
+from .select import *
+from .webhook_sender import *
+
+__version__ = '0.0.1'

discord_py_help_lib-0.0.1/discord_py_help_lib/select/category_select.py

@@ -0,0 +1,138 @@
+import discord
+import traceback
+from discord.ext import commands
+from typing import Callable, Optional, Awaitable
+
+def select_category(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> dict:
+    category_list = guild.categories
+    total_categories = len(category_list)
+    
+    # 1ページあたりの項目数
+    items_per_page = 25
+    # ページの範囲を計算
+    start = items_per_page * (page - 1)
+    end = items_per_page * page
+    last_page = (total_categories + items_per_page - 1) // items_per_page  # ページ数を計算
+    print(f"start: {start}, end: {end}, total_categories: {total_categories}")
+    # 範囲外なら最後のページを選ぶ
+    if start >= total_categories:
+        start = items_per_page * (last_page - 1)
+        end = total_categories
+        page = last_page
+    options = []
+    count: int = 0
+    for category in category_list[start:end]:
+        options.append(discord.SelectOption(label="📂"+category.name, value=str(category.id)))
+        count += 1
+    if not multiselect:
+        count = 1
+    select_ui = discord.ui.Select(custom_id=select_ui_id + "_" + str(page), placeholder=placeholder, options=options, max_values=count)
+    return {"select_ui": select_ui, "page": page, "last_page": last_page}
+
+def get_category_select(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> discord.ui.View:
+    try:
+        data = select_category(guild, select_ui_id, placeholder, page, multiselect)
+        view: discord.ui.View = discord.ui.View()
+        select_category_ui: discord.ui.Select = data["select_ui"]
+        view.add_item(select_category_ui)
+        prev_button: discord.ui.Button = discord.ui.Button(style=discord.ButtonStyle.red, label="前へ", custom_id=f"{select_ui_id}_back_select_{page - 1}", disabled=False if page > 1 else True)
+        view.add_item(prev_button)
+        next_button: discord.ui.Button = discord.ui.Button(style=discord.ButtonStyle.green, label="次へ", custom_id=f"{select_ui_id}_next_select_{page + 1}")
+        view.add_item(next_button)
+        cancel_button: discord.ui.Button = discord.ui.Button(style=discord.ButtonStyle.red, label="キャンセル", custom_id=f"{select_ui_id}_cancel_select")
+        view.add_item(cancel_button)
+        return view
+    except Exception as e:
+        print(f"Error in get_category_select: {e}")
+        traceback.print_exc()
+        return None
+
+class CategorySelectHandler:
+    def __init__(self, 
+            bot: commands.Bot, 
+            custom_id: str,
+            placeholder: str = "カテゴリーを選択してください。",
+            multiselect: bool = False,
+            on_select: Optional[Callable[[discord.Interaction, list[discord.CategoryChannel]], Awaitable[None]]] = None
+        ):
+        """
+        Initialize the CategorySelectHandler.
+        
+        Args:
+            bot: Discord bot instance
+            custom_id: Unique identifier for this handler
+            placeholder: Placeholder text for the select menu
+            multiselect: Whether to allow multiple selections
+            on_select: Callback function when categories are selected
+        """
+        self.bot: commands.Bot = bot
+        self.custom_id = custom_id
+        self.placeholder = placeholder
+        self.multiselect = multiselect
+        self.on_select = on_select
+    
+    def get_custom_id(self) -> str:
+        return self.custom_id
+    
+    def get_view(self, guild: discord.Guild, page: int = 1) -> discord.ui.View:
+        return get_category_select(guild, self.custom_id, self.placeholder, page, self.multiselect)
+
+    async def call(self, inter: discord.Interaction):
+        try:
+            custom_id: str = inter.data["custom_id"]
+            
+            if custom_id == f"{self.custom_id}_cancel_select":
+                await inter.response.edit_message(content="キャンセルしました。", view=None)
+                    
+            elif custom_id.startswith(f"{self.custom_id}_next_select_") or custom_id.startswith(f"{self.custom_id}_back_select_"):
+                page: int = int(custom_id.split("_")[-1])
+                view = self.get_view(inter.guild, page)
+                if not view:
+                    await inter.response.edit_message("カテゴリーが設定されていません。", view=None)
+                    return
+                await inter.response.edit_message(content=f"{self.placeholder}", view=view)
+                
+            elif custom_id.startswith(f"{self.custom_id}_"):
+                # セレクトメニューが選択された場合
+                if inter.data.get("component_type") == 3:  # Select Menu
+                    selected_ids = inter.data["values"]
+                    selected_categories = []
+                    for category_id in selected_ids:
+                        category = inter.guild.get_channel(int(category_id))
+                        if category and isinstance(category, discord.CategoryChannel):
+                            selected_categories.append(category)
+                    
+                    if self.on_select:
+                        await self.on_select(inter, selected_categories)
+                    else:
+                        category_names = [cat.name for cat in selected_categories]
+                        await inter.response.edit_message(
+                            content=f"選択されたカテゴリー: {', '.join(category_names)}", 
+                            view=None
+                        )
+                        
+        except Exception:
+            traceback.print_exc()
+
+# グローバルなハンドラー管理辞書
+_category_handlers: dict[str, CategorySelectHandler] = {}
+
+def register_category_handler(handler: CategorySelectHandler):
+    """ハンドラーを登録"""
+    _category_handlers[handler.get_custom_id()] = handler
+
+def get_category_handler(custom_id: str) -> Optional[CategorySelectHandler]:
+    """登録されたハンドラーを取得"""
+    for handler_id, handler in _category_handlers.items():
+        if custom_id.startswith(handler_id):
+            return handler
+    return None
+
+async def handle_category_interaction(inter: discord.Interaction):
+    """統一されたインタラクションハンドラー"""
+    custom_id = inter.data["custom_id"]
+    handler = get_category_handler(custom_id)
+    if handler:
+        await handler.call(inter)
+    else:
+        await inter.response.send_message("ハンドラーが見つかりません。", ephemeral=True)

discord_py_help_lib-0.0.1/discord_py_help_lib/select/role_select.py

@@ -0,0 +1,177 @@
+import discord
+import traceback
+from discord.ext import commands
+from typing import Callable, Optional, Awaitable
+
+def select_role(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> dict:
+    # @everyoneロールを除外してロール一覧を取得
+    role_list = [role for role in guild.roles if role.name != "@everyone"]
+    # 位置順でソート（上位のロールが先頭）
+    role_list.sort(key=lambda role: role.position, reverse=True)
+    
+    total_roles = len(role_list)
+    
+    # 1ページあたりの項目数
+    items_per_page = 25
+    # ページの範囲を計算
+    start = items_per_page * (page - 1)
+    end = items_per_page * page
+    last_page = (total_roles + items_per_page - 1) // items_per_page  # ページ数を計算
+    print(f"start: {start}, end: {end}, total_roles: {total_roles}")
+    # 範囲外なら最後のページを選ぶ
+    if start >= total_roles:
+        start = items_per_page * (last_page - 1)
+        end = total_roles
+        page = last_page
+    
+    options = []
+    count: int = 0
+    for role in role_list[start:end]:
+        # ロールの色を表示に使用
+        emoji = "🔴" if role.color != discord.Color.default() else "⚪"
+        label = f"{emoji}{role.name}"
+        # ラベルが100文字を超える場合は切り詰める
+        if len(label) > 100:
+            label = label[:97] + "..."
+        options.append(discord.SelectOption(label=label, value=str(role.id)))
+        count += 1
+    
+    if not multiselect:
+        count = 1
+    
+    select_ui = discord.ui.Select(custom_id=select_ui_id + "_" + str(page), placeholder=placeholder, options=options, max_values=count)
+    return {"select_ui": select_ui, "page": page, "last_page": last_page}
+
+def get_role_select(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> discord.ui.View:
+    try:
+        data = select_role(guild, select_ui_id, placeholder, page, multiselect)
+        view: discord.ui.View = discord.ui.View()
+        select_role_ui: discord.ui.Select = data["select_ui"]
+        view.add_item(select_role_ui)
+        
+        page = data["page"]
+        last_page = data["last_page"]
+        
+        prev_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.red, 
+            label="前へ", 
+            custom_id=f"{select_ui_id}_back_select_{page - 1}", 
+            disabled=page <= 1
+        )
+        view.add_item(prev_button)
+        
+        next_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.green, 
+            label="次へ", 
+            custom_id=f"{select_ui_id}_next_select_{page + 1}",
+            disabled=page >= last_page
+        )
+        view.add_item(next_button)
+        
+        cancel_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.red, 
+            label="キャンセル", 
+            custom_id=f"{select_ui_id}_cancel_select"
+        )
+        view.add_item(cancel_button)
+        
+        return view
+    except Exception as e:
+        print(f"Error in get_role_select: {e}")
+        traceback.print_exc()
+        return None
+
+class RoleSelectHandler:
+    def __init__(self, 
+        bot: commands.Bot, 
+        custom_id: str,
+        placeholder: str = "ロールを選択してください。",
+        multiselect: bool = False,
+        on_select: Optional[Callable[[discord.Interaction, list[discord.Role]], Awaitable[None]]] = None
+    ):
+        """
+        Initialize the RoleSelectHandler.
+        
+        Args:
+            bot: Discord bot instance
+            custom_id: Unique identifier for this handler
+            placeholder: Placeholder text for the select menu
+            multiselect: Whether to allow multiple selections
+            on_select: Callback function when roles are selected
+        """
+        self.bot: commands.Bot = bot
+        self.custom_id = custom_id
+        self.placeholder = placeholder
+        self.multiselect = multiselect
+        self.on_select = on_select
+    
+    def get_custom_id(self) -> str:
+        return self.custom_id
+    
+    def get_view(self, guild: discord.Guild, page: int = 1) -> discord.ui.View:
+        return get_role_select(guild, self.custom_id, self.placeholder, page, self.multiselect)
+
+    async def call(self, inter: discord.Interaction):
+        try:
+            custom_id: str = inter.data["custom_id"]
+            
+            if custom_id == f"{self.custom_id}_cancel_select":
+                await inter.response.edit_message(content="キャンセルしました。", view=None)
+                    
+            elif custom_id.startswith(f"{self.custom_id}_next_select_") or custom_id.startswith(f"{self.custom_id}_back_select_"):
+                page: int = int(custom_id.split("_")[-1])
+                view = self.get_view(inter.guild, page)
+                if not view:
+                    await inter.response.edit_message("ロールが設定されていません。", view=None)
+                    return
+                await inter.response.edit_message(content=f"{self.placeholder}", view=view)
+                
+            elif custom_id.startswith(f"{self.custom_id}_"):
+                # セレクトメニューが選択された場合
+                if inter.data.get("component_type") == 3:  # Select Menu
+                    selected_ids = inter.data["values"]
+                    selected_roles = []
+                    for role_id in selected_ids:
+                        role = inter.guild.get_role(int(role_id))
+                        if role:
+                            selected_roles.append(role)
+                    
+                    if self.on_select:
+                        await self.on_select(inter, selected_roles)
+                    else:
+                        role_names = [role.name for role in selected_roles]
+                        await inter.response.edit_message(
+                            content=f"選択されたロール: {', '.join(role_names)}", 
+                            view=None
+                        )
+                        
+        except Exception:
+            traceback.print_exc()
+
+# グローバルなハンドラー管理辞書
+_role_handlers: dict[str, RoleSelectHandler] = {}
+
+def register_role_handler(handler: RoleSelectHandler):
+    """ハンドラーを登録"""
+    _role_handlers[handler.get_custom_id()] = handler
+
+def get_role_handler(custom_id: str) -> Optional[RoleSelectHandler]:
+    """登録されたハンドラーを取得"""
+    for handler_id, handler in _role_handlers.items():
+        if custom_id.startswith(handler_id):
+            return handler
+    return None
+
+async def handle_role_interaction(inter: discord.Interaction):
+    """統一されたインタラクションハンドラー"""
+    try:
+        custom_id = inter.data["custom_id"]
+        handler = get_role_handler(custom_id)
+        if handler:
+            await handler.call(inter)
+        else:
+            await inter.response.send_message("ハンドラーが見つかりません。", ephemeral=True)
+    except Exception as e:
+        print(f"Error in handle_role_interaction: {e}")
+        traceback.print_exc()
+        await inter.response.send_message("エラーが発生しました。", ephemeral=True)

discord_py_help_lib-0.0.1/discord_py_help_lib/select/vc_select.py

@@ -0,0 +1,175 @@
+import discord
+import traceback
+from discord.ext import commands
+from typing import Callable, Optional, Awaitable
+
+def select_vc(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> dict:
+    # ボイスチャンネルの一覧を取得
+    vc_list = [channel for channel in guild.channels if isinstance(channel, discord.VoiceChannel)]
+    # カテゴリー順、位置順でソート
+    vc_list.sort(key=lambda vc: (vc.category.name if vc.category else "", vc.position))
+    
+    total_vcs = len(vc_list)
+    
+    # 1ページあたりの項目数
+    items_per_page = 25
+    # ページの範囲を計算
+    start = items_per_page * (page - 1)
+    end = items_per_page * page
+    last_page = (total_vcs + items_per_page - 1) // items_per_page  # ページ数を計算
+    print(f"start: {start}, end: {end}, total_vcs: {total_vcs}")
+    # 範囲外なら最後のページを選ぶ
+    if start >= total_vcs:
+        start = items_per_page * (last_page - 1)
+        end = total_vcs
+        page = last_page
+    
+    options = []
+    count: int = 0
+    for vc in vc_list[start:end]:
+        # カテゴリー名を含めて表示
+        if vc.category:
+            label = f"🔊[{vc.category.name}] {vc.name}"
+        else:
+            label = f"🔊{vc.name}"
+        
+        # ラベルが100文字を超える場合は切り詰める
+        if len(label) > 100:
+            label = label[:97] + "..."
+        
+        options.append(discord.SelectOption(label=label, value=str(vc.id)))
+        count += 1
+    
+    if not multiselect:
+        count = 1
+    
+    select_ui = discord.ui.Select(custom_id=select_ui_id + "_" + str(page), placeholder=placeholder, options=options, max_values=count)
+    return {"select_ui": select_ui, "page": page, "last_page": last_page}
+
+def get_vc_select(guild: discord.Guild, select_ui_id: str, placeholder: str, page: int = 1, multiselect: bool = False) -> discord.ui.View:
+    try:
+        data = select_vc(guild, select_ui_id, placeholder, page, multiselect)
+        view: discord.ui.View = discord.ui.View()
+        select_vc_ui: discord.ui.Select = data["select_ui"]
+        view.add_item(select_vc_ui)
+        
+        page = data["page"]
+        last_page = data["last_page"]
+        
+        prev_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.red, 
+            label="前へ", 
+            custom_id=f"{select_ui_id}_back_select_{page - 1}", 
+            disabled=page <= 1
+        )
+        view.add_item(prev_button)
+        
+        next_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.green, 
+            label="次へ", 
+            custom_id=f"{select_ui_id}_next_select_{page + 1}",
+            disabled=page >= last_page
+        )
+        view.add_item(next_button)
+        
+        cancel_button: discord.ui.Button = discord.ui.Button(
+            style=discord.ButtonStyle.red, 
+            label="キャンセル", 
+            custom_id=f"{select_ui_id}_cancel_select"
+        )
+        view.add_item(cancel_button)
+        
+        return view
+    except Exception as e:
+        print(f"Error in get_vc_select: {e}")
+        traceback.print_exc()
+        return None
+
+class VCSelectHandler:
+    def __init__(self, 
+                 bot: commands.Bot, 
+                 custom_id: str,
+                 placeholder: str = "ボイスチャンネルを選択してください。",
+                 multiselect: bool = False,
+                 on_select: Optional[Callable[[discord.Interaction, list[discord.VoiceChannel]], Awaitable[None]]] = None):
+        """
+        Initialize the VCSelectHandler.
+        
+        Args:
+            bot: Discord bot instance
+            custom_id: Unique identifier for this handler
+            placeholder: Placeholder text for the select menu
+            multiselect: Whether to allow multiple selections
+            on_select: Callback function when voice channels are selected
+        """
+        self.bot: commands.Bot = bot
+        self.custom_id = custom_id
+        self.placeholder = placeholder
+        self.multiselect = multiselect
+        self.on_select = on_select
+    
+    def get_custom_id(self) -> str:
+        return self.custom_id
+    
+    def get_view(self, guild: discord.Guild, page: int = 1) -> discord.ui.View:
+        return get_vc_select(guild, self.custom_id, self.placeholder, page, self.multiselect)
+
+    async def call(self, inter: discord.Interaction):
+        try:
+            custom_id: str = inter.data["custom_id"]
+            
+            if custom_id == f"{self.custom_id}_cancel_select":
+                await inter.response.edit_message(content="キャンセルしました。", view=None)
+                    
+            elif custom_id.startswith(f"{self.custom_id}_next_select_") or custom_id.startswith(f"{self.custom_id}_back_select_"):
+                page: int = int(custom_id.split("_")[-1])
+                view = self.get_view(inter.guild, page)
+                if not view:
+                    await inter.response.edit_message("ボイスチャンネルが設定されていません。", view=None)
+                    return
+                await inter.response.edit_message(content=f"{self.placeholder}", view=view)
+                
+            elif custom_id.startswith(f"{self.custom_id}_"):
+                # セレクトメニューが選択された場合
+                if inter.data.get("component_type") == 3:  # Select Menu
+                    selected_ids = inter.data["values"]
+                    selected_vcs = []
+                    for vc_id in selected_ids:
+                        vc = inter.guild.get_channel(int(vc_id))
+                        if vc and isinstance(vc, discord.VoiceChannel):
+                            selected_vcs.append(vc)
+                    
+                    if self.on_select:
+                        await self.on_select(inter, selected_vcs)
+                    else:
+                        vc_names = [vc.name for vc in selected_vcs]
+                        await inter.response.edit_message(
+                            content=f"選択されたボイスチャンネル: {', '.join(vc_names)}", 
+                            view=None
+                        )
+                        
+        except Exception:
+            traceback.print_exc()
+
+# グローバルなハンドラー管理辞書
+_vc_handlers: dict[str, VCSelectHandler] = {}
+
+def register_vc_handler(handler: VCSelectHandler):
+    """ハンドラーを登録"""
+    _vc_handlers[handler.get_custom_id()] = handler
+
+def get_vc_handler(custom_id: str) -> Optional[VCSelectHandler]:
+    """登録されたハンドラーを取得"""
+    for handler_id, handler in _vc_handlers.items():
+        if custom_id.startswith(handler_id):
+            return handler
+    return None
+
+async def handle_vc_interaction(inter: discord.Interaction):
+    """統一されたインタラクションハンドラー"""
+    custom_id = inter.data["custom_id"]
+    handler = get_vc_handler(custom_id)
+    if handler:
+        await handler.call(inter)
+    else:
+        await inter.response.send_message("ハンドラーが見つかりません。", ephemeral=True)

discord_py_help_lib-0.0.1/discord_py_help_lib/webhook_sender.py

@@ -0,0 +1,238 @@
+import discord
+import traceback
+from typing import Union, Optional
+
+async def send_webhook_message(
+    channel: Union[discord.TextChannel, discord.VoiceChannel, discord.Thread],
+    content: str = None,
+    embed: discord.Embed = None,
+    embeds: list[discord.Embed] = None,
+    username: str = "Webhook Bot",
+    avatar_url: str = None,
+    file: discord.File = None,
+    files: list[discord.File] = None
+) -> Optional[discord.WebhookMessage]:
+    """
+    指定されたチャンネルにWebhookメッセージを送信する
+    
+    Args:
+        channel: 送信先チャンネル (TextChannel/VoiceChannel/Thread)
+        content: メッセージ内容
+        embed: 埋め込み (単体)
+        embeds: 埋め込み (複数)
+        username: Webhookの表示名
+        avatar_url: Webhookのアイコン画像URL
+        file: 添付ファイル (単体)
+        files: 添付ファイル (複数)
+    
+    Returns:
+        WebhookMessage: 送信されたメッセージ (失敗時はNone)
+    """
+    try:
+        webhook = None
+        target_channel = None
+        
+        # チャンネルタイプに応じて処理を分岐
+        if isinstance(channel, discord.Thread):
+            # スレッドの場合、親チャンネルのWebhookを使用
+            target_channel = channel.parent
+            if not isinstance(target_channel, (discord.TextChannel, discord.VoiceChannel)):
+                print(f"Error: スレッドの親チャンネルが無効です: {target_channel}")
+                return None
+        elif isinstance(channel, discord.VoiceChannel):
+            # VCの場合、VCチャットのWebhookを使用
+            target_channel = channel
+        elif isinstance(channel, discord.TextChannel):
+            # テキストチャンネルの場合
+            target_channel = channel
+        else:
+            print(f"Error: サポートされていないチャンネルタイプです: {type(channel)}")
+            return None
+        
+        # 既存のWebhookを検索
+        webhooks = await target_channel.webhooks()
+        for wh in webhooks:
+            if wh.name == "MPEventBot Webhook":
+                webhook = wh
+                break
+        
+        # Webhookが存在しない場合は新規作成
+        if not webhook:
+            try:
+                webhook = await target_channel.create_webhook(
+                    name="MPEventBot Webhook",
+                    reason="MPEventBot用のWebhook"
+                )
+                print(f"新しいWebhookを作成しました: {target_channel.name}")
+            except discord.Forbidden:
+                print(f"Error: Webhook作成権限がありません: {target_channel.name}")
+                return None
+            except discord.HTTPException as e:
+                print(f"Error: Webhook作成に失敗しました: {e}")
+                return None
+        
+        # メッセージ送信の準備
+        kwargs = {
+            "username": username,
+            "wait": True  # 送信されたメッセージを取得するため
+        }
+        
+        if avatar_url:
+            kwargs["avatar_url"] = avatar_url
+        
+        if content:
+            kwargs["content"] = content
+        
+        if embed:
+            kwargs["embed"] = embed
+        elif embeds:
+            kwargs["embeds"] = embeds
+        
+        if file:
+            kwargs["file"] = file
+        elif files:
+            kwargs["files"] = files
+        
+        # スレッドの場合はthread_idを指定
+        if isinstance(channel, discord.Thread):
+            kwargs["thread"] = channel
+        
+        # メッセージ送信
+        message = await webhook.send(**kwargs)
+        print(f"Webhookメッセージを送信しました: {target_channel.name}")
+        return message
+        
+    except discord.Forbidden:
+        print(f"Error: 権限が不足しています: {channel.name if hasattr(channel, 'name') else channel}")
+        return None
+    except discord.HTTPException as e:
+        print(f"Error: HTTP例外が発生しました: {e}")
+        return None
+    except Exception as e:
+        print(f"Error: 予期しないエラーが発生しました: {e}")
+        traceback.print_exc()
+        return None
+
+async def send_webhook_message_simple(
+    channel: Union[discord.TextChannel, discord.VoiceChannel, discord.Thread],
+    content: str,
+    username: str = "MPEventBot",
+    avatar_url: str = None
+) -> Optional[discord.WebhookMessage]:
+    """
+    シンプルなWebhookメッセージ送信 (テキストのみ)
+    
+    Args:
+        channel: 送信先チャンネル
+        content: メッセージ内容
+        username: Webhookの表示名
+        avatar_url: Webhookのアイコン画像URL
+    
+    Returns:
+        WebhookMessage: 送信されたメッセージ (失敗時はNone)
+    """
+    return await send_webhook_message(
+        channel=channel,
+        content=content,
+        username=username,
+        avatar_url=avatar_url
+    )
+
+async def send_webhook_embed(
+    channel: Union[discord.TextChannel, discord.VoiceChannel, discord.Thread],
+    embed: discord.Embed,
+    username: str = "MPEventBot",
+    avatar_url: str = None
+) -> Optional[discord.WebhookMessage]:
+    """
+    Embed付きWebhookメッセージ送信
+    
+    Args:
+        channel: 送信先チャンネル
+        embed: 埋め込み
+        username: Webhookの表示名
+        avatar_url: Webhookのアイコン画像URL
+    
+    Returns:
+        WebhookMessage: 送信されたメッセージ (失敗時はNone)
+    """
+    return await send_webhook_message(
+        channel=channel,
+        embed=embed,
+        username=username,
+        avatar_url=avatar_url
+    )
+
+async def send_webhook_file(
+    channel: Union[discord.TextChannel, discord.VoiceChannel, discord.Thread],
+    file: discord.File,
+    content: str = None,
+    username: str = "MPEventBot",
+    avatar_url: str = None
+) -> Optional[discord.WebhookMessage]:
+    """
+    ファイル付きWebhookメッセージ送信
+    
+    Args:
+        channel: 送信先チャンネル
+        file: 添付ファイル
+        content: メッセージ内容 (オプション)
+        username: Webhookの表示名
+        avatar_url: Webhookのアイコン画像URL
+    
+    Returns:
+        WebhookMessage: 送信されたメッセージ (失敗時はNone)
+    """
+    return await send_webhook_message(
+        channel=channel,
+        content=content,
+        file=file,
+        username=username,
+        avatar_url=avatar_url
+    )
+
+# 使用例
+"""
+# テキストチャンネルに送信
+channel = bot.get_channel(channel_id)
+await send_webhook_message_simple(
+    channel=channel,
+    content="こんにちは！",
+    username="カスタムBot",
+    avatar_url="https://example.com/avatar.png"
+)
+
+# VCチャットに送信
+vc = bot.get_channel(vc_id)
+await send_webhook_message_simple(
+    channel=vc,
+    content="VCチャットメッセージ",
+    username="VC Bot"
+)
+
+# スレッドに送信
+thread = channel.get_thread(thread_id)
+await send_webhook_message_simple(
+    channel=thread,
+    content="スレッドメッセージ",
+    username="Thread Bot"
+)
+
+# Embed付きで送信
+embed = discord.Embed(title="タイトル", description="説明", color=0x00ff00)
+await send_webhook_embed(
+    channel=channel,
+    embed=embed,
+    username="Embed Bot",
+    avatar_url="https://example.com/avatar.png"
+)
+
+# ファイル付きで送信
+file = discord.File("path/to/file.txt")
+await send_webhook_file(
+    channel=channel,
+    file=file,
+    content="ファイルを送信します",
+    username="File Bot"
+)
+"""

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.2
+Name: discord-py-help-lib
+Version: 0.0.1
+Summary: A library to assist with Discord.py development
+Home-page: https://github.com/hashimotok-ecsv/discord-py-help-lib
+Download-URL: https://github.com/hashimotok-ecsv/discord-py-help-lib
+Author: hashimotok
+Author-email: contact@hashimotok.dev
+License: MIT
+Project-URL: Documentation, https://discord-py-help-lib.readthedocs.io/
+Project-URL: Source, https://github.com/hashimotok-ecsv/discord-py-help-lib
+Project-URL: Tracker, https://github.com/hashimotok-ecsv/discord-py-help-lib/issues
+Keywords: discord.py help library
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord.py>=2.5.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Auxiliary for discord.py Library
+
+![PyPI version](https://img.shields.io/pypi/v/discord-py-auxiliary-lib.svg)
+![Python version](https://img.shields.io/pypi/pyversions/discord-py-auxiliary-lib.svg)
+![License](https://img.shields.io/pypi/l/discord-py-auxiliary-lib.svg)
+
+---
+
+## 📦 概要
+
+`discord-py-auxiliary-lib` は、discord.pyで役職パネルを簡単に実装するための Python ライブラリです。
+
+主な機能は以下のとおりです：
+
+- 後日更新
+
+---
+
+## ✨ 特徴
+
+- ✅ 簡単に使用が可能
+
+---
+
+## 🔧 インストール
+
+### PyPIからインストール：
+```bash
+pip install discord-py-auxiliary-lib
+```
+### githubからインストール：
+```bash
+pip install git+https://github.com/hashimotok-ecsv/discord_py_auxiliary_lib.git
+```
+## 使い方
+```python
+# 後日更新
+```
+#### 管理者用
+##### 更新方法
+```bash
+py setup.py sdist
+py setup.py bdist_wheel
+py -m twine upload --repository testpypi dist/*
+py -m twine upload --repository pypi dist/*
+```

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+setup.py
+discord_py_help_lib/__init__.py
+discord_py_help_lib/webhook_sender.py
+discord_py_help_lib.egg-info/PKG-INFO
+discord_py_help_lib.egg-info/SOURCES.txt
+discord_py_help_lib.egg-info/dependency_links.txt
+discord_py_help_lib.egg-info/entry_points.txt
+discord_py_help_lib.egg-info/not-zip-safe
+discord_py_help_lib.egg-info/requires.txt
+discord_py_help_lib.egg-info/top_level.txt
+discord_py_help_lib/select/category_select.py
+discord_py_help_lib/select/role_select.py
+discord_py_help_lib/select/vc_select.py

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+discord-py-help-lib = discord_py_help_lib.__main__:main

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/requires.txt

@@ -0,0 +1 @@
+discord.py>=2.5.2

discord_py_help_lib-0.0.1/discord_py_help_lib.egg-info/top_level.txt

@@ -0,0 +1 @@
+discord_py_help_lib

discord_py_help_lib-0.0.1/setup.cfg

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

discord_py_help_lib-0.0.1/setup.py

@@ -0,0 +1,77 @@
+from setuptools import setup
+import re
+
+def derive_version() -> str:
+    version = ''
+    with open('discord_py_help_lib/__init__.py', encoding='utf-8') as f:
+        version = re.search(r'^__version__\s*=\s*[\'"]([^\'"]*)[\'"]', f.read(), re.MULTILINE).group(1)
+
+    if not version:
+        raise RuntimeError('version is not set')
+
+    if version.endswith(('a', 'b', 'rc')):
+        # append version identifier based on commit count
+        try:
+            import subprocess
+
+            p = subprocess.Popen(['git', 'rev-list', '--count', 'HEAD'], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+            out, err = p.communicate()
+            if out:
+                version += out.decode('utf-8').strip()
+            p = subprocess.Popen(['git', 'rev-parse', '--short', 'HEAD'], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+            out, err = p.communicate()
+            if out:
+                version += '+g' + out.decode('utf-8').strip()
+        except Exception:
+            pass
+
+    return version
+
+NAME='discord-py-help-lib'
+
+PACKAGES = [
+    'discord_py_help_lib',
+    'discord_py_help_lib.select'
+]
+
+setup(
+    name=NAME,
+    version=derive_version(),
+    packages=PACKAGES,
+    install_requires=[
+        'discord.py>=2.5.2',
+        # Add other dependencies here
+    ],
+    author='hashimotok',
+    author_email='contact@hashimotok.dev',
+    url=f'https://github.com/hashimotok-ecsv/{NAME}',
+    download_url=f'https://github.com/hashimotok-ecsv/{NAME}',
+    python_requires=">=3.10.6",
+    description='A library to assist with Discord.py development',
+    long_description=open('README.md', encoding='utf-8').read(),
+    long_description_content_type='text/markdown',
+    classifiers=[
+        'Development Status :: 5 - Production/Stable',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Operating System :: OS Independent',
+    ],
+    keywords='discord.py help library',
+    include_package_data=True,
+    zip_safe=False,
+    entry_points={
+        'console_scripts': [
+            'discord-py-help-lib=discord_py_help_lib.__main__:main',
+        ],
+    },
+    project_urls={
+        'Documentation': f'https://{NAME}.readthedocs.io/',
+        'Source': f'https://github.com/hashimotok-ecsv/{NAME}',
+        'Tracker': f'https://github.com/hashimotok-ecsv/{NAME}/issues',
+    },
+    license='MIT',
+    license_files=('LICENSE',),
+)