Mercurial Repositories > eric / file diff

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Plugins/VcsPlugins/vcsMercurial/HgExtensionProjectHelper.py	Tue May 31 10:31:06 2011 +0200
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2011 Detlev Offenbach <detlev@die-offenbachs.de>
+#
+
+"""
+Module implementing the project helper base for Mercurial extension interfaces.
+"""
+
+from PyQt4.QtCore import QObject
+
+
+class HgExtensionProjectHelper(QObject):
+    """
+    Class implementing the project helper base for Mercurial extension interfaces.
+    
+    Note: The methods initActions(), initMenu(mainMenu) and menuTitle() have to be
+          reimplemented by derived classes.
+    """
+    def __init__(self):
+        """
+        Constructor
+        """
+        QObject.__init__(self)
+        
+        self.actions = []
+        
+        self.initActions()
+    
+    def setObjects(self, vcsObject, projectObject):
+        """
+        Public method to set references to the vcs and project objects.
+        
+        @param vcsObject reference to the vcs object
+        @param projectObject reference to the project object
+        """
+        self.vcs = vcsObject
+        self.project = projectObject
+    
+    def getActions(self):
+        """
+        Public method to get a list of all actions.
+        
+        @return list of all actions (list of E5Action)
+        """
+        return self.actions[:]
+    
+    def initActions(self):
+        """
+        Public method to generate the action objects.
+        
+        Note: Derived class must implement this method.
+        
+        @exception NotImplementedError raised if the class has not been reimplemente
+        """
+        raise NotImplementedError
+    
+    def initMenu(self, mainMenu):
+        """
+        Public method to generate the extension menu.
+        
+        Note: Derived class must implement this method.
+        
+        @param mainMenu reference to the main menu (QMenu)
+        @return populated menu (QMenu)
+        @exception NotImplementedError raised if the class has not been reimplemente
+        """
+        raise NotImplementedError
+    
+    def menuTitle(self):
+        """
+        Public method to get the menu title.
+        
+        Note: Derived class must implement this method.
+        
+        @return title of the menu (string)
+        @exception NotImplementedError raised if the class has not been reimplemente
+        """
+        raise NotImplementedError