Viewing file:  orca_prefs.py (34.34 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
# Orca
#
# Copyright 2004-2008 Sun Microsystems Inc.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Library General Public
# License as published by the Free Software Foundation; either
# version 2 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Library General Public License for more details.
#
# You should have received a copy of the GNU Library General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., Franklin Street, Fifth Floor,
# Boston MA 02110-1301 USA.
"""Common utilities to manage the writing of the user preferences file."""
__id__ = "$Id$"
__version__ = "$Revision$"
__date__ = "$Date$"
__copyright__ = "Copyright (c) 2005-2008 Sun Microsystems Inc."
__license__ = "LGPL"
import os
import pprint
import settings
# The same fields than in orca_gui_prefs.py:
#
(HANDLER, DESCRIP, MOD_MASK1, MOD_USED1, KEY1, CLICK_COUNT1, OLDTEXT1, \
TEXT1, MOD_MASK2, MOD_USED2, KEY2, CLICK_COUNT2, OLDTEXT2, TEXT2, MODIF, \
EDITABLE) = range(16)
(ACTUAL, REPLACEMENT) = range(2)
class OrcaPrefs:
def __init__(self, prefsDict, keyBindingsTreeModel=None,
pronunciationTreeModel=None):
"""Creates a new OrcaPrefs instance that will be used to write out
application specific preferences.
Arguments:
- prefsDict: a dictionary where the keys are orca preferences
names and the values are the values for the preferences.
- keyBindingsTreeModel - key bindings tree model, or None if we are
writing out console preferences.
- pronunciationTreeModel - pronunciation dictionary tree model, or
None if we are writing out console preferences.
"""
self.prefsDict = prefsDict
self.keyBindingsTreeModel = keyBindingsTreeModel
self.pronunciationTreeModel = pronunciationTreeModel
def _createDir(self, dirname):
"""Creates the given directory if it doesn't already exist.
"""
try:
os.chdir(dirname)
except:
os.mkdir(dirname)
def _writePreferencesPreamble(self, prefs):
"""Writes the preamble to the user-settings.py file."""
prefs.writelines("# -*- coding: utf-8 -*-\n")
prefs.writelines("# user-settings.py - custom Orca settings\n")
prefs.writelines("# Generated by orca. DO NOT EDIT THIS FILE!!!\n")
prefs.writelines( \
"# If you want permanent customizations that will not\n")
prefs.writelines("# be overwritten, edit orca-customizations.py.\n")
prefs.writelines("#\n")
prefs.writelines("import re\n")
prefs.writelines("import time\n")
prefs.writelines("\n")
prefs.writelines("import orca.debug\n")
prefs.writelines("import orca.settings\n")
prefs.writelines("import orca.acss\n")
prefs.writelines("\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_OFF\n")
prefs.writelines("orca.debug.debugLevel = orca.debug.LEVEL_SEVERE\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_WARNING\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_INFO\n")
prefs.writelines( \
"#orca.debug.debugLevel = orca.debug.LEVEL_CONFIGURATION\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_FINE\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_FINER\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_FINEST\n")
prefs.writelines("#orca.debug.debugLevel = orca.debug.LEVEL_ALL\n")
prefs.writelines("\n")
prefs.writelines("#orca.debug.eventDebugLevel = " \
"orca.debug.LEVEL_OFF\n")
prefs.writelines("#orca.debug.eventDebugFilter = None\n")
prefs.writelines("#orca.debug.eventDebugFilter = " \
"re.compile('[\S]*focus|[\S]*activ')\n")
prefs.writelines( \
"#orca.debug.eventDebugFilter = re.compile('nomatch')\n")
prefs.writelines("#orca.debug.eventDebugFilter = " \
"re.compile('[\S]*:accessible-name')\n")
prefs.writelines("#orca.debug.eventDebugFilter = " \
"re.compile('[\S]*:(?!bounds-changed)')\n")
prefs.writelines("\n")
prefs.writelines("#orca.debug.debugFile = " \
"open(time.strftime('debug-%Y-%m-%d-%H:%M:%S.out'), "\
"'w', 0)\n")
prefs.writelines("#orca.debug.debugFile = open('debug.out', 'w', 0)\n")
prefs.writelines("\n")
prefs.writelines("#orca.settings.useBonoboMain=False\n")
prefs.writelines("#orca.settings.debugEventQueue=True\n")
prefs.writelines("#orca.settings.gilSleepTime=0\n")
prefs.writelines("\n")
prefs.writelines("if False:\n")
prefs.writelines(" import sys\n")
prefs.writelines(" import orca.debug\n")
prefs.writelines(" sys.settrace(orca.debug.traceit)\n")
prefs.writelines(" orca.debug.debugLevel = orca.debug.LEVEL_ALL\n")
prefs.writelines("\n")
def _writePreferencesPostamble(self, prefs):
"""Writes the postamble to the user-settings.py file."""
prefs.writelines("\nimport orca.orca_state\n")
prefs.writelines("\ntry:\n")
prefs.writelines(" reload(orca.orca_state.orcaCustomizations)\n")
prefs.writelines("except AttributeError:\n")
prefs.writelines(" try:\n")
prefs.writelines(" orca.orca_state.orcaCustomizations = "
"__import__(\"orca-customizations\")\n")
prefs.writelines(" except ImportError:\n")
prefs.writelines(" pass\n")
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 _getDisplayString(self, display):
"""Returns a string that represents the source or target
magnifier display.
Arguments:
- display: the magnifier source or taget display string.
Returns a string suitable for the preferences file.
"""
if not display:
return "''"
else:
return "'%s'" % display
def _getSpeechServerFactoryString(self, factory):
"""Returns a string that represents the speech server factory passed in.
Arguments:
- factory: the speech server factory
Returns a string suitable for the preferences file.
"""
if not factory:
return None
elif isinstance(factory, basestring):
return "'%s'" % factory
else:
return "'%s'" % factory.__name__
def _getSpeechServerString(self, server):
"""Returns a string that represents the speech server passed in.
Arguments:
- server: a speech server
Returns a string suitable for the preferences file.
"""
if not server:
return None
elif isinstance(server, [].__class__):
return repr(server)
else:
return repr(server.getInfo())
def _getVoicesString(self, voices):
"""Returns a string that represents the list of voices passed in.
Arguments:
- voices: a list of ACSS instances.
Returns a string suitable for the preferences file.
"""
voicesStr = "{\n"
for voice in voices:
voicesStr += "'%s' : orca.acss.ACSS(" % voice
voicesStr += pprint.pformat(voices[voice]) + "),\n"
voicesStr += "}"
return voicesStr
def _getKeyboardLayoutString(self, keyboardLayout):
"""Returns a string that represents the keyboard layout passed in."""
if keyboardLayout == settings.GENERAL_KEYBOARD_LAYOUT_DESKTOP:
return "orca.settings.GENERAL_KEYBOARD_LAYOUT_DESKTOP"
else:
return "orca.settings.GENERAL_KEYBOARD_LAYOUT_LAPTOP"
def _getOrcaModifierKeysString(self, orcaModifierKeys):
"""Returns a string that represents the Orca modifier keys passed in."""
if orcaModifierKeys == settings.DESKTOP_MODIFIER_KEYS:
return "orca.settings.DESKTOP_MODIFIER_KEYS"
else:
return "orca.settings.LAPTOP_MODIFIER_KEYS"
def _getSpokenTextAttributesString(self, enabledSpokenTextAttributes):
""" Returns a string that represents the enabled spoken text attributes
passed in.
"""
return "\"" + enabledSpokenTextAttributes + "\""
def _getBrailledTextAttributesString(self, enabledBrailledTextAttributes):
""" Returns a string that represents the enabled brailled text
attributes passed in.
"""
return "\"" + enabledBrailledTextAttributes + "\""
def _getTextAttributesBrailleIndicatorString(self, brailleIndicator):
"""Returns a string that represents the text attribute braille indicator
value passed in."""
if brailleIndicator == settings.TEXT_ATTR_BRAILLE_NONE:
return "orca.settings.TEXT_ATTR_BRAILLE_NONE"
elif brailleIndicator == settings.TEXT_ATTR_BRAILLE_7:
return "orca.settings.TEXT_ATTR_BRAILLE_7"
elif brailleIndicator == settings.TEXT_ATTR_BRAILLE_8:
return "orca.settings.TEXT_ATTR_BRAILLE_8"
elif brailleIndicator == settings.TEXT_ATTR_BRAILLE_BOTH:
return "orca.settings.TEXT_ATTR_BRAILLE_BOTH"
else:
return "orca.settings.TEXT_ATTR_BRAILLE_NONE"
def _getBrailleSelectionIndicatorString(self, selectionIndicator):
"""Returns a string that represents the braille selection indicator
value passed in."""
if selectionIndicator == settings.BRAILLE_SEL_NONE:
return "orca.settings.BRAILLE_SEL_NONE"
elif selectionIndicator == settings.BRAILLE_SEL_7:
return "orca.settings.BRAILLE_SEL_7"
elif selectionIndicator == settings.BRAILLE_SEL_8:
return "orca.settings.BRAILLE_SEL_8"
elif selectionIndicator == settings.BRAILLE_SEL_BOTH:
return "orca.settings.BRAILLE_SEL_BOTH"
else:
return "orca.settings.BRAILLE_SEL_NONE"
def _getBrailleLinkIndicatorString(self, linkIndicator):
"""Returns a string that represents the braille link indicator
value passed in."""
if linkIndicator == settings.BRAILLE_LINK_NONE:
return "orca.settings.BRAILLE_LINK_NONE"
elif linkIndicator == settings.BRAILLE_LINK_7:
return "orca.settings.BRAILLE_LINK_7"
elif linkIndicator == settings.BRAILLE_LINK_8:
return "orca.settings.BRAILLE_LINK_8"
elif linkIndicator == settings.BRAILLE_LINK_BOTH:
return "orca.settings.BRAILLE_LINK_BOTH"
else:
return "orca.settings.BRAILLE_LINK_NONE"
def _getVerbosityString(self, verbosityLevel):
"""Returns a string that represents the verbosity level passed in."""
if verbosityLevel == settings.VERBOSITY_LEVEL_BRIEF:
return "orca.settings.VERBOSITY_LEVEL_BRIEF"
elif verbosityLevel == settings.VERBOSITY_LEVEL_VERBOSE:
return "orca.settings.VERBOSITY_LEVEL_VERBOSE"
else:
return "orca.settings.VERBOSITY_LEVEL_VERBOSE"
def _getBrailleRolenameStyleString(self, rolenameStyle):
"""Returns a string that represents the rolename style passed in."""
if rolenameStyle == settings.BRAILLE_ROLENAME_STYLE_SHORT:
return "orca.settings.BRAILLE_ROLENAME_STYLE_SHORT"
elif rolenameStyle == settings.BRAILLE_ROLENAME_STYLE_LONG:
return "orca.settings.BRAILLE_ROLENAME_STYLE_LONG"
else:
return "orca.settings.BRAILLE_ROLENAME_STYLE_LONG"
def _getBrailleAlignmentStyleString(self, brailleAlignmentStyle):
"""Returns a string that represents the brailleAlignmentStyle
passed in."""
if brailleAlignmentStyle == settings.ALIGN_BRAILLE_BY_WORD:
return "orca.settings.ALIGN_BRAILLE_BY_WORD"
if brailleAlignmentStyle == settings.ALIGN_BRAILLE_BY_MARGIN:
return "orca.settings.ALIGN_BRAILLE_BY_MARGIN"
else:
return "orca.settings.ALIGN_BRAILLE_BY_EDGE"
def _getVerbalizePunctuationStyleString(self, punctuationStyle):
"""Returns a string that represents the punctuation style passed in."""
if punctuationStyle == settings.PUNCTUATION_STYLE_NONE:
return "orca.settings.PUNCTUATION_STYLE_NONE"
elif punctuationStyle == settings.PUNCTUATION_STYLE_SOME:
return "orca.settings.PUNCTUATION_STYLE_SOME"
elif punctuationStyle == settings.PUNCTUATION_STYLE_MOST:
return "orca.settings.PUNCTUATION_STYLE_MOST"
elif punctuationStyle == settings.PUNCTUATION_STYLE_ALL:
return "orca.settings.PUNCTUATION_STYLE_ALL"
else:
return "orca.settings.PUNCTUATION_STYLE_ALL"
def _getSayAllStyleString(self, sayAllStyle):
"""Returns a string that represents the say all style passed in."""
if sayAllStyle == settings.SAYALL_STYLE_LINE:
return "orca.settings.SAYALL_STYLE_LINE"
elif sayAllStyle == settings.SAYALL_STYLE_SENTENCE:
return "orca.settings.SAYALL_STYLE_SENTENCE"
def _getMagColorString(self, cursorColor):
"""Returns a string that represents the magnification object's color
passed in.
Arguments:
- cursorColor: magnification object's color
Returns a string suitable for the preferences file.
"""
cursorColorStr = "'%s'" % cursorColor
return cursorColorStr
def _getMagSmoothingModeString(self, smoothingMode):
"""Returns a string that represents the magnification smoothing mode
passed in.
Arguments:
- smoothingMode: magnification smoothing mode.
Returns a string suitable for the preferences file.
"""
if smoothingMode == settings.MAG_SMOOTHING_MODE_BILINEAR:
return "orca.settings.MAG_SMOOTHING_MODE_BILINEAR"
elif smoothingMode == settings.MAG_SMOOTHING_MODE_NONE:
return "orca.settings.MAG_SMOOTHING_MODE_NONE"
else:
return "orca.settings.MAG_SMOOTHING_MODE_BILINEAR"
def _getMagMouseTrackingModeString(self, mouseTrackingMode):
"""Returns a string that represents the magnification mouse tracking
mode passed in.
Arguments:
- mouseTrackingMode: magnification mouse tracking mode.
Returns a string suitable for the preferences file.
"""
if mouseTrackingMode == settings.MAG_TRACKING_MODE_CENTERED:
return "orca.settings.MAG_TRACKING_MODE_CENTERED"
elif mouseTrackingMode == settings.MAG_TRACKING_MODE_NONE:
return "orca.settings.MAG_TRACKING_MODE_NONE"
elif mouseTrackingMode == settings.MAG_TRACKING_MODE_PROPORTIONAL:
return "orca.settings.MAG_TRACKING_MODE_PROPORTIONAL"
elif mouseTrackingMode == settings.MAG_TRACKING_MODE_PUSH:
return "orca.settings.MAG_TRACKING_MODE_PUSH"
else:
return "orca.settings.MAG_TRACKING_MODE_CENTERED"
def _getMagControlTrackingModeString(self, controlTrackingMode):
"""Returns a string that represents the magnification control
and menu item tracking mode passed in.
Arguments:
- controlTrackingMode: magnification control and menu item tracking
mode.
Returns a string suitable for the preferences file.
"""
if controlTrackingMode == settings.MAG_TRACKING_MODE_CENTERED:
return "orca.settings.MAG_TRACKING_MODE_CENTERED"
elif controlTrackingMode == settings.MAG_TRACKING_MODE_NONE:
return "orca.settings.MAG_TRACKING_MODE_NONE"
elif controlTrackingMode == settings.MAG_TRACKING_MODE_PUSH:
return "orca.settings.MAG_TRACKING_MODE_PUSH"
else:
return "orca.settings.MAG_TRACKING_MODE_PUSH"
def _getMagTextTrackingModeString(self, textTrackingMode):
"""Returns a string that represents the magnification text cursor
tracking mode passed in.
Arguments:
- textTrackingMode: magnification text cursor tracking mode.
Returns a string suitable for the preferences file.
"""
if textTrackingMode == settings.MAG_TRACKING_MODE_CENTERED:
return "orca.settings.MAG_TRACKING_MODE_CENTERED"
elif textTrackingMode == settings.MAG_TRACKING_MODE_NONE:
return "orca.settings.MAG_TRACKING_MODE_NONE"
elif textTrackingMode == settings.MAG_TRACKING_MODE_PUSH:
return "orca.settings.MAG_TRACKING_MODE_PUSH"
else:
return "orca.settings.MAG_TRACKING_MODE_PUSH"
def _getMagColorFilteringModeString(self, mode):
"""Returns a string that represents the magnification color filtering
mode passed in.
Arguments:
- mode: magnification color filtering mode.
Returns a string suitable for the preferences file.
"""
if mode == settings.MAG_COLOR_FILTERING_MODE_NONE:
return "orca.settings.MAG_COLOR_FILTERING_MODE_NONE"
elif mode == settings.MAG_COLOR_FILTERING_MODE_SATURATE_RED:
return "orca.settings.MAG_COLOR_FILTERING_MODE_SATURATE_RED"
elif mode == settings.MAG_COLOR_FILTERING_MODE_SATURATE_GREEN:
return "orca.settings.MAG_COLOR_FILTERING_MODE_SATURATE_GREEN"
elif mode == settings.MAG_COLOR_FILTERING_MODE_SATURATE_BLUE:
return "orca.settings.MAG_COLOR_FILTERING_MODE_SATURATE_BLUE"
elif mode == settings.MAG_COLOR_FILTERING_MODE_DESATURATE_RED:
return "orca.settings.MAG_COLOR_FILTERING_MODE_DESATURATE_RED"
elif mode == settings.MAG_COLOR_FILTERING_MODE_DESATURATE_GREEN:
return "orca.settings.MAG_COLOR_FILTERING_MODE_DESATURATE_GREEN"
elif mode == settings.MAG_COLOR_FILTERING_MODE_DESATURATE_BLUE:
return "orca.settings.MAG_COLOR_FILTERING_MODE_DESATURATE_BLUE"
elif mode == settings.MAG_COLOR_FILTERING_MODE_POSITIVE_HUE_SHIFT:
return "orca.settings.MAG_COLOR_FILTERING_MODE_POSITIVE_HUE_SHIFT"
elif mode == settings.MAG_COLOR_FILTERING_MODE_NEGATIVE_HUE_SHIFT:
return "orca.settings.MAG_COLOR_FILTERING_MODE_NEGATIVE_HUE_SHIFT"
else:
return "orca.settings.MAG_COLOR_FILTERING_MODE_NONE"
def _getMagZoomerTypeString(self, magZoomerType):
"""Returns a string that represents the magnification zoomer position
type passed in.
Arguments:
- magZoomerType: magnification zoomer position type.
Returns a string suitable for the preferences file.
"""
if magZoomerType == settings.MAG_ZOOMER_TYPE_FULL_SCREEN:
return "orca.settings.MAG_ZOOMER_TYPE_FULL_SCREEN"
elif magZoomerType == settings.MAG_ZOOMER_TYPE_TOP_HALF:
return "orca.settings.MAG_ZOOMER_TYPE_TOP_HALF"
elif magZoomerType == settings.MAG_ZOOMER_TYPE_BOTTOM_HALF:
return "orca.settings.MAG_ZOOMER_TYPE_BOTTOM_HALF"
elif magZoomerType == settings.MAG_ZOOMER_TYPE_LEFT_HALF:
return "orca.settings.MAG_ZOOMER_TYPE_LEFT_HALF"
elif magZoomerType == settings.MAG_ZOOMER_TYPE_RIGHT_HALF:
return "orca.settings.MAG_ZOOMER_TYPE_RIGHT_HALF"
elif magZoomerType == settings.MAG_ZOOMER_TYPE_CUSTOM:
return "orca.settings.MAG_ZOOMER_TYPE_CUSTOM"
else:
return "orca.settings.MAG_ZOOMER_TYPE_FULL_SCREEN"
def _getProgressBarVerbosityString(self, verbosityLevel):
"""Returns a string that represents the progress bar verbosity level
passed in.
Arguments:
- verbosityLevel: verbosity level for progress bars.
Returns a string suitable for the preferences file.
"""
if verbosityLevel == settings.PROGRESS_BAR_ALL:
return "orca.settings.PROGRESS_BAR_ALL"
elif verbosityLevel == settings.PROGRESS_BAR_WINDOW:
return "orca.settings.PROGRESS_BAR_WINDOW"
else:
return "orca.settings.PROGRESS_BAR_APPLICATION"
def _writeKeyBindingsPreamble(self, prefs):
"""Writes the preamble to the user-settings.py keyBindings section."""
prefs.writelines("\n")
prefs.writelines("# Set up a user key-bindings profile\n")
prefs.writelines("#\n")
prefs.writelines('def overrideKeyBindings(script, keyB):\n')
def _writeKeyBinding(self, prefs, tupl):
"""Writes a single keyBinding to the user-settings.py
keyBindings section.
Arguments:
- prefs: text string - file to write the key binding to.
- tupl: tuple - a tuple with the values of the
keybinding (gtk.TreeStore model columns)
"""
prefs.writelines(" keyB.removeByHandler(script.inputEventHandlers['" \
+ str(tupl[HANDLER])+"'])\n")
if not (tupl[TEXT1] or tupl[TEXT2]):
prefs.writelines(" keyB.add(orca.keybindings.KeyBinding(\n")
prefs.writelines(" '',\n")
prefs.writelines(" %d,\n" % settings.defaultModifierMask)
prefs.writelines(" 0,\n")
prefs.writelines(' script.inputEventHandlers["' + \
str(tupl[HANDLER]) +'"]))\n\n')
if (tupl[TEXT1]):
prefs.writelines(" keyB.add(orca.keybindings.KeyBinding(\n")
prefs.writelines(" '" + str(tupl[KEY1]) + "',\n")
if tupl[MOD_MASK1] or tupl[MOD_USED1]:
prefs.writelines(" " + str(tupl[MOD_MASK1]) + ",\n")
prefs.writelines(" " + str(tupl[MOD_USED1]) + ",\n")
else:
prefs.writelines(" 0,\n")
prefs.writelines(" 0,\n")
if (tupl[CLICK_COUNT1] == "1"):
prefs.writelines(' script.inputEventHandlers["' + \
str(tupl[HANDLER]) +'"]))\n\n')
else:
prefs.writelines(' script.inputEventHandlers["' + \
str(tupl[HANDLER]) +'"],\n')
prefs.writelines(" " + str(tupl[CLICK_COUNT1]) + \
"))\n\n")
if (tupl[TEXT2]):
prefs.writelines(" keyB.add(orca.keybindings.KeyBinding(\n")
prefs.writelines(" '" + str(tupl[KEY2]) + "',\n")
if tupl[MOD_MASK2] or tupl[MOD_USED2]:
prefs.writelines(" " + str(tupl[MOD_MASK2]) + ",\n")
prefs.writelines(" " + str(tupl[MOD_USED2]) + ",\n")
else:
prefs.writelines(" %d,\n" % settings.defaultModifierMask)
prefs.writelines(" 0,\n")
if (tupl[CLICK_COUNT2] == "1"):
prefs.writelines(' script.inputEventHandlers["' + \
str(tupl[HANDLER]) +'"]))\n\n')
else:
prefs.writelines(' script.inputEventHandlers["' + \
str(tupl[HANDLER]) +'"],\n')
prefs.writelines(" " + str(tupl[CLICK_COUNT2]) + \
"))\n\n")
def _writeKeyBindingsPostamble(self, prefs):
"""Writes the postamble to the user-settings.py keyBindings section."""
prefs.writelines(' return keyB')
prefs.writelines("\n\n")
prefs.writelines( \
'orca.settings.overrideKeyBindings = overrideKeyBindings')
prefs.writelines("\n")
def _iterateKeyBindings(self, prefs, treeModel):
"""Iterate over all the key bindings in the tree model and write
out all that the user has modified.
"""
thisIter = treeModel.get_iter_first()
while thisIter != None:
iterChild = treeModel.iter_children(thisIter)
while iterChild != None:
values = treeModel.get(iterChild,
0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15)
if values[MODIF]:
self._writeKeyBinding(prefs, values)
iterChild = treeModel.iter_next(iterChild)
thisIter = treeModel.iter_next(thisIter)
def _writeKeyBindingsMap(self, prefs, treeModel):
"""Write to configuration file 'prefs' the key bindings passed in the
model treeModel.
"""
self._writeKeyBindingsPreamble(prefs)
self._iterateKeyBindings(prefs, treeModel)
self._writeKeyBindingsPostamble(prefs)
def _writePronunciationsPreamble(self, prefs):
"""Writes the preamble to the ~/.orca/user-settings.py
pronunciations section."""
prefs.writelines("\n")
prefs.writelines( \
"# User customized pronunciation dictionary settings\n")
prefs.writelines("#\n")
prefs.writelines("import orca.pronunciation_dict\n\n")
prefs.writelines("orca.pronunciation_dict.pronunciation_dict={}\n")
def _writePronunciation(self, prefs, word, value):
"""Write out a single pronunciation entry to the
~/.orca/user-setting.py settings file.
Arguments:
- prefs: file handle for user preferences.
- word: the actual word to be pronunced.
- value: the replacement string to use.
"""
prefs.writelines("orca.pronunciation_dict.setPronunciation(" + \
repr(word) + ", " + repr(value) + ")\n")
def _iteratePronunciations(self, prefs, treeModel):
"""Iterate over each of the entries in the tree model and write out
a pronunciation diction entry for them. If any strings with an
actual string of "" are found, they are ignored.
"""
thisIter = treeModel.get_iter_first()
while thisIter != None:
values = treeModel.get(thisIter, ACTUAL, REPLACEMENT)
word = values[ACTUAL]
value = values[REPLACEMENT]
if word != "":
self._writePronunciation(prefs, word, value)
thisIter = treeModel.iter_next(thisIter)
def _writePronunciationMap(self, prefs, treeModel):
"""Write to configuration file 'prefs' the new pronunciation dictionary
entries passed in the model treeModel.
Arguments:
- prefs: file handle for application preferences.
- treeModel: pronunciation dictionary tree model.
"""
self._writePronunciationsPreamble(prefs)
self._iteratePronunciations(prefs, treeModel)
def _setupPreferencesDirs(self):
"""Creates the directories and standard files to hold user
preferences."""
# Set up the user's preferences directory (~/.orca by default).
#
orcaDir = settings.userPrefsDir
self._createDir(orcaDir)
# Set up ~/.orca/orca-scripts as a Python package
#
orcaScriptDir = os.path.join(orcaDir, "orca-scripts")
self._createDir(orcaScriptDir)
initFile = os.path.join(orcaScriptDir, "__init__.py")
if not os.path.exists(initFile):
os.close(os.open(initFile, os.O_CREAT, 0700))
# Set up ~/.orca/app-settings as a Python package.
#
orcaSettingsDir = os.path.join(orcaDir, "app-settings")
self._createDir(orcaSettingsDir)
initFile = os.path.join(orcaSettingsDir, "__init__.py")
if not os.path.exists(initFile):
os.close(os.open(initFile, os.O_CREAT, 0700))
def _getValueForKey(self, prefsDict, key):
"""Return the value associated with this preferences dictionary key
Arguments:
- prefsDict: a dictionary where the keys are orca preferences
names and the values are the values for the preferences.
- key: the preferences dictionary key.
Return the value of the given preferences dictionary key.
"""
value = None
if key in prefsDict:
if key == "voices":
value = self._getVoicesString(prefsDict[key])
elif key == "speechServerInfo":
value = self._getSpeechServerString(prefsDict[key])
elif key == "speechServerFactory":
value = self._getSpeechServerFactoryString(prefsDict[key])
elif key.endswith("VerbosityLevel"):
value = self._getVerbosityString(prefsDict[key])
elif key == "brailleRolenameStyle":
value = self._getBrailleRolenameStyleString(prefsDict[key])
elif key == "brailleSelectorIndicator":
value = self._getBrailleSelectionIndicatorString(prefsDict[key])
elif key == "brailleLinkIndicator":
value = self._getBrailleLinkIndicatorString(prefsDict[key])
elif key == "brailleAlignmentStyle":
value = self._getBrailleAlignmentStyleString(prefsDict[key])
elif key == "verbalizePunctuationStyle":
value = self._getVerbalizePunctuationStyleString(prefsDict[key])
elif key == "sayAllStyle":
value = self._getSayAllStyleString(prefsDict[key])
elif key in ["magCursorColor",
"magCrossHairColor",
"magZoomerBorderColor"]:
value = self._getMagColorString(prefsDict[key])
elif key == "magSmoothingMode":
value = self._getMagSmoothingModeString(prefsDict[key])
elif key == "magMouseTrackingMode":
value = self._getMagMouseTrackingModeString(prefsDict[key])
elif key == "magControlTrackingMode":
value = self._getMagControlTrackingModeString(prefsDict[key])
elif key == "magTextTrackingMode":
value = self._getMagTextTrackingModeString(prefsDict[key])
elif key == "magZoomerType":
value = self._getMagZoomerTypeString(prefsDict[key])
elif key == "magColorFilteringMode":
value = self._getMagColorFilteringModeString(prefsDict[key])
elif key == "magSourceDisplay" or key == "magTargetDisplay":
value = self._getDisplayString(prefsDict[key])
elif key == "keyboardLayout":
value = self._getKeyboardLayoutString(prefsDict[key])
elif key == "orcaModifierKeys":
value = self._getOrcaModifierKeysString(prefsDict[key])
elif key == "enabledSpokenTextAttributes":
value = self._getSpokenTextAttributesString(prefsDict[key])
elif key == "enabledBrailledTextAttributes":
value = self._getBrailledTextAttributesString(prefsDict[key])
elif key == "textAttributesBrailleIndicator":
value = self._getTextAttributesBrailleIndicatorString( \
prefsDict[key])
elif key == "progressBarVerbosity":
value = self._getProgressBarVerbosityString(prefsDict[key])
elif key == "brailleContractionTable":
value = "'%s'" % prefsDict[key]
elif key == "brailleEOLIndicator":
value = "'%s'" % prefsDict[key]
elif key == "brailleRequiredStateString":
value = "'%s'" % prefsDict[key]
elif key == "speechRequiredStateString":
value = "'%s'" % prefsDict[key]
else:
value = prefsDict[key]
return value
def writePreferences(self):
"""Creates the directory and files to hold user preferences. Note
that callers of this method may want to consider using an ordered
dictionary so that the keys are output in a deterministic order.
Returns True if accessibility was enabled as a result of this
call.
"""
self._setupPreferencesDirs()
# Write ~/.orca/user-settings.py
#
orcaDir = settings.userPrefsDir
prefs = open(os.path.join(orcaDir, "user-settings.py"), "w")
self._writePreferencesPreamble(prefs)
for key in settings.userCustomizableSettings:
value = self._getValueForKey(self.prefsDict, key)
if value != None:
prefs.writelines("orca.settings.%s = %s\n" % (key, value))
if self.keyBindingsTreeModel:
self._writeKeyBindingsMap(prefs, self.keyBindingsTreeModel)
if self.pronunciationTreeModel:
self._writePronunciationMap(prefs, self.pronunciationTreeModel)
self._writePreferencesPostamble(prefs)
prefs.close()
# Return True if this caused accessibility to be enabled
# as a result of this call.
#
return self._enableAccessibility()
def readPreferences():
"""Returns a dictionary containing the names and values of the
customizable features of Orca."""
prefsDict = {}
for key in settings.userCustomizableSettings:
try:
prefsDict[key] = getattr(settings, key)
except:
pass
return prefsDict
def writePreferences(prefsDict, keyBindingsTreeModel=None,
pronunciationTreeModel=None):
"""Creates the directory and files to hold application specific
user preferences. Write out any preferences that are different
from the generic Orca preferences for this user. Note that callers
of this method may want to consider using an ordered dictionary so
that the keys are output in a deterministic order.
Arguments:
- prefsDict: a dictionary where the keys are orca preferences
names and the values are the values for the preferences.
- keyBindingsTreeModel - key bindings tree model, or None if we are
writing out console preferences.
- pronunciationTreeModel - pronunciation dictionary tree model, or
None if we are writing out console preferences.
Returns True if the user needs to log out for accessibility settings
to take effect.
"""
orcaPrefs = OrcaPrefs(prefsDict,
keyBindingsTreeModel,
pronunciationTreeModel)
return orcaPrefs.writePreferences()
|