Add oldest_first param

discord/abc.py

@@ -1715,6 +1715,7 @@ class Messageable:
         *,
         limit: Optional[int] = None,
         before: SnowflakeTime = MISSING,
+        oldest_first: bool = False,
     ) -> AsyncIterator[Message]:
         """Retrieves an :term:`asynchronous iterator` of the pinned messages in the channel.
 
@@ -1744,6 +1745,11 @@ class Messageable:
             If a datetime is provided, it is recommended to use a UTC aware datetime.
             If the datetime is naive, it is assumed to be local time.
 
+            .. versionadded:: 2.6
+        oldest_first: :class:`bool`
+            If set to ``True``, return messages in oldest->newest order.
+            Defaults to ``False``.
+
             .. versionadded:: 2.6
 
         Raises
@@ -1794,6 +1800,9 @@ class Messageable:
             if len(items) < max_limit or not data['has_more']:
                 limit = 0
 
+            if oldest_first:
+                reversed(items)
+
             for m in items:
                 message = state.create_message(channel=channel, data=m['message'])
                 message._pinned_at = utils.parse_time(m['pinned_at'])