270 lines
7.0 KiB
Python
270 lines
7.0 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
import re
|
|
import uuid
|
|
|
|
from urllib.parse import urlparse, urlencode, quote
|
|
|
|
from toot import http, CLIENT_NAME, CLIENT_WEBSITE
|
|
from toot.exceptions import AuthenticationError
|
|
from toot.utils import str_bool
|
|
|
|
SCOPES = 'read write follow'
|
|
|
|
|
|
def _account_action(app, user, account, action):
|
|
url = '/api/v1/accounts/{}/{}'.format(account, action)
|
|
|
|
return http.post(app, user, url).json()
|
|
|
|
|
|
def _status_action(app, user, status_id, action):
|
|
url = '/api/v1/statuses/{}/{}'.format(status_id, action)
|
|
|
|
return http.post(app, user, url).json()
|
|
|
|
|
|
def create_app(domain, scheme='https'):
|
|
url = '{}://{}/api/v1/apps'.format(scheme, domain)
|
|
|
|
data = {
|
|
'client_name': CLIENT_NAME,
|
|
'redirect_uris': 'urn:ietf:wg:oauth:2.0:oob',
|
|
'scopes': SCOPES,
|
|
'website': CLIENT_WEBSITE,
|
|
}
|
|
|
|
return http.anon_post(url, data).json()
|
|
|
|
|
|
def login(app, username, password):
|
|
url = app.base_url + '/oauth/token'
|
|
|
|
data = {
|
|
'grant_type': 'password',
|
|
'client_id': app.client_id,
|
|
'client_secret': app.client_secret,
|
|
'username': username,
|
|
'password': password,
|
|
'scope': SCOPES,
|
|
}
|
|
|
|
response = http.anon_post(url, data, allow_redirects=False)
|
|
|
|
# If auth fails, it redirects to the login page
|
|
if response.is_redirect:
|
|
raise AuthenticationError()
|
|
|
|
return response.json()
|
|
|
|
|
|
def get_browser_login_url(app):
|
|
"""Returns the URL for manual log in via browser"""
|
|
return "{}/oauth/authorize/?{}".format(app.base_url, urlencode({
|
|
"response_type": "code",
|
|
"redirect_uri": "urn:ietf:wg:oauth:2.0:oob",
|
|
"scope": SCOPES,
|
|
"client_id": app.client_id,
|
|
}))
|
|
|
|
|
|
def request_access_token(app, authorization_code):
|
|
url = app.base_url + '/oauth/token'
|
|
|
|
data = {
|
|
'grant_type': 'authorization_code',
|
|
'client_id': app.client_id,
|
|
'client_secret': app.client_secret,
|
|
'code': authorization_code,
|
|
'redirect_uri': 'urn:ietf:wg:oauth:2.0:oob',
|
|
}
|
|
|
|
return http.anon_post(url, data, allow_redirects=False).json()
|
|
|
|
|
|
def post_status(
|
|
app,
|
|
user,
|
|
status,
|
|
visibility='public',
|
|
media_ids=None,
|
|
sensitive=False,
|
|
spoiler_text=None,
|
|
in_reply_to_id=None,
|
|
language=None,
|
|
):
|
|
"""
|
|
Posts a new status.
|
|
https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#posting-a-new-status
|
|
"""
|
|
|
|
# Idempotency key assures the same status is not posted multiple times
|
|
# if the request is retried.
|
|
headers = {"Idempotency-Key": uuid.uuid4().hex}
|
|
|
|
return http.post(app, user, '/api/v1/statuses', {
|
|
'status': status,
|
|
'media_ids[]': media_ids,
|
|
'visibility': visibility,
|
|
'sensitive': str_bool(sensitive),
|
|
'spoiler_text': spoiler_text,
|
|
'in_reply_to_id': in_reply_to_id,
|
|
'language': language,
|
|
}, headers=headers).json()
|
|
|
|
|
|
def delete_status(app, user, status_id):
|
|
"""
|
|
Deletes a status with given ID.
|
|
https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#deleting-a-status
|
|
"""
|
|
return http.delete(app, user, '/api/v1/statuses/{}'.format(status_id))
|
|
|
|
|
|
def favourite(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'favourite')
|
|
|
|
|
|
def unfavourite(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'unfavourite')
|
|
|
|
|
|
def reblog(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'reblog')
|
|
|
|
|
|
def unreblog(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'unreblog')
|
|
|
|
|
|
def pin(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'pin')
|
|
|
|
|
|
def unpin(app, user, status_id):
|
|
return _status_action(app, user, status_id, 'unpin')
|
|
|
|
|
|
def context(app, user, status_id):
|
|
url = '/api/v1/statuses/{}/context'.format(status_id)
|
|
|
|
return http.get(app, user, url).json()
|
|
|
|
|
|
def reblogged_by(app, user, status_id):
|
|
url = '/api/v1/statuses/{}/reblogged_by'.format(status_id)
|
|
|
|
return http.get(app, user, url).json()
|
|
|
|
|
|
def _get_next_path(headers):
|
|
"""Given timeline response headers, returns the path to the next batch"""
|
|
links = headers.get('Link', '')
|
|
matches = re.match('<([^>]+)>; rel="next"', links)
|
|
if matches:
|
|
parsed = urlparse(matches.group(1))
|
|
return "?".join([parsed.path, parsed.query])
|
|
|
|
|
|
def _timeline_generator(app, user, path, params=None):
|
|
while path:
|
|
response = http.get(app, user, path, params)
|
|
yield response.json()
|
|
path = _get_next_path(response.headers)
|
|
|
|
|
|
def _anon_timeline_generator(instance, path, params=None):
|
|
while path:
|
|
url = "https://{}{}".format(instance, path)
|
|
response = http.anon_get(url, params)
|
|
yield response.json()
|
|
path = _get_next_path(response.headers)
|
|
|
|
|
|
def home_timeline_generator(app, user, limit=20):
|
|
path = '/api/v1/timelines/home?limit={}'.format(limit)
|
|
return _timeline_generator(app, user, path)
|
|
|
|
|
|
def public_timeline_generator(instance, local=False, limit=20):
|
|
path = '/api/v1/timelines/public'
|
|
params = {'local': str_bool(local), 'limit': limit}
|
|
return _anon_timeline_generator(instance, path, params)
|
|
|
|
|
|
def tag_timeline_generator(instance, hashtag, local=False, limit=20):
|
|
path = '/api/v1/timelines/tag/{}'.format(hashtag)
|
|
params = {'local': str_bool(local), 'limit': limit}
|
|
return _anon_timeline_generator(instance, path, params)
|
|
|
|
|
|
def timeline_list_generator(app, user, list_id, limit=20):
|
|
path = '/api/v1/timelines/list/{}'.format(list_id)
|
|
return _timeline_generator(app, user, path, {'limit': limit})
|
|
|
|
|
|
def upload_media(app, user, file):
|
|
return http.post(app, user, '/api/v1/media', files={
|
|
'file': file
|
|
}).json()
|
|
|
|
|
|
def search(app, user, query, resolve):
|
|
return http.get(app, user, '/api/v2/search', {
|
|
'q': query,
|
|
'resolve': resolve,
|
|
}).json()
|
|
|
|
|
|
def search_accounts(app, user, query):
|
|
return http.get(app, user, '/api/v1/accounts/search', {
|
|
'q': query,
|
|
}).json()
|
|
|
|
|
|
def follow(app, user, account):
|
|
return _account_action(app, user, account, 'follow')
|
|
|
|
|
|
def unfollow(app, user, account):
|
|
return _account_action(app, user, account, 'unfollow')
|
|
|
|
|
|
def mute(app, user, account):
|
|
return _account_action(app, user, account, 'mute')
|
|
|
|
|
|
def unmute(app, user, account):
|
|
return _account_action(app, user, account, 'unmute')
|
|
|
|
|
|
def block(app, user, account):
|
|
return _account_action(app, user, account, 'block')
|
|
|
|
|
|
def unblock(app, user, account):
|
|
return _account_action(app, user, account, 'unblock')
|
|
|
|
|
|
def verify_credentials(app, user):
|
|
return http.get(app, user, '/api/v1/accounts/verify_credentials').json()
|
|
|
|
|
|
def single_status(app, user, status_id):
|
|
url = '/api/v1/statuses/{}'.format(status_id)
|
|
|
|
return http.get(app, user, url).json()
|
|
|
|
|
|
def get_notifications(app, user):
|
|
return http.get(app, user, '/api/v1/notifications').json()
|
|
|
|
|
|
def clear_notifications(app, user):
|
|
http.post(app, user, '/api/v1/notifications/clear')
|
|
|
|
|
|
def get_instance(domain, scheme="https"):
|
|
url = "{}://{}/api/v1/instance".format(scheme, domain)
|
|
return http.anon_get(url).json()
|