gui.py

   1 # DSL - easy Display Setup for Laptops
   2 # Copyright (C) 2012-2015 Ralf Jung <post@ralfj.de>
   3 #
   4 # This program is free software; you can redistribute it and/or modify
   5 # it under the terms of the GNU General Public License as published by
   6 # the Free Software Foundation; either version 2 of the License, or
   7 # (at your option) any later version.
   8 #
   9 # This program is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 # GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License
  15 # along with this program; if not, write to the Free Software
  16 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  17
  18 # This file abstracts GUI stuff away, so that the actual dsl.py does not have to deal with it
  19
  20 '''
  21 This module implements two functions:
  22
  23 def error(message):
  24     This function displays the error message to the user in some appropriate fassion
  25
  26 def setup(internalResolutions, externalResolutions):
  27     Both arguments are lists of (width, height) tuples of resolutions. You can use dsl.res2user to obtain a user-readable representation of a resolution tuple.
  28     The user should be asked about his display setup preferences.
  29     The function returns None if the user cancelled, and an instance of dsl.ScreenSetup otherwise.
  30 '''
  31 import collections
  32
  33 from qt_frontend import QtFrontend
  34 from cli_frontend import CLIFrontend
  35 from zenity_frontend import ZenityFrontend
  36
  37
  38 # list of available frontends
  39 frontends = collections.OrderedDict()
  40 frontends["qt"] = QtFrontend
  41 frontends["zenity"] = ZenityFrontend
  42 frontends["cli"] = CLIFrontend
  43
  44 # get a frontend
  45 def getFrontend(name = None):
  46     # by name
  47     if name is not None:
  48         if name in frontends:
  49             if frontends[name].isAvailable():
  50                 return frontends[name]() # call constructor
  51             else:
  52                 raise Exception("Frontend %s not available" % name)
  53         # frontend not found
  54         raise Exception("Frontend %s not found" % name)
  55     # auto-detect
  56     for frontend in frontends.values():
  57         if frontend.isAvailable():
  58             return frontend() # call constructor
  59     raise Exception("No frontend is available - this should not happen")