Add client.fetch_channels

Add fetch_channels method that follows Helix

Author: chillymosh

docs/changelog.rst

@@ -22,6 +22,7 @@ Master
         - Added following new Client methods:
             - :func:`~twitchio.Client.fetch_chatters_colors`
             - :func:`~twitchio.Client.update_chatter_color`
+            - :func:`~twitchio.Client.fetch_channels`
         - Add ``duration`` and ``vod_offset`` attributes to :class:`~twitchio.Clip`
         - Added repr for :class:`~twitchio.CustomReward`
         - Added repr for :class:`~twitchio.PredictionOutcome`

twitchio/client.py

@@ -440,15 +440,20 @@ async def fetch_clips(self, ids: List[str]):
         data = await self._http.get_clips(ids=ids)
         return [models.Clip(self._http, d) for d in data]
 
-    async def fetch_channel(self, broadcaster: str):
+    async def fetch_channel(self, broadcaster: str, token: Optional[str] = None):
         """|coro|
 
         Retrieve channel information from the API.
 
+        .. note::
+            This will be deprecated in 3.0. It's recommended to use :func:`~fetch_channels` instead.
+
         Parameters
         -----------
         broadcaster: str
             The channel name or ID to request from API. Returns empty dict if no channel was found.
+        token: Optional[:class:`str`]
+            An optional OAuth token to use instead of the bot OAuth token.
 
         Returns
         --------
@@ -459,9 +464,9 @@ async def fetch_channel(self, broadcaster: str):
             get_id = await self.fetch_users(names=[broadcaster.lower()])
             if not get_id:
                 raise IndexError("Invalid channel name.")
-            broadcaster = get_id[0].id
+            broadcaster = str(get_id[0].id)
         try:
-            data = await self._http.get_channels(broadcaster)
+            data = await self._http.get_channels(broadcaster_id=broadcaster, token=token)
 
             from .models import ChannelInfo
 
@@ -470,6 +475,28 @@ async def fetch_channel(self, broadcaster: str):
         except HTTPException:
             raise HTTPException("Incorrect channel ID.")
 
+    async def fetch_channels(self, broadcaster_ids: List[int], token: Optional[str] = None):
+        """|coro|
+
+        Retrieve information for up to 100 channels from the API.
+
+        Parameters
+        -----------
+        broadcaster_ids: List[:class:`int`]
+            The channel ids to request from API.
+        token: Optional[:class:`str`]
+            An optional OAuth token to use instead of the bot OAuth token
+
+        Returns
+        --------
+            List[:class:`twitchio.ChannelInfo`]
+        """
+        from .models import ChannelInfo
+
+        data = await self._http.get_channels_new(broadcaster_ids=broadcaster_ids, token=token)
+        return [ChannelInfo(self._http, data=d) for d in data]
+
+
     async def fetch_videos(
         self,
         ids: List[int] = None,

twitchio/http.py

@@ -683,9 +683,16 @@ async def get_stream_markers(self, token: str, user_id: str = None, video_id: st
             )
         )
 
-    async def get_channels(self, broadcaster_id: str, token: str = None):
+    async def get_channels(self, broadcaster_id: str, token: Optional[str]= None):
         return await self.request(Route("GET", "channels", query=[("broadcaster_id", broadcaster_id)], token=token))
 
+
+    async def get_channels_new(self, broadcaster_ids: List[int], token: Optional[str] = None):
+        if len(broadcaster_ids) > 100:
+            raise ValueError("Maximum of 100 broadcaster_ids")
+        q = [("broadcaster_id", str(broadcaster_id)) for broadcaster_id in broadcaster_ids]
+        return await self.request(Route("GET", "channels", query=q, token=token))
+
     async def patch_channel(
         self, token: str, broadcaster_id: str, game_id: str = None, language: str = None, title: str = None
     ):