feat: add guild configuration command

.pre-commit-config.yaml

@@ -18,7 +18,7 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.2.2"
+    rev: "v0.3.2"
     hooks:
       - id: ruff
         args: ["--fix"]
@@ -88,7 +88,7 @@ repos:
   #             discord-py,
   #           ]
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.351
+    rev: v1.1.353
     hooks:
       - id: pyright
         additional_dependencies:
@@ -142,6 +142,7 @@ repos:
             asyncpg-stubs,
             polyfactory,
             discord-py,
+            types-python-dateutil,
           ]
   - repo: https://github.com/sphinx-contrib/sphinx-lint
     rev: "v0.9.1"

docs/conf.py

@@ -1,4 +1,5 @@
 """Sphinx configuration."""
+
 from __future__ import annotations
 
 import importlib.metadata

pyproject.toml

@@ -15,11 +15,11 @@ dependencies = [
     "advanced-alchemy>=0.6.1",
     "certifi>=2023.11.17",
     "asyncpg>=0.29.0",
-    "githubkit[auth-app] @ git+https://github.com/yanyongyu/githubkit.git",
     "PyJWT>=2.8.0",
     "alembic>=1.13.0",
     "pre-commit>=3.6.2",
     "ruff>=0.1.7",
+    "githubkit[auth-app]>=0.11.2",
 ]
 requires-python = ">=3.11,<4.0"
 readme = "README.md"
@@ -82,7 +82,7 @@ changelog = "git cliff -c pyproject.toml -o docs/changelog.rst"
 # TODO: Move more from makefile here
 ci = { composite = ["lint", "test"] }
 
-[tool.pdm.dev-dependencies]
+[project.optional-dependencies]
 test = [
     "pytest>=7.4.3",
     "coverage>=7.3.2",

src/__init__.py

@@ -1,4 +1,5 @@
 """Byte Bot."""
+
 from __future__ import annotations
 
 from rich import get_console

src/__main__.py

@@ -1,4 +1,5 @@
 """Application Entrypoint."""
+
 from __future__ import annotations
 
 __all__ = ("run_cli",)

src/app.py

@@ -1,4 +1,5 @@
 """ASGI application factory."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

src/byte/__init__.py

@@ -1,4 +1,5 @@
 """Byte Bot Bot."""
+
 from __future__ import annotations
 
 from byte import bot, lib, plugins, views

src/byte/bot.py

@@ -1,4 +1,5 @@
 """Byte Bot."""
+
 from __future__ import annotations
 
 import contextlib

src/byte/lib/__init__.py

@@ -1,10 +1,11 @@
 """Byte library module."""
 
-from byte.lib import common, log, settings, utils
+from byte.lib import common, log, settings, types, utils
 
 __all__ = [
     "settings",
     "utils",
     "log",
     "common",
+    "types",
 ]

src/byte/lib/checks.py

@@ -0,0 +1,65 @@
+""":doc:`Checks <discord.py:Checks>` for Byte."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from discord.ext.commands import CheckFailure, Context, check
+
+from byte.lib import settings
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from discord.ext.commands._types import Check
+
+__all__ = ("is_byte_dev", "is_guild_admin")
+
+
+def is_guild_admin() -> Callable[[Context], Check]:
+    """Check if the user is a guild admin.
+
+    Returns:
+        A check function.
+    """
+
+    async def predicate(ctx: Context) -> bool:
+        """Check if the user is a guild admin.
+
+        Args:
+            ctx: Context object.
+
+        Returns:
+            True if the user is a guild admin, False otherwise.
+        """
+        if not (member := ctx.guild.get_member(ctx.author.id)):
+            msg = "Member not found in the guild."
+            raise CheckFailure(msg)
+        return member.guild_permissions.administrator
+
+    return check(predicate)
+
+
+def is_byte_dev() -> Callable[[Context], Check]:
+    """Determines if the user is a Byte developer or owner.
+
+    Returns:
+        A check function.
+    """
+
+    async def predicate(ctx: Context) -> bool:
+        """Check if the user is a Byte developer or owner.
+
+        Args:
+            ctx: Context object.
+
+        Returns:
+            True if the user is a Byte developer or owner, False otherwise.
+        """
+        return (
+            await ctx.bot.is_owner(ctx.author)
+            or ctx.author.id == settings.discord.DEV_USER_ID
+            or any(role.name == "byte-dev" for role in ctx.author.roles)
+        )
+
+    return check(predicate)

src/byte/lib/common/__init__.py

@@ -3,11 +3,55 @@
 .. todo:: temporary, these are not multi-guild friendly.
 """
 
-from byte.lib.common import assets, colors, guilds, links
+from typing import Any
+
+from byte.lib.common import assets, colors, guilds, links, mention
 
 __all__ = (
     "assets",
     "colors",
     "guilds",
     "links",
+    "config_options",
+    "mention",
 )
+
+config_options: list[dict[str, Any]] = [
+    {
+        "label": "Server Settings",
+        "description": "Configure overall server settings",
+        "sub_settings": [
+            {"label": "Prefix", "field": "prefix", "data_type": "String"},
+            {"label": "Help Channel ID", "field": "help_channel_id", "data_type": "Integer"},
+            {"label": "Sync Label", "field": "sync_label", "data_type": "String"},
+            {"label": "Issue Linking", "field": "issue_linking", "data_type": "True/False"},
+            {"label": "Comment Linking", "field": "comment_linking", "data_type": "True/False"},
+            {"label": "PEP Linking", "field": "pep_linking", "data_type": "True/False"},
+        ],
+    },
+    {
+        "label": "GitHub Settings",
+        "description": "Configure GitHub settings",
+        "sub_settings": [
+            {"label": "Discussion Sync", "field": "discussion_sync", "data_type": "True/False"},
+            {"label": "GitHub Organization", "field": "github_organization", "data_type": "String"},
+            {"label": "GitHub Repository", "field": "github_repository", "data_type": "String"},
+        ],
+    },
+    {
+        "label": "StackOverflow Settings",
+        "description": "Configure StackOverflow settings",
+        "sub_settings": [
+            {"label": "Tag Name", "field": "tag_name", "data_type": "Comma-Separated String"},
+        ],
+    },
+    {
+        "label": "Allowed Users",
+        "description": "Configure allowed users",
+        "sub_settings": [
+            {"label": "User ID", "field": "user_id", "data_type": "Integer"},
+        ],
+    },
+    # Forum Settings: Configure help and showcase forum settings
+    # Byte Settings: Configure meta-level Byte features
+]

src/byte/lib/common/assets.py

@@ -2,6 +2,7 @@
 
 .. todo:: temporary, these are not multi-guild friendly.
 """
+
 from typing import Final
 
 # --- Assets

src/byte/lib/common/colors.py

@@ -2,6 +2,7 @@
 
 .. todo:: temporary, these are not multi-guild friendly.
 """
+
 from typing import Final
 
 # --- Colors

src/byte/lib/common/guilds.py

@@ -2,6 +2,7 @@
 
 .. todo:: temporary, these are not multi-guild friendly.
 """
+
 from typing import Final
 
 # --- Channel IDs

src/byte/lib/common/links.py

@@ -2,6 +2,7 @@
 
 .. todo:: temporary, these are not multi-guild friendly.
 """
+
 from typing import Final
 
 # --- Links