def _enableAccessibility(self):
"""Enables the GNOME accessibility flag. Users need to log out and
then back in for this to take effect.
Returns True if an action was taken (i.e., accessibility was not
set prior to this call).
"""
alreadyEnabled = settings.isAccessibilityEnabled()
if not alreadyEnabled:
settings.setAccessibilityEnabled(True)
return not alreadyEnabled
def _enableAccessibility(self):
"""Enables the GNOME accessibility flag. Users need to log out and
then back in for this to take effect.
Returns True if an action was taken (i.e., accessibility was not
set prior to this call).
"""
alreadyEnabled = settings.isAccessibilityEnabled()
if not alreadyEnabled:
settings.setAccessibilityEnabled(True)
return not alreadyEnabled
def main():
"""The main entry point for Orca. The exit codes for Orca will
loosely be based on signals, where the exit code will be the
signal used to terminate Orca (if a signal was used). Otherwise,
an exit code of 0 means normal completion and an exit code of 50
means Orca exited because of a hang."""
global _commandLineSettings
# Method to call when we think something might be hung.
#
settings.timeoutCallback = timeout
# Various signal handlers we want to listen for.
#
signal.signal(signal.SIGHUP, shutdownOnSignal)
signal.signal(signal.SIGINT, shutdownOnSignal)
signal.signal(signal.SIGTERM, shutdownOnSignal)
signal.signal(signal.SIGQUIT, shutdownOnSignal)
signal.signal(signal.SIGSEGV, abortOnSignal)
# See if the desktop is running. If it is, the import of gtk will
# succeed. If it isn't, the import will fail.
#
desktopRunning = False
try:
if gtk.gdk.display_get_default():
desktopRunning = True
except:
pass
# Parse the command line options.
#
# Run the preferences setup if the user has specified
# "--setup" or "--text-setup" on the command line. If the
# desktop is not running, we will fallback to the console-based
# method as appropriate.
#
bypassSetup = False
setupRequested = False
showGUI = False
# We hack a little here because the shell script to start orca can
# conflate all of command line arguments into one string, which is
# not what we want. We detect this by seeing if the length of the
# argument list is 1.
#
arglist = sys.argv[1:]
if len(arglist) == 1:
arglist = arglist[0].split()
try:
# ? is for help
# e is for enabling a feature
# d is for disabling a feature
# h is for help
# u is for alternate user preferences location
# s is for setup
# n is for no setup
# t is for text setup
# v is for version
#
opts, args = getopt.getopt(
arglist,
"?stnvd:e:u:",
["help",
"user-prefs-dir=",
"enable=",
"disable=",
"setup",
"gui-setup",
"text-setup",
"no-setup",
"version"])
for opt, val in opts:
if opt in ("-u", "--user-prefs-dir"):
userPrefsDir = val.strip();
try:
os.chdir(userPrefsDir)
settings.userPrefsDir = userPrefsDir
except:
debug.printException(debug.LEVEL_FINEST)
if opt in ("-e", "--enable"):
feature = val.strip()
if feature == "speech":
_commandLineSettings["enableSpeech"] = True
elif feature == "braille":
_commandLineSettings["enableBraille"] = True
elif feature == "braille-monitor":
_commandLineSettings["enableBrailleMonitor"] = True
elif feature == "magnifier":
_commandLineSettings["enableMagnifier"] = True
elif feature == "main-window":
_commandLineSettings["showMainWindow"] = True
else:
usage()
os._exit(2)
if opt in ("-d", "--disable"):
feature = val.strip()
if feature == "speech":
_commandLineSettings["enableSpeech"] = False
elif feature == "braille":
_commandLineSettings["enableBraille"] = False
elif feature == "braille-monitor":
_commandLineSettings["enableBrailleMonitor"] = False
elif feature == "magnifier":
_commandLineSettings["enableMagnifier"] = False
elif feature == "main-window":
_commandLineSettings["showMainWindow"] = False
else:
usage()
os._exit(2)
if opt in ("-s", "--gui-setup", "--setup"):
setupRequested = True
showGUI = desktopRunning
if opt in ("-t", "--text-setup"):
setupRequested = True
showGUI = False
if opt in ("-n", "--no-setup"):
bypassSetup = True
if opt in ("-?", "--help"):
usage()
os._exit(0)
if opt in ("-v", "--version"):
print "Orca %s" % platform.version
os._exit(0)
except:
debug.printException(debug.LEVEL_OFF)
usage()
os._exit(2)
# Do not run Orca if accessibility has not been enabled.
# We do allow, however, one to force Orca to run via the
# "-n" switch. The main reason is so that things such
# as accessible login can work -- in those cases, the gconf
# setting is typically not set since the gdm user does not
# have a home.
#
a11yEnabled = settings.isAccessibilityEnabled()
if (not bypassSetup) and (not a11yEnabled):
_showPreferencesConsole()
abort()
if setupRequested and (not bypassSetup) and (not showGUI):
_showPreferencesConsole()
if not desktopRunning:
print "Cannot start Orca because it cannot connect"
print "to the Desktop. Please make sure the DISPLAY"
print "environment variable has been set."
return 1
userprefs = settings.userPrefsDir
sys.path.insert(0, userprefs)
sys.path.insert(0, '') # current directory
registry = atspi.Registry()
init(registry)
try:
message = _("Welcome to Orca.")
speech.speak(message)
braille.displayMessage(message)
except:
debug.printException(debug.LEVEL_SEVERE)
# Check to see if the user wants the configuration GUI. It's
# done here so that the user's existing preferences can be used
# to set the initial GUI state. We'll also force the set to
# be run if the preferences file doesn't exist, unless the
# user has bypassed any setup via the --no-setup switch.
#
if setupRequested and (not bypassSetup) and showGUI:
_showPreferencesGUI()
elif (not _userSettings) and (not bypassSetup):
if desktopRunning:
_showPreferencesGUI()
else:
_showPreferencesConsole()
start(registry) # waits until we stop the registry
return 0
def main():
"""The main entry point for Orca. The exit codes for Orca will
loosely be based on signals, where the exit code will be the
signal used to terminate Orca (if a signal was used). Otherwise,
an exit code of 0 means normal completion and an exit code of 50
means Orca exited because of a hang."""
global _commandLineSettings
# Method to call when we think something might be hung.
#
settings.timeoutCallback = timeout
# Various signal handlers we want to listen for.
#
signal.signal(signal.SIGHUP, shutdownOnSignal)
signal.signal(signal.SIGINT, shutdownOnSignal)
signal.signal(signal.SIGTERM, shutdownOnSignal)
signal.signal(signal.SIGQUIT, shutdownOnSignal)
signal.signal(signal.SIGSEGV, abortOnSignal)
# See if the desktop is running. If it is, the import of gtk will
# succeed. If it isn't, the import will fail.
#
desktopRunning = False
try:
if gtk.gdk.display_get_default():
desktopRunning = True
except:
pass
# Parse the command line options.
#
# Run the preferences setup if the user has specified
# "--setup" or "--text-setup" on the command line. If the
# desktop is not running, we will fallback to the console-based
# method as appropriate.
#
bypassSetup = False
setupRequested = False
showGUI = False
# We hack a little here because the shell script to start orca can
# conflate all of command line arguments into one string, which is
# not what we want. We detect this by seeing if the length of the
# argument list is 1.
#
arglist = sys.argv[1:]
if len(arglist) == 1:
arglist = arglist[0].split()
try:
# ? is for help
# e is for enabling a feature
# d is for disabling a feature
# h is for help
# u is for alternate user preferences location
# s is for setup
# n is for no setup
# t is for text setup
# v is for version
#
opts, args = getopt.getopt(arglist, "?stnvd:e:u:", [
"help", "user-prefs-dir=", "enable=", "disable=", "setup",
"gui-setup", "text-setup", "no-setup", "version"
])
for opt, val in opts:
if opt in ("-u", "--user-prefs-dir"):
userPrefsDir = val.strip()
try:
os.chdir(userPrefsDir)
settings.userPrefsDir = userPrefsDir
except:
debug.printException(debug.LEVEL_FINEST)
if opt in ("-e", "--enable"):
feature = val.strip()
if feature == "speech":
_commandLineSettings["enableSpeech"] = True
elif feature == "braille":
_commandLineSettings["enableBraille"] = True
elif feature == "braille-monitor":
_commandLineSettings["enableBrailleMonitor"] = True
elif feature == "magnifier":
_commandLineSettings["enableMagnifier"] = True
elif feature == "main-window":
_commandLineSettings["showMainWindow"] = True
else:
usage()
os._exit(2)
if opt in ("-d", "--disable"):
feature = val.strip()
if feature == "speech":
_commandLineSettings["enableSpeech"] = False
elif feature == "braille":
_commandLineSettings["enableBraille"] = False
elif feature == "braille-monitor":
_commandLineSettings["enableBrailleMonitor"] = False
elif feature == "magnifier":
_commandLineSettings["enableMagnifier"] = False
elif feature == "main-window":
_commandLineSettings["showMainWindow"] = False
else:
usage()
os._exit(2)
if opt in ("-s", "--gui-setup", "--setup"):
setupRequested = True
showGUI = desktopRunning
if opt in ("-t", "--text-setup"):
setupRequested = True
showGUI = False
if opt in ("-n", "--no-setup"):
bypassSetup = True
if opt in ("-?", "--help"):
usage()
os._exit(0)
if opt in ("-v", "--version"):
print "Orca %s" % platform.version
os._exit(0)
except:
debug.printException(debug.LEVEL_OFF)
usage()
os._exit(2)
# Do not run Orca if accessibility has not been enabled.
# We do allow, however, one to force Orca to run via the
# "-n" switch. The main reason is so that things such
# as accessible login can work -- in those cases, the gconf
# setting is typically not set since the gdm user does not
# have a home.
#
a11yEnabled = settings.isAccessibilityEnabled()
if (not bypassSetup) and (not a11yEnabled):
_showPreferencesConsole()
abort()
if setupRequested and (not bypassSetup) and (not showGUI):
_showPreferencesConsole()
if not desktopRunning:
print "Cannot start Orca because it cannot connect"
print "to the Desktop. Please make sure the DISPLAY"
print "environment variable has been set."
return 1
userprefs = settings.userPrefsDir
sys.path.insert(0, userprefs)
sys.path.insert(0, '') # current directory
registry = atspi.Registry()
init(registry)
try:
message = _("Welcome to Orca.")
speech.speak(message)
braille.displayMessage(message)
except:
debug.printException(debug.LEVEL_SEVERE)
# Check to see if the user wants the configuration GUI. It's
# done here so that the user's existing preferences can be used
# to set the initial GUI state. We'll also force the set to
# be run if the preferences file doesn't exist, unless the
# user has bypassed any setup via the --no-setup switch.
#
if setupRequested and (not bypassSetup) and showGUI:
_showPreferencesGUI()
elif (not _userSettings) and (not bypassSetup):
if desktopRunning:
_showPreferencesGUI()
else:
_showPreferencesConsole()
start(registry) # waits until we stop the registry
return 0
