From 96ca7cafeefb388b898fd8ed9c7279069b71b013 Mon Sep 17 00:00:00 2001 From: Rapptz Date: Sun, 25 Sep 2016 04:40:31 -0400 Subject: Add Client.get_user_info to retrieve a User from ID. --- discord/client.py | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'discord/client.py') diff --git a/discord/client.py b/discord/client.py index 74a417cd..f304be24 100644 --- a/discord/client.py +++ b/discord/client.py @@ -2795,4 +2795,31 @@ class Client: description=data['description'], icon=data['icon'], owner=User(**data['owner'])) + @asyncio.coroutine + def get_user_info(self, user_id): + """|coro| + + Retrieves a :class:`User` based on their ID. This can only + be used by bot accounts. You do not have to share any servers + with the user to get this information, however many operations + do require that you do. + + Parameters + ----------- + user_id: str + The user's ID to fetch from. + + Returns + -------- + :class:`User` + The user you requested. + Raises + ------- + NotFound + A user with this ID does not exist. + HTTPException + Fetching the user failed. + """ + data = yield from self.http.get_user_info(user_id) + return User(**data) -- cgit v1.2.3