gui.py

   1 # -*- coding: utf-8 -*-
   2
   3 """
   4 Dboxswitch dropbox profile switcher
   5
   6 license: Modified BSD License
   7
   8 Copyright (c) 2012,  <stack@inventati.org>
   9 All rights reserved.
  10
  11 Redistribution and use in source and binary forms, with or without
  12 modification, are permitted provided that the following conditions are met:
  13     * Redistributions of source code must retain the above copyright
  14       notice, this list of conditions and the following disclaimer.
  15     * Redistributions in binary form must reproduce the above copyright
  16       notice, this list of conditions and the following disclaimer in the
  17       documentation and/or other materials provided with the distribution.
  18     * Neither the name of the <organization> nor the
  19       names of its contributors may be used to endorse or promote products
  20       derived from this software without specific prior written permission.
  21
  22 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  23 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  24 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25 DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
  26 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  27 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  28 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  29 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  31 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32
  33 """
  34 import sys
  35 import os
  36 from PyQt4 import QtGui, QtCore
  37 from PyQt4.QtCore import SIGNAL
  38 from qmenutooltip import QMenuToolTip
  39
  40 from apperror import AppError
  41 from settings import appconf
  42
  43 class Gui(QtGui.QDialog):
  44     def __init__(self, prManager):
  45         """ Gui init, an QApplication is created and stored here, also a main window and a trayIcon
  46         are created.
  47         Default actions are builded and profile manager stored from argument (instance of ProfHandler """
  48
  49         self.app = QtGui.QApplication(sys.argv)
  50
  51         #check if system tray is avaiable on the system
  52         if not QtGui.QSystemTrayIcon.isSystemTrayAvailable():
  53             QtGui.QMessageBox.critical(None, "Systray",
  54                     "I couldn't detect any system tray on this system.")
  55             sys.exit(1)
  56
  57         QtGui.QApplication.setQuitOnLastWindowClosed(False)
  58
  59         super(Gui, self).__init__()
  60
  61         self.createActions()
  62         self.createTrayIcon()
  63
  64         self.trayIcon.show()
  65
  66         self.setWindowTitle("Profile manager / Dboxswitch - dropbox profile switcher")
  67         self.resize(200, 200)
  68
  69         self.profileManager = prManager
  70
  71     def main(self):
  72         """ Like Gtk application this main executes the app, thi is somewhat writed for
  73         compatibility in porting the app """
  74
  75         sys.exit(self.app.exec_())
  76
  77     def closeEvent(self, event):
  78         """ Handle application closing """
  79
  80         if self.trayIcon.isVisible():
  81             self.hide()
  82             event.ignore()
  83
  84     def createActions(self):
  85         """ Create actions for the various components """
  86
  87         self.manageprofiles = QtGui.QAction("Manage &Profiles", self,
  88                 triggered=self.hide)
  89         self.quitAction = QtGui.QAction("&Quit", self,
  90                 triggered=QtGui.qApp.quit)
  91
  92         #profile manager component
  93         self.addProfile = QtGui.QAction("  Add &Profile  ", self,
  94                 triggered=self.addProfile)
  95
  96
  97     def createTrayIcon(self):
  98          """ Builds a new tray icon with a context menu and an action for the profile manager menu """
  99
 100          #context menu build, right click
 101          self.trayIconMenu = QtGui.QMenu(self)
 102          self.trayIconMenu.addAction(self.manageprofiles)
 103          self.trayIconMenu.addSeparator()
 104          self.trayIconMenu.addAction(self.quitAction)
 105
 106          #create the tray with an incon
 107          self.trayIcon = QtGui.QSystemTrayIcon(QtGui.QIcon(appconf.icon), self.app)
 108          #attach a context menu for the right click to the tray
 109          self.trayIcon.setContextMenu(self.trayIconMenu)
 110          #baloon on hover for the tray
 111          self.trayIcon.setToolTip(appconf.appname+" "+appconf.appversion+"\nRight Click to manage profiles.")
 112          #left click profiles show for the tray
 113          self.trayIcon.activated.connect(self.showTrayProfiles)
 114
 115
 116     def showTrayProfiles(self,reason):
 117         """ Pops up a system tray profile Manager with a list of activable profiles and an
 118         action to add a new One """
 119
 120         if reason in (QtGui.QSystemTrayIcon.Trigger, QtGui.QSystemTrayIcon.DoubleClick):
 121             self.menuProfiles = QMenuToolTip()
 122             self.menuProfiles.setTitle("Profiles")
 123             QtCore.QCoreApplication.setAttribute(QtCore.Qt.AA_DontShowIconsInMenus, False)
 124
 125             #Get profiles from the ProfHandler embedded in the gui
 126             profiles = self.profileManager.getProfilesList()
 127
 128             for prpath in profiles:
 129                 pr = os.path.basename(prpath)
 130                 receiver = self.activateProfileAction(prpath)
 131                 menuItem_Profile = self.menuProfiles.addAction(pr)
 132                 if self.profileManager.isCurrentProfile(prpath):
 133                     menuItem_Profile.setIcon(QtGui.QIcon(appconf.cpicon))
 134
 135                 #Using lambda function to pass additional arguments to the function, in this case the path of the profile
 136                 self.connect(menuItem_Profile, SIGNAL('triggered()'), receiver)
 137                 #set menu item ToolTip
 138                 menuItem_Profile.setToolTip("Activate profile: "+pr)
 139
 140                 self.menuProfiles.addAction(menuItem_Profile)
 141
 142             self.menuProfiles.addSeparator()
 143             #action and menu item for adding a New Profile
 144             self.menuProfiles.addAction(self.addProfile)
 145
 146             self.menuProfiles.activateWindow()
 147             self.menuProfiles.popup(QtGui.QCursor.pos())
 148
 149     def activateProfileAction(self, pr):
 150         """ Returns a callable to be passed as an action for the switching profile mechanism
 151         to self.connect(menuItem_Profile...
 152         It compiles a function with a profile name as argument and also handle the displaying of errors."""
 153
 154         def f():
 155             try:
 156                 self.profileManager.activateProfile(pr)
 157             except AppError, e:
 158                 self.showError(str(e))
 159         return f
 160
 161     def addProfile(self):
 162         """ Gui frontend to add a new Profile, it requests the user a profile name
 163         through a QInputDialog and creates a new profile with the help of the ProfHandler embedded in the Gui """
 164
 165         self.setWindowTitle("Add New Profile - Dboxswitch - dropbox profile switcher")
 166         self.resize(300, 100)
 167         text, ok = QtGui.QInputDialog.getText(self, 'Input Dialog',
 168                             'Enter profile name:')
 169         if ok:
 170             try:
 171                 self.profileManager.addProfile(unicode(text))
 172             except AppError, e:
 173                 self.showError(str(e))
 174
 175     def showError(self, err):
 176         """ Display an error message through a QErrorMessage """
 177
 178         self.setWindowTitle("Error - Dboxswitch - dropbox profile switcher")
 179         self.resize(200, 100)
 180         err = QtGui.QErrorMessage.showMessage(QtGui.QErrorMessage.qtHandler(), "Error: "+err)