Merge branch 'bug_355_seek_fixes'
[enigma2.git] / 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         # reason (True: Networkconfig read finished, False: Networkconfig reload initiated )
53         WHERE_NETWORKCONFIG_READ = 12
54
55         WHERE_AUDIOMENU = 13
56
57         # fnc 'SoftwareSupported' or  'AdvancedSoftwareSupported' must take a parameter and return None
58         # if the plugin should not be displayed inside Softwaremanger or return a function which is called with session
59         # and 'None' as parameter to call the plugin from the Softwaremanager menus. "menuEntryName" and "menuEntryDescription"
60         # should be provided to name and describe the new menu entry.
61         WHERE_SOFTWAREMANAGER = 14
62
63
64         def __init__(self, name = "Plugin", where = [ ], description = "", icon = None, fnc = None, wakeupfnc = None, internal = False):
65                 self.name = name
66                 self.internal = internal
67                 if isinstance(where, list):
68                         self.where = where
69                 else:
70                         self.where = [ where ]
71                 self.description = description
72
73                 if icon is None or isinstance(icon, str):
74                         self.iconstr = icon
75                         self.icon = None
76                 else:
77                         self.icon = icon
78
79                 self.wakeupfnc = wakeupfnc
80
81                 self.__call__ = fnc
82
83         def updateIcon(self, path):
84                 if isinstance(self.iconstr, str):
85                         self.icon = LoadPixmap('/'.join((path, self.iconstr)))
86                 else:
87                         self.icon = None
88
89         def getWakeupTime(self):
90                 return self.wakeupfnc and self.wakeupfnc() or -1
91
92         def __eq__(self, other):
93                 return self.__call__ == other.__call__