diff --git a/discord/abc.py b/discord/abc.py index 4e13973f5..24b4a2e14 100644 --- a/discord/abc.py +++ b/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'])