# Base classes for the graphical user interface. # # Copyright (C) 2011-2012 Red Hat, Inc. # # This copyrighted material is made available to anyone wishing to use, # modify, copy, or redistribute it subject to the terms and conditions of # the GNU General Public License v.2, or (at your option) any later version. # This program is distributed in the hope that it will be useful, but WITHOUT # ANY WARRANTY expressed or implied, including the implied warranties of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General # Public License for more details. You should have received a copy of the # GNU General Public License along with this program; if not, write to the # Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA # 02110-1301, USA. Any Red Hat trademarks that are incorporated in the # source code or documentation are not subject to the GNU General Public # License and may only be used or replicated with the express permission of # Red Hat, Inc. # # Red Hat Author(s): Chris Lumens # import importlib, inspect, os, sys, time import meh.ui.gui from gi.repository import Gdk from pyanaconda.product import distributionText, isFinal from pyanaconda.ui import UserInterface, common from pyanaconda.ui.gui.utils import enlightbox, gtk_thread_wait import gettext _ = lambda x: gettext.ldgettext("anaconda", x) import logging log = logging.getLogger("anaconda") __all__ = ["GraphicalUserInterface", "UIObject", "busyCursor", "unbusyCursor"] _screenshotIndex = 0 class GraphicalUserInterface(UserInterface): """This is the standard GTK+ interface we try to steer everything to using. It is suitable for use both directly and via VNC. """ def __init__(self, storage, payload, instclass): UserInterface.__init__(self, storage, payload, instclass) self._actions = [] self._currentAction = None self._ui = None self.data = None # This is a hack to make sure the AnacondaWidgets library gets loaded # before the introspection stuff. import ctypes ctypes.CDLL("libAnacondaWidgets.so.0", ctypes.RTLD_GLOBAL) def setup(self, data): from hubs.summary import SummaryHub from hubs.progress import ProgressHub from spokes import StandaloneSpoke busyCursor() hubs = [SummaryHub, ProgressHub] path = os.path.join(os.path.dirname(__file__), "spokes") self._actions = self.getActionClasses("pyanaconda.ui.gui.spokes.%s", path, hubs, StandaloneSpoke) self.data = data def _instantiateAction(self, actionClass): from spokes import StandaloneSpoke # Instantiate an action on-demand, passing the arguments defining our # spoke API and setting up continue/quit signal handlers. obj = actionClass(self.data, self.storage, self.payload, self.instclass) # If we are doing a kickstart install, some standalone spokes # could already be filled out. In that case, we do not want # to display them. if isinstance(obj, StandaloneSpoke) and obj.completed: del(obj) return None obj.register_event_cb("continue", self._on_continue_clicked) obj.register_event_cb("quit", self._on_quit_clicked) return obj def run(self): from gi.repository import Gtk if Gtk.main_level() > 0: # Gtk main loop running. That means python-meh caught exception # and runs its main loop. Do not crash Gtk by running another one # from a different thread and just wait until python-meh is # finished, then quit. unbusyCursor() log.error("Unhandled exception caught, waiting for python-meh to "\ "exit") while Gtk.main_level() > 0: time.sleep(2) sys.exit(0) while not self._currentAction: self._currentAction = self._instantiateAction(self._actions[0]) if not self._currentAction: self._actions.pop(0) if not self._actions: sys.exit(0) return self._currentAction.initialize() # Do this at the last possible minute. unbusyCursor() self._currentAction.refresh() self._currentAction.window.set_beta(not isFinal) self._currentAction.window.set_property("distribution", distributionText().upper()) # Set fonts app-wide, where possible settings = Gtk.Settings.get_default() settings.set_property("gtk-font-name", "Cantarell") self._currentAction.window.show_all() Gtk.main() ### ### MESSAGE HANDLING METHODS ### @gtk_thread_wait def showError(self, message): from gi.repository import AnacondaWidgets, Gtk dlg = Gtk.MessageDialog(flags=Gtk.DialogFlags.MODAL, message_type=Gtk.MessageType.ERROR, buttons=Gtk.ButtonsType.NONE, message_format=message) dlg.set_decorated(False) dlg.add_button(_("_Exit Installer"), 0) with enlightbox(self._currentAction.window, dlg): dlg.run() dlg.destroy() @gtk_thread_wait def showDetailedError(self, message, details): from pyanaconda.ui.gui.spokes.lib.detailederror import DetailedErrorDialog dlg = DetailedErrorDialog(None, buttons=[_("_Quit")], label=message) with enlightbox(self._currentAction.window, dlg.window): dlg.refresh(details) rc = dlg.run() dlg.window.destroy() @gtk_thread_wait def showYesNoQuestion(self, message): from gi.repository import AnacondaWidgets, Gtk dlg = Gtk.MessageDialog(flags=Gtk.DialogFlags.MODAL, message_type=Gtk.MessageType.QUESTION, buttons=Gtk.ButtonsType.NONE, message_format=message) dlg.set_decorated(False) dlg.add_buttons(_("_No"), 0, _("_Yes"), 1) dlg.set_default_response(1) with enlightbox(self._currentAction.window, dlg): rc = dlg.run() dlg.destroy() return bool(rc) def mainExceptionWindow(self, text, exn_file, *args, **kwargs): from gi.repository import Gtk, AnacondaWidgets meh_intf = meh.ui.gui.GraphicalIntf() exc_window = meh_intf.mainExceptionWindow(text, exn_file) exc_window.main_window.set_decorated(False) # exception may appear before self._actions gets populated if len(self._actions) > 0: lightbox = AnacondaWidgets.lb_show_over(self._currentAction.window) exc_window.main_window.set_transient_for(lightbox) # without WindowGroup, python-meh's window is insensitive if it appears # above a spoke (Gtk.Window running its own Gtk.main loop) window_group = Gtk.WindowGroup() window_group.add_window(exc_window.main_window) return exc_window def saveExceptionWindow(self, account_manager, signature, *args, **kwargs): meh_intf = meh.ui.gui.GraphicalIntf() meh_intf.saveExceptionWindow(account_manager, signature) ### ### SIGNAL HANDLING METHODS ### def _on_continue_clicked(self): # If we're on the last screen, clicking Continue quits. if len(self._actions) == 1: sys.exit(0) return nextAction = None ndx = 0 # If the current action wants us to jump to an arbitrary point ahead, # look for where that is now. if self._currentAction.skipTo: found = False for ndx in range(1, len(self._actions)): if self._actions[ndx].__class__.__name__ == self._currentAction.skipTo: found = True break # If we found the point in question, compose a new actions list # consisting of the current action, the one to jump to, and all # the ones after. That means the rest of the code below doesn't # have to change. if found: self._actions = [self._actions[0]] + self._actions[ndx:] # _instantiateAction returns None for actions that should not be # displayed (because they're already completed, for instance) so skip # them here. while not nextAction: nextAction = self._instantiateAction(self._actions[1]) if not nextAction: self._actions.pop(1) if not self._actions: sys.exit(0) return nextAction.initialize() nextAction.window.set_beta(self._currentAction.window.get_beta()) nextAction.window.set_property("distribution", distributionText().upper()) if not nextAction.showable: self._currentAction.window.hide() self._actions.pop(0) self._on_continue_clicked() return nextAction.refresh() # Do this last. Setting up curAction could take a while, and we want # to leave something on the screen while we work. nextAction.window.show_all() self._currentAction.window.hide() self._currentAction = nextAction self._actions.pop(0) def _on_quit_clicked(self): dialog = QuitDialog(None) with enlightbox(self._currentAction.window, dialog.window): rc = dialog.run() dialog.window.destroy() if rc == 1: sys.exit(0) class GUIObject(common.UIObject): """This is the base class from which all other GUI classes are derived. It thus contains only attributes and methods that are common to everything else. It should not be directly instantiated. Class attributes: builderObjects -- A list of UI object names that should be extracted from uiFile and exposed for this class to use. If this list is empty, all objects will be exposed. Only the following kinds of objects need to be exported: (1) Top-level objects (like GtkDialogs) that are directly used in Python. (2) Top-level objects that are not directly used in Python, but are used by another object somewhere down in the hierarchy. This includes things like a custom GtkImage used by a button that is part of an exported dialog, and a GtkListStore that is the model of a Gtk*View that is part of an exported object. mainWidgetName -- The name of the top-level widget this object object implements. This will be the widget searched for in uiFile by the window property. uiFile -- The location of an XML file that describes the layout of widgets shown by this object. UI files are searched for relative to the same directory as this object's module. """ builderObjects = [] mainWidgetName = None uiFile = "" def __init__(self, data): """Create a new UIObject instance, including loading its uiFile and all UI-related objects. Instance attributes: data -- An instance of a pykickstart Handler object. The Hub never directly uses this instance. Instead, it passes it down into Spokes when they are created and applied. The Hub simply stores this instance so it doesn't need to be passed by the user. skipTo -- If this attribute is set to something other than None, it must be the name of a class (as a string). Then, the interface will skip to the first instance of that class in the action list instead of going on to whatever the next action is normally. Note that actions may only skip ahead, never backwards. Also, standalone spokes may not skip to an individual spoke off a hub. They can only skip to the hub itself. """ common.UIObject.__init__(self, data) if self.__class__ is GUIObject: raise TypeError("GUIObject is an abstract class") self.skipTo = None self.applyOnSkip = False from gi.repository import Gtk self.builder = Gtk.Builder() self.builder.set_translation_domain("anaconda") self._window = None if self.builderObjects: self.builder.add_objects_from_file(self._findUIFile(), self.builderObjects) else: self.builder.add_from_file(self._findUIFile()) self.builder.connect_signals(self) self.window.connect("key-release-event", self._handlePrntScreen) def _findUIFile(self): path = os.environ.get("UIPATH", "./:/tmp/updates/:/tmp/updates/ui/:/usr/share/anaconda/ui/") for d in path.split(":"): testPath = os.path.normpath(d + self.uiFile) if os.path.isfile(testPath) and os.access(testPath, os.R_OK): return testPath raise IOError("Could not load UI file '%s' for object '%s'" % (self.uiFile, self)) def _handlePrntScreen(self, window, event): global _screenshotIndex if event.keyval != Gdk.KEY_Print: return # Make sure the screenshot directory exists. if not os.access("/tmp/anaconda-screenshots", os.W_OK): os.mkdir("/tmp/anaconda-screenshots") fn = "/tmp/anaconda-screenshots/screenshot-%04d.png" % _screenshotIndex win = window.get_window() width = win.get_width() height = win.get_height() pixbuf = Gdk.pixbuf_get_from_window(win, 0, 0, width, height) pixbuf.savev(fn, "png", [], []) _screenshotIndex += 1 @property def window(self): """Return the top-level object out of the GtkBuilder representation previously loaded by the load method. """ # This will raise an AttributeError if the subclass failed to set a # mainWidgetName attribute, which is exactly what I want. if not self._window: self._window = self.builder.get_object(self.mainWidgetName) return self._window def clear_info(self): """Clear any info bar from the bottom of the screen.""" self.window.clear_info() def set_error(self, msg): """Display an info bar along the bottom of the screen with the provided message. This method is used to display critical errors anaconda may not be able to do anything about, but that the user may. A suitable background color and icon will be displayed. """ self.window.set_error(msg) def set_info(self, msg): """Display an info bar along the bottom of the screen with the provided message. This method is used to display informational text - non-critical warnings during partitioning, for instance. The user should investigate these messages but doesn't have to. A suitable background color and icon will be displayed. """ self.window.set_info(msg) def set_warning(self, msg): """Display an info bar along the bottom of the screen with the provided message. This method is used to display errors the user needs to attend to in order to continue installation. This is the bulk of messages. A suitable background color and icon will be displayed. """ self.window.set_warning(msg) class QuitDialog(GUIObject): builderObjects = ["quitDialog"] mainWidgetName = "quitDialog" uiFile = "main.glade" def run(self): rc = self.window.run() return rc def busyCursor(): window = Gdk.get_default_root_window() window.set_cursor(Gdk.Cursor(Gdk.CursorType.WATCH)) def unbusyCursor(): window = Gdk.get_default_root_window() window.set_cursor(Gdk.Cursor(Gdk.CursorType.ARROW))