Improve comments on get_user_by_access_token

because I have to reverse-engineer this every time.
pull/2721/head
Richard van der Hoff 2017-11-29 15:41:20 +00:00
parent 5a4da5bf78
commit da562bd6a1
1 changed files with 5 additions and 1 deletions

View File

@ -270,7 +270,11 @@ class Auth(object):
rights (str): The operation being performed; the access token must rights (str): The operation being performed; the access token must
allow this. allow this.
Returns: Returns:
dict : dict that includes the user and the ID of their access token. Deferred[dict]: dict that includes:
`user` (UserID)
`is_guest` (bool)
`token_id` (int|None): access token id. May be None if guest
`device_id` (str|None): device corresponding to access token
Raises: Raises:
AuthError if no user by that token exists or the token is invalid. AuthError if no user by that token exists or the token is invalid.
""" """