fix, update and improve typehints and documentation in a few place

Author: Drapersniper

lavalink/lavalink.py

@@ -34,9 +34,9 @@ async def initialize(
     host,
     password,
     port: Optional[int] = None,
-    timeout=30,
+    timeout: float = 30,
     resume_key: Optional[str] = None,
-    resume_timeout: int = 60,
+    resume_timeout: float = 60,
     secured: bool = False,
 ):
     """
@@ -57,11 +57,11 @@ async def initialize(
         The password of the Lavalink node.
     port : Optional[int]
         The websocket port on the Lavalink Node.
-    timeout : int
+    timeout : float
         Amount of time to allow retries to occur, ``None`` is considered forever.
     resume_key : Optional[str]
         A resume key used for resuming a session upon re-establishing a WebSocket connection to Lavalink.
-    resume_timeout : inr
+    resume_timeout : float
         How long the node should wait for a connection while disconnected before clearing all players.
     secured: bool
            Whether to use the `wss://` and `https://` protocol.
@@ -106,7 +106,10 @@ async def connect(channel: discord.VoiceChannel, deafen: bool = False):
 
     Parameters
     ----------
-    channel
+    channel : discord.VoiceChannel
+        The channel to connect to.
+    deafen: bool
+        Whether to deafen the bot user upon join.
 
     Returns
     -------

lavalink/node.py

@@ -111,7 +111,7 @@ def __repr__(self):
 
 class Node:
 
-    _is_shutdown = False  # type: bool
+    _is_shutdown: bool = False
 
     def __init__(
         self,
@@ -124,7 +124,7 @@ def __init__(
         num_shards: int,
         port: Optional[int] = None,
         resume_key: Optional[str] = None,
-        resume_timeout: int = 60,
+        resume_timeout: float = 60,
         bot: Bot = None,
         secured: bool = False,
     ):
@@ -151,7 +151,7 @@ def __init__(
             Number of shards to which the bot is currently connected.
         resume_key : Optional[str]
             A resume key used for resuming a session upon re-establishing a WebSocket connection to Lavalink.
-        resume_timeout : int
+        resume_timeout : float
             How long the node should wait for a connection while disconnected before clearing all players.
         bot: AutoShardedBot
             The Bot object that connects to discord.
@@ -234,7 +234,7 @@ async def connect(self, timeout=None, *, shutdown=False):
 
         Parameters
         ----------
-        timeout : int
+        timeout : float
             Time after which to timeout on attempting to connect to the Lavalink websocket,
             ``None`` is considered never, but the underlying code may stop trying past a
             certain point.