lib/python/Plugins/Plugin.py

   1 from Components.config import ConfigSubsection, config
   2 from Tools.LoadPixmap import LoadPixmap
   3
   4 config.plugins = ConfigSubsection()
   5
   6 class PluginDescriptor:
   7         """An object to describe a plugin."""
   8
   9         # where to list the plugin. Note that there are different call arguments,
  10         # so you might not be able to combine them.
  11
  12         # supported arguments are:
  13         #   session
  14         #   servicereference
  15         #   reason
  16
  17         # you have to ignore unknown kwargs!
  18
  19         # argument: session
  20         WHERE_EXTENSIONSMENU = 0
  21         WHERE_MAINMENU = 1
  22         WHERE_PLUGINMENU  = 2
  23         # argument: session, serviceref (currently selected)
  24         WHERE_MOVIELIST = 3
  25         # argument: menuid. Fnc must return list with menuitems (4-tuple of name, fnc to call, entryid or None, weight or None)
  26         WHERE_MENU = 4
  27
  28         # reason (0: start, 1: end)
  29         WHERE_AUTOSTART = 5
  30
  31         # start as wizard. In that case, fnc must be tuple (priority,class) with class being a screen class!
  32         WHERE_WIZARD = 6
  33
  34         # like autostart, but for a session. currently, only session starts are
  35         # delivered, and only on pre-loaded plugins
  36         WHERE_SESSIONSTART = 7
  37
  38         # start as teletext plugin. arguments: session, serviceref
  39         WHERE_TELETEXT = 8
  40
  41         # file-scanner, fnc must return a list of Scanners
  42         WHERE_FILESCAN = 9
  43
  44         # fnc must take an interface name as parameter and return None if the plugin supports an extended setup
  45         # or return a function which is called with session and the interface name for extended setup of this interface
  46         WHERE_NETWORKSETUP = 10
  47
  48         def __init__(self, name = "Plugin", where = [ ], description = "", icon = None, fnc = None, wakeupfnc = None):
  49                 self.name = name
  50                 if type(where) is list:
  51                         self.where = where
  52                 else:
  53                         self.where = [ where ]
  54                 self.description = description
  55
  56                 if type(icon) is str or icon is None:
  57                         self.iconstr = icon
  58                         self.icon = None
  59                 else:
  60                         self.icon = icon
  61
  62                 self.wakeupfnc = wakeupfnc
  63
  64                 self.__call__ = fnc
  65
  66         def updateIcon(self, path):
  67                 if type(self.iconstr) is str:
  68                         self.icon = LoadPixmap(path + "/" + self.iconstr)
  69                 else:
  70                         self.icon = None
  71
  72         def getWakeupTime(self):
  73                 return self.wakeupfnc and self.wakeupfnc() or -1
  74
  75         def __eq__(self, other):
  76                 return self.__call__ == other.__call__