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         # show up this plugin (or a choicebox with all of them) for long INFO keypress
  49         # or return a function which is called with session and the interface name for extended setup of this interface
  50         WHERE_EVENTINFO = 11
  51
  52         def __init__(self, name = "Plugin", where = [ ], description = "", icon = None, fnc = None, wakeupfnc = None, internal = False):
  53                 self.name = name
  54                 self.internal = internal
  55                 if type(where) is list:
  56                         self.where = where
  57                 else:
  58                         self.where = [ where ]
  59                 self.description = description
  60
  61                 if type(icon) is str or icon is None:
  62                         self.iconstr = icon
  63                         self.icon = None
  64                 else:
  65                         self.icon = icon
  66
  67                 self.wakeupfnc = wakeupfnc
  68
  69                 self.__call__ = fnc
  70
  71         def updateIcon(self, path):
  72                 if type(self.iconstr) is str:
  73                         self.icon = LoadPixmap(path + "/" + self.iconstr)
  74                 else:
  75                         self.icon = None
  76
  77         def getWakeupTime(self):
  78                 return self.wakeupfnc and self.wakeupfnc() or -1
  79
  80         def __eq__(self, other):
  81                 return self.__call__ == other.__call__