fix(general): Deprecated Member.mute and added Member.timeout and member.remove_timeout

Author: mccoderpy

discord/member.py

@@ -652,9 +652,58 @@ def voice(self):
     def communication_disabled_until(self) -> Optional[datetime.datetime]:
         return datetime.datetime.fromisoformat(self._communication_disabled_until) if self._communication_disabled_until else None
 
+    @utils.deprecated('Member.timeout')
     async def mute(self, until: datetime.datetime, *, reason: Optional[str] = None):
         await self.edit(communication_disabled_until=until, reason=reason)
 
+    async def timeout(self, until: datetime.datetime, *, reason: Optional[str] = None) -> None:
+        """|coro|
+
+        A shortcut method to timeout a member.
+
+        The :attr:`~Permissions.moderate_members` permission is needed to do this.
+
+        Parameters
+        -----------
+        until: :class:`datetime.datetime`
+            Until when the member should be timeouted
+            
+            .. note::
+                This can be max 28 days from current time!
+                
+        reason: Optional[:class:`str`]
+            The reason for sending the member to timeout - Shows up in the audit-log
+        
+        Raises
+        -------
+        Forbidden:
+            The bot missing access to timeout this member
+        HTTPException:
+            Timeouting the member failed
+        """
+        await self.edit(communication_disabled_until=until, reason=reason)
+
+    async def remove_timeout(self, *, reason: Optional[str] = None) -> None:
+        """|coro|
+
+        A shortcut method to remove a member from timeout.
+
+        The :attr:`~Permissions.moderate_members` permission is needed to do this.
+
+        Parameters
+        -----------
+        reason: Optional[:class:`str`]
+            The reason for removing the member from timeout - Shows up in the audit-log
+
+        Raises
+        -------
+        Forbidden:
+            The bot missing access to remove this member from timeout
+        HTTPException:
+            Removing the member from timeout failed
+        """
+        await self.edit(communication_disabled_until=None, reason=reason)
+
     async def ban(self, **kwargs):
         """|coro|
 
@@ -796,7 +845,7 @@ async def edit(self, *, reason: Optional[str] = None, **fields):
         except KeyError:
             pass
         else:
-            if communication_disabled_until is not None:
+            if communication_disabled_until:
                 payload['communication_disabled_until'] = communication_disabled_until.isoformat()
             else:
                 payload['communication_disabled_until'] = None

docs/_templates/style.css renamed to docs/_static/style.css

@@ -173,7 +173,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static', './_templates/style.css']
+html_static_path = ['_static']
 
 def setup(app: 'App'):
-    app.add_css_file('./_templates/style.css')
+    app.add_css_file('style.css')

docs/conf.py

@@ -41,13 +41,13 @@
      New features are also implemented. It's not an extension!
      The name only comes from the fact that the original purpose of the library was to add support for message components and we haven't found a better one yet.
 
-.. figure:: https://github.com/mccoderpy/discord.py-message-components/raw/main/images/rtd-logo-wordmark-light.png
-   :name: discord.py-message-components documentation
-   :alt: Link to the documentation of discord.py-message-components
-   :align: center
-   :target: https://discordpy-message-components.readthedocs.io/en/developer/
+.. |PyPI| image:: https://cdn.discordapp.com/emojis/854380926548967444.png?v=1
+   :alt: PyPI Logo
+   :width: 30px
+   :target: https://pypi.org
 
-   **Read the Documentation** `here <https://discordpy-message-components.readthedocs.io/en/developer/>`_
+.. centered::
+   **Visit on** |PyPI| **PyPI** `here <https://pypi.org/project/discord.py-message-components>`_
 
 
 discord.py-message-components is a modern, easy to use, feature-rich, and async ready API wrapper

docs/index.rst

@@ -48,6 +48,9 @@ For a Debian-based system, the following command will get these dependencies:
 
 **Remember to check your permissions!**
 
+Installing the developer version
+---------------------------------
+
 To install the developer (alpha/beta) version from the `developer-branch <https://github.com/mccoderpy/discord.py-message-components/tree/developer>`_ use:
 
 .. code-block:: sh