Add first kwarg for get_redemption

Add first kwarg for get_redemption

Author: chillymosh

docs/changelog.rst

@@ -16,6 +16,8 @@ Massive documentation updates
     - Added :func:`User.fetch_goals` method
     - Added :func:`User.fetch_chat_settings` and :func:`User.update_chat_settings` methods
     - Added :func:`Client.part_channels` method
+    - Added :func:`Client.event_channel_joined` event. This is dispatched when the bot joins a channel
+    - Added first kwarg to CustomReward.get_redemption()
 
 - ext.commands
     - :func:`Bot.handle_commands` now also invokes on threads / replies

twitchio/http.py

@@ -445,12 +445,12 @@ async def get_reward_redemptions(
         token: str,
         broadcaster_id: int,
         reward_id: str,
-        redemption_id: str = None,
-        status: str = None,
-        sort: str = None,
+        redemption_id: Optional[str] = None,
+        status: Optional[str] = None,
+        sort: str = "OLDEST",
+        first: int = 20
     ):
-        params = [("broadcaster_id", str(broadcaster_id)), ("reward_id", reward_id)]
-
+        params = [("broadcaster_id", str(broadcaster_id)), ("reward_id", reward_id), ("first", first)]
         if redemption_id:
             params.append(("id", redemption_id))
         if status:

twitchio/rewards.py

@@ -224,7 +224,7 @@ async def delete(self, token: str):
                 ) from error
             raise
 
-    async def get_redemptions(self, token: str, status: str, sort: str = None):
+    async def get_redemptions(self, token: str, status: str, sort: str = "OLDEST", first: int = 20):
         """
         Gets redemptions for this reward
 
@@ -235,11 +235,14 @@ async def get_redemptions(self, token: str, status: str, sort: str = None):
         status:
             :class:`str` one of UNFULFILLED, FULFILLED or CANCELED
         sort:
-            :class:`str` the order redemptions are returned in. One of OLDEST, NEWEST. Default: OLDEST.
+            Optional[:class:`str`] the order redemptions are returned in. One of OLDEST, NEWEST. Default: OLDEST.
+        first:
+            :class:`int` Number of results to be returned when getting the paginated Custom Reward Redemption objects for a reward.
+            Limit: 50. Default: 20.
         """
         try:
             data = await self._http.get_reward_redemptions(
-                token, self._broadcaster_id, self.id, status=status, sort=sort
+                token, self._broadcaster_id, self.id, status=status, sort=sort, first=first
             )
         except Unauthorized as error:
             raise Unauthorized("The given token is invalid", "", 401) from error