#!/usr/bin/env python # -*- coding: utf-8 -*- # This file is part of PlexPy. # # PlexPy is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # PlexPy is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with PlexPy. If not, see . import hashlib import inspect import json import os import random import re import threading import time import traceback import cherrypy import xmltodict import plexpy import database import logger import pmsconnect class API2: def __init__(self, **kwargs): self._api_valid_methods = self._api_docs().keys() self._api_authenticated = False self._api_out_type = 'json' # default self._api_msg = None self._api_debug = None self._api_cmd = None self._api_apikey = None self._api_callback = None # JSONP self._api_result_type = 'failed' self._api_profileme = None # For profiling the api call self._api_kwargs = None # Cleaned kwargs def _api_docs(self, md=False): """ Makes the api docs """ docs = {} for f, _ in inspect.getmembers(self, predicate=inspect.ismethod): if not f.startswith('_') and not f.startswith('_api'): if md is True: docs[f] = inspect.getdoc(getattr(self, f)) if inspect.getdoc(getattr(self, f)) else None else: docs[f] = ' '.join(inspect.getdoc(getattr(self, f)).split()) if inspect.getdoc(getattr(self, f)) else None return docs def docs_md(self): """ Return a API.md to simplify api docs because of the decorator. """ return self._api_make_md() def docs(self): """ Returns a dict where commands are keys, docstring are value. """ return self._api_docs() def _api_validate(self, *args, **kwargs): """ sets class vars and remove unneeded parameters. """ if not plexpy.CONFIG.API_ENABLED: self._api_msg = 'API not enabled' elif not plexpy.CONFIG.API_KEY: self._api_msg = 'API key not generated' elif len(plexpy.CONFIG.API_KEY) != 32: self._api_msg = 'API key not generated correctly' elif 'apikey' not in kwargs: self._api_msg = 'Parameter apikey is required' elif kwargs.get('apikey', '') != plexpy.CONFIG.API_KEY: self._api_msg = 'Invalid apikey' elif 'cmd' not in kwargs: self._api_msg = 'Parameter cmd is required. Possible commands are: %s' % ', '.join(self._api_valid_methods) elif 'cmd' in kwargs and kwargs.get('cmd') not in self._api_valid_methods: self._api_msg = 'Unknown command: %s. Possible commands are: %s' % (kwargs.get('cmd', ''), ', '.join(self._api_valid_methods)) self._api_callback = kwargs.pop('callback', None) self._api_apikey = kwargs.pop('apikey', None) self._api_cmd = kwargs.pop('cmd', None) self._api_debug = kwargs.pop('debug', False) self._api_profileme = kwargs.pop('profileme', None) # Allow override for the api. self._api_out_type = kwargs.pop('out_type', 'json') if self._api_apikey == plexpy.CONFIG.API_KEY and plexpy.CONFIG.API_ENABLED and self._api_cmd in self._api_valid_methods: self._api_authenticated = True self._api_msg = None self._api_kwargs = kwargs elif self._api_cmd in ('get_apikey', 'docs', 'docs_md') and plexpy.CONFIG.API_ENABLED: self._api_authenticated = True # Remove the old error msg self._api_msg = None self._api_kwargs = kwargs logger.debug(u'PlexPy APIv2 :: Cleaned kwargs %s' % self._api_kwargs) return self._api_kwargs def get_logs(self, sort='', search='', order='desc', regex='', start=0, end=0, **kwargs): """ Returns the log Args: sort(string, optional): time, thread, msg, loglevel search(string, optional): 'string' order(string, optional): desc, asc regex(string, optional): 'regexstring' start(int, optional): int end(int, optional): int Returns: ```{"response": {"msg": "Hey", "result": "success"}, "data": [ {"time": "29-sept.2015", "thread: "MainThread", "msg: "Called x from y", "loglevel": "DEBUG" } ] } ``` """ logfile = os.path.join(plexpy.CONFIG.LOG_DIR, 'plexpy.log') templog = [] start = int(kwargs.get('start', 0)) end = int(kwargs.get('end', 0)) if regex: logger.debug(u'PlexPy APIv2 :: Filtering log using regex %s' % regex) reg = re.compile('u' + regex, flags=re.I) for line in open(logfile, 'r').readlines(): temp_loglevel_and_time = None try: temp_loglevel_and_time = line.split('- ') loglvl = temp_loglevel_and_time[1].split(' :')[0].strip() tl_tread = line.split(' :: ') if loglvl is None: msg = line.replace('\n', '') else: msg = line.split(' : ')[1].replace('\n', '') thread = tl_tread[1].split(' : ')[0] except IndexError: # We assume this is a traceback tl = (len(templog) - 1) templog[tl]['msg'] += line.replace('\n', '') continue if len(line) > 1 and temp_loglevel_and_time is not None and loglvl in line: d = { 'time': temp_loglevel_and_time[0], 'loglevel': loglvl, 'msg': msg.replace('\n', ''), 'thread': thread } templog.append(d) if end > 0 or start > 0: logger.debug(u'PlexPy APIv2 :: Slicing the log from %s to %s' % (start, end)) templog = templog[start:end] if sort: logger.debug(u'PlexPy APIv2 :: Sorting log based on %s' % sort) templog = sorted(templog, key=lambda k: k[sort]) if search: logger.debug(u'PlexPy APIv2 :: Searching log values for %s' % search) tt = [d for d in templog for k, v in d.items() if search.lower() in v.lower()] if len(tt): templog = tt if regex: tt = [] for l in templog: stringdict = ' '.join('{}{}'.format(k, v) for k, v in l.items()) if reg.search(stringdict): tt.append(l) if len(tt): templog = tt if order == 'desc': templog = templog[::-1] self.data = templog return templog def get_settings(self, key=''): """ Fetches all settings from the config file Args: key(string, optional): 'Run the it without args to see all args' Returns: json: ``` {General: {api_enabled: true, ...} Advanced: {cache_sizemb: "32", ...}} ``` """ interface_dir = os.path.join(plexpy.PROG_DIR, 'data/interfaces/') interface_list = [name for name in os.listdir(interface_dir) if os.path.isdir(os.path.join(interface_dir, name))] conf = plexpy.CONFIG._config config = {} # Truthify the dict for k, v in conf.iteritems(): if isinstance(v, dict): d = {} for kk, vv in v.iteritems(): if vv == '0' or vv == '1': d[kk] = bool(vv) else: d[kk] = vv config[k] = d if k == 'General': config[k]['interface'] = interface_dir config[k]['interface_list'] = interface_list if key: return config.get(key, None) return config def sql(self, query=''): """ Query the db with raw sql, makes backup of the db if the backup is older then 24h """ if not plexpy.CONFIG.API_SQL or not query: return # allow the user to shoot them self # in the foot but not in the head.. if not len(os.listdir(plexpy.BACKUP_DIR)): self.backupdb() else: # If the backup is less then 24 h old lets make a backup if any([os.path.getctime(os.path.join(plexpy.BACKUP_DIR, file_)) < (time.time() - 86400) for file_ in os.listdir(plexpy.BACKUP_DIR)]): self.backupdb() db = database.MonitorDatabase() rows = db.select(query) self.data = rows return rows def backupdb(self): """ Creates a manual backup of the plexpy.db file """ data = database.make_backup() if data: self.result_type = 'success' else: self.result_type = 'failed' return data def restart(self, **kwargs): """ Restarts plexpy """ plexpy.SIGNAL = 'restart' self.msg = 'Restarting plexpy' self.result_type = 'success' def update(self, **kwargs): """ Check for updates on Github """ plexpy.SIGNAL = 'update' self.msg = 'Updating plexpy' self.result_type = 'success' def refresh_libraries_list(self, **kwargs): threading.Thread(target=pmsconnect.refresh_libraries).start() self.result_type = 'success' def _api_make_md(self): """ Tries to make a API.md to simplify the api docs """ head = '''# API Reference\n The API is still pretty new and needs some serious cleaning up on the backend but should be reasonably functional. There are no error codes yet. ## General structure The API endpoint is `http://ip:port + HTTP_ROOT + /api?apikey=$apikey&cmd=$command` Response example ``` { "response": { "data": [ { "loglevel": "INFO", "msg": "Signal 2 caught, saving and exiting...", "thread": "MainThread", "time": "22-sep-2015 01:42:56 " } ], "message": null, "result": "success" } } ``` General parameters: out_type: 'xml', callback: 'pong', 'debug': 1 ## API methods''' body = '' doc = self._api_docs(md=True) for k in sorted(doc): v = doc.get(k) body += '### %s\n' % k body += '' if not v else v + '\n' body += '\n\n' result = head + '\n\n' + body return '
' + result + '
' def get_apikey(self, username='', password=''): """ Fetches apikey Args: username(string, optional): Your username password(string, optional): Your password Returns: string: Apikey, args are required if auth is enabled makes and saves the apikey it does not exist """ apikey = hashlib.sha224(str(random.getrandbits(256))).hexdigest()[0:32] if plexpy.CONFIG.HTTP_USERNAME and plexpy.CONFIG.HTTP_PASSWORD: if username == plexpy.HTTP_USERNAME and password == plexpy.CONFIG.HTTP_PASSWORD: if plexpy.CONFIG.API_KEY: self.data = plexpy.CONFIG.API_KEY else: self.data = apikey plexpy.CONFIG.API_KEY = apikey plexpy.CONFIG.write() else: self.msg = 'Authentication is enabled, please add the correct username and password to the parameters' else: if plexpy.CONFIG.API_KEY: self.data = plexpy.CONFIG.API_KEY else: # Make a apikey if the doesn't exist self.data = apikey plexpy.CONFIG.API_KEY = apikey plexpy.CONFIG.write() return self.data def _api_responds(self, result_type='success', data=None, msg=''): """ Formats the result to a predefined dict so we can hange it the to the desired output by _api_out_as """ if data is None: data = {} return {"response": {"result": result_type, "message": msg, "data": data}} def _api_out_as(self, out): """ Formats the response to the desired output """ if self._api_cmd == 'docs_md': return out['response']['data'] if self._api_out_type == 'json': cherrypy.response.headers['Content-Type'] = 'application/json;charset=UTF-8' try: if self._api_debug: out = json.dumps(out, indent=4, sort_keys=True) else: out = json.dumps(out) if self._api_callback is not None: cherrypy.response.headers['Content-Type'] = 'application/javascript' # wrap with JSONP call if requested out = self._api_callback + '(' + out + ');' # if we fail to generate the output fake an error except Exception as e: logger.info(u'PlexPy APIv2 :: ' + traceback.format_exc()) out['message'] = traceback.format_exc() out['result'] = 'error' elif self._api_out_type == 'xml': cherrypy.response.headers['Content-Type'] = 'application/xml' try: out = xmltodict.unparse(out, pretty=True) except Exception as e: logger.error(u'PlexPy APIv2 :: Failed to parse xml result') try: out['message'] = e out['result'] = 'error' out = xmltodict.unparse(out, pretty=True) except Exception as e: logger.error(u'PlexPy APIv2 :: Failed to parse xml result error message %s' % e) out = ''' %s error ''' % e return out def _api_run(self, *args, **kwargs): """ handles the stuff from the handler """ result = {} logger.debug(u'PlexPy APIv2 :: Original kwargs was %s' % kwargs) self._api_validate(**kwargs) if self._api_cmd and self._api_authenticated: call = getattr(self, self._api_cmd) # Profile is written to console. if self._api_profileme: from profilehooks import profile call = profile(call, immediate=True) # We allow this to fail so we get a # traceback in the browser if self._api_debug: result = call(**self._api_kwargs) else: try: result = call(**self._api_kwargs) except Exception as e: logger.error(u'PlexPy APIv2 :: Failed to run %s %s %s' % (self._api_cmd, self._api_kwargs, e)) ret = None # The api decorated function can return different result types. # convert it to a list/dict before we change it to the users # wanted output try: if isinstance(result, (dict, list)): ret = result else: raise except: try: ret = json.loads(result) except (ValueError, TypeError): try: ret = xmltodict.parse(result, attr_prefix='') except: pass # Fallback if we cant "parse the reponse" if ret is None: ret = result if ret or self._api_result_type == 'success': # To allow override for restart etc # if the call returns some data we are gonna assume its a success self._api_result_type = 'success' else: self._api_result_type = 'error' return self._api_out_as(self._api_responds(result_type=self._api_result_type, msg=self._api_msg, data=ret))