Add user_id property to client (#256)

Author: tkdrob

README.rst

@@ -72,6 +72,7 @@ A simple Chat Bot.
         async def event_ready(self):
             # We are logged in and ready to chat and use commands...
             print(f'Logged in as | {self.nick}')
+            print(f'User id is | {self.user_id}')
 
         @commands.command()
         async def hello(self, ctx: commands.Context):

docs/changelog.rst

@@ -1,5 +1,10 @@
 .. currentmodule:: twitchio
 
+Master
+=====
+- TwitchIO
+    - Add `user_id` property to Client
+
 2.1.4
 ======
 - TwitchIO

docs/quickstart.rst

@@ -41,6 +41,7 @@ Here we will be using the commands extension of TwitchIO to create a Chat Bot.
             # Notify us when everything is ready!
             # We are logged in and ready to chat and use commands...
             print(f'Logged in as | {self.nick}')
+            print(f'User id is | {self.user_id}')
 
         @commands.command()
         async def hello(self, ctx: commands.Context):
@@ -82,6 +83,7 @@ For an exhaustive list of events, visit: `Event Reference <twitchio.html#event-r
             # Notify us when everything is ready!
             # We are logged in and ready to chat and use commands...
             print(f'Logged in as | {self.nick}')
+            print(f'User id is | {self.user_id}')
 
         async def event_message(self, message):
             # Messages with echo set to True are messages sent by the bot...

twitchio/client.py

@@ -336,6 +336,11 @@ def nick(self):
         """The IRC bots nick."""
         return self._http.nick or self._connection.nick
 
+    @property
+    def user_id(self):
+        """The IRC bot user id."""
+        return self._http.user_id or self._connection.user_id
+
     def create_user(self, user_id: int, user_name: str) -> PartialUser:
         """
         A helper method to create a :class:`twitchio.PartialUser` from a user id and user name.

twitchio/http.py

@@ -98,6 +98,7 @@ def __init__(
         self.client_secret = client_secret
         self.client_id = client_id
         self.nick = None
+        self.user_id = None
 
         self.bucket = RateBucket(method="http")
         self.scopes = kwargs.get("scopes", [])
@@ -325,6 +326,7 @@ async def validate(self, *, token: str = None) -> dict:
 
         if not self.nick:
             self.nick = data.get("login")
+            self.user_id = int(data.get("user_id"))
             self.client_id = data.get("client_id")
 
         return data

twitchio/websocket.py

@@ -90,6 +90,7 @@ def __init__(
         }
 
         self.nick = None
+        self.user_id = None
         self._token = token
         self.modes = modes or ("commands", "tags", "membership")
         self._initial_channels = initial_channels or []
@@ -126,6 +127,7 @@ async def _connect(self):
         if not self._client._http.nick:
             data = await self._client._http.validate(token=self._token)
             self.nick = data["login"]
+            self.user_id = int(data["user_id"])
 
         session = self._client._http.session