Viewing file:  gaim.py (12.21 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
# Orca
#
# Copyright 2004-2006 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., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.
"""Custom script for gaim. This provides the ability for Orca to
monitor both the IM input and IM output text areas at the same time.
The following script specific key sequences are supported:
Insert-h - Toggle whether we prefix chat room messages with
the name of the chat room.
Insert-[1-9] - Speak and braille a previous chat room message.
"""
__id__ = "$Id: gaim.py,v 1.21 2006/07/28 17:33:18 wwalker Exp $"
__version__ = "$Revision: 1.21 $"
__date__ = "$Date: 2006/07/28 17:33:18 $"
__copyright__ = "Copyright (c) 2005-2006 Sun Microsystems Inc."
__license__ = "LGPL"
import orca.atspi as atspi
import orca.braille as braille
import orca.debug as debug
import orca.default as default
import orca.input_event as input_event
import orca.keybindings as keybindings
import orca.rolenames as rolenames
import orca.settings as settings
import orca.speech as speech
import orca.util as util
from orca.orca_i18n import _
########################################################################
# #
# Ring List. A fixed size circular list by Flavio Catalani #
# http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/435902 #
# #
########################################################################
class RingList:
def __init__(self, length):
self.__data__ = []
self.__full__ = 0
self.__max__ = length
self.__cur__ = 0
def append(self, x):
if self.__full__ == 1:
for i in range (0, self.__cur__ - 1):
self.__data__[i] = self.__data__[i + 1]
self.__data__[self.__cur__ - 1] = x
else:
self.__data__.append(x)
self.__cur__ += 1
if self.__cur__ == self.__max__:
self.__full__ = 1
def get(self):
return self.__data__
def remove(self):
if (self.__cur__ > 0):
del self.__data__[self.__cur__ - 1]
self.__cur__ -= 1
def size(self):
return self.__cur__
def maxsize(self):
return self.__max__
def __str__(self):
return ''.join(self.__data__)
########################################################################
# #
# The Gaim script class. #
# #
########################################################################
class Script(default.Script):
def __init__(self, app):
"""Creates a new script for the given application.
Arguments:
- app: the application to create a script for.
"""
# Set the debug level for all the methods in this script.
#
self.debugLevel = debug.LEVEL_FINEST
# Whether we prefix chat room messages with the name of the chat room.
#
self.prefixChatMessage = False
# Create two cyclic lists; one that will contain the previous
# chat room messages and the other that will contain the names
# of the associated chat rooms.
#
self.MESSAGE_LIST_LENGTH = 9
self.previousMessages = RingList(self.MESSAGE_LIST_LENGTH)
self.previousChatRoomNames = RingList(self.MESSAGE_LIST_LENGTH)
# Initially populate the cyclic lists with empty strings.
#
for i in range(0, self.previousMessages.maxsize()):
self.previousMessages.append("")
for i in range(0, self.previousChatRoomNames.maxsize()):
self.previousChatRoomNames.append("")
# Keep track of the various text areas for chatting.
# The key is the tab and the value is the text area where
# the chat occurs.
#
self.chatAreas = {}
default.Script.__init__(self, app)
def setupInputEventHandlers(self):
"""Defines InputEventHandler fields for this script that can be
called by the key and braille bindings. In this particular case,
we just want to be able to add a handler to toggle whether we
prefix chat room messages with the name of the chat room.
"""
debug.println(self.debugLevel, "gaim.setupInputEventHandlers.")
default.Script.setupInputEventHandlers(self)
self.togglePrefixHandler = input_event.InputEventHandler(
Script.togglePrefix,
_("Toggle whether we prefix chat room messages with the name of the chat room."))
self.readPreviousMessageHandler = input_event.InputEventHandler(
Script.readPreviousMessage,
_("Speak and braille a previous chat room message."))
def getKeyBindings(self):
"""Defines the key bindings for this script. Setup the default
key bindings, then add one in for toggling whether we prefix
chat room messages with the name of the chat room.
Returns an instance of keybindings.KeyBindings.
"""
debug.println(self.debugLevel, "gaim.getKeyBindings.")
keyBindings = default.Script.getKeyBindings(self)
keyBindings.add(
keybindings.KeyBinding(
"h",
1 << settings.MODIFIER_ORCA,
1 << settings.MODIFIER_ORCA,
self.togglePrefixHandler))
messageKeys = [ "1", "2", "3", "4", "5", "6", "7", "8", "9" ]
for i in range(0, len(messageKeys)):
keyBindings.add(
keybindings.KeyBinding(
messageKeys[i],
1 << settings.MODIFIER_ORCA,
1 << settings.MODIFIER_ORCA,
self.readPreviousMessageHandler))
return keyBindings
def togglePrefix(self, inputEvent):
""" Toggle whether we prefix chat room messages with the name of
the chat room.
Arguments:
- inputEvent: if not None, the input event that caused this action.
"""
debug.println(self.debugLevel, "gaim.togglePrefix.")
line = _("speak chat room name.")
self.prefixChatMessage = not self.prefixChatMessage
if not self.prefixChatMessage:
line = _("Do not speak chat room name.")
speech.speak(line)
return True
def utterMessage(self, chatRoomName, message):
""" Speak/braille a chat room message.
messages are kept.
Arguments:
- chatRoomName: name of the chat room this message came from.
- message: the chat room message.
"""
text = ""
if self.prefixChatMessage:
if chatRoomName and chatRoomName != "":
text += _("Message from chat room ") + chatRoomName + " "
if message and message != "":
text += message
if text != "":
braille.displayMessage(text)
speech.speak(text)
def readPreviousMessage(self, inputEvent):
""" Speak/braille a previous chat room message. Up to nine
previous messages are kept.
Arguments:
- inputEvent: if not None, the input event that caused this action.
"""
debug.println(self.debugLevel, "gaim.readPreviousMessage.")
i = int(inputEvent.event_string)
messageNo = self.MESSAGE_LIST_LENGTH-i
chatRoomNames = self.previousChatRoomNames.get()
chatRoomName = chatRoomNames[messageNo]
messages = self.previousMessages.get()
message = messages[messageNo]
self.utterMessage(chatRoomName, message)
def getChatRoomTab(self, obj):
"""Walk up the hierarchy until we've found the page tab for this
chat room, and return that object.
Arguments:
- obj: the accessible component to start from.
Returns the page tab component for the chat room.
"""
if obj:
while True:
if obj:
if obj.role == rolenames.ROLE_APPLICATION:
break
elif obj.role == rolenames.ROLE_PAGE_TAB:
return obj
else:
obj = obj.parent
else:
break
return None
def onTextInserted(self, event):
"""Called whenever text is inserted into one of Gaim's text
objects. If the object is an instant message or chat, speak
the text. If we're not watching anything, do the default
behavior.
Arguments:
- event: the text inserted Event
"""
chatRoomTab = self.getChatRoomTab(event.source)
if not chatRoomTab:
default.Script.onTextInserted(self, event)
return
# [[[TODO: HACK - it looks as though the GAIM chat area may
# not start emitting text inserted events until we tickle it
# by looking at it in the hierarchy. The simple workaround of
# entering flat review and exiting does this. So, we tickle
# the hierarchy here. We probably should be trying somewhere
# else since we may miss the first message in a chat area. In
# addition, this is a source of a very small memory leak since
# we do not free up the entries when the tab goes away. One
# would have to engage in hundreds of chats with hundreds of
# different people from the same instance of gaim for that
# memory leak to have an issue here. One thing we could do if
# that is deemed a severe enough problem is to check for
# children-changed events and clean up in that.]]]
#
chatArea = None
if not self.chatAreas.has_key(chatRoomTab):
# Different message types (AIM, IRC ...) have a different
# component hierarchy for their chat rooms. By testing
# with AIM and IRC, we've found that the messages area for
# those two type of chats has an index that is the penultimate
# text field. Hopefully this is true for other types of chat
# as well, but is currently untested.
#
allTextFields = util.findByRole(chatRoomTab,
rolenames.ROLE_TEXT)
index = len(allTextFields) - 2
if index >= 0:
self.chatAreas[chatRoomTab] = allTextFields[index]
chatArea = self.chatAreas[chatRoomTab]
else:
chatArea = self.chatAreas[chatRoomTab]
if event.source and (event.source == chatArea):
# We always automatically go back to focus tracking mode when
# someone sends us a message.
#
if self.flatReviewContext:
self.toggleFlatReviewMode()
message = event.source.text.getText(event.detail1,
event.detail1 + event.detail2)
if message and message[0] == "\n":
message = message[1:]
chatRoomName = util.getDisplayedText(chatRoomTab)
self.utterMessage(chatRoomName, message)
# Add the latest message to the list of saved ones. For each
# one added, the oldest one automatically gets dropped off.
#
self.previousMessages.append(message)
self.previousChatRoomNames.append(chatRoomName)
else:
# Pass the event onto the parent class to be handled in the
# default way.
#
default.Script.onTextInserted(self, event)
|