Add follower and following count methods

Add PartialUser follower and following count methods.

Author: chillymosh

docs/changelog.rst

@@ -4,7 +4,11 @@ Master
 ======
 - TwitchIO
     - Additions
-        - Added :func:`~twitchio.Chatter.is_vip` property to Chatter
+        - Added :attr:`~twitchio.Chatter.is_vip` property to Chatter
+        - New PartialUser methods
+            - :func:`~twitchio.PartialUser.fetch_follower_count` to fetch total follower count of a User
+            - :func:`~twitchio.PartialUser.fetch_following_count` to fetch total following count of a User
+
     - Bug fixes
         - Fix whispers that were not able to be parsed
 
@@ -106,7 +110,7 @@ Massive documentation updates
         - Fix bug where # prefixed channel names and capitals in initial_channels would not trigger :func:`~twitchio.Client.event_ready`
         - Adjusted join channel rate limit handling
         - :func:`twitchio.PartialUser.create_clip` has been fixed by converting bool to string in http request
-        - :func:`~twitchio.Client.fetch_cheermotes` color attribute corrected
+        - :attr:`~twitchio.Client.fetch_cheermotes` color attribute corrected
         - :func:`twitchio.PartialUser.fetch_channel_teams` returns empty list if no teams found rather than unhandled error
         - Fix :class:`twitchio.CustomRewardRedemption` so :func:`twitchio.CustomReward.get_redemptions` returns correctly
 
@@ -134,13 +138,13 @@ Massive documentation updates
 
 - TwitchIO
     - Loosen aiohttp requirements to allow 3.8.1
-    - :class:`twitchio.Stream` was missing from ``__all__``. It is now available in the twitchio namespace.
+    - :class:`~twitchio.Stream` was missing from ``__all__``. It is now available in the twitchio namespace.
     - Added ``.status``, ``.reason`` and ``.extra`` to :class:`HTTPException`
     - Fix ``Message._timestamp`` value when tag is not provided by twitch
-    - Fix :func:`twitchio.Client.wait_for_ready`
-    - Remove loop= parameter inside :func:`twitchio.Client.wait_for` for 3.10 compatibility
-    - Add ``is_broadcaster`` check to :class:`twitchio.PartialChatter`. This is accessible as ``Context.author.is_broadcaster``
-    - :func:`twitchio.PartialUser.fetch_follow` will now return ``None`` if the FollowEvent does not exists
+    - Fix :func:`~twitchio.Client.wait_for_ready`
+    - Remove loop= parameter inside :func:`~twitchio.Client.wait_for` for 3.10 compatibility
+    - Add :attr:`~twitchio.Chatter.is_broadcaster` check to :class:`~twitchio.PartialChatter`. This is accessible as ``Context.author.is_broadcaster``
+    - :func:`~twitchio.PartialUser.fetch_follow` will now return ``None`` if the FollowEvent does not exists
     - TwitchIO will now correctly handle error raised when only the prefix is typed in chat
     - Fix paginate logic in :func:`TwitchHTTP.request`
 

twitchio/http.py

@@ -778,15 +778,17 @@ async def delete_unfollow_channel(self, token: str, from_id: str, to_id: str):
             Route("DELETE", "users/follows", query=[("from_id", from_id), ("to_id", to_id)], token=token)
         )
 
-    async def get_users(self, ids: List[int], logins: List[str], token: str = None):
+    async def get_users(self, ids: List[int], logins: List[str], token: Optional[str] = None):
         q = []
         if ids:
             q.extend(("id", id) for id in ids)
         if logins:
             q.extend(("login", login) for login in logins)
         return await self.request(Route("GET", "users", query=q, token=token))
 
-    async def get_user_follows(self, from_id: str = None, to_id: str = None, token: str = None):
+    async def get_user_follows(
+        self, from_id: Optional[str] = None, to_id: Optional[str] = None, token: Optional[str] = None
+    ):
         return await self.request(
             Route(
                 "GET",
@@ -1069,3 +1071,17 @@ async def delete_ban_timeout_user(
     ):
         q = [("broadcaster_id", broadcaster_id), ("moderator_id", moderator_id), ("user_id", user_id)]
         return await self.request(Route("DELETE", "moderation/bans", query=q, token=token))
+
+    async def get_follow_count(
+        self, from_id: Optional[str] = None, to_id: Optional[str] = None, token: Optional[str] = None
+    ):
+        return await self.request(
+            Route(
+                "GET",
+                "users/follows",
+                query=[x for x in [("from_id", from_id), ("to_id", to_id)] if x[1] is not None],
+                token=token,
+            ),
+            full_body=True,
+            paginate=False,
+        )

twitchio/user.py

@@ -474,7 +474,7 @@ async def fetch_stream_key(self, token: str):
         data = await self._http.get_stream_key(token, str(self.id))
         return data
 
-    async def fetch_following(self, token: str = None) -> List["FollowEvent"]:
+    async def fetch_following(self, token: Optional[str] = None) -> List["FollowEvent"]:
         """|coro|
 
         Fetches a list of users that this user is following.
@@ -493,7 +493,7 @@ async def fetch_following(self, token: str = None) -> List["FollowEvent"]:
         data = await self._http.get_user_follows(token=token, from_id=str(self.id))
         return [FollowEvent(self._http, d, from_=self) for d in data]
 
-    async def fetch_followers(self, token: str = None):
+    async def fetch_followers(self, token: Optional[str] = None):
         """|coro|
 
         Fetches a list of users that are following this user.
@@ -509,10 +509,10 @@ async def fetch_followers(self, token: str = None):
         """
         from .models import FollowEvent
 
-        data = await self._http.get_user_follows(to_id=str(self.id))
+        data = await self._http.get_user_follows(token=token, to_id=str(self.id))
         return [FollowEvent(self._http, d, to=self) for d in data]
 
-    async def fetch_follow(self, to_user: "PartialUser", token: str = None):
+    async def fetch_follow(self, to_user: "PartialUser", token: Optional[str] = None):
         """|coro|
 
         Check if a user follows another user or when they followed a user.
@@ -531,9 +531,44 @@ async def fetch_follow(self, to_user: "PartialUser", token: str = None):
             raise TypeError(f"to_user must be a PartialUser not {type(to_user)}")
         from .models import FollowEvent
 
-        data = await self._http.get_user_follows(from_id=str(self.id), to_id=str(to_user.id))
+        data = await self._http.get_user_follows(token=token, from_id=str(self.id), to_id=str(to_user.id))
         return FollowEvent(self._http, data[0]) if data else None
 
+    async def fetch_follower_count(self, token: Optional[str] = None) -> int:
+        """|coro|
+
+        Fetches a list of users that are following this user.
+
+        Parameters
+        -----------
+        token: Optional[:class:`str`]
+            An oauth token to use instead of the bots token
+
+        Returns
+        --------
+            :class:`int`
+        """
+
+        data = await self._http.get_follow_count(token=token, to_id=str(self.id))
+        return data["total"]
+
+    async def fetch_following_count(self, token: Optional[str] = None) -> int:
+        """|coro|
+
+        Fetches a list of users that this user is following.
+
+        Parameters
+        -----------
+        token: Optional[:class:`str`]
+            An oauth token to use instead of the bots token
+
+        Returns
+        --------
+            :class:`int`
+        """
+        data = await self._http.get_follow_count(token=token, from_id=str(self.id))
+        return data["total"]
+
     async def follow(self, userid: int, token: str, *, notifications=False):
         """|coro|