from flask_restful import abort, Resource from flask import request, make_response import validators from . import auth # https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html class Watch(Resource): def __init__(self, **kwargs): # datastore is a black box dependency self.datastore = kwargs['datastore'] self.update_q = kwargs['update_q'] # Get information about a single watch, excluding the history list (can be large) # curl http://localhost:4000/api/v1/watch/ # ?recheck=true @auth.check_token def get(self, uuid): from copy import deepcopy watch = deepcopy(self.datastore.data['watching'].get(uuid)) if not watch: abort(404, message='No watch exists with the UUID of {}'.format(uuid)) if request.args.get('recheck'): self.update_q.put(uuid) return "OK", 200 # Return without history, get that via another API call watch['history_n'] = len(watch['history']) del (watch['history']) return watch @auth.check_token def delete(self, uuid): if not self.datastore.data['watching'].get(uuid): abort(400, message='No watch exists with the UUID of {}'.format(uuid)) self.datastore.delete(uuid) return 'OK', 204 class WatchHistory(Resource): def __init__(self, **kwargs): # datastore is a black box dependency self.datastore = kwargs['datastore'] # Get a list of available history for a watch by UUID # curl http://localhost:4000/api/v1/watch//history def get(self, uuid): watch = self.datastore.data['watching'].get(uuid) if not watch: abort(404, message='No watch exists with the UUID of {}'.format(uuid)) return watch['history'], 200 class WatchSingleHistory(Resource): def __init__(self, **kwargs): # datastore is a black box dependency self.datastore = kwargs['datastore'] # Read a given history snapshot and return its content # or "latest" # curl http://localhost:4000/api/v1/watch//history/ @auth.check_token def get(self, uuid, timestamp): watch = self.datastore.data['watching'].get(uuid) if not watch: abort(404, message='No watch exists with the UUID of {}'.format(uuid)) if not len(watch['history']): abort(404, message='Watch found but no history exists for the UUID {}'.format(uuid)) if timestamp == 'latest': timestamp = list(watch['history'].keys())[-1] with open(watch['history'][timestamp], 'r') as f: content = f.read() response = make_response(content, 200) response.mimetype = "text/plain" return response class CreateWatch(Resource): def __init__(self, **kwargs): # datastore is a black box dependency self.datastore = kwargs['datastore'] self.update_q = kwargs['update_q'] @auth.check_token def post(self): # curl http://localhost:4000/api/v1/watch -H "Content-Type: application/json" -d '{"url": "https://my-nice.com", "tag": "one, two" }' json_data = request.get_json() tag = json_data['tag'].strip() if json_data.get('tag') else '' if not validators.url(json_data['url'].strip()): return "Invalid or unsupported URL", 400 extras = {'title': json_data['title'].strip()} if json_data.get('title') else {} new_uuid = self.datastore.add_watch(url=json_data['url'].strip(), tag=tag, extras=extras) self.update_q.put(new_uuid) return {'uuid': new_uuid}, 201 # Return concise list of available watches and some very basic info # curl http://localhost:4000/api/v1/watch|python -mjson.tool # ?recheck_all=1 to recheck all @auth.check_token def get(self): list = {} for k, v in self.datastore.data['watching'].items(): list[k] = {'url': v['url'], 'title': v['title'], 'last_checked': v['last_checked'], 'last_changed': v['last_changed'], 'last_error': v['last_error']} if request.args.get('recheck_all'): for uuid in self.datastore.data['watching'].keys(): self.update_q.put(uuid) return {'status': "OK"}, 200 return list, 200