dshellInterpreter 0.2.9__py3-none-any.whl → 0.2.9.2__py3-none-any.whl

Dshell/DISCORD_COMMANDS/dshell_channel.py

@@ -2,9 +2,11 @@ from asyncio import sleep
 from re import search
 from typing import Union
 
-from discord import MISSING, PermissionOverwrite, Member, Role, Message, Thread
+from discord import MISSING, PermissionOverwrite, Member, Role, Message
 from discord.utils import _MissingSentinel
-from discord import NotFound
+
+from .utils.utils_message import utils_get_message
+from .utils.utils_thread import utils_get_thread
 
 __all__ = [
     'dshell_get_channel',
@@ -22,60 +24,6 @@ __all__ = [
     'dshell_edit_thread'
 ]
 
-async def utils_get_message(ctx: Message, message: Union[int, str]) -> Message:
-    """
-    Returns the message object of the specified message ID or link.
-    Message is only available in the same server as the command and in the same channel.
-    If the message is a link, it must be in the format: https://discord.com/channels/{guild_id}/{channel_id}/{message_id}
-    """
-
-    if isinstance(message, int):
-        return await ctx.channel.fetch_message(message)
-
-    elif isinstance(message, str):
-        match = search(r'https://discord\.com/channels/(\d+)/(\d+)/(\d+)', message)
-        if not match:
-            raise Exception("Invalid message link format. Use a valid Discord message link.")
-        guild_id = int(match.group(1))
-        channel_id = int(match.group(2))
-        message_id = int(match.group(3))
-
-        if guild_id != ctx.guild.id:
-            raise Exception("The message must be from the same server as the command !")
-
-        return await ctx.guild.get_channel(channel_id).fetch_message(message_id)
-
-    raise Exception(f"Message must be an integer or a string, not {type(message)} !")
-
-async def utils_get_thread(ctx: Message, thread: Union[int, str]) -> Thread:
-    """
-    Returns the thread object of the specified thread ID or link.
-    Thread is only available in the same server as the command and in the same channel.
-    If the thread is a link, it must be in the format: https://discord.com/channels/{guild_id}/{channel_id}/{message_id}
-    """
-
-    if isinstance(thread, int):
-        return ctx.channel.get_thread(thread)
-
-    elif isinstance(thread, str):
-        match = search(r'https://discord\.com/channels/(\d+)/(\d+)(/\d+)?', thread)
-        if not match:
-            raise Exception("Invalid thread link format. Use a valid Discord thread link.")
-        guild_id = int(match.group(1))
-        message_id = int(match.group(2))
-        channel_id = ctx.channel.id if len(match.groups()) == 3 else ctx.channel.id
-
-        if guild_id != ctx.guild.id:
-            raise Exception("The thread must be from the same server as the command !")
-
-        try:
-            c = await ctx.guild.get_channel(channel_id).fetch_message(message_id)
-            return c.thread
-        except NotFound:
-            raise Exception(f"Thread with ID {message_id} not found in channel {channel_id} !")
-
-    raise Exception(f"Thread must be an integer or a string, not {type(thread)} !")
-
 
 async def dshell_get_channel(ctx: Message, name):
     """
@@ -338,7 +286,7 @@ async def dshell_create_thread_message(ctx: Message,
     if message is None:
         message = ctx.id
 
-    message = await utils_get_message(ctx, message)
+    message = utils_get_message(ctx, message)
 
 
     if not isinstance(name, str):

Dshell/DISCORD_COMMANDS/dshell_member.py

@@ -1,8 +1,9 @@
 from datetime import timedelta, datetime, UTC
 
-from discord import MISSING, Message, Member, Permissions, Role
+from discord import MISSING, Message, Member, Permissions, Role, Embed
 
 __all__ = [
+    "dshell_send_private_message",
     "dshell_ban_member",
     "dshell_unban_member",
     "dshell_kick_member",
@@ -16,6 +17,35 @@ __all__ = [
     "dshell_remove_member_roles"
 ]
 
+async def dshell_send_private_message(ctx: Message, message: str = None, member: int = None, delete: int = None, embeds = None, ):
+    """
+    Sends a private message to a member.
+    If member is None, sends the message to the author of the command.
+    If delete is specified, deletes the message after the specified time in seconds.
+    """
+    if delete is not None and not isinstance(delete, (int, float)):
+        raise Exception(f'Delete parameter must be a number (seconds) or None, not {type(delete)} !')
+
+    member_to_send = ctx.author if member is None else ctx.channel.guild.get_member(member)
+
+    if member_to_send is None:
+        raise Exception(f'Member {member} not found!')
+
+    from .._DshellParser.ast_nodes import ListNode
+
+    if embeds is None:
+        embeds = ListNode([])
+
+    elif isinstance(embeds, Embed):
+        embeds = ListNode([embeds])
+
+    else:
+        raise Exception(f'Embeds must be a list of Embed objects or a single Embed object, not {type(embeds)} !')
+
+    sended_message = await member_to_send.send(message, delete_after=delete, embeds=embeds)
+
+    return sended_message.id
+
 
 async def dshell_ban_member(ctx: Message, member: int, reason: str = MISSING):
     """

Dshell/DISCORD_COMMANDS/dshell_message.py

@@ -3,8 +3,11 @@ from re import search
 from discord import Embed, Message, NotFound
 from discord.ext import commands
 
+from .utils.utils_message import utils_get_message
+
 __all__ = [
     'dshell_send_message',
+    'dshell_respond_message',
     'dshell_delete_message',
     'dshell_purge_message',
     'dshell_edit_message',
@@ -47,13 +50,41 @@ async def dshell_send_message(ctx: Message, message=None, delete=None, channel=N
     return sended_message.id
 
 
+async def dshell_respond_message(ctx: Message, message=None, content: str = None, delete=None, mention: bool = None, embeds=None):
+    """
+    Responds to a message on Discord
+    """
+    if delete is not None and not isinstance(delete, (int, float)):
+        raise Exception(f'Delete parameter must be a number (seconds) or None, not {type(delete)} !')
+
+    respond_message = ctx if message is None else utils_get_message(ctx, message)  # builds a reference to the message (even if it doesn't exist)
+    mention_author = mention if mention is not None else False
+
+    from .._DshellParser.ast_nodes import ListNode
+
+    if embeds is None:
+        embeds = ListNode([])
+
+    elif isinstance(embeds, Embed):
+        embeds = ListNode([embeds])
+
+    else:
+        raise Exception(f'Embeds must be a list of Embed objects or a single Embed object, not {type(embeds)} !')
+
+    sended_message = await ctx.reply(reference=respond_message,
+                                     content=content,
+                                     mention_author=mention_author,
+                                     delete_after=delete,
+                                     embeds=embeds)
+
+    return sended_message.id
+
 async def dshell_delete_message(ctx: Message, message=None, reason=None, delay=0):
     """
     Deletes a message
     """
 
-    delete_message = ctx if message is None else ctx.channel.get_partial_message(
-        message)  # builds a reference to the message (even if it doesn't exist)
+    delete_message = ctx if message is None else utils_get_message(ctx, message)
 
     if not isinstance(delay, int):
         raise Exception(f'Delete delay must be an integer, not {type(delay)} !')
@@ -64,7 +95,7 @@ async def dshell_delete_message(ctx: Message, message=None, reason=None, delay=0
     await delete_message.delete(delay=delay, reason=reason)
 
 
-async def dshell_purge_message(ctx: Message, message_number, channel=None, reason=None):
+async def dshell_purge_message(ctx: Message, message_number: int, channel=None, reason=None):
     """
     Purges messages from a channel
     """
@@ -84,8 +115,7 @@ async def dshell_edit_message(ctx: Message, message, new_content=None, embeds=No
     """
     Edits a message
     """
-    edit_message = ctx.channel.get_partial_message(
-        message)  # builds a reference to the message (even if it doesn't exist)
+    edit_message = utils_get_message(ctx, message)
 
     if embeds is None:
         embeds = []
@@ -141,8 +171,7 @@ async def dshell_add_reactions(ctx: Message, reactions, message=None):
     """
     Adds reactions to a message
     """
-    message = ctx if message is None else ctx.channel.get_partial_message(
-        message)  # builds a reference to the message (even if it doesn't exist)
+    message = ctx if message is None else utils_get_message(ctx, message)
 
     if isinstance(reactions, str):
         reactions = (reactions,)
@@ -157,8 +186,7 @@ async def dshell_remove_reactions(ctx: Message, reactions, message=None):
     """
     Removes reactions from a message
     """
-    message = ctx if message is None else ctx.channel.get_partial_message(
-        message)  # builds a reference to the message (even if it doesn't exist)
+    message = ctx if message is None else utils_get_message(ctx, message)
 
     if isinstance(reactions, str):
         reactions = [reactions]
@@ -172,29 +200,21 @@ async def dshell_clear_message_reactions(ctx: Message, message):
     """
     Clear all reaction on the target message
     """
-    if not isinstance(message, int):
-        raise Exception(f'Message must be integer, not {type(message)}')
+    message = ctx if message is None else utils_get_message(ctx, message)
 
-    target_message = await ctx.channel.fetch_message(message)
-
-    if target_message is None:
+    if message is None:
         raise Exception(f'Message not found !')
 
-    await target_message.clear_reactions()
+    await message.clear_reactions()
 
 async def dshell_clear_one_reactions(ctx: Message, message, emoji):
     """
     Clear one emoji on the target message
     """
-    if not isinstance(message, int):
-        raise Exception(f'Message must be integer, not {type(message)}')
 
     if not isinstance(emoji, str):
         raise Exception(f'Emoji must be string, not {type(emoji)}')
 
-    try:
-        target_message = await ctx.channel.fetch_message(message)
-    except NotFound:
-        raise Exception(f'Message not found !')
+    target_message = ctx if message is None else utils_get_message(ctx, message)
 
     await target_message.clear_reaction(emoji)

Dshell/DISCORD_COMMANDS/dshell_role.py

@@ -1,5 +1,6 @@
 from discord import MISSING, Message, PermissionOverwrite
 from discord.utils import _MissingSentinel
+from typing import Union
 from .._utils import NoneType
 
 __all__ = [
@@ -56,7 +57,7 @@ async def dshell_delete_roles(ctx: Message, roles, reason=None):
     Delete the role on the server
     """
     from .._DshellInterpreteur.dshell_interpreter import ListNode
-    roles: int | ListNode
+    roles: Union[int, ListNode]
     if not isinstance(roles, (int, ListNode)):
         raise Exception(f"Role must be a int, role mention or NodeList of both, not {type(roles)} !")
 

Dshell/_DshellTokenizer/dshell_keywords.py

@@ -28,6 +28,8 @@ dshell_commands: dict[str, Callable] = {
     "gp": dshell_get_pastbin,  # get pastbin
 
     "sm": dshell_send_message,  # send message
+    "spm": dshell_send_private_message,  # send private message
+    "srm": dshell_respond_message,  # respond to a message
     "dm": dshell_delete_message,
     "pm": dshell_purge_message,
     "em": dshell_edit_message,  # edit message

{dshellinterpreter-0.2.9.dist-info → dshellinterpreter-0.2.9.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dshellInterpreter
-Version: 0.2.9
+Version: 0.2.9.2
 Summary: A Discord bot interpreter for creating custom commands and automations.
 Home-page: https://github.com/BOXERRMD/Dshell_Interpreter
 Author: Chronos

{dshellinterpreter-0.2.9.dist-info → dshellinterpreter-0.2.9.2.dist-info}/RECORD

@@ -1,22 +1,22 @@
 Dshell/__init__.py,sha256=pGd94FPy8kVXH_jH566HhApQPhbPfMPnZXzH_0dPWh0,93
 Dshell/_utils.py,sha256=PJ3fwn8IMqUMnW9oTwfr9v4--rzHIhhLQoVVqjwjoJU,23
 Dshell/DISCORD_COMMANDS/__init__.py,sha256=_oo_aMEju4gZg-MIbF8bKMVM6CWAF0AO9DxAlemaXMw,149
-Dshell/DISCORD_COMMANDS/dshell_channel.py,sha256=kjSTJnTTXHprCURESlO_62jv3Yu832lUELJi47PyWdo,18538
-Dshell/DISCORD_COMMANDS/dshell_member.py,sha256=L3Ud4nza_55n9R02kfL-iNK9ybBczx6SDkccUTWxv3s,7646
-Dshell/DISCORD_COMMANDS/dshell_message.py,sha256=SvX9I4nYMWm8ACE56QJBM5yEiZoXIKbTLkIOyrENd5o,6253
+Dshell/DISCORD_COMMANDS/dshell_channel.py,sha256=__vRngQD0USGBuJIuvHQckrtbhbufn5etaqXgNS90IA,16124
+Dshell/DISCORD_COMMANDS/dshell_member.py,sha256=5Iw-2dydhYMZOw2nx0svZP9JpZWHOXC0qkL9tClJHtw,8840
+Dshell/DISCORD_COMMANDS/dshell_message.py,sha256=KoR5hLQiGdkmBjMUJvdItsGximA0mUJ2MmNGV_1-1b8,6942
 Dshell/DISCORD_COMMANDS/dshell_pastbin.py,sha256=TkWFGRRTvhhJgvwkDFx9Fz4UM2UUFwxyq0laMVx0mUk,881
-Dshell/DISCORD_COMMANDS/dshell_role.py,sha256=fotsYWGHebgIx157q-zRbcCd90Y7jIuKCZ8udQoEzSU,4970
+Dshell/DISCORD_COMMANDS/dshell_role.py,sha256=t_yRZRD0FKE2gT4dIDIsHz2PSZZztDVEkkqkG_OkNh4,5002
 Dshell/_DshellInterpreteur/__init__.py,sha256=xy5-J-R3YmY99JF3NBHTRRLsComFxpjnCA5xacISctU,35
 Dshell/_DshellInterpreteur/dshell_interpreter.py,sha256=sYQ9qIVjRedwkfITEeVAFN0RdHjiY7RGO6z0j4D7eno,23072
 Dshell/_DshellParser/__init__.py,sha256=ONDfhZMvClqP_6tE8SLjp-cf3pXL-auQYnfYRrHZxC4,56
 Dshell/_DshellParser/ast_nodes.py,sha256=heOMQzAchQ8UroQaMSfU_6SYEXw-nme0jGcoVkCXPUs,15284
 Dshell/_DshellParser/dshell_parser.py,sha256=RxS5GgmTel10pH9HII0X_8XZnVyIQGd9ThZZcZDpEqc,15545
 Dshell/_DshellTokenizer/__init__.py,sha256=LIQSRhDx2B9pmPx5ADMwwD0Xr9ybneVLhHH8qrJWw_s,172
-Dshell/_DshellTokenizer/dshell_keywords.py,sha256=V4WU7PBvP9o7qxbE0Xsd8RmT_jxVRzZa1SOr2JeTyIg,5517
+Dshell/_DshellTokenizer/dshell_keywords.py,sha256=yBTXKBCb7NZa-DGDeeyIZrl_CS1Y4WCmwshUdBHQhlo,5642
 Dshell/_DshellTokenizer/dshell_token_type.py,sha256=gYIb2XN2YcgeRgmar_rBDS5CGmwfmxihu8mOW_d6lbE,1533
 Dshell/_DshellTokenizer/dshell_tokenizer.py,sha256=LZGs4Ytuyx9Galazqtz32lS4Mmu9yZya1B7AzFQAQOk,7150
-dshellinterpreter-0.2.9.dist-info/licenses/LICENSE,sha256=lNgcw1_xb7QENAQi3uHGymaFtbs0RV-ihiCd7AoLQjA,1082
-dshellinterpreter-0.2.9.dist-info/METADATA,sha256=IafKmA2w0eQvRLUnEydFgseeujbmQAfKjp7CJSc0WFk,1120
-dshellinterpreter-0.2.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-dshellinterpreter-0.2.9.dist-info/top_level.txt,sha256=B4CMhtmchGwPQJLuqUy0GhRG-0cUGxKL4GqEbCiB_vE,7
-dshellinterpreter-0.2.9.dist-info/RECORD,,
+dshellinterpreter-0.2.9.2.dist-info/licenses/LICENSE,sha256=lNgcw1_xb7QENAQi3uHGymaFtbs0RV-ihiCd7AoLQjA,1082
+dshellinterpreter-0.2.9.2.dist-info/METADATA,sha256=8yS0LBpjnf_2Md5wd9uXk-Cs5cfNJ3G2TQJWB9SWALQ,1122
+dshellinterpreter-0.2.9.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dshellinterpreter-0.2.9.2.dist-info/top_level.txt,sha256=B4CMhtmchGwPQJLuqUy0GhRG-0cUGxKL4GqEbCiB_vE,7
+dshellinterpreter-0.2.9.2.dist-info/RECORD,,