feat: add new guild helper methods (#647)

* feat: two new guild methods

* feat: added new guild methods to pyi

* fix: corrected http method name

* ci: correct from checks.

* fix: add typehint for get_list_of_member returns

Co-authored-by: EdVraz <[email protected]>

* fix: add typehint for search_members method return

Co-authored-by: EdVraz <[email protected]>

* feat: add typehint for search_member return in main file

Co-authored-by: EdVraz <[email protected]>

* fix: add typehint for get_list_of_member returns in main file

Co-authored-by: EdVraz <[email protected]>

* feat: allow member to be used as an input for get_list_of_members

very cool idea

Co-authored-by: EdVraz <[email protected]>

* doc: specify that Member objects should be use in after param

Co-authored-by: EdVraz <[email protected]>

* doc: change docstring to allow for Member objects and int to be used

Co-authored-by: EdVraz <[email protected]>

* fix: account for errors with MISSING, make ids and Member objects both function

this is some voodoo

Co-authored-by: EdVraz <[email protected]>

* doc: make Member and int usage in get_list_of_members and default to MISSING

Co-authored-by: EdVraz <[email protected]>

* doc: add return info to get_list_of_members

* doc: add return info to docstring search_members

* doc: properly closed bracket

* fix: properly closed brackets

* ci: correct from checks.

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: EdVraz <[email protected]>

Author: 3 people

interactions/api/models/guild.py

@@ -1546,6 +1546,50 @@ async def delete_emoji(
             reason=reason,
         )
 
+    async def get_list_of_members(
+        self,
+        limit: Optional[int] = 1,
+        after: Optional[Union[Member, int]] = MISSING,
+    ) -> List[Member]:
+        """
+        Lists the members of a guild.
+
+        :param limit?: How many members to get from the API. Max is 1000.
+        :type limit: Optional[int]
+        :param after?: Get only Members after this member.
+        :type after: Optional[Union[Member, int]]
+        :return: A list of members
+        :rtype: List[Member]
+        """
+        if not self._client:
+            raise AttributeError("HTTPClient not found!")
+        if after is not MISSING:
+            _after = int(after.id) if not isinstance(after, int) else after
+        else:
+            _after = None
+        res = await self._client.get_list_of_members(
+            guild_id=int(self.id), limit=limit, after=_after
+        )
+        return [Member(**member, _client=self._client) for member in res]
+
+    async def search_members(self, query: str, limit: Optional[int] = 1) -> List[Member]:
+        """
+        Search the guild for members whose username or nickname starts with provided string.
+
+        :param query: The string to search for
+        :type query: str
+        :param limit?: The number of members to return.
+        :type limit: Optional[int]
+        :return: A list of matching members
+        :rtype: List[Member]
+        """
+        if not self._client:
+            raise AttributeError("HTTPClient not found!")
+        res = await self._client.search_guild_members(
+            guild_id=int(self.id), query=query, limit=limit
+        )
+        return [Member(**member, _client=self._client) for member in res]
+
 
 class GuildPreview(DictSerializerMixin):
     """

interactions/api/models/guild.pyi

@@ -394,6 +394,16 @@ class Guild(DictSerializerMixin):
         emoji: Union[Emoji, int],
         reason: Optional[str] = None,
     ) -> None: ...
+    async def get_list_of_members(
+        self,
+        limit: Optional[int] = 1,
+        after: Optional[Union[Member, int]] = MISSING,
+    ) -> List[Member]: ...
+    async def search_members(
+        self,
+        query: str,
+        limit: Optional[int] = 1
+    ) -> List[Member]: ...
 
 class GuildPreview(DictSerializerMixin):
     _json: dict