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, internal = False):
  49                 self.name = name
  50                 self.internal = internal
  51                 if type(where) is list:
  52                         self.where = where
  53                 else:
  54                         self.where = [ where ]
  55                 self.description = description
  56
  57                 if type(icon) is str or icon is None:
  58                         self.iconstr = icon
  59                         self.icon = None
  60                 else:
  61                         self.icon = icon
  62
  63                 self.wakeupfnc = wakeupfnc
  64
  65                 self.__call__ = fnc
  66
  67         def updateIcon(self, path):
  68                 if type(self.iconstr) is str:
  69                         self.icon = LoadPixmap(path + "/" + self.iconstr)
  70                 else:
  71                         self.icon = None
  72
  73         def getWakeupTime(self):
  74                 return self.wakeupfnc and self.wakeupfnc() or -1
  75
  76         def __eq__(self, other):
  77                 return self.__call__ == other.__call__