SeaCogs/aurora/utilities/factory.py

582 lines
22 KiB
Python
Raw Permalink Normal View History

2024-02-28 10:58:57 -05:00
# pylint: disable=cyclic-import
2024-01-08 04:18:54 -05:00
from datetime import datetime, timedelta
2024-02-02 11:21:56 -05:00
from typing import Union
2024-01-08 04:18:54 -05:00
import humanize
from discord import Color, Embed, Guild, Member, Message, Role, User
from redbot.core import commands
2024-02-02 11:21:56 -05:00
from redbot.core.utils.chat_formatting import bold, box, error, warning
2024-01-08 04:18:54 -05:00
from aurora.utilities.config import config
from aurora.utilities.utils import (fetch_channel_dict, fetch_user_dict,
get_bool_emoji, get_next_case_number,
get_pagesize_str)
2024-02-02 11:21:56 -05:00
async def message_factory(
color: Color,
guild: Guild,
reason: str,
moderation_type: str,
moderator: Union[Member, User] = None,
duration: timedelta = None,
response: Message = None,
role: Role = None,
2024-02-02 11:21:56 -05:00
) -> Embed:
2024-01-08 04:18:54 -05:00
"""This function creates a message from set parameters, meant for contacting the moderated user.
Args:
color (Color): The color of the embed.
guild (Guild): The guild the moderation occurred in.
reason (str): The reason for the moderation.
moderation_type (str): The type of moderation.
moderator (Union[Member, User], optional): The moderator who performed the moderation. Defaults to None.
duration (timedelta, optional): The duration of the moderation. Defaults to None.
response (Message, optional): The response message. Defaults to None.
role (Role, optional): The role that was added or removed. Defaults to None.
2024-01-08 04:18:54 -05:00
Returns:
embed: The message embed.
"""
2024-02-14 10:39:26 -05:00
if response is not None and moderation_type not in [
2024-02-02 11:21:56 -05:00
"kicked",
"banned",
"tempbanned",
"unbanned",
]:
2024-01-08 04:18:54 -05:00
guild_name = f"[{guild.name}]({response.jump_url})"
else:
guild_name = guild.name
if moderation_type in ["tempbanned", "muted"] and duration:
embed_duration = f" for {humanize.precisedelta(duration)}"
else:
embed_duration = ""
if moderation_type == "note":
embed_desc = "received a"
elif moderation_type == "addrole":
embed_desc = f"received the {role.name} role"
elif moderation_type == "removerole":
embed_desc = f"lost the {role.name} role"
2024-01-08 04:18:54 -05:00
else:
embed_desc = "been"
2024-02-02 11:21:56 -05:00
embed = Embed(
title=str.title(moderation_type),
description=f"You have {embed_desc} {moderation_type}{embed_duration} in {guild_name}.",
color=color,
timestamp=datetime.now(),
)
2024-01-08 04:18:54 -05:00
if await config.guild(guild).show_moderator() and moderator is not None:
2024-02-02 11:21:56 -05:00
embed.add_field(
name="Moderator", value=f"`{moderator.name} ({moderator.id})`", inline=False
)
2024-01-08 04:18:54 -05:00
2024-02-02 11:21:56 -05:00
embed.add_field(name="Reason", value=f"`{reason}`", inline=False)
2024-01-08 04:18:54 -05:00
if guild.icon.url is not None:
embed.set_author(name=guild.name, icon_url=guild.icon.url)
else:
embed.set_author(name=guild.name)
2024-02-02 11:21:56 -05:00
embed.set_footer(
text=f"Case #{await get_next_case_number(guild.id):,}",
icon_url="https://cdn.discordapp.com/attachments/1070822161389994054/1159469476773904414/arrow-right-circle-icon-512x512-2p1e2aaw.png?ex=65312319&is=651eae19&hm=3cebdd28e805c13a79ec48ef87c32ca532ffa6b9ede2e48d0cf8e5e81f3a6818&",
)
2024-01-08 04:18:54 -05:00
return embed
2024-02-02 11:21:56 -05:00
async def log_factory(
ctx: commands.Context, case_dict: dict, resolved: bool = False
2024-02-02 11:21:56 -05:00
) -> Embed:
2024-01-08 04:18:54 -05:00
"""This function creates a log embed from set parameters, meant for moderation logging.
Args:
interaction (Interaction): The interaction object.
case_dict (dict): The case dictionary.
resolved (bool, optional): Whether the case is resolved or not. Defaults to False.
"""
if resolved:
2024-02-02 11:21:56 -05:00
if case_dict["target_type"] == "USER":
target_user = await fetch_user_dict(ctx.bot, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
target_name = (
f"`{target_user['name']}`"
if target_user["discriminator"] == "0"
else f"`{target_user['name']}#{target_user['discriminator']}`"
)
elif case_dict["target_type"] == "CHANNEL":
target_user = await fetch_channel_dict(ctx.guild, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
if target_user["mention"]:
2024-01-08 04:18:54 -05:00
target_name = f"{target_user['mention']}"
else:
target_name = f"`{target_user['name']}`"
moderator_user = await fetch_user_dict(ctx.bot, case_dict["moderator_id"])
2024-02-02 11:21:56 -05:00
moderator_name = (
f"`{moderator_user['name']}`"
if moderator_user["discriminator"] == "0"
else f"`{moderator_user['name']}#{moderator_user['discriminator']}`"
)
2024-01-08 04:18:54 -05:00
2024-02-02 11:21:56 -05:00
embed = Embed(
title=f"📕 Case #{case_dict['moderation_id']:,} Resolved",
color=await ctx.client.get_embed_color(ctx.channel),
2024-02-02 11:21:56 -05:00
)
2024-01-08 04:18:54 -05:00
embed.description = f"**Type:** {str.title(case_dict['moderation_type'])}\n**Target:** {target_name} ({target_user['id']})\n**Moderator:** {moderator_name} ({moderator_user['id']})\n**Timestamp:** <t:{case_dict['timestamp']}> | <t:{case_dict['timestamp']}:R>"
2024-02-02 11:21:56 -05:00
if case_dict["duration"] != "NULL":
td = timedelta(
**{
unit: int(val)
for unit, val in zip(
["hours", "minutes", "seconds"],
case_dict["duration"].split(":"),
)
}
)
duration_embed = (
f"{humanize.precisedelta(td)} | <t:{case_dict['end_timestamp']}:R>"
if case_dict["expired"] == "0"
else str(humanize.precisedelta(td))
)
embed.description = (
embed.description
+ f"\n**Duration:** {duration_embed}\n**Expired:** {bool(case_dict['expired'])}"
)
embed.add_field(name="Reason", value=box(case_dict["reason"]), inline=False)
resolved_user = await fetch_user_dict(ctx.bot, case_dict["resolved_by"])
2024-02-02 11:21:56 -05:00
resolved_name = (
resolved_user["name"]
if resolved_user["discriminator"] == "0"
else f"{resolved_user['name']}#{resolved_user['discriminator']}"
)
embed.add_field(
name="Resolve Reason",
value=f"Resolved by `{resolved_name}` ({resolved_user['id']}) for:\n"
+ box(case_dict["resolve_reason"]),
inline=False,
)
2024-01-08 04:18:54 -05:00
else:
2024-02-02 11:21:56 -05:00
if case_dict["target_type"] == "USER":
target_user = await fetch_user_dict(ctx.bot, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
target_name = (
f"`{target_user['name']}`"
if target_user["discriminator"] == "0"
else f"`{target_user['name']}#{target_user['discriminator']}`"
)
elif case_dict["target_type"] == "CHANNEL":
target_user = await fetch_channel_dict(ctx.guild, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
if target_user["mention"]:
target_name = target_user["mention"]
2024-01-08 04:18:54 -05:00
else:
target_name = f"`{target_user['name']}`"
moderator_user = await fetch_user_dict(ctx.bot, case_dict["moderator_id"])
2024-02-02 11:21:56 -05:00
moderator_name = (
f"`{moderator_user['name']}`"
if moderator_user["discriminator"] == "0"
else f"`{moderator_user['name']}#{moderator_user['discriminator']}`"
)
embed = Embed(
title=f"📕 Case #{case_dict['moderation_id']:,}",
color=await ctx.bot.get_embed_color(ctx.channel),
2024-02-02 11:21:56 -05:00
)
2024-01-08 04:18:54 -05:00
embed.description = f"**Type:** {str.title(case_dict['moderation_type'])}\n**Target:** {target_name} ({target_user['id']})\n**Moderator:** {moderator_name} ({moderator_user['id']})\n**Timestamp:** <t:{case_dict['timestamp']}> | <t:{case_dict['timestamp']}:R>"
2024-02-02 11:21:56 -05:00
if case_dict["duration"] != "NULL":
td = timedelta(
**{
unit: int(val)
for unit, val in zip(
["hours", "minutes", "seconds"],
case_dict["duration"].split(":"),
)
}
)
embed.description = (
embed.description
+ f"\n**Duration:** {humanize.precisedelta(td)} | <t:{case_dict['end_timestamp']}:R>"
)
embed.add_field(name="Reason", value=box(case_dict["reason"]), inline=False)
2024-01-08 04:18:54 -05:00
return embed
2024-02-02 11:21:56 -05:00
async def case_factory(ctx: commands.Context, case_dict: dict) -> Embed:
2024-01-08 04:18:54 -05:00
"""This function creates a case embed from set parameters.
Args:
ctx (commands.Context): The context object.
2024-01-08 04:18:54 -05:00
case_dict (dict): The case dictionary.
"""
2024-02-02 11:21:56 -05:00
if case_dict["target_type"] == "USER":
target_user = await fetch_user_dict(ctx.bot, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
target_name = (
f"`{target_user['name']}`"
if target_user["discriminator"] == "0"
else f"`{target_user['name']}#{target_user['discriminator']}`"
)
elif case_dict["target_type"] == "CHANNEL":
target_user = await fetch_channel_dict(ctx.guild, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
if target_user["mention"]:
2024-01-08 04:18:54 -05:00
target_name = f"{target_user['mention']}"
else:
target_name = f"`{target_user['name']}`"
moderator_user = await fetch_user_dict(ctx.bot, case_dict["moderator_id"])
2024-02-02 11:21:56 -05:00
moderator_name = (
f"`{moderator_user['name']}`"
if moderator_user["discriminator"] == "0"
else f"`{moderator_user['name']}#{moderator_user['discriminator']}`"
)
2024-01-08 04:18:54 -05:00
2024-02-02 11:21:56 -05:00
embed = Embed(
title=f"📕 Case #{case_dict['moderation_id']:,}",
color=await ctx.bot.get_embed_color(ctx.channel),
2024-02-02 11:21:56 -05:00
)
2024-01-08 04:18:54 -05:00
embed.description = f"**Type:** {str.title(case_dict['moderation_type'])}\n**Target:** {target_name} ({target_user['id']})\n**Moderator:** {moderator_name} ({moderator_user['id']})\n**Resolved:** {bool(case_dict['resolved'])}\n**Timestamp:** <t:{case_dict['timestamp']}> | <t:{case_dict['timestamp']}:R>"
2024-02-02 11:21:56 -05:00
if case_dict["duration"] != "NULL":
td = timedelta(
**{
unit: int(val)
for unit, val in zip(
["hours", "minutes", "seconds"], case_dict["duration"].split(":")
)
}
)
duration_embed = (
f"{humanize.precisedelta(td)} | <t:{case_dict['end_timestamp']}:R>"
if bool(case_dict["expired"]) is False
else str(humanize.precisedelta(td))
)
2024-01-08 04:18:54 -05:00
embed.description += f"\n**Duration:** {duration_embed}\n**Expired:** {bool(case_dict['expired'])}"
2024-02-02 11:21:56 -05:00
embed.description += (
f"\n**Changes:** {len(case_dict['changes']) - 1}"
if case_dict["changes"]
else "\n**Changes:** 0"
)
2024-01-08 04:18:54 -05:00
2024-02-02 11:21:56 -05:00
if case_dict["metadata"]:
if case_dict["metadata"]["imported_from"]:
embed.description += (
f"\n**Imported From:** {case_dict['metadata']['imported_from']}"
)
embed.add_field(name="Reason", value=box(case_dict["reason"]), inline=False)
if case_dict["resolved"] == 1:
resolved_user = await fetch_user_dict(ctx.bot, case_dict["resolved_by"])
2024-02-02 11:21:56 -05:00
resolved_name = (
f"`{resolved_user['name']}`"
if resolved_user["discriminator"] == "0"
else f"`{resolved_user['name']}#{resolved_user['discriminator']}`"
)
embed.add_field(
name="Resolve Reason",
value=f"Resolved by {resolved_name} ({resolved_user['id']}) for:\n{box(case_dict['resolve_reason'])}",
inline=False,
)
2024-01-08 04:18:54 -05:00
return embed
2024-02-02 11:21:56 -05:00
async def changes_factory(ctx: commands.Context, case_dict: dict) -> Embed:
2024-01-08 04:18:54 -05:00
"""This function creates a changes embed from set parameters.
Args:
ctx (commands.Context): The context object.
2024-01-08 04:18:54 -05:00
case_dict (dict): The case dictionary.
"""
2024-02-02 11:21:56 -05:00
embed = Embed(
title=f"📕 Case #{case_dict['moderation_id']:,} Changes",
color=await ctx.bot.get_embed_color(ctx.channel),
2024-02-02 11:21:56 -05:00
)
2024-01-08 04:18:54 -05:00
memory_dict = {}
2024-02-02 11:21:56 -05:00
if case_dict["changes"]:
for change in case_dict["changes"]:
if change["user_id"] not in memory_dict:
memory_dict[str(change["user_id"])] = await fetch_user_dict(
ctx.bot, change["user_id"]
2024-02-02 11:21:56 -05:00
)
2024-01-08 04:18:54 -05:00
2024-02-02 11:21:56 -05:00
user = memory_dict[str(change["user_id"])]
name = (
user["name"]
if user["discriminator"] == "0"
else f"{user['name']}#{user['discriminator']}"
)
2024-01-08 04:18:54 -05:00
timestamp = f"<t:{change['timestamp']}> | <t:{change['timestamp']}:R>"
2024-02-02 11:21:56 -05:00
if change["type"] == "ORIGINAL":
embed.add_field(
name="Original",
value=f"**User:** `{name}` ({user['id']})\n**Reason:** {change['reason']}\n**Timestamp:** {timestamp}",
inline=False,
)
elif change["type"] == "EDIT":
embed.add_field(
name="Edit",
value=f"**User:** `{name}` ({user['id']})\n**Reason:** {change['reason']}\n**Timestamp:** {timestamp}",
inline=False,
)
elif change["type"] == "RESOLVE":
embed.add_field(
name="Resolve",
value=f"**User:** `{name}` ({user['id']})\n**Reason:** {change['reason']}\n**Timestamp:** {timestamp}",
inline=False,
)
2024-01-08 04:18:54 -05:00
else:
embed.description = "*No changes have been made to this case.* 🙁"
return embed
2024-02-02 11:21:56 -05:00
async def evidenceformat_factory(ctx: commands.Context, case_dict: dict) -> str:
2024-01-08 04:18:54 -05:00
"""This function creates a codeblock in evidence format from set parameters.
Args:
interaction (Interaction): The interaction object.
case_dict (dict): The case dictionary.
"""
2024-02-02 11:21:56 -05:00
if case_dict["target_type"] == "USER":
target_user = await fetch_user_dict(ctx.bot, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
target_name = (
target_user["name"]
if target_user["discriminator"] == "0"
else f"{target_user['name']}#{target_user['discriminator']}"
)
elif case_dict["target_type"] == "CHANNEL":
target_user = await fetch_channel_dict(ctx.guild, case_dict["target_id"])
2024-02-02 11:21:56 -05:00
target_name = target_user["name"]
moderator_user = await fetch_user_dict(ctx.bot, case_dict["moderator_id"])
2024-02-02 11:21:56 -05:00
moderator_name = (
moderator_user["name"]
if moderator_user["discriminator"] == "0"
else f"{moderator_user['name']}#{moderator_user['discriminator']}"
)
2024-01-08 04:18:54 -05:00
content = f"Case: {case_dict['moderation_id']:,} ({str.title(case_dict['moderation_type'])})\nTarget: {target_name} ({target_user['id']})\nModerator: {moderator_name} ({moderator_user['id']})"
2024-02-02 11:21:56 -05:00
if case_dict["duration"] != "NULL":
hours, minutes, seconds = map(int, case_dict["duration"].split(":"))
2024-01-08 04:18:54 -05:00
td = timedelta(hours=hours, minutes=minutes, seconds=seconds)
content += f"\nDuration: {humanize.precisedelta(td)}"
content += f"\nReason: {case_dict['reason']}"
2024-02-02 11:21:56 -05:00
return box(content, "prolog")
########################################################################################################################
### Configuration Embeds #
########################################################################################################################
2024-02-02 11:21:56 -05:00
2024-01-16 09:26:54 -05:00
async def _config(ctx: commands.Context) -> Embed:
"""Generates the core embed for configuration menus to use."""
2024-02-02 11:21:56 -05:00
e = Embed(title="Aurora Configuration Menu", color=await ctx.embed_color())
e.set_thumbnail(url=ctx.bot.user.display_avatar.url)
return e
2024-02-02 11:21:56 -05:00
2024-01-16 09:26:54 -05:00
async def overrides_embed(ctx: commands.Context) -> Embed:
"""Generates a configuration menu embed for a user's overrides."""
override_settings = {
"ephemeral": await config.user(ctx.author).history_ephemeral(),
"inline": await config.user(ctx.author).history_inline(),
"inline_pagesize": await config.user(ctx.author).history_inline_pagesize(),
"pagesize": await config.user(ctx.author).history_pagesize(),
2024-02-02 11:21:56 -05:00
"auto_evidenceformat": await config.user(ctx.author).auto_evidenceformat(),
}
override_str = [
2024-02-02 11:21:56 -05:00
"- "
+ bold("Auto Evidence Format: ")
+ get_bool_emoji(override_settings["auto_evidenceformat"]),
"- " + bold("Ephemeral: ") + get_bool_emoji(override_settings["ephemeral"]),
"- " + bold("History Inline: ") + get_bool_emoji(override_settings["inline"]),
"- "
+ bold("History Inline Pagesize: ")
+ get_pagesize_str(override_settings["inline_pagesize"]),
"- "
+ bold("History Pagesize: ")
+ get_pagesize_str(override_settings["pagesize"]),
]
2024-02-02 11:21:56 -05:00
override_str = "\n".join(override_str)
2024-01-16 09:26:54 -05:00
e = await _config(ctx)
e.title += ": User Overrides"
2024-02-02 11:21:56 -05:00
e.description = (
"""
Use the buttons below to manage your user overrides.
These settings will override the relevant guild settings.\n
2024-02-02 11:21:56 -05:00
"""
+ override_str
)
return e
2024-02-02 11:21:56 -05:00
2024-01-16 09:26:54 -05:00
async def guild_embed(ctx: commands.Context) -> Embed:
"""Generates a configuration menu field value for a guild's settings."""
guild_settings = {
"show_moderator": await config.guild(ctx.guild).show_moderator(),
2024-02-02 11:21:56 -05:00
"use_discord_permissions": await config.guild(
ctx.guild
).use_discord_permissions(),
"ignore_modlog": await config.guild(ctx.guild).ignore_modlog(),
"ignore_other_bots": await config.guild(ctx.guild).ignore_other_bots(),
"dm_users": await config.guild(ctx.guild).dm_users(),
"log_channel": await config.guild(ctx.guild).log_channel(),
"history_ephemeral": await config.guild(ctx.guild).history_ephemeral(),
"history_inline": await config.guild(ctx.guild).history_inline(),
"history_pagesize": await config.guild(ctx.guild).history_pagesize(),
2024-02-02 11:21:56 -05:00
"history_inline_pagesize": await config.guild(
ctx.guild
).history_inline_pagesize(),
"auto_evidenceformat": await config.guild(ctx.guild).auto_evidenceformat(),
}
2024-02-02 11:21:56 -05:00
channel = ctx.guild.get_channel(guild_settings["log_channel"])
if channel is None:
channel = warning("Not Set")
else:
channel = channel.mention
guild_str = [
2024-02-02 11:21:56 -05:00
"- "
+ bold("Show Moderator: ")
+ get_bool_emoji(guild_settings["show_moderator"]),
"- "
+ bold("Use Discord Permissions: ")
+ get_bool_emoji(guild_settings["use_discord_permissions"]),
"- "
+ bold("Ignore Modlog: ")
+ get_bool_emoji(guild_settings["ignore_modlog"]),
"- "
+ bold("Ignore Other Bots: ")
+ get_bool_emoji(guild_settings["ignore_other_bots"]),
"- " + bold("DM Users: ") + get_bool_emoji(guild_settings["dm_users"]),
"- "
+ bold("Auto Evidence Format: ")
+ get_bool_emoji(guild_settings["auto_evidenceformat"]),
"- "
+ bold("Ephemeral: ")
+ get_bool_emoji(guild_settings["history_ephemeral"]),
"- "
+ bold("History Inline: ")
+ get_bool_emoji(guild_settings["history_inline"]),
"- "
+ bold("History Pagesize: ")
+ get_pagesize_str(guild_settings["history_pagesize"]),
"- "
+ bold("History Inline Pagesize: ")
+ get_pagesize_str(guild_settings["history_inline_pagesize"]),
"- " + bold("Log Channel: ") + channel,
]
2024-02-02 11:21:56 -05:00
guild_str = "\n".join(guild_str)
2024-01-16 09:26:54 -05:00
e = await _config(ctx)
e.title += ": Server Configuration"
2024-02-02 11:21:56 -05:00
e.description = (
"""
Use the buttons below to manage Aurora's server configuration.\n
2024-02-02 11:21:56 -05:00
"""
+ guild_str
)
return e
2024-02-02 11:21:56 -05:00
2024-01-16 09:26:54 -05:00
async def addrole_embed(ctx: commands.Context) -> Embed:
"""Generates a configuration menu field value for a guild's addrole whitelist."""
whitelist = await config.guild(ctx.guild).addrole_whitelist()
if whitelist:
2024-02-02 11:21:56 -05:00
whitelist = [
ctx.guild.get_role(role).mention or error(f"`{role}` (Not Found)")
for role in whitelist
]
whitelist = "\n".join(whitelist)
else:
whitelist = warning("No roles are on the addrole whitelist!")
2024-01-16 09:26:54 -05:00
e = await _config(ctx)
e.title += ": Addrole Whitelist"
2024-02-02 11:21:56 -05:00
e.description = (
"Use the select menu below to manage this guild's addrole whitelist."
)
if len(whitelist) > 4000 and len(whitelist) < 5000:
2024-02-02 11:21:56 -05:00
lines = whitelist.split("\n")
chunks = []
chunk = ""
for line in lines:
if len(chunk) + len(line) > 1024:
chunks.append(chunk)
chunk = line
else:
2024-02-02 11:21:56 -05:00
chunk += "\n" + line if chunk else line
chunks.append(chunk)
for chunk in chunks:
e.add_field(name="", value=chunk)
else:
2024-02-02 11:21:56 -05:00
e.description += "\n\n" + whitelist
return e
2024-02-02 11:21:56 -05:00
2024-01-16 09:26:54 -05:00
async def immune_embed(ctx: commands.Context) -> Embed:
"""Generates a configuration menu field value for a guild's immune roles."""
immune_roles = await config.guild(ctx.guild).immune_roles()
if immune_roles:
2024-02-02 11:21:56 -05:00
immune_str = [
ctx.guild.get_role(role).mention or error(f"`{role}` (Not Found)")
for role in immune_roles
]
immune_str = "\n".join(immune_str)
else:
immune_str = warning("No roles are set as immune roles!")
2024-01-16 09:26:54 -05:00
e = await _config(ctx)
e.title += ": Immune Roles"
e.description = "Use the select menu below to manage this guild's immune roles."
if len(immune_str) > 4000 and len(immune_str) < 5000:
2024-02-02 11:21:56 -05:00
lines = immune_str.split("\n")
chunks = []
chunk = ""
for line in lines:
if len(chunk) + len(line) > 1024:
chunks.append(chunk)
chunk = line
else:
2024-02-02 11:21:56 -05:00
chunk += "\n" + line if chunk else line
chunks.append(chunk)
for chunk in chunks:
e.add_field(name="", value=chunk)
else:
2024-02-02 11:21:56 -05:00
e.description += "\n\n" + immune_str
return e