Updated Main-Branch(docs) to 1.7.5.1

Author: mccoderpy

LICENSE

@@ -1,23 +1,23 @@
-The MIT License (MIT)
-
-Copyright (c) 2015-present Rapptz
-
-Implementing of the Discord-Message-components made by mccoderpy (Discord-User mccuber04#2960)
-
-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.
+The MIT License (MIT)
+
+Copyright (c) 2015-present Rapptz
+
+Implementing of the Discord-Message-components made by mccoderpy (Discord-User mccuber04#2960)
+
+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.

MANIFEST.in

@@ -0,0 +1,6 @@
+include README.rst
+include LICENSE.txt
+include discord/*
+include discord/bin/*.dll
+include discord/ext/commands/*
+include discord/ext/tasks/__init__.py

README.rst

@@ -1,43 +1,55 @@
-.. image:: https://cdn.discordapp.com/attachments/852872100073963532/854711446767796286/discord.py-message-components.png
-    :target: https://pypi.org/project/discord.py-message-components
-    :alt: Name of the project
-            
-.. image:: https://discord.com/api/guilds/852871920411475968/embed.png
-  :target: https://discord.gg/sb69muSqsg
-  :alt: Discord Server Invite
+Welcome to discord.py-message-components' documentation!
+=========================================================
 
-.. image:: https://img.shields.io/pypi/v/discord.py-message-components.svg
-  :target: https://pypi.python.org/pypi/discord.py-message-components
-  :alt: PyPI version info
+.. figure:: https://cdn.discordapp.com/attachments/852872100073963532/854711446767796286/discord.py-message-components.png
+   :name: discord.py-message-components
+   :align: center
+   :alt: Name of the Project (discord.py-message-components)
 
-.. image:: https://img.shields.io/pypi/pyversions/discord.py-message-components.svg
-  :target: https://pypi.python.org/pypi/discord.py-message-components
-  :alt: PyPI supported Python versions
-  
-.. image:: https://static.pepy.tech/personalized-badge/discord-py-message-components?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads
-  :target: https://pepy.tech/project/discord.py-message-components
-  :alt: Total downloads for the project
+   ..
+   .. image:: https://discord.com/api/guilds/852871920411475968/embed.png
+      :target: https://discord.gg/sb69muSqsg
+      :alt: Discord Server Invite
 
-.. image:: https://readthedocs.org/projects/discordpy-message-components/badge/?version=latest
-  :target: https://discordpy-message-components.readthedocs.io/en/latest/
-  :alt: Documentation Status
+   .. image:: https://img.shields.io/pypi/v/discord.py-message-components.svg
+      :target: https://pypi.python.org/pypi/discord.py-message-components
+      :alt: PyPI version info
 
-The Original `discord.py <https://pypi.org/project/discord.py>`_ Library made by `Rapptz <https://github.com/Rapptz>`_ with implementation of the `Discord-Message-Components <https://discord.com/developers/docs/interactions/message-components>`_ by `mccoderpy <https://github.com/mccoderpy/>`_
+   .. image:: https://img.shields.io/pypi/pyversions/discord.py-message-components.svg
+      :target: https://pypi.python.org/pypi/discord.py-message-components
+      :alt: PyPI supported Python versions
 
-**Documentation:** `read the docs <https://discordpy-message-components.readthedocs.io/en/latest/>`_
+   .. image:: https://static.pepy.tech/personalized-badge/discord-py-message-components?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads
+      :target: https://pepy.tech/project/discord.py-message-components
+      :alt: Total downloads for the project
 
-Questions, Bugs or Ideas
-________________________
+   .. image:: https://readthedocs.org/projects/discordpy-message-components/badge/?version=latest
+      :target: https://discordpy-message-components.readthedocs.io/en/latest/
+      :alt: Documentation Status
 
-Open a Issue/Pull request on `GitHub <https://github.com/mccoderpy/discord.py-message-components/pulls>`_, join the `support-Server <https://discord.gg/sb69muSqsg>`_ or send me a direct-message on `Discord <https://discord.com/channels/@me>`_: ``mccuber04#2960``
+   The Original `discord.py <https://pypi.org/project/discord.py/1.7.3>`_ Library made by `Rapptz <https://github.com/Rapptz>`_ with implementation of the `Discord-Message-Components <https://discord.com/developers/docs/interactions/message-components>`_ by `mccoderpy <https://github.com/mccoderpy/>`_
+
+.. figure:: images/rtd-logo-wordmark-light.png
+   :name: discord.py-message-components documentation
+   :alt: Link to the documentation of discord.py-message-components
+   :align: center
+   :scale: 20%
+   :target: https://discordpy-message-components.readthedocs.io/en/latest/
+
+   **Read the Documentation** `here <https://discordpy-message-components.readthedocs.io/en/latest/>`_
+
+You need help? Or have ideas/feedback?
+______________________________________
 
+Open a Issue/Pull request on `GitHub <https://github.com/mccoderpy/discord.py-message-components/pulls>`_, join the `support-Server <https://discord.gg/sb69muSqsg>`_ or send me a direct-message on `Discord <https://discord.com/channels/@me>`_: ``mccuber04#2960``
 
 Installing
 __________
 
 **Python 3.5.3 or higher is required**
 
-first uninstall the original `discord.py <https://pypi.org/project/discord.py>`_ Library:
+This Library overwrite the original discord.py Library so to be sure all will work fine
+first uninstall the original `discord.py <https://pypi.org/project/discord.py/1.7.3>`_ Library if it is installed:
 
 .. code:: sh
 
@@ -47,7 +59,7 @@ first uninstall the original `discord.py <https://pypi.org/project/discord.py>`_
     # Windows
     py -3 -m pip uninstall discord.py
 
-then install `this Library <https://pypi.org/project/discord.py-message-components>`_ using:
+Then install `this Library <https://pypi.org/project/discord.py-message-components>`_ using:
 
 .. code:: sh
 
@@ -68,7 +80,7 @@ A Command that sends you a Message and edit it when you click a Button:
     import typing
     import discord
     from discord.ext import commands
-    from discord import ActionRow, Button, ButtonColor
+    from discord import ActionRow, Button, ButtonStyle
 
     client = commands.Bot(command_prefix=commands.when_mentioned_or('.!'), intents=discord.Intents.all(), case_insensitive=True)
 
@@ -77,33 +89,37 @@ A Command that sends you a Message and edit it when you click a Button:
         components = [ActionRow(Button(label='Option Nr.1',
                                        custom_id='option1',
                                        emoji="🆒",
-                                       style=ButtonColor.green
+                                       style=ButtonStyle.green
                                        ),
                                 Button(label='Option Nr.2',
                                        custom_id='option2',
                                        emoji="🆗",
-                                       style=ButtonColor.blurple)),
+                                       style=ButtonStyle.blurple)),
                       ActionRow(Button(label='A Other Row',
                                        custom_id='sec_row_1st option',
-                                       style=ButtonColor.red,
+                                       style=ButtonStyle.red,
                                        emoji='😀'),
                                 Button(url='https://www.youtube.com/watch?v=dQw4w9WgXcQ',
                                        label="This is an Link",
+                                       style=ButtonStyle.url,
                                        emoji='🎬'))
                       ]
         an_embed = discord.Embed(title='Here are some Button\'s', description='Choose an option', color=discord.Color.random())
         msg = await ctx.send(embed=an_embed, components=components)
 
-        def _check(i: discord.Interaction, b: discord.ButtonClick):
+        def _check(i: discord.Interaction, b):
             return i.message == msg and i.member == ctx.author
 
         interaction, button = await client.wait_for('button_click', check=_check)
         button_id = button.custom_id
 
         # This sends the Discord-API that the interaction has been received and is being "processed"
-        await interaction.defer()  # if this is not used and you also do not edit the message within 3 seconds as described below, Discord will indicate that the interaction has failed.
+        await interaction.defer()
+        # if this is not used and you also do not edit the message within 3 seconds as described below,
+        # Discord will indicate that the interaction has failed.
 
-        # If you use interaction.edit instead of interaction.message.edit, you do not have to deffer the interaction if your response does not last longer than 3 seconds.
+        # If you use interaction.edit instead of interaction.message.edit, you do not have to defer the interaction,
+        # if your response does not last longer than 3 seconds.
         await interaction.edit(embed=an_embed.add_field(name='Choose', value=f'Your Choose was `{button_id}`'),
                                components=[components[0].disable_all_buttons(), components[1].disable_all_buttons()])
 
@@ -176,7 +192,7 @@ Another (complex) Example where a small Embed will be send; you can move a small
             [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
             [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
         ]
-        base[y].__setitem__(x, 1)
+        base[y][x] = 1
         base.reverse()
         return ''.join(f"\n{''.join([str(base[i][w]) for w in range(len(base[i]))]).replace('0', '⬛').replace('1', '⬜')}" for i in range(len(base)))
 
@@ -201,45 +217,52 @@ Another (complex) Example where a small Embed will be send; you can move a small
                        )
 
 
-    @client.event
-    async def on_raw_interaction_create(interaction: discord.Interaction):
-        await interaction.defer()
+    @client.on_click()
+    async def up(i: discord.Interaction, button):
         pointer: Pointer = get_pointer(interaction.guild)
-        if not (message := interaction.message):
-            message: discord.Message = await interaction.channel.fetch_message(interaction.message_id)
-        if interaction.component.custom_id == "up":
-            pointer.set_y(1)
-            await message.edit(embed=discord.Embed(title="Little Game",
-                                                   description=display(x=pointer.possition_x, y=pointer.possition_y)),
+        pointer.set_y(1)
+        await i.edit(embed=discord.Embed(title="Little Game",
+                                         description=display(x=pointer.possition_x, y=pointer.possition_y)),
                                components=[discord.ActionRow(empty_button, arrow_button().set_label('↑').set_custom_id('up').disable_if(pointer.possition_y >= 9), empty_button),
                                            discord.ActionRow(arrow_button().set_label('←').set_custom_id('left').disable_if(pointer.possition_x <= 0),
                                                              arrow_button().set_label('↓').set_custom_id('down'),
                                                              arrow_button().set_label('→').set_custom_id('right').disable_if(pointer.possition_x >= 9))]
                                )
-        elif interaction.component.custom_id == "down":
-            pointer.set_y(-1)
-            await message.edit(embed=discord.Embed(title="Little Game",
-                                                   description=display(x=pointer.possition_x, y=pointer.possition_y)),
+
+    @client.on_click()
+    async def down(i: discord.Interaction, button):
+        pointer: Pointer = get_pointer(interaction.guild)
+        pointer.set_y(-1)
+        await message.edit(embed=discord.Embed(title="Little Game",
+                                              description=display(x=pointer.possition_x, y=pointer.possition_y)),
                                components=[discord.ActionRow(empty_button, arrow_button().set_label('↑').set_custom_id('up'), empty_button),
                                            discord.ActionRow(arrow_button().set_label('←').set_custom_id('left').disable_if(pointer.possition_x <= 0),
                                                              arrow_button().set_label('↓').set_custom_id('down').disable_if(pointer.possition_y <= 0),
                                                              arrow_button().set_label('→').set_custom_id('right').disable_if(pointer.possition_x >= 9))]
                                )
-        elif interaction.component.custom_id == "right":
-            pointer.set_x(1)
-            await message.edit(embed=discord.Embed(title="Little Game",
-                                                   description=display(x=pointer.possition_x, y=pointer.possition_y)),
+
+    @client.on_click()
+    async def right(i: discord.Interaction, button):
+        pointer: Pointer = get_pointer(interaction.guild)
+        pointer.set_x(1)
+        await message.edit(embed=discord.Embed(title="Little Game",
+                                               description=display(x=pointer.possition_x, y=pointer.possition_y)),
                                components=[discord.ActionRow(empty_button, arrow_button().set_label('↑').set_custom_id('up'), empty_button),
                                            discord.ActionRow(arrow_button().set_label('←').set_custom_id('left'),
                                                              arrow_button().set_label('↓').set_custom_id('down'),
                                                              arrow_button().set_label('→').set_custom_id('right').disable_if(pointer.possition_x >= 9))]
                                )
-        elif interaction.component.custom_id == "left":
-            pointer.set_x(-1)
-            await message.edit(embed=discord.Embed(title="Little Game",
-                                                   description=display(x=pointer.possition_x, y=pointer.possition_y)),
+
+    @client.on_click()
+    async def left(i: discord.Interaction, button):
+        pointer: Pointer = get_pointer(interaction.guild)
+        pointer.set_x(-1)
+        await message.edit(embed=discord.Embed(title="Little Game",
+                                               description=display(x=pointer.possition_x, y=pointer.possition_y)),
                                components=[discord.ActionRow(empty_button, arrow_button().set_label('↑').set_custom_id('up'), empty_button),
                                            discord.ActionRow(arrow_button().set_label('←').set_custom_id('left').disable_if(pointer.possition_x <= 0),
                                                              arrow_button().set_label('↓').set_custom_id('down'),
                                                              arrow_button().set_label('→').set_custom_id('right'))]
-                               )
+                               )
+
+Take a look at `the documentation <https://discordpy-message-components.readthedocs.io/en/latest/>`_ to see more examples.