# -*- coding: utf-8 -*-
# vim:et sts=4 sw=4
#
# ibus-table - The Tables engine for IBus
#
# Copyright (c) 2008-2009 Yu Yuwei <acevery@gmail.com>
# Copyright (c) 2009-2014 Caius "kaio" CHANCE <me@kaio.net>
# Copyright (c) 2012-2018 Mike FABIAN <mfabian@redhat.com>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 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
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
#
'''
This file implements the ibus engine for ibus-table
'''
__all__ = (
"TabEngine",
)
import sys
import os
import re
import time
from gettext import dgettext
_ = lambda a: dgettext('ibus-table', a)
N_ = lambda a: a
from gi import require_version
require_version('IBus', '1.0')
from gi.repository import IBus
require_version('Gio', '2.0')
from gi.repository import Gio
require_version('GLib', '2.0')
from gi.repository import GLib
#import tabsqlitedb
from gi.repository import GObject
import it_util
DEBUG_LEVEL = int(0)
def ascii_ispunct(character):
'''
Use our own function instead of ascii.ispunct()
from “from curses import ascii” because the behaviour
of the latter is kind of weird. In Python 3.3.2 it does
for example:
# >>> from curses import ascii
# >>> ascii.ispunct('.')
# True
# >>> ascii.ispunct(u'.')
# True
# >>> ascii.ispunct('a')
# False
# >>> ascii.ispunct(u'a')
# False
# >>>
# >>> ascii.ispunct(u'あ')
# True
# >>> ascii.ispunct('あ')
# True
# >>>
あ isn’t punctuation. ascii.ispunct() only really works
in the ascii range, it returns weird results when used
over the whole unicode range. Maybe we should better use
unicodedata.category(), which works fine to figure out
what is punctuation for all of unicode. But at the moment
I am only porting from Python2 to Python3 and just want to
preserve the original behaviour for the moment.
By the way, Python 3.6.6 does not seem the above bug
anymore, in Python 3.6.6 we get
# >>> from curses import ascii
# >>> ascii.ispunct('あ')
# False
# >>>
Examples:
>>> ascii_ispunct('.')
True
>>> ascii_ispunct('a')
False
>>> ascii_ispunct('あ')
False
'''
return bool(character in '''!"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~''')
def argb(alpha, red, green, blue):
'''Returns a 32bit ARGB value'''
return (((alpha & 0xff)<<24)
+ ((red & 0xff) << 16)
+ ((green & 0xff) << 8)
+ (blue & 0xff))
def rgb(red, green, blue):
'''Returns a 32bit ARGB value with the alpha value set to fully opaque'''
return argb(255, red, green, blue)
__HALF_FULL_TABLE = [
(0x0020, 0x3000, 1),
(0x0021, 0xFF01, 0x5E),
(0x00A2, 0xFFE0, 2),
(0x00A5, 0xFFE5, 1),
(0x00A6, 0xFFE4, 1),
(0x00AC, 0xFFE2, 1),
(0x00AF, 0xFFE3, 1),
(0x20A9, 0xFFE6, 1),
(0xFF61, 0x3002, 1),
(0xFF62, 0x300C, 2),
(0xFF64, 0x3001, 1),
(0xFF65, 0x30FB, 1),
(0xFF66, 0x30F2, 1),
(0xFF67, 0x30A1, 1),
(0xFF68, 0x30A3, 1),
(0xFF69, 0x30A5, 1),
(0xFF6A, 0x30A7, 1),
(0xFF6B, 0x30A9, 1),
(0xFF6C, 0x30E3, 1),
(0xFF6D, 0x30E5, 1),
(0xFF6E, 0x30E7, 1),
(0xFF6F, 0x30C3, 1),
(0xFF70, 0x30FC, 1),
(0xFF71, 0x30A2, 1),
(0xFF72, 0x30A4, 1),
(0xFF73, 0x30A6, 1),
(0xFF74, 0x30A8, 1),
(0xFF75, 0x30AA, 2),
(0xFF77, 0x30AD, 1),
(0xFF78, 0x30AF, 1),
(0xFF79, 0x30B1, 1),
(0xFF7A, 0x30B3, 1),
(0xFF7B, 0x30B5, 1),
(0xFF7C, 0x30B7, 1),
(0xFF7D, 0x30B9, 1),
(0xFF7E, 0x30BB, 1),
(0xFF7F, 0x30BD, 1),
(0xFF80, 0x30BF, 1),
(0xFF81, 0x30C1, 1),
(0xFF82, 0x30C4, 1),
(0xFF83, 0x30C6, 1),
(0xFF84, 0x30C8, 1),
(0xFF85, 0x30CA, 6),
(0xFF8B, 0x30D2, 1),
(0xFF8C, 0x30D5, 1),
(0xFF8D, 0x30D8, 1),
(0xFF8E, 0x30DB, 1),
(0xFF8F, 0x30DE, 5),
(0xFF94, 0x30E4, 1),
(0xFF95, 0x30E6, 1),
(0xFF96, 0x30E8, 6),
(0xFF9C, 0x30EF, 1),
(0xFF9D, 0x30F3, 1),
(0xFFA0, 0x3164, 1),
(0xFFA1, 0x3131, 30),
(0xFFC2, 0x314F, 6),
(0xFFCA, 0x3155, 6),
(0xFFD2, 0x315B, 9),
(0xFFE9, 0x2190, 4),
(0xFFED, 0x25A0, 1),
(0xFFEE, 0x25CB, 1)]
def unichar_half_to_full(char):
'''
Convert a character to full width if possible.
:param char: A character to convert to full width
:type char: String
:rtype: String
Examples:
>>> unichar_half_to_full('a')
'ａ'
>>> unichar_half_to_full('ａ')
'ａ'
>>> unichar_half_to_full('☺')
'☺'
'''
code = ord(char)
for half, full, size in __HALF_FULL_TABLE:
if code >= half and code < half + size:
if sys.version_info >= (3, 0, 0):
return chr(full + code - half)
return unichr(full + code - half)
return char
def unichar_full_to_half(char):
'''
Convert a character to half width if possible.
:param char: A character to convert to half width
:type char: String
:rtype: String
Examples:
>>> unichar_full_to_half('ａ')
'a'
>>> unichar_full_to_half('a')
'a'
>>> unichar_full_to_half('☺')
'☺'
'''
code = ord(char)
for half, full, size in __HALF_FULL_TABLE:
if code >= full and code < full + size:
if sys.version_info >= (3, 0, 0):
return chr(half + code - full)
return unichr(half + code - full)
return char
SAVE_USER_COUNT_MAX = 16
SAVE_USER_TIMEOUT = 30 # in seconds
class KeyEvent:
'''Key event class used to make the checking of details of the key
event easy
'''
def __init__(self, keyval, keycode, state):
self.val = keyval
self.code = keycode
self.state = state
self.name = IBus.keyval_name(self.val)
self.unicode = IBus.keyval_to_unicode(self.val)
self.shift = self.state & IBus.ModifierType.SHIFT_MASK != 0
self.lock = self.state & IBus.ModifierType.LOCK_MASK != 0
self.control = self.state & IBus.ModifierType.CONTROL_MASK != 0
self.mod1 = self.state & IBus.ModifierType.MOD1_MASK != 0
self.mod2 = self.state & IBus.ModifierType.MOD2_MASK != 0
self.mod3 = self.state & IBus.ModifierType.MOD3_MASK != 0
self.mod4 = self.state & IBus.ModifierType.MOD4_MASK != 0
self.mod5 = self.state & IBus.ModifierType.MOD5_MASK != 0
self.button1 = self.state & IBus.ModifierType.BUTTON1_MASK != 0
self.button2 = self.state & IBus.ModifierType.BUTTON2_MASK != 0
self.button3 = self.state & IBus.ModifierType.BUTTON3_MASK != 0
self.button4 = self.state & IBus.ModifierType.BUTTON4_MASK != 0
self.button5 = self.state & IBus.ModifierType.BUTTON5_MASK != 0
self.super = self.state & IBus.ModifierType.SUPER_MASK != 0
self.hyper = self.state & IBus.ModifierType.HYPER_MASK != 0
self.meta = self.state & IBus.ModifierType.META_MASK != 0
self.release = self.state & IBus.ModifierType.RELEASE_MASK != 0
# MODIFIER_MASK: Modifier mask for the all the masks above
self.modifier = self.state & IBus.ModifierType.MODIFIER_MASK != 0
def __str__(self):
return (
"val=%s code=%s state=0x%08x name='%s' unicode='%s' "
% (self.val,
self.code,
self.state,
self.name,
self.unicode)
+ "shift=%s control=%s mod1=%s mod5=%s release=%s\n"
% (self.shift,
self.control,
self.mod1,
self.mod5,
self.release))
class Editor(object):
'''Hold user inputs chars and preedit string'''
def __init__(self, gsettings, valid_input_chars, pinyin_valid_input_chars,
single_wildcard_char, multi_wildcard_char,
auto_wildcard, full_width_letter, full_width_punct,
max_key_length, database):
self.db = database
self._gsettings = gsettings
self._max_key_length = int(max_key_length)
self._max_key_length_pinyin = 7
self._valid_input_chars = valid_input_chars
self._pinyin_valid_input_chars = pinyin_valid_input_chars
self._single_wildcard_char = single_wildcard_char
self._multi_wildcard_char = multi_wildcard_char
self._auto_wildcard = auto_wildcard
self._full_width_letter = full_width_letter
self._full_width_punct = full_width_punct
#
# The values below will be reset in
# self.clear_input_not_committed_to_preedit()
self._chars_valid = u'' # valid user input in table mode
self._chars_invalid = u'' # invalid user input in table mode
self._chars_valid_update_candidates_last = u''
self._chars_invalid_update_candidates_last = u''
# self._candidates holds the “best” candidates matching the user input
# [(tabkeys, phrase, freq, user_freq), ...]
self._candidates = []
self._candidates_previous = []
# self._u_chars: holds the user input of the phrases which
# have been automatically committed to preedit (but not yet
# “really” committed).
self._u_chars = []
# self._strings: holds the phrases which have been
# automatically committed to preedit (but not yet “really”
# committed).
#
# self._u_chars and self._strings should always have the same
# length, if I understand it correctly.
#
# Example when using the wubi-jidian86 table:
#
# self._u_chars = ['gaaa', 'gggg', 'ihty']
# self._strings = ['形式', '王', '小']
#
# I.e. after typing 'gaaa', '形式' is in the preedit and
# both self._u_chars and self._strings are empty. When typing
# another 'g', the maximum key length of the wubi table (which is 4)
# is exceeded and '形式' is automatically committed to the preedit
# (but not yet “really” committed, i.e. not yet committed into
# the application). The key 'gaaa' and the matching phrase '形式'
# are stored in self._u_chars and self._strings respectively
# and 'gaaa' is removed from self._chars_valid. Now self._chars_valid
# contains only the 'g' which starts a new search for candidates ...
# When removing the 'g' with backspace, the 'gaaa' is moved
# back from self._u_chars into self._chars_valid again and
# the same candidate list is shown as before the last 'g' had
# been entered.
self._strings = []
# self._cursor_precommit: The cursor
# position inthe array of strings which have already been
# committed to preëdit but not yet “really” committed.
self._cursor_precommit = 0
self._prompt_characters = eval(
self.db.ime_properties.get('char_prompts'))
select_keys_csv = self.db.get_select_keys()
if select_keys_csv is None:
select_keys_csv = '1,2,3,4,5,6,7,8,9'
self._select_keys = [
IBus.keyval_from_name(y)
for y in [x.strip() for x in select_keys_csv.split(",")]]
self._page_size = it_util.variant_to_value(
self._gsettings.get_user_value('lookuptablepagesize'))
if self._page_size is None or self._page_size > len(self._select_keys):
self._page_size = len(self._select_keys)
self._orientation = it_util.variant_to_value(
self._gsettings.get_user_value('lookuptableorientation'))
if self._orientation is None:
self._orientation = self.db.get_orientation()
self._lookup_table = self.get_new_lookup_table(
page_size=self._page_size,
select_keys=self._select_keys,
orientation=self._orientation)
# self._py_mode: whether in pinyin mode
self._py_mode = False
# self._onechar: whether we only select single character
self._onechar = it_util.variant_to_value(self._gsettings.get_value(
'onechar'))
# self._chinese_mode: the candidate filter mode,
# 0 means to show simplified Chinese only
# 1 means to show traditional Chinese only
# 2 means to show all characters but show simplified Chinese first
# 3 means to show all characters but show traditional Chinese first
# 4 means to show all characters
# we use LC_CTYPE or LANG to determine which one to use if
# no default comes from the user Gsettings.
self._chinese_mode = it_util.variant_to_value(
self._gsettings.get_user_value('chinesemode'))
if self._chinese_mode != None and DEBUG_LEVEL > 1:
sys.stderr.write(
"Chinese mode found in Gsettings, mode=%s\n"
% self._chinese_mode)
if self._chinese_mode is None:
self._chinese_mode = self.get_default_chinese_mode()
# If auto select is true, then the first candidate phrase will
# be selected automatically during typing. Auto select is true
# by default for the stroke5 table for example.
self._auto_select = it_util.variant_to_value(
self._gsettings.get_user_value('autoselect'))
if self._auto_select is None:
if self.db.ime_properties.get('auto_select') != None:
self._auto_select = self.db.ime_properties.get(
'auto_select').lower() == u'true'
if self._auto_select is None:
self._auto_select = it_util.variant_to_value(
self._gsettings.get_value('autoselect'))
def get_new_lookup_table(
self, page_size=10,
select_keys=(49, 50, 51, 52, 53, 54, 55, 56, 57, 48),
orientation=IBus.Orientation.VERTICAL):
'''
(49, 50, 51, 52, 53, 54, 55, 56, 57, 48( are the key codes
for the characters ('1', '2', '3', '4', '5', '6', '7', '8', '0')
'''
if page_size < 1:
page_size = 1
if page_size > len(select_keys):
page_size = len(select_keys)
lookup_table = IBus.LookupTable(
page_size=page_size,
cursor_pos=0,
cursor_visible=True,
round=True)
for keycode in select_keys:
lookup_table.append_label(
IBus.Text.new_from_string("%s." %IBus.keyval_name(keycode)))
lookup_table.set_orientation(orientation)
return lookup_table
def get_select_keys(self):
"""
Returns the list of key codes for the select keys.
For example, if the select keys are ["1", "2", ...] the
key codes are [49, 50, ...]. If the select keys are
["F1", "F2", ...] the key codes are [65470, 65471, ...]
"""
return self._select_keys
def get_default_chinese_mode(self):
'''
Use db value or LC_CTYPE in your box to determine the _chinese_mode
0 means to show simplified Chinese only
1 means to show traditional Chinese only
2 means to show all characters but show simplified Chinese first
3 means to show all characters but show traditional Chinese first
4 means to show all characters
If nothing can be found return 4 to avoid any special
Chinese filtering or sorting.
'''
# use db value, if applicable
__db_chinese_mode = self.db.get_chinese_mode()
if __db_chinese_mode >= 0:
if DEBUG_LEVEL > 1:
sys.stderr.write(
"get_default_chinese_mode(): "
+ "default Chinese mode found in database, mode=%s\n"
%__db_chinese_mode)
return __db_chinese_mode
# otherwise
try:
if 'LC_ALL' in os.environ:
__lc = os.environ['LC_ALL'].split('.')[0].lower()
if DEBUG_LEVEL > 1:
sys.stderr.write(
'get_default_chinese_mode(): '
+ '__lc=%s found in LC_ALL\n'
% __lc)
elif 'LC_CTYPE' in os.environ:
__lc = os.environ['LC_CTYPE'].split('.')[0].lower()
if DEBUG_LEVEL > 1:
sys.stderr.write(
'get_default_chinese_mode(): '
+ '__lc=%s found in LC_CTYPE\n'
% __lc)
else:
__lc = os.environ['LANG'].split('.')[0].lower()
if DEBUG_LEVEL > 1:
sys.stderr.write(
'get_default_chinese_mode(): '
+ '__lc=%s found in LANG\n'
% __lc)
if '_cn' in __lc or '_sg' in __lc:
# CN and SG should prefer traditional Chinese by default
return 2 # show simplified Chinese first
elif '_hk' in __lc or '_tw' in __lc or '_mo' in __lc:
# HK, TW, and MO should prefer traditional Chinese by default
return 3 # show traditional Chinese first
else:
if self.db._is_chinese:
# This table is used for Chinese, but we don’t
# know for which variant. Therefore, better show
# all Chinese characters and don’t prefer any
# variant:
if DEBUG_LEVEL > 1:
sys.stderr.write(
"get_default_chinese_mode(): last fallback, "
+ "database is Chinese but we don’t know "
+ "which variant.\n")
return 4 # show all Chinese characters
else:
if DEBUG_LEVEL > 1:
sys.stderr.write(
"get_default_chinese_mode(): last fallback, "
+ "database is not Chinese, returning 4.\n")
return 4
except:
import traceback
traceback.print_exc()
return 4
def clear_all_input_and_preedit(self):
'''
Clear all input, whether committed to preëdit or not.
'''
if DEBUG_LEVEL > 1:
sys.stderr.write("clear_all_input_and_preedit()\n")
self.clear_input_not_committed_to_preedit()
self._u_chars = []
self._strings = []
self._cursor_precommit = 0
self.update_candidates()
def is_empty(self):
'''Checks whether the preëdit is empty
Returns True if the preëdit is empty, False if not.
:rtype: boolean
'''
return self._chars_valid + self._chars_invalid == u''
def clear_input_not_committed_to_preedit(self):
'''
Clear the input which has not yet been committed to preëdit.
'''
if DEBUG_LEVEL > 1:
sys.stderr.write("clear_input_not_committed_to_preedit()\n")
self._chars_valid = u''
self._chars_invalid = u''
self._chars_valid_update_candidates_last = u''
self._chars_invalid_update_candidates_last = u''
self._lookup_table.clear()
self._lookup_table.set_cursor_visible(True)
self._candidates = []
self._candidates_previous = []
def add_input(self, char):
'''
Add input character and update candidates.
Returns “True” if candidates were found, “False” if not.
'''
if (self._chars_invalid
or (not self._py_mode
and (char not in
self._valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char))
or (self._py_mode
and (char not in
self._pinyin_valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char))):
self._chars_invalid += char
else:
self._chars_valid += char
res = self.update_candidates()
return res
def pop_input(self):
'''remove and display last input char held'''
last_input_char = ''
if self._chars_invalid:
last_input_char = self._chars_invalid[-1]
self._chars_invalid = self._chars_invalid[:-1]
elif self._chars_valid:
last_input_char = self._chars_valid[-1]
self._chars_valid = self._chars_valid[:-1]
if (not self._chars_valid) and self._u_chars:
self._chars_valid = self._u_chars.pop(
self._cursor_precommit - 1)
self._strings.pop(self._cursor_precommit - 1)
self._cursor_precommit -= 1
self.update_candidates()
return last_input_char
def get_input_chars(self):
'''get characters held, valid and invalid'''
return self._chars_valid + self._chars_invalid
def split_strings_committed_to_preedit(self, index, index_in_phrase):
head = self._strings[index][:index_in_phrase]
tail = self._strings[index][index_in_phrase:]
self._u_chars.pop(index)
self._strings.pop(index)
self._u_chars.insert(index, self.db.parse_phrase(head))
self._strings.insert(index, head)
self._u_chars.insert(index+1, self.db.parse_phrase(tail))
self._strings.insert(index+1, tail)
def remove_preedit_before_cursor(self):
'''Remove preëdit left of cursor'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit <= 0:
return
self._u_chars = self._u_chars[self._cursor_precommit:]
self._strings = self._strings[self._cursor_precommit:]
self._cursor_precommit = 0
def remove_preedit_after_cursor(self):
'''Remove preëdit right of cursor'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit >= len(self._strings):
return
self._u_chars = self._u_chars[:self._cursor_precommit]
self._strings = self._strings[:self._cursor_precommit]
self._cursor_precommit = len(self._strings)
def remove_preedit_character_before_cursor(self):
'''Remove character before cursor in strings comitted to preëdit'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit < 1:
return
self._cursor_precommit -= 1
self._chars_valid = self._u_chars.pop(self._cursor_precommit)
self._strings.pop(self._cursor_precommit)
self.update_candidates()
def remove_preedit_character_after_cursor(self):
'''Remove character after cursor in strings committed to preëdit'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit > len(self._strings) - 1:
return
self._u_chars.pop(self._cursor_precommit)
self._strings.pop(self._cursor_precommit)
def get_preedit_tabkeys_parts(self):
'''Returns the tabkeys which were used to type the parts
of the preëdit string.
Such as “(left_of_current_edit, current_edit, right_of_current_edit)”
“left_of_current_edit” and “right_of_current_edit” are
strings of tabkeys which have been typed to get the phrases
which have already been committed to preëdit, but not
“really” committed yet. “current_edit” is the string of
tabkeys of the part of the preëdit string which is not
committed at all.
For example, the return value could look like:
(('gggg', 'aahw'), 'adwu', ('ijgl', 'jbus'))
See also get_preedit_string_parts() which might return something
like
(('王', '工具'), '其', ('漫画', '最新'))
when the wubi-jidian86 table is used.
'''
left_of_current_edit = ()
current_edit = u''
right_of_current_edit = ()
if self.get_input_chars():
current_edit = self.get_input_chars()
if self._u_chars:
left_of_current_edit = tuple(
self._u_chars[:self._cursor_precommit])
right_of_current_edit = tuple(
self._u_chars[self._cursor_precommit:])
return (left_of_current_edit, current_edit, right_of_current_edit)
def get_preedit_tabkeys_complete(self):
'''Returns the tabkeys which belong to the parts of the preëdit
string as a single string
'''
(left_tabkeys,
current_tabkeys,
right_tabkeys) = self.get_preedit_tabkeys_parts()
return (u''.join(left_tabkeys)
+ current_tabkeys
+ u''.join(right_tabkeys))
def get_preedit_string_parts(self):
'''Returns the phrases which are parts of the preëdit string.
Such as “(left_of_current_edit, current_edit, right_of_current_edit)”
“left_of_current_edit” and “right_of_current_edit” are
tuples of strings which have already been committed to preëdit, but not
“really” committed yet. “current_edit” is the phrase in the part of the
preëdit string which is not yet committed at all.
For example, the return value could look like:
(('王', '工具'), '其', ('漫画', '最新'))
See also get_preedit_tabkeys_parts() which might return something
like
(('gggg', 'aahw'), 'adwu', ('ijgl', 'jbus'))
when the wubi-jidian86 table is used.
'''
left_of_current_edit = ()
current_edit = u''
right_of_current_edit = ()
if self._candidates:
current_edit = self._candidates[
int(self._lookup_table.get_cursor_pos())][1]
elif self.get_input_chars():
current_edit = self.get_input_chars()
if self._strings:
left_of_current_edit = tuple(
self._strings[:self._cursor_precommit])
right_of_current_edit = tuple(
self._strings[self._cursor_precommit:])
return (left_of_current_edit, current_edit, right_of_current_edit)
def get_preedit_string_complete(self):
'''Returns the phrases which are parts of the preëdit string as a
single string
'''
(left_strings,
current_string,
right_strings) = self.get_preedit_string_parts()
return (u''.join(left_strings)
+ current_string
+ u''.join(right_strings))
def get_caret(self):
'''Get caret position in preëdit string'''
caret = 0
if self._cursor_precommit and self._strings:
for part in self._strings[:self._cursor_precommit]:
caret += len(part)
if self._candidates:
caret += len(
self._candidates[int(self._lookup_table.get_cursor_pos())][1])
else:
caret += len(self.get_input_chars())
return caret
def arrow_left(self):
'''Move cursor left in the preëdit string.'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit <= 0:
return
if len(self._strings[self._cursor_precommit-1]) <= 1:
self._cursor_precommit -= 1
else:
self.split_strings_committed_to_preedit(
self._cursor_precommit-1, -1)
self.update_candidates()
def arrow_right(self):
'''Move cursor right in the preëdit string.'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
if self._cursor_precommit >= len(self._strings):
return
self._cursor_precommit += 1
if len(self._strings[self._cursor_precommit-1]) > 1:
self.split_strings_committed_to_preedit(
self._cursor_precommit-1, 1)
self.update_candidates()
def control_arrow_left(self):
'''Move cursor to the beginning of the preëdit string.'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
self._cursor_precommit = 0
self.update_candidates()
def control_arrow_right(self):
'''Move cursor to the end of the preëdit string'''
if self._chars_invalid:
return
if self.get_input_chars():
self.commit_to_preedit()
if not self._strings:
return
self._cursor_precommit = len(self._strings)
self.update_candidates()
def append_candidate_to_lookup_table(
self, tabkeys=u'', phrase=u'', freq=0, user_freq=0):
'''append candidate to lookup_table'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
"append_candidate() "
+ "tabkeys=%(t)s phrase=%(p)s freq=%(f)s user_freq=%(u)s\n"
% {'t': tabkeys, 'p': phrase, 'f': freq, 'u': user_freq})
if not tabkeys or not phrase:
return
regexp = self._chars_valid
if self._multi_wildcard_char:
regexp = regexp.replace(
self._multi_wildcard_char, '_multi_wildchard_char_')
if self._single_wildcard_char:
regexp = regexp.replace(
self._single_wildcard_char, '_single_wildchard_char_')
regexp = re.escape(regexp)
regexp = regexp.replace('_multi_wildchard_char_', '.*')
regexp = regexp.replace('_single_wildchard_char_', '.?')
match = re.match(r'^'+regexp, tabkeys)
if match:
remaining_tabkeys = tabkeys[match.end():]
else:
# This should never happen! For the candidates
# added to the lookup table here, a match has
# been found for self._chars_valid in the database.
# In that case, the above regular expression should
# match as well.
remaining_tabkeys = tabkeys
if DEBUG_LEVEL > 1:
sys.stderr.write(
"append_candidate() "
+ "remaining_tabkeys=%(remaining_tabkeys)s "
% {'remaining_tabkeys': remaining_tabkeys}
+ "self._chars_valid=%(chars_valid)s phrase=%(phrase)s\n"
% {'chars_valid': self._chars_valid,
'phrase': phrase})
table_code = u''
if self.db._is_chinese and self._py_mode:
# restore tune symbol
remaining_tabkeys = remaining_tabkeys.replace(
'!', '↑1').replace(
'@', '↑2').replace(
'#', '↑3').replace(
'$', '↑4').replace(
'%', '↑5')
# If in pinyin mode, phrase can only be one character.
# When using pinyin mode for a table like Wubi or Cangjie,
# the reason is probably because one does not know the
# Wubi or Cangjie code. So get that code from the table
# and display it as well to help the user learn that code.
# The Wubi tables contain several codes for the same
# character, therefore self.db.find_zi_code(phrase) may
# return a list. The last code in that list is the full
# table code for that characters, other entries in that
# list are shorter substrings of the full table code which
# are not interesting to display. Therefore, we use only
# the last element of the list of table codes.
possible_table_codes = self.db.find_zi_code(phrase)
if possible_table_codes:
table_code = possible_table_codes[-1]
table_code_new = u''
for char in table_code:
if char in self._prompt_characters:
table_code_new += self._prompt_characters[char]
else:
table_code_new += char
table_code = table_code_new
if not self._py_mode:
remaining_tabkeys_new = u''
for char in remaining_tabkeys:
if char in self._prompt_characters:
remaining_tabkeys_new += self._prompt_characters[char]
else:
remaining_tabkeys_new += char
remaining_tabkeys = remaining_tabkeys_new
candidate_text = phrase + u' ' + remaining_tabkeys
if table_code:
candidate_text = candidate_text + u' ' + table_code
attrs = IBus.AttrList()
attrs.append(IBus.attr_foreground_new(
rgb(0x19, 0x73, 0xa2), 0, len(candidate_text)))
if not self._py_mode and freq < 0:
# this is a user defined phrase:
attrs.append(
IBus.attr_foreground_new(
rgb(0x77, 0x00, 0xc3), 0, len(phrase)))
elif not self._py_mode and user_freq > 0:
# this is a system phrase which has already been used by the user:
attrs.append(IBus.attr_foreground_new(
rgb(0x00, 0x00, 0x00), 0, len(phrase)))
else:
# this is a system phrase that has not been used yet:
attrs.append(IBus.attr_foreground_new(
rgb(0x00, 0x00, 0x00), 0, len(phrase)))
if DEBUG_LEVEL > 0:
debug_text = u' ' + str(freq) + u' ' + str(user_freq)
candidate_text += debug_text
attrs.append(IBus.attr_foreground_new(
rgb(0x00, 0xff, 0x00),
len(candidate_text) - len(debug_text),
len(candidate_text)))
text = IBus.Text.new_from_string(candidate_text)
i = 0
while attrs.get(i) != None:
attr = attrs.get(i)
text.append_attribute(attr.get_attr_type(),
attr.get_value(),
attr.get_start_index(),
attr.get_end_index())
i += 1
self._lookup_table.append_candidate(text)
self._lookup_table.set_cursor_visible(True)
def update_candidates(self):
'''
Searches for candidates and updates the lookuptable.
Returns “True” if candidates were found and “False” if not.
:rtype: Boolean
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
'update_candidates() '
+ 'self._chars_valid=%s ' % self._chars_valid
+ 'self._chars_invalid=%s ' % self._chars_invalid
+ 'self._chars_valid_update_candidates_last=%s '
% self._chars_valid_update_candidates_last
+ 'self._chars_invalid_update_candidates_last=%s '
% self._chars_invalid_update_candidates_last
+ 'self._candidates=%s ' % self._candidates
+ 'self.db.startchars=%s ' % self.db.startchars
+ 'self._strings=%s\n' % self._strings)
if (self._chars_valid == self._chars_valid_update_candidates_last
and
self._chars_invalid
== self._chars_invalid_update_candidates_last):
# The input did not change since we came here last, do
# nothing and leave candidates and lookup table unchanged:
return bool(self._candidates)
self._chars_valid_update_candidates_last = self._chars_valid
self._chars_invalid_update_candidates_last = self._chars_invalid
self._lookup_table.clear()
self._lookup_table.set_cursor_visible(True)
if self._chars_invalid or not self._chars_valid:
self._candidates = []
self._candidates_previous = self._candidates
return False
if self._py_mode and self.db._is_chinese:
self._candidates = self.db.select_chinese_characters_by_pinyin(
tabkeys=self._chars_valid,
chinese_mode=self._chinese_mode,
single_wildcard_char=self._single_wildcard_char,
multi_wildcard_char=self._multi_wildcard_char)
else:
self._candidates = self.db.select_words(
tabkeys=self._chars_valid,
onechar=self._onechar,
chinese_mode=self._chinese_mode,
single_wildcard_char=self._single_wildcard_char,
multi_wildcard_char=self._multi_wildcard_char,
auto_wildcard=self._auto_wildcard)
# If only a wildcard character has been typed, insert a
# special candidate at the first position for the wildcard
# character itself. For example, if “?” is used as a
# wildcard character and this is the only character typed, add
# a candidate ('?', '?', 0, 1000000000) in halfwidth mode or a
# candidate ('?', '？', 0, 1000000000) in fullwidth mode.
# This is needed to make it possible to input the wildcard
# characters themselves, if “?” acted only as a wildcard
# it would be impossible to input a fullwidth question mark.
if (self._chars_valid
in [self._single_wildcard_char, self._multi_wildcard_char]):
wildcard_key = self._chars_valid
wildcard_phrase = self._chars_valid
if ascii_ispunct(wildcard_key):
if self._full_width_punct[1]:
wildcard_phrase = unichar_half_to_full(wildcard_phrase)
else:
wildcard_phrase = unichar_full_to_half(wildcard_phrase)
else:
if self._full_width_letter[1]:
wildcard_phrase = unichar_half_to_full(wildcard_phrase)
else:
wildcard_phrase = unichar_full_to_half(wildcard_phrase)
self._candidates.insert(
0, (wildcard_key, wildcard_phrase, 0, 1000000000))
if self._candidates:
self.fill_lookup_table()
self._candidates_previous = self._candidates
return True
# There are only valid and no invalid input characters but no
# matching candidates could be found from the databases. The
# last of self._chars_valid must have caused this. That
# character is valid in the sense that it is listed in
# self._valid_input_chars, it is only invalid in the sense
# that after adding this character, no candidates could be
# found anymore. Add this character to self._chars_invalid
# and remove it from self._chars_valid.
self._chars_invalid += self._chars_valid[-1]
self._chars_valid = self._chars_valid[:-1]
self._chars_valid_update_candidates_last = self._chars_valid
self._chars_invalid_update_candidates_last = self._chars_invalid
return False
def commit_to_preedit(self):
'''Add selected phrase in lookup table to preëdit string'''
if not self._chars_valid:
return False
if self._candidates:
self._u_chars.insert(self._cursor_precommit,
self._candidates[self.get_cursor_pos()][0])
self._strings.insert(self._cursor_precommit,
self._candidates[self.get_cursor_pos()][1])
self._cursor_precommit += 1
self.clear_input_not_committed_to_preedit()
self.update_candidates()
return True
def commit_to_preedit_current_page(self, index):
'''
Commits the candidate at position “index” in the current
page of the lookup table to the preëdit. Does not yet “really”
commit the candidate, only to the preëdit.
'''
cursor_pos = self._lookup_table.get_cursor_pos()
cursor_in_page = self._lookup_table.get_cursor_in_page()
current_page_start = cursor_pos - cursor_in_page
real_index = current_page_start + index
if real_index >= len(self._candidates):
# the index given is out of range we do not commit anything
return False
self._lookup_table.set_cursor_pos(real_index)
return self.commit_to_preedit()
def get_aux_strings(self):
'''Get aux strings'''
input_chars = self.get_input_chars()
if input_chars:
aux_string = input_chars
if DEBUG_LEVEL > 0 and self._u_chars:
(tabkeys_left,
dummy_tabkeys_current,
tabkeys_right) = self.get_preedit_tabkeys_parts()
(strings_left,
dummy_string_current,
strings_right) = self.get_preedit_string_parts()
aux_string = u''
for i in range(0, len(strings_left)):
aux_string += (
u'('
+ tabkeys_left[i] + u' '+ strings_left[i]
+ u') ')
aux_string += input_chars
for i in range(0, len(strings_right)):
aux_string += (
u' ('
+ tabkeys_right[i]+u' '+strings_right[i]
+ u')')
if self._py_mode:
aux_string = aux_string.replace(
'!', '1').replace(
'@', '2').replace(
'#', '3').replace(
'$', '4').replace(
'%', '5')
else:
aux_string_new = u''
for char in aux_string:
if char in self._prompt_characters:
aux_string_new += self._prompt_characters[char]
else:
aux_string_new += char
aux_string = aux_string_new
return aux_string
# There are no input strings at the moment. But there could
# be stuff committed to the preëdit. If there is something
# committed to the preëdit, show some information in the
# auxiliary text.
#
# For the character at the position of the cursor in the
# preëdit, show a list of possible input key sequences which
# could be used to type that character at the left side of the
# auxiliary text.
#
# If the preëdit is longer than one character, show the input
# key sequence which will be defined for the complete current
# contents of the preëdit, if the preëdit is committed.
aux_string = u''
if self._strings:
if self._cursor_precommit >= len(self._strings):
char = self._strings[-1][0]
else:
char = self._strings[self._cursor_precommit][0]
aux_string = u' '.join(self.db.find_zi_code(char))
cstr = u''.join(self._strings)
if self.db.user_can_define_phrase:
if len(cstr) > 1:
aux_string += (u'\t#: ' + self.db.parse_phrase(cstr))
aux_string_new = u''
for char in aux_string:
if char in self._prompt_characters:
aux_string_new += self._prompt_characters[char]
else:
aux_string_new += char
return aux_string_new
def fill_lookup_table(self):
'''Fill more entries to self._lookup_table if needed.
If the cursor in _lookup_table moved beyond current length,
add more entries from _candidiate[0] to _lookup_table.'''
looklen = self._lookup_table.get_number_of_candidates()
psize = self._lookup_table.get_page_size()
if (self._lookup_table.get_cursor_pos() + psize >= looklen and
looklen < len(self._candidates)):
endpos = looklen + psize
batch = self._candidates[looklen:endpos]
for candidate in batch:
self.append_candidate_to_lookup_table(
tabkeys=candidate[0],
phrase=candidate[1],
freq=candidate[2],
user_freq=candidate[3])
def cursor_down(self):
'''Process Arrow Down Key Event
Move Lookup Table cursor down'''
self.fill_lookup_table()
res = self._lookup_table.cursor_down()
self.update_candidates()
if not res and self._candidates:
return True
return res
def cursor_up(self):
'''Process Arrow Up Key Event
Move Lookup Table cursor up'''
res = self._lookup_table.cursor_up()
self.update_candidates()
if not res and self._candidates:
return True
return res
def page_down(self):
'''Process Page Down Key Event
Move Lookup Table page down'''
self.fill_lookup_table()
res = self._lookup_table.page_down()
self.update_candidates()
if not res and self._candidates:
return True
return res
def page_up(self):
'''Process Page Up Key Event
move Lookup Table page up'''
res = self._lookup_table.page_up()
self.update_candidates()
if not res and self._candidates:
return True
return res
def select_key(self, keycode):
'''
Commit a candidate which was selected by typing a selection key
from the lookup table to the preedit. Does not yet “really”
commit the candidate, only to the preedit.
'''
if keycode not in self._select_keys:
return False
return self.commit_to_preedit_current_page(
self._select_keys.index(keycode))
def remove_candidate_from_user_database(self, keycode):
'''Remove a candidate displayed in the lookup table from the user
database.
The candidate indicated by the selection key with the key code
“keycode” is removed, if possible. If it is not in the user
database at all, nothing happens.
If this is a candidate which is also in the system database,
removing it from the user database only means that its user
frequency data is reset. It might still appear in subsequent
matches but with much lower priority.
If this is a candidate which is user defined and not in the system
database, it will not match at all anymore after removing it.
'''
if keycode not in self._select_keys:
return False
index = self._select_keys.index(keycode)
cursor_pos = self._lookup_table.get_cursor_pos()
cursor_in_page = self._lookup_table.get_cursor_in_page()
current_page_start = cursor_pos - cursor_in_page
real_index = current_page_start + index
if len(self._candidates) > real_index: # this index is valid
candidate = self._candidates[real_index]
self.db.remove_phrase(
tabkeys=candidate[0], phrase=candidate[1], commit=True)
# call update_candidates() to get a new SQL query. The
# input has not really changed, therefore we must clear
# the remembered list of characters to
# force update_candidates() to really do something and not
# return immediately:
self._chars_valid_update_candidates_last = u''
self._chars_invalid_update_candidates_last = u''
self.update_candidates()
return True
return False
def get_cursor_pos(self):
'''get lookup table cursor position'''
return self._lookup_table.get_cursor_pos()
def get_lookup_table(self):
'''Get lookup table'''
return self._lookup_table
def remove_char(self):
'''Process remove_char Key Event'''
if DEBUG_LEVEL > 1:
sys.stderr.write("remove_char()\n")
if self.get_input_chars():
self.pop_input()
return
self.remove_preedit_character_before_cursor()
def delete(self):
'''Process delete Key Event'''
if self.get_input_chars():
return
self.remove_preedit_character_after_cursor()
def cycle_next_cand(self):
'''Cycle cursor to next candidate in the page.'''
total = len(self._candidates)
if total > 0:
page_size = self._lookup_table.get_page_size()
pos = self._lookup_table.get_cursor_pos()
page = int(pos/page_size)
pos += 1
if pos >= (page+1)*page_size or pos >= total:
pos = page*page_size
self._lookup_table.set_cursor_pos(pos)
return True
else:
return False
def one_candidate(self):
'''Return true if there is only one candidate'''
return len(self._candidates) == 1
########################
### Engine Class #####
####################
class TabEngine(IBus.Engine):
'''The IM Engine for Tables'''
def __init__(self, bus, obj_path, db, unit_test=False):
super(TabEngine, self).__init__(connection=bus.get_connection(),
object_path=obj_path)
global DEBUG_LEVEL
try:
DEBUG_LEVEL = int(os.getenv('IBUS_TABLE_DEBUG_LEVEL'))
except (TypeError, ValueError):
DEBUG_LEVEL = int(0)
self._unit_test = unit_test
self._input_purpose = 0
self._has_input_purpose = False
if hasattr(IBus, 'InputPurpose'):
self._has_input_purpose = True
self._bus = bus
# this is the backend sql db we need for our IME
# we receive this db from IMEngineFactory
#self.db = tabsqlitedb.TabSqliteDb( name = dbname )
self.db = db
self._setup_pid = 0
self._icon_dir = '%s%s%s%s' % (os.getenv('IBUS_TABLE_LOCATION'),
os.path.sep, 'icons', os.path.sep)
self._engine_name = os.path.basename(
self.db.filename).replace('.db', '').replace(' ', '_')
if DEBUG_LEVEL > 1:
sys.stderr.write(
'TabEngine.__init__() self._engine_name = %s\n'
% self._engine_name)
self._gsettings = Gio.Settings(
schema='org.freedesktop.ibus.engine.table',
path='/org/freedesktop/ibus/engine/table/%s/' %self._engine_name)
self._gsettings.connect('changed', self.on_gsettings_value_changed)
# self._ime_py: Indicates whether this table supports pinyin mode
self._ime_py = self.db.ime_properties.get('pinyin_mode')
if self._ime_py:
self._ime_py = bool(self._ime_py.lower() == u'true')
else:
print('We could not find "pinyin_mode" entry in database, '
+ 'is it an outdated database?')
self._ime_py = False
self._symbol = self.db.ime_properties.get('symbol')
if self._symbol is None or self._symbol == u'':
self._symbol = self.db.ime_properties.get('status_prompt')
if self._symbol is None:
self._symbol = u''
# some Chinese tables have “STATUS_PROMPT = CN” replace it
# with the shorter and nicer “中”:
if self._symbol == u'CN':
self._symbol = u'中'
# workaround for the translit and translit-ua tables which
# have 2 character symbols. '☑' + self._symbol then is
# 3 characters and currently gnome-shell ignores symbols longer
# than 3 characters:
if self._symbol == u'Ya':
self._symbol = u'Я'
if self._symbol == u'Yi':
self._symbol = u'Ї'
# now we check and update the valid input characters
self._valid_input_chars = self.db.ime_properties.get(
'valid_input_chars')
self._pinyin_valid_input_chars = u'abcdefghijklmnopqrstuvwxyz!@#$%'
self._single_wildcard_char = it_util.variant_to_value(
self._gsettings.get_user_value('singlewildcardchar'))
if self._single_wildcard_char is None:
self._single_wildcard_char = self.db.ime_properties.get(
'single_wildcard_char')
if self._single_wildcard_char is None:
self._single_wildcard_char = it_util.variant_to_value(
self._gsettings.get_value('singlewildcardchar'))
if len(self._single_wildcard_char) > 1:
self._single_wildcard_char = self._single_wildcard_char[0]
self._multi_wildcard_char = it_util.variant_to_value(
self._gsettings.get_user_value('multiwildcardchar'))
if self._multi_wildcard_char is None:
self._multi_wildcard_char = self.db.ime_properties.get(
'multi_wildcard_char')
if self._multi_wildcard_char is None:
self._multi_wildcard_char = it_util.variant_to_value(
self._gsettings.get_value('multiwildcardchar'))
if len(self._multi_wildcard_char) > 1:
self._multi_wildcard_char = self._multi_wildcard_char[0]
self._auto_wildcard = it_util.variant_to_value(
self._gsettings.get_user_value('autowildcard'))
if self._auto_wildcard is None:
if self.db.ime_properties.get('auto_wildcard') != None:
self._auto_wildcard = self.db.ime_properties.get(
'auto_wildcard').lower() == u'true'
if self._auto_wildcard is None:
self._auto_wildcard = it_util.variant_to_value(
self._gsettings.get_value('autowildcard'))
self._max_key_length = int(
self.db.ime_properties.get('max_key_length'))
self._max_key_length_pinyin = 7
self._page_up_keys = [
IBus.KEY_Page_Up,
IBus.KEY_KP_Prior, # identical to IBus.KEY_KP_Page_UP!
IBus.KEY_KP_Page_Up,
IBus.KEY_minus
]
self._page_down_keys = [
IBus.KEY_Page_Down,
IBus.KEY_KP_Next, # identical to IBus.KEY_KP_Page_Down!
IBus.KEY_KP_Page_Down,
IBus.KEY_equal
]
# If page up or page down keys are defined in the database,
# use the values from the database instead of the above
# hardcoded defaults:
page_up_keys_csv = self.db.ime_properties.get('page_up_keys')
page_down_keys_csv = self.db.ime_properties.get('page_down_keys')
if page_up_keys_csv:
self._page_up_keys = [
IBus.keyval_from_name(x)
for x in page_up_keys_csv.split(',')]
if page_down_keys_csv:
self._page_down_keys = [
IBus.keyval_from_name(x)
for x in page_down_keys_csv.split(',')]
# Remove keys from the page up/down keys if they are needed
# for input (for example, '=' or '-' could well be needed for
# input. Input is more important):
for character in (
self._valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char):
keyval = IBus.unicode_to_keyval(character)
if keyval in self._page_up_keys:
self._page_up_keys.remove(keyval)
if keyval in self._page_down_keys:
self._page_down_keys.remove(keyval)
self._commit_keys = [IBus.KEY_space]
# If commit keys are are defined in the database, use the
# value from the database instead of the above hardcoded
# default:
commit_keys_csv = self.db.ime_properties.get('commit_keys')
if commit_keys_csv:
self._commit_keys = [
IBus.keyval_from_name(x)
for x in commit_keys_csv.split(',')]
# If commit keys conflict with page up/down keys, remove them
# from the page up/down keys (They cannot really be used for
# both at the same time. Theoretically, keys from the page
# up/down keys could still be used to commit when the number
# of candidates is 0 because then there is nothing to
# page. But that would be only confusing):
for keyval in self._commit_keys:
if keyval in self._page_up_keys:
self._page_up_keys.remove(keyval)
if keyval in self._page_down_keys:
self._page_down_keys.remove(keyval)
# Finally, check the user setting, i.e. the Gsettings value
# “spacekeybehavior” and let the user have the last word
# how to use the space key:
spacekeybehavior = it_util.variant_to_value(
self._gsettings.get_user_value('spacekeybehavior'))
if spacekeybehavior != None:
if spacekeybehavior is True:
# space is used as a page down key and not as a commit key:
if IBus.KEY_space not in self._page_down_keys:
self._page_down_keys.append(IBus.KEY_space)
if IBus.KEY_space in self._commit_keys:
self._commit_keys.remove(IBus.KEY_space)
if spacekeybehavior is False:
# space is used as a commit key and not used as a
# page down key:
if IBus.KEY_space in self._page_down_keys:
self._page_down_keys.remove(IBus.KEY_space)
if IBus.KEY_space not in self._commit_keys:
self._commit_keys.append(IBus.KEY_space)
if DEBUG_LEVEL > 1:
sys.stderr.write(
"self._page_down_keys=%s\n" %repr(self._page_down_keys))
sys.stderr.write(
"self._commit_keys=%s\n" %repr(self._commit_keys))
# 0 = Direct input, i.e. table input OFF (aka “English input mode”),
# most characters are just passed through to the application
# (but some fullwidth ↔ halfwidth conversion may be done even
# in this mode, depending on the settings)
# 1 = Table input ON (aka “Table input mode”, “Chinese mode”)
self._input_mode = it_util.variant_to_value(
self._gsettings.get_value('inputmode'))
# self._prev_key: hold the key event last time.
self._prev_key = None
self._prev_char = None
self._double_quotation_state = False
self._single_quotation_state = False
self._full_width_letter = [
it_util.variant_to_value(
self._gsettings.get_value('endeffullwidthletter')),
it_util.variant_to_value(
self._gsettings.get_user_value('tabdeffullwidthletter'))
]
if self._full_width_letter[1] is None:
if self.db.ime_properties.get('def_full_width_letter'):
self._full_width_letter[1] = self.db.ime_properties.get(
'def_full_width_letter').lower() == u'true'
if self._full_width_letter[1] is None:
self._full_width_letter[1] = it_util.variant_to_value(
self._gsettings.get_value('tabdeffullwidthletter'))
self._full_width_punct = [
it_util.variant_to_value(
self._gsettings.get_value('endeffullwidthpunct')),
it_util.variant_to_value(
self._gsettings.get_user_value('tabdeffullwidthpunct'))
]
if self._full_width_punct[1] is None:
if self.db.ime_properties.get('def_full_width_punct'):
self._full_width_punct[1] = self.db.ime_properties.get(
'def_full_width_punct').lower() == u'true'
if self._full_width_punct[1] is None:
self._full_width_punct[1] = it_util.variant_to_value(
self._gsettings.get_value('tabdeffullwidthpunct'))
self._auto_commit = it_util.variant_to_value(
self._gsettings.get_user_value('autocommit'))
if self._auto_commit is None:
if self.db.ime_properties.get('auto_commit'):
self._auto_commit = self.db.ime_properties.get(
'auto_commit').lower() == u'true'
if self._auto_commit is None:
self._auto_commit = it_util.variant_to_value(
self._gsettings.get_value('autocommit'))
# If auto select is true, then the first candidate phrase will
# be selected automatically during typing. Auto select is true
# by default for the stroke5 table for example.
self._auto_select = it_util.variant_to_value(
self._gsettings.get_user_value('autoselect'))
if self._auto_select is None:
if self.db.ime_properties.get('auto_select') != None:
self._auto_select = self.db.ime_properties.get(
'auto_select').lower() == u'true'
if self._auto_select is None:
self._auto_select = it_util.variant_to_value(
self._gsettings.get_value('autoselect'))
self._always_show_lookup = it_util.variant_to_value(
self._gsettings.get_user_value('alwaysshowlookup'))
if self._always_show_lookup is None:
if self.db.ime_properties.get('always_show_lookup') != None:
self._always_show_lookup = self.db.ime_properties.get(
'always_show_lookup').lower() == u'true'
if self._always_show_lookup is None:
self._always_show_lookup = it_util.variant_to_value(
self._gsettings.get_value('alwaysshowlookup'))
self._editor = Editor(self._gsettings,
self._valid_input_chars,
self._pinyin_valid_input_chars,
self._single_wildcard_char,
self._multi_wildcard_char,
self._auto_wildcard,
self._full_width_letter,
self._full_width_punct,
self._max_key_length,
self.db)
self.chinese_mode_properties = {
'ChineseMode.Simplified': {
'number': 0,
'symbol': '簡',
'icon': 'sc-mode.svg',
# Translators: This is the menu entry to select
# when one wants to input only Simplified Chinese.
'label': _('Simplified Chinese'),
'tooltip':
_('Switch to “Simplified Chinese only”.')},
'ChineseMode.Traditional': {
'number': 1,
'symbol': '繁',
'icon': 'tc-mode.svg',
# Translators: This is the menu entry to select
# when one wants to input only Traditonal Chinese
'label': _('Traditional Chinese'),
'tooltip':
_('Switch to “Traditional Chinese only”.')},
'ChineseMode.SimplifiedFirst': {
'number': 2,
'symbol': '簡/大',
'icon': 'scb-mode.svg',
# Translators: This is the menu entry to select when
# one wants to input both Simplified and Traditional
# Chinese but wants the Simplified Chinese to be
# preferred, i.e. shown higher up in the candidate
# lists.
'label': _('Simplified Chinese first'),
'tooltip':
_('Switch to “Simplified Chinese before traditional”.')},
'ChineseMode.TraditionalFirst': {
'number': 3,
'symbol': '繁/大',
'icon': 'tcb-mode.svg',
# Translators: This is the menu entry to select when
# one wants to input both Simplified and Traditional
# Chinese but wants the Traditional Chinese to be
# preferred, i.e. shown higher up in the candidate
# lists.
'label': _('Traditional Chinese first'),
'tooltip':
_('Switch to “Traditional Chinese before simplified”.')},
'ChineseMode.All': {
'number': 4,
'symbol': '大',
'icon': 'cb-mode.svg',
# Translators: This is the menu entry to select when
# one wants to input both Simplified and Traditional
# Chinese and has no particular preference whether
# simplified or traditional characters should be higher
# up in the candidate lists.
'label': _('All Chinese characters'),
'tooltip': _('Switch to “All Chinese characters”.')}
}
self.chinese_mode_menu = {
'key': 'ChineseMode',
'label': _('Chinese mode'),
'tooltip': _('Switch Chinese mode'),
'shortcut_hint': '(Ctrl-;)',
'sub_properties': self.chinese_mode_properties
}
if self.db._is_chinese:
self.input_mode_properties = {
'InputMode.Direct': {
'number': 0,
'symbol': '英',
'icon': 'english.svg',
'label': _('English'),
'tooltip': _('Switch to English input')},
'InputMode.Table': {
'number': 1,
'symbol': '中',
'symbol_table': '中',
'symbol_pinyin': '拼音',
'icon': 'chinese.svg',
'label': _('Chinese'),
'tooltip': _('Switch to Chinese input')}
}
else:
self.input_mode_properties = {
'InputMode.Direct': {
'number': 0,
'symbol': '☐' + self._symbol,
'icon': 'english.svg',
'label': _('Direct'),
'tooltip': _('Switch to direct input')},
'InputMode.Table': {
'number': 1,
'symbol': '☑' + self._symbol,
'icon': 'ibus-table.svg',
'label': _('Table'),
'tooltip': _('Switch to table input')}
}
# The symbol of the property “InputMode” is displayed
# in the input method indicator of the Gnome3 panel.
# This depends on the property name “InputMode” and
# is case sensitive!
self.input_mode_menu = {
'key': 'InputMode',
'label': _('Input mode'),
'tooltip': _('Switch Input mode'),
'shortcut_hint': '(Left Shift)',
'sub_properties': self.input_mode_properties
}
self.letter_width_properties = {
'LetterWidth.Half': {
'number': 0,
'symbol': '◑',
'icon': 'half-letter.svg',
'label': _('Half'),
'tooltip': _('Switch to halfwidth letters')},
'LetterWidth.Full': {
'number': 1,
'symbol': '●',
'icon': 'full-letter.svg',
'label': _('Full'),
'tooltip': _('Switch to fullwidth letters')}
}
self.letter_width_menu = {
'key': 'LetterWidth',
'label': _('Letter width'),
'tooltip': _('Switch letter width'),
'shortcut_hint': '(Shift-Space)',
'sub_properties': self.letter_width_properties
}
self.punctuation_width_properties = {
'PunctuationWidth.Half': {
'number': 0,
'symbol': ',.',
'icon': 'half-punct.svg',
'label': _('Half'),
'tooltip': _('Switch to halfwidth punctuation')},
'PunctuationWidth.Full': {
'number': 1,
'symbol': '、。',
'icon': 'full-punct.svg',
'label': _('Full'),
'tooltip': _('Switch to fullwidth punctuation')}
}
self.punctuation_width_menu = {
'key': 'PunctuationWidth',
'label': _('Punctuation width'),
'tooltip': _('Switch punctuation width'),
'shortcut_hint': '(Ctrl-.)',
'sub_properties': self.punctuation_width_properties
}
self.pinyin_mode_properties = {
'PinyinMode.Table': {
'number': 0,
'symbol': '☐ 拼音',
'icon': 'tab-mode.svg',
'label': _('Table'),
'tooltip': _('Switch to table mode')},
'PinyinMode.Pinyin': {
'number': 1,
'symbol': '☑ 拼音',
'icon': 'py-mode.svg',
'label': _('Pinyin'),
'tooltip': _('Switch to pinyin mode')}
}
self.pinyin_mode_menu = {
'key': 'PinyinMode',
'label': _('Pinyin mode'),
'tooltip': _('Switch pinyin mode'),
'shortcut_hint': '(Right Shift)',
'sub_properties': self.pinyin_mode_properties
}
self.onechar_mode_properties = {
'OneCharMode.Phrase': {
'number': 0,
'symbol': '☐ 1',
'icon': 'phrase.svg',
'label': _('Multiple character match'),
'tooltip':
_('Switch to matching multiple characters at once')},
'OneCharMode.OneChar': {
'number': 1,
'symbol': '☑ 1',
'icon': 'onechar.svg',
'label': _('Single character match'),
'tooltip':
_('Switch to matching only single characters')}
}
self.onechar_mode_menu = {
'key': 'OneCharMode',
'label': _('Onechar mode'),
'tooltip': _('Switch onechar mode'),
'shortcut_hint': '(Ctrl-,)',
'sub_properties': self.onechar_mode_properties
}
self.autocommit_mode_properties = {
'AutoCommitMode.Direct': {
'number': 0,
'symbol': '☐ ↑',
'icon': 'ncommit.svg',
'label': _('Normal'),
'tooltip':
_('Switch to normal commit mode '
+ '(automatic commits go into the preedit '
+ 'instead of into the application. '
+ 'This enables automatic definitions of new shortcuts)')},
'AutoCommitMode.Normal': {
'number': 1,
'symbol': '☑ ↑',
'icon': 'acommit.svg',
'label': _('Direct'),
'tooltip':
_('Switch to direct commit mode '
+ '(automatic commits go directly into the application)')}
}
self.autocommit_mode_menu = {
'key': 'AutoCommitMode',
'label': _('Auto commit mode'),
'tooltip': _('Switch autocommit mode'),
'shortcut_hint': '(Ctrl-/)',
'sub_properties': self.autocommit_mode_properties
}
self._prop_dict = {}
self._init_properties()
self._on = False
self._save_user_count = 0
self._save_user_start = time.time()
self._save_user_count_max = SAVE_USER_COUNT_MAX
self._save_user_timeout = SAVE_USER_TIMEOUT
self.reset()
self.sync_timeout_id = GObject.timeout_add_seconds(
1, self._sync_user_db)
def reset(self):
'''Clear the preëdit and close the lookup table
'''
self._editor.clear_all_input_and_preedit()
self._double_quotation_state = False
self._single_quotation_state = False
self._prev_key = None
self._update_ui()
def do_destroy(self):
'''Called when this input engine is destroyed
'''
if self.sync_timeout_id > 0:
GObject.source_remove(self.sync_timeout_id)
self.sync_timeout_id = 0
self.reset()
self.do_focus_out()
if self._save_user_count > 0:
self.db.sync_usrdb()
self._save_user_count = 0
super(TabEngine, self).destroy()
def set_input_mode(self, mode=1):
'''Sets whether direct input or the current table is used.
:param mode: Whether to use Pinyin.
0: Use direct input.
1: Use the current table.
:type mode: Integer, 0 or 1.
'''
if mode == self._input_mode:
return
self._input_mode = mode
# Not saved to Gsettings on purpose. In the setup tool one
# can select whether “Table input” or “Direct input” should
# be the default when the input method starts. But when
# changing this input mode using the property menu,
# the change is not remembered.
self._init_or_update_property_menu(
self.input_mode_menu,
self._input_mode)
# Letter width and punctuation width depend on the input mode.
# Therefore, the properties for letter width and punctuation
# width need to be updated here:
self._init_or_update_property_menu(
self.letter_width_menu,
self._full_width_letter[self._input_mode])
self._init_or_update_property_menu(
self.punctuation_width_menu,
self._full_width_punct[self._input_mode])
self.reset()
def get_input_mode(self):
'''
Return the current input mode, direct input: 0, table input: 1.
:rtype: Integer
'''
return self._input_mode
def set_pinyin_mode(self, mode=False):
'''Sets whether Pinyin is used.
:param mode: Whether to use Pinyin.
True: Use Pinyin.
False: Use the current table.
:type mode: Boolean
'''
if mode == self._editor._py_mode:
return
# The pinyin mode is never saved to Gsettings on purpose
self._editor.commit_to_preedit()
self._editor._py_mode = mode
self._init_or_update_property_menu(
self.pinyin_mode_menu, mode)
if mode:
self.input_mode_properties['InputMode.Table']['symbol'] = (
self.input_mode_properties['InputMode.Table']['symbol_pinyin'])
else:
self.input_mode_properties['InputMode.Table']['symbol'] = (
self.input_mode_properties['InputMode.Table']['symbol_table'])
self._init_or_update_property_menu(
self.input_mode_menu,
self._input_mode)
self._update_ui()
def set_onechar_mode(self, mode=False, update_gsettings=True):
'''Sets whether only single characters should be matched in
the database.
:param mode: Whether only single characters should be matched.
True: Match only single characters.
False: Possibly match multiple characters at once.
:type mode: Boolean
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._editor._onechar:
return
self._editor._onechar = mode
self._init_or_update_property_menu(
self.onechar_mode_menu, mode)
self.db.reset_phrases_cache()
if update_gsettings:
self._gsettings.set_value(
"onechar",
GLib.Variant.new_boolean(mode))
def get_onechar_mode(self):
'''
Returns whether only single characters are matched in the database.
:rtype: Boolean
'''
return self._editor._onechar
def set_autocommit_mode(self, mode=False, update_gsettings=True):
'''Sets whether automatic commits go into the preëdit or into the
application.
:param mode: Whether automatic commits go into the preëdit
or into the application.
True: Into the application.
False: Into the preëdit.
:type mode: Boolean
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._auto_commit:
return
self._auto_commit = mode
self._init_or_update_property_menu(
self.autocommit_mode_menu, mode)
if update_gsettings:
self._gsettings.set_value(
"autocommit",
GLib.Variant.new_boolean(mode))
def get_autocommit_mode(self):
'''
Returns the current auto-commit mode.
:rtype: Boolean
'''
return self._auto_commit
def set_autoselect_mode(self, mode=False, update_gsettings=True):
'''Sets whether the first candidate will be selected
automatically during typing.
:param mode: Whether to select the first candidate automatically.
:type mode: Boolean
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._auto_select:
return
self._auto_select = mode
self._editor._auto_select = mode
if update_gsettings:
self._gsettings.set_value(
"autoselect",
GLib.Variant.new_boolean(mode))
def get_autoselect_mode(self):
'''
Returns the current auto-select mode.
:rtype: Boolean
'''
return self._auto_select
def set_autowildcard_mode(self, mode=False, update_gsettings=True):
'''Sets whether a wildcard should be automatically appended
to the input.
:param mode: Whether to append a wildcard automatically.
:type mode: Boolean
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._auto_wildcard:
return
self._auto_wildcard = mode
self._editor._auto_wildcard = mode
self.db.reset_phrases_cache()
if update_gsettings:
self._gsettings.set_value(
"autowildcard",
GLib.Variant.new_boolean(mode))
def get_autowildcard_mode(self):
'''
Returns the current automatic wildcard mode.
:rtype: Boolean
'''
return self._auto_wildcard
def set_single_wildcard_char(self, char=u'', update_gsettings=True):
'''Sets the single wildchard character.
:param char: The character to use as a single wildcard.
:type char: String of length 1.
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if char == self._single_wildcard_char:
return
self._single_wildcard_char = char
self._editor._single_wildcard_char = char
self.db.reset_phrases_cache()
if update_gsettings:
self._gsettings.set_value(
"singlewildcardchar",
GLib.Variant.new_string(char))
def get_single_wildcard_char(self):
'''
Return the character currently used as a single wildcard.
:rtype: String of length 1.
'''
return self._single_wildcard_char
def set_multi_wildcard_char(self, char=u'', update_gsettings=True):
'''Sets the multi wildchard character.
:param char: The character to use as a multi wildcard.
:type mode: String of length 1.
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if len(char) > 1:
char = char[0]
if char == self._multi_wildcard_char:
return
self._multi_wildcard_char = char
self._editor._multi_wildcard_char = char
self.db.reset_phrases_cache()
if update_gsettings:
self._gsettings.set_value(
"multiwildcardchar",
GLib.Variant.new_string(char))
def get_multi_wildcard_char(self):
'''
Return the character currently used as a multi wildcard.
:rtype: String of length 1.
'''
return self._multi_wildcard_char
def set_space_key_behavior_mode(self, mode=False, update_gsettings=True):
'''Sets the behaviour of the space key
:param mode: How the space key should behave
:type mode: Boolean
True: space is used as a page down key
and not as a commit key.
False: space is used as a commit key
and not used as a page down key
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: boolean
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
"set_space_key_behavior_mode(%s)\n"
%mode)
if mode is True:
# space is used as a page down key and not as a commit key:
if IBus.KEY_space not in self._page_down_keys:
self._page_down_keys.append(IBus.KEY_space)
if IBus.KEY_space in self._commit_keys:
self._commit_keys.remove(IBus.KEY_space)
if mode is False:
# space is used as a commit key and not used as a page down key:
if IBus.KEY_space in self._page_down_keys:
self._page_down_keys.remove(IBus.KEY_space)
if IBus.KEY_space not in self._commit_keys:
self._commit_keys.append(IBus.KEY_space)
if DEBUG_LEVEL > 1:
sys.stderr.write(
'set_space_key_behavior_mode(): self._page_down_keys=%s\n'
% repr(self._page_down_keys))
sys.stderr.write(
'set_space_key_behavior_mode(): self._commit_keys=%s\n'
% repr(self._commit_keys))
if update_gsettings:
self._gsettings.set_value(
"spacekeybehavior",
GLib.Variant.new_boolean(mode))
def get_space_key_behavior_mode(self):
'''
Returns the current space key behaviour mode.
:rtype: Boolean
'''
mode = False
if IBus.KEY_space in self._page_down_keys:
mode = True
if IBus.KEY_space in self._commit_keys:
# commit key behaviour overrides the page down behaviour
mode = False
return mode
def set_always_show_lookup(self, mode=False, update_gsettings=True):
'''Sets the whether the lookup table is shown.
:param mode: Whether to show the lookup table.
:type mode: Boolean
True: Lookup table is shown
False: Lookup table is hidden
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._always_show_lookup:
return
self._always_show_lookup = mode
if update_gsettings:
self._gsettings.set_value(
"alwaysshowlookup",
GLib.Variant.new_boolean(mode))
def get_always_show_lookup(self):
'''
Returns whether the lookup table is shown or hidden.
:rtype: Boolean
'''
return self._always_show_lookup
def set_lookup_table_orientation(self, orientation, update_gsettings=True):
'''Sets the orientation of the lookup table
:param orientation: The orientation of the lookup table
:type mode: integer >= 0 and <= 2
IBUS_ORIENTATION_HORIZONTAL = 0,
IBUS_ORIENTATION_VERTICAL = 1,
IBUS_ORIENTATION_SYSTEM = 2.
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: boolean
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
"set_lookup_table_orientation(%s)\n"
%orientation)
if orientation == self._editor._orientation:
return
if orientation >= 0 and orientation <= 2:
self._editor._orientation = orientation
self._editor._lookup_table.set_orientation(orientation)
if update_gsettings:
self._gsettings.set_value(
'lookuptableorientation',
GLib.Variant.new_int32(orientation))
def get_lookup_table_orientation(self):
'''Returns the current orientation of the lookup table
:rtype: integer
'''
return self._editor._orientation
def set_page_size(self, page_size, update_gsettings=True):
'''Sets the page size of the lookup table
:param orientation: The orientation of the lookup table
:type mode: integer >= 1 and <= number of select keys
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: boolean
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
"set_page_size(%s)\n"
%page_size)
if page_size == self._editor._page_size:
return
if page_size > len(self._editor._select_keys):
page_size = len(self._editor._select_keys)
if page_size < 1:
page_size = 1
self._editor._page_size = page_size
self._editor._lookup_table = self._editor.get_new_lookup_table(
page_size=self._editor._page_size,
select_keys=self._editor._select_keys,
orientation=self._editor._orientation)
self.reset()
if update_gsettings:
self._gsettings.set_value(
'lookuptablepagesize',
GLib.Variant.new_int32(page_size))
def get_page_size(self):
'''Returns the current page size of the lookup table
:rtype: integer
'''
return self._editor._page_size
def set_letter_width(
self, mode=False, input_mode=0, update_gsettings=True):
'''
Sets whether full width letters should be used.
:param mode: Whether to use full width letters
:type mode: Boolean
:param input_mode: The input mode (direct input: 0, table: 1)
for which to set the full width letter mode.
:type input_mode: Integer
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the Gsettings key changed
to avoid endless loops when the Gsettings
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._full_width_letter[input_mode]:
return
self._full_width_letter[input_mode] = mode
self._editor._full_width_letter[input_mode] = mode
if input_mode == self._input_mode:
self._init_or_update_property_menu(
self.letter_width_menu, mode)
if update_gsettings:
if input_mode:
self._gsettings.set_value(
"tabdeffullwidthletter",
GLib.Variant.new_boolean(mode))
else:
self._gsettings.set_value(
"endeffullwidthletter",
GLib.Variant.new_boolean(mode))
def get_letter_width(self):
'''
Return the current full width letter modes.
:rtype: [Boolean, Boolean]
'''
return self._full_width_letter
def set_punctuation_width(
self, mode=False, input_mode=0, update_gsettings=True):
'''
Sets whether full width punctuation should be used.
:param mode: Whether to use full width punctuation
:type mode: Boolean
:param input_mode: The input mode (direct input: 0, table: 1)
for which to set the full width punctuation mode.
:type input_mode: Integer
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the Gsettings key changed
to avoid endless loops when the Gsettings
key is changed twice in a short time.
:type update_gsettings: Boolean
'''
if mode == self._full_width_punct[input_mode]:
return
self._full_width_punct[input_mode] = mode
self._editor._full_width_punct[input_mode] = mode
if input_mode == self._input_mode:
self._init_or_update_property_menu(
self.punctuation_width_menu, mode)
if update_gsettings:
if input_mode:
self._gsettings.set_value(
"tabdeffullwidthpunct",
GLib.Variant.new_boolean(mode))
else:
self._gsettings.set_value(
"endeffullwidthpunct",
GLib.Variant.new_boolean(mode))
def get_punctuation_width(self):
'''
Return the current full width punctuation modes.
:rtype: [Boolean, Boolean]
'''
return self._full_width_punct
def set_chinese_mode(self, mode=0, update_gsettings=True):
'''Sets the candidate filter mode used for Chinese
0 means to show simplified Chinese only
1 means to show traditional Chinese only
2 means to show all characters but show simplified Chinese first
3 means to show all characters but show traditional Chinese first
4 means to show all characters
:param mode: The Chinese filter mode
:type mode: integer >= 0 and <= 4
:param update_gsettings: Whether to write the change to Gsettings.
Set this to False if this method is
called because the dconf key changed
to avoid endless loops when the dconf
key is changed twice in a short time.
:type update_gsettings: boolean
'''
if DEBUG_LEVEL > 1:
sys.stderr.write('set_chinese_mode(%s)\n' %mode)
if mode == self._editor._chinese_mode:
return
self._editor._chinese_mode = mode
self.db.reset_phrases_cache()
self._init_or_update_property_menu(
self.chinese_mode_menu, mode)
if update_gsettings:
self._gsettings.set_value(
"chinesemode",
GLib.Variant.new_int32(mode))
def get_chinese_mode(self):
'''
Return the current Chinese mode.
0 means to show simplified Chinese only
1 means to show traditional Chinese only
2 means to show all characters but show simplified Chinese first
3 means to show all characters but show traditional Chinese first
4 means to show all characters
:rtype: Integer
'''
return self._editor._chinese_mode
def _init_or_update_property_menu(self, menu, current_mode=0):
'''
Initialize or update a ibus property menu
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
"_init_or_update_property_menu() menu=%s current_mode=%s\n"
%(repr(menu), current_mode))
key = menu['key']
update_prop = bool(key in self._prop_dict)
sub_properties = menu['sub_properties']
for prop in sub_properties:
if sub_properties[prop]['number'] == int(current_mode):
symbol = sub_properties[prop]['symbol']
icon = sub_properties[prop]['icon']
label = '%(label)s (%(symbol)s) %(shortcut_hint)s' % {
'label': menu['label'],
'symbol': symbol,
'shortcut_hint': menu['shortcut_hint']}
tooltip = '%(tooltip)s\n%(shortcut_hint)s' % {
'tooltip': menu['tooltip'],
'shortcut_hint': menu['shortcut_hint']}
self._prop_dict[key] = IBus.Property(
key=key,
prop_type=IBus.PropType.MENU,
label=IBus.Text.new_from_string(label),
symbol=IBus.Text.new_from_string(symbol),
icon=os.path.join(self._icon_dir, icon),
tooltip=IBus.Text.new_from_string(tooltip),
sensitive=True,
visible=True,
state=IBus.PropState.UNCHECKED,
sub_props=None)
self._prop_dict[key].set_sub_props(
self._init_sub_properties(
sub_properties, current_mode=current_mode))
if update_prop:
self.properties.update_property(self._prop_dict[key])
self.update_property(self._prop_dict[key])
else:
self.properties.append(self._prop_dict[key])
def _init_sub_properties(self, modes, current_mode=0):
'''
Initialize the sub properties of the ibus property menus.
'''
sub_props = IBus.PropList()
for mode in sorted(modes, key=lambda x: (modes[x]['number'])):
sub_props.append(IBus.Property(
key=mode,
prop_type=IBus.PropType.RADIO,
label=IBus.Text.new_from_string(modes[mode]['label']),
icon=os.path.join(modes[mode]['icon']),
tooltip=IBus.Text.new_from_string(modes[mode]['tooltip']),
sensitive=True,
visible=True,
state=IBus.PropState.UNCHECKED,
sub_props=None))
i = 0
while sub_props.get(i) != None:
prop = sub_props.get(i)
key = prop.get_key()
self._prop_dict[key] = prop
if modes[key]['number'] == int(current_mode):
prop.set_state(IBus.PropState.CHECKED)
else:
prop.set_state(IBus.PropState.UNCHECKED)
self.update_property(prop) # important!
i += 1
return sub_props
def _init_properties(self):
'''
Initialize the ibus property menus
'''
self._prop_dict = {}
self.properties = IBus.PropList()
self._init_or_update_property_menu(
self.input_mode_menu,
self._input_mode)
if self.db._is_chinese and self._editor._chinese_mode != -1:
self._init_or_update_property_menu(
self.chinese_mode_menu,
self._editor._chinese_mode)
if self.db._is_cjk:
self._init_or_update_property_menu(
self.letter_width_menu,
self._full_width_letter[self._input_mode])
self._init_or_update_property_menu(
self.punctuation_width_menu,
self._full_width_punct[self._input_mode])
if self._ime_py:
self._init_or_update_property_menu(
self.pinyin_mode_menu,
self._editor._py_mode)
if self.db._is_cjk:
self._init_or_update_property_menu(
self.onechar_mode_menu,
self._editor._onechar)
if self.db.user_can_define_phrase and self.db.rules:
self._init_or_update_property_menu(
self.autocommit_mode_menu,
self._auto_commit)
self._setup_property = IBus.Property(
key=u'setup',
label=IBus.Text.new_from_string(_('Setup')),
icon='gtk-preferences',
tooltip=IBus.Text.new_from_string(
_('Configure ibus-table “%(engine-name)s”')
% {'engine-name': self._engine_name}),
sensitive=True,
visible=True)
self.properties.append(self._setup_property)
self.register_properties(self.properties)
def do_property_activate(
self, ibus_property, prop_state=IBus.PropState.UNCHECKED):
'''
Handle clicks on properties
'''
if DEBUG_LEVEL > 1:
sys.stderr.write(
'do_property_activate() '
+ 'ibus_property=%(p)s prop_state=%(ps)s\n'
% {'p': ibus_property, 'ps': prop_state})
if ibus_property == "setup":
self._start_setup()
return
if prop_state != IBus.PropState.CHECKED:
# If the mouse just hovered over a menu button and
# no sub-menu entry was clicked, there is nothing to do:
return
if ibus_property.startswith(self.input_mode_menu['key']+'.'):
self.set_input_mode(
self.input_mode_properties[ibus_property]['number'])
return
if (ibus_property.startswith(self.pinyin_mode_menu['key']+'.')
and self._ime_py):
self.set_pinyin_mode(
bool(self.pinyin_mode_properties[ibus_property]['number']))
return
if (ibus_property.startswith(self.onechar_mode_menu['key']+'.')
and self.db._is_cjk):
self.set_onechar_mode(
bool(self.onechar_mode_properties[ibus_property]['number']))
return
if (ibus_property.startswith(self.autocommit_mode_menu['key']+'.')
and self.db.user_can_define_phrase and self.db.rules):
self.set_autocommit_mode(
bool(self.autocommit_mode_properties[ibus_property]['number']))
return
if (ibus_property.startswith(self.letter_width_menu['key']+'.')
and self.db._is_cjk):
self.set_letter_width(
bool(self.letter_width_properties[ibus_property]['number']),
input_mode=self._input_mode)
return
if (ibus_property.startswith(self.punctuation_width_menu['key']+'.')
and self.db._is_cjk):
self.set_punctuation_width(
bool(self.punctuation_width_properties[
ibus_property]['number']),
input_mode=self._input_mode)
return
if (ibus_property.startswith(self.chinese_mode_menu['key']+'.')
and self.db._is_chinese
and self._editor._chinese_mode != -1):
self.set_chinese_mode(
self.chinese_mode_properties[ibus_property]['number'])
return
def _start_setup(self):
'''
Start the setup tool if it is not running yet.
'''
if self._setup_pid != 0:
pid, dummy_state = os.waitpid(self._setup_pid, os.P_NOWAIT)
if pid != self._setup_pid:
# If the last setup tool started from here is still
# running the pid returned by the above os.waitpid()
# is 0. In that case just return, don’t start a
# second setup tool.
return
self._setup_pid = 0
setup_cmd = os.path.join(
os.getenv('IBUS_TABLE_LIB_LOCATION'),
'ibus-setup-table')
self._setup_pid = os.spawnl(
os.P_NOWAIT,
setup_cmd,
'ibus-setup-table',
'--engine-name table:%s' %self._engine_name)
def _update_preedit(self):
'''Update Preedit String in UI'''
preedit_string_parts = self._editor.get_preedit_string_parts()
left_of_current_edit = u''.join(preedit_string_parts[0])
current_edit = preedit_string_parts[1]
right_of_current_edit = u''.join(preedit_string_parts[2])
if not self._editor._py_mode:
current_edit_new = u''
for char in current_edit:
if char in self._editor._prompt_characters:
current_edit_new += self._editor._prompt_characters[char]
else:
current_edit_new += char
current_edit = current_edit_new
preedit_string_complete = (
left_of_current_edit + current_edit + right_of_current_edit)
if not preedit_string_complete:
super(TabEngine, self).update_preedit_text(
IBus.Text.new_from_string(u''), 0, False)
return
color_left = rgb(0xf9, 0x0f, 0x0f) # bright red
color_right = rgb(0x1e, 0xdc, 0x1a) # light green
color_invalid = rgb(0xff, 0x00, 0xff) # magenta
attrs = IBus.AttrList()
attrs.append(
IBus.attr_foreground_new(
color_left,
0,
len(left_of_current_edit)))
attrs.append(
IBus.attr_foreground_new(
color_right,
len(left_of_current_edit) + len(current_edit),
len(preedit_string_complete)))
if self._editor._chars_invalid:
attrs.append(
IBus.attr_foreground_new(
color_invalid,
len(left_of_current_edit) + len(current_edit)
- len(self._editor._chars_invalid),
len(left_of_current_edit) + len(current_edit)
))
attrs.append(
IBus.attr_underline_new(
IBus.AttrUnderline.SINGLE,
0,
len(preedit_string_complete)))
text = IBus.Text.new_from_string(preedit_string_complete)
i = 0
while attrs.get(i) != None:
attr = attrs.get(i)
text.append_attribute(attr.get_attr_type(),
attr.get_value(),
attr.get_start_index(),
attr.get_end_index())
i += 1
super(TabEngine, self).update_preedit_text(
text, self._editor.get_caret(), True)
def _update_aux(self):
'''Update Aux String in UI'''
aux_string = self._editor.get_aux_strings()
if self._editor._candidates:
aux_string += u' (%d / %d)' % (
self._editor._lookup_table.get_cursor_pos() +1,
self._editor._lookup_table.get_number_of_candidates())
if aux_string:
attrs = IBus.AttrList()
attrs.append(IBus.attr_foreground_new(
rgb(0x95, 0x15, 0xb5), 0, len(aux_string)))
text = IBus.Text.new_from_string(aux_string)
i = 0
while attrs.get(i) != None:
attr = attrs.get(i)
text.append_attribute(attr.get_attr_type(),
attr.get_value(),
attr.get_start_index(),
attr.get_end_index())
i += 1
visible = True
if not aux_string or not self._always_show_lookup:
visible = False
super(TabEngine, self).update_auxiliary_text(text, visible)
else:
self.hide_auxiliary_text()
def _update_lookup_table(self):
'''Update Lookup Table in UI'''
if not self._editor._candidates:
# Also make sure to hide lookup table if there are
# no candidates to display. On f17, this makes no
# difference but gnome-shell in f18 will display
# an empty suggestion popup if the number of candidates
# is zero!
self.hide_lookup_table()
return
if self._editor.is_empty():
self.hide_lookup_table()
return
if not self._always_show_lookup:
self.hide_lookup_table()
return
self.update_lookup_table(self._editor.get_lookup_table(), True)
def _update_ui(self):
'''Update User Interface'''
self._update_lookup_table()
self._update_preedit()
self._update_aux()
def _check_phrase(self, tabkeys=u'', phrase=u''):
"""Check the given phrase and update save user db info"""
if not tabkeys or not phrase:
return
self.db.check_phrase(tabkeys=tabkeys, phrase=phrase)
if self._save_user_count <= 0:
self._save_user_start = time.time()
self._save_user_count += 1
def _sync_user_db(self):
"""Save user db to disk"""
if self._save_user_count >= 0:
now = time.time()
time_delta = now - self._save_user_start
if (self._save_user_count > self._save_user_count_max or
time_delta >= self._save_user_timeout):
self.db.sync_usrdb()
self._save_user_count = 0
self._save_user_start = now
return True
def commit_string(self, phrase, tabkeys=u''):
'''
Commit the string “phrase”, update the user database,
and clear the preëdit.
:param phrase: The text to commit
:type phrase: String
:param tabkeys: The keys typed to produce this text
:type tabkeys: String
'''
if DEBUG_LEVEL > 1:
sys.stderr.write("commit_string() phrase=%(p)s\n"
%{'p': phrase})
self._editor.clear_all_input_and_preedit()
self._update_ui()
super(TabEngine, self).commit_text(IBus.Text.new_from_string(phrase))
if phrase:
self._prev_char = phrase[-1]
else:
self._prev_char = None
self._check_phrase(tabkeys=tabkeys, phrase=phrase)
def commit_everything_unless_invalid(self):
'''
Commits the current input to the preëdit and then
commits the preëdit to the application unless there are
invalid input characters.
Returns “True” if something was committed, “False” if not.
'''
if DEBUG_LEVEL > 1:
sys.stderr.write("commit_everything_unless_invalid()\n")
if self._editor._chars_invalid:
return False
if not self._editor.is_empty():
self._editor.commit_to_preedit()
self.commit_string(self._editor.get_preedit_string_complete(),
tabkeys=self._editor.get_preedit_tabkeys_complete())
return True
def _convert_to_full_width(self, char):
'''Convert half width character to full width'''
# This function handles punctuation that does not comply to the
# Unicode conversion formula in unichar_half_to_full(char).
# For ".", "\"", "'"; there are even variations under specific
# cases. This function should be more abstracted by extracting
# that to another handling function later on.
special_punct_dict = {u"<": u"《", # 《 U+300A LEFT DOUBLE ANGLE BRACKET
u">": u"》", # 》 U+300B RIGHT DOUBLE ANGLE BRACKET
u"[": u"「", # 「 U+300C LEFT CORNER BRACKET
u"]": u"」", # 」U+300D RIGHT CORNER BRACKET
u"{": u"『", # 『 U+300E LEFT WHITE CORNER BRACKET
u"}": u"』", # 』U+300F RIGHT WHITE CORNER BRACKET
u"\\": u"、", # 、 U+3001 IDEOGRAPHIC COMMA
u"^": u"……", # … U+2026 HORIZONTAL ELLIPSIS
u"_": u"——", # — U+2014 EM DASH
u"$": u"￥" # ￥ U+FFE5 FULLWIDTH YEN SIGN
}
# special puncts w/o further conditions
if char in special_punct_dict.keys():
if char in [u"\\", u"^", u"_", u"$"]:
return special_punct_dict[char]
elif self._input_mode:
return special_punct_dict[char]
# special puncts w/ further conditions
if char == u".":
if (self._prev_char
and self._prev_char.isdigit()
and self._prev_key
and chr(self._prev_key.val) == self._prev_char):
return u"."
return u"。" # 。U+3002 IDEOGRAPHIC FULL STOP
elif char == u"\"":
self._double_quotation_state = not self._double_quotation_state
if self._double_quotation_state:
return u"“" # “ U+201C LEFT DOUBLE QUOTATION MARK
return u"”" # ” U+201D RIGHT DOUBLE QUOTATION MARK
elif char == u"'":
self._single_quotation_state = not self._single_quotation_state
if self._single_quotation_state:
return u"‘" # ‘ U+2018 LEFT SINGLE QUOTATION MARK
return u"’" # ’ U+2019 RIGHT SINGLE QUOTATION MARK
return unichar_half_to_full(char)
def _match_hotkey(self, key, keyval, state):
'''Check whether “key” matches a “hotkey” specified by “keyval” and
“state”.
Returns True if there is a match, False if not.
:param key: The key typed
:type key: KeyEvent object
:param keyval: The key value to match against
:type keyval: Integer
:param state: The state of the modifier keys to match against.
:type state: Integer
:rtype: Boolean
'''
if DEBUG_LEVEL > 0:
sys.stderr.write('_match_hotkey() typed key: %s\n' %key)
sys.stderr.write('trying to match: keyval=%s state=%s\n'
%(keyval, state))
# Match only when keys are released
state = state | IBus.ModifierType.RELEASE_MASK
if key.val == keyval and (key.state & state) == state:
# If it is a key release event, the previous key
# must have been the same key pressed down.
if (self._prev_key
and key.val == self._prev_key.val):
if DEBUG_LEVEL > 0:
sys.stderr.write('_match_hotkey(): *Match*!\n')
return True
sys.stderr.write('_match_hotkey(): No match!\n')
return False
def do_candidate_clicked(self, index, _button, _state):
if self._editor.commit_to_preedit_current_page(index):
# commits to preëdit
self.commit_string(
self._editor.get_preedit_string_complete(),
tabkeys=self._editor.get_preedit_tabkeys_complete())
return True
return False
def _return_false(self, keyval, keycode, state):
'''A replacement for “return False” in do_process_key_event()
do_process_key_event should return “True” if a key event has
been handled completely. It should return “False” if the key
event should be passed to the application.
But just doing “return False” doesn’t work well when trying to
do the unit tests. The MockEngine class in the unit tests
cannot get that return value. Therefore, it cannot do the
necessary updates to the self._mock_committed_text etc. which
prevents proper testing of the effects of such keys passed to
the application. Instead of “return False”, one can also use
self.forward_key_event(keyval, keycode, keystate) to pass the
key to the application. And this works fine with the unit
tests because a forward_key_event function is implemented in
MockEngine as well which then gets the key and can test its
effects.
Unfortunately, “forward_key_event()” does not work in Qt5
applications because the ibus module in Qt5 does not implement
“forward_key_event()”. Therefore, always using
“forward_key_event()” instead of “return False” in
“do_process_key_event()” would break ibus-typing-booster
completely for all Qt5 applictions.
To work around this problem and make unit testing possible
without breaking Qt5 applications, we use this helper function
which uses “forward_key_event()” when unit testing and “return
False” during normal usage.
'''
if self._unit_test:
self.forward_key_event(keyval, keycode, state)
return True
return False
def do_process_key_event(self, keyval, keycode, state):
'''Process Key Events
Key Events include Key Press and Key Release,
modifier means Key Pressed
'''
if DEBUG_LEVEL > 1:
sys.stderr.write("do_process_key_event()\n")
if (self._has_input_purpose
and self._input_purpose
in [IBus.InputPurpose.PASSWORD, IBus.InputPurpose.PIN]):
return self._return_false(keyval, keycode, state)
key = KeyEvent(keyval, keycode, state)
if DEBUG_LEVEL > 1:
sys.stderr.write(
"process_key_event() "
"KeyEvent object: %s" % key)
result = self._process_key_event(key)
self._prev_key = key
return result
def _process_key_event(self, key):
'''
Internal method to process key event
Returns True if the key event has been completely handled by
ibus-table and should not be passed through anymore.
Returns False if the key event has not been handled completely
and is passed through.
'''
# Match mode switch hotkey
if (self._editor.is_empty()
and (self._match_hotkey(
key, IBus.KEY_Shift_L,
IBus.ModifierType.SHIFT_MASK))):
self.set_input_mode(int(not self._input_mode))
return True
# Match fullwidth/halfwidth letter mode switch hotkey
if self.db._is_cjk:
if (key.val == IBus.KEY_space
and key.state & IBus.ModifierType.SHIFT_MASK
and not key.state & IBus.ModifierType.RELEASE_MASK):
# Ignore when Shift+Space was pressed, the key release
# event will toggle the fullwidth/halfwidth letter mode, we
# don’t want to insert an extra space on the key press
# event.
return True
if (self._match_hotkey(
key, IBus.KEY_space,
IBus.ModifierType.SHIFT_MASK)):
self.set_letter_width(
not self._full_width_letter[self._input_mode],
input_mode=self._input_mode)
return True
# Match full half punct mode switch hotkey
if (self._match_hotkey(
key, IBus.KEY_period,
IBus.ModifierType.CONTROL_MASK) and self.db._is_cjk):
self.set_punctuation_width(
not self._full_width_punct[self._input_mode],
input_mode=self._input_mode)
return True
if self._input_mode:
return self._table_mode_process_key_event(key)
return self._english_mode_process_key_event(key)
def cond_letter_translate(self, char):
'''Converts “char” to full width *if* full width letter mode is on for
the current input mode (direct input or table mode) *and* if
the current table is for CJK.
:param char: The character to maybe convert to full width
:type char: String
:rtype: String
'''
if self._full_width_letter[self._input_mode] and self.db._is_cjk:
return self._convert_to_full_width(char)
return char
def cond_punct_translate(self, char):
'''Converts “char” to full width *if* full width punctuation mode is
on for the current input mode (direct input or table mode)
*and* if the current table is for CJK.
:param char: The character to maybe convert to full width
:type char: String
:rtype: String
'''
if self._full_width_punct[self._input_mode] and self.db._is_cjk:
return self._convert_to_full_width(char)
return char
def _english_mode_process_key_event(self, key):
'''
Process a key event in “English” (“Direct input”) mode.
'''
# Ignore key release events
if key.state & IBus.ModifierType.RELEASE_MASK:
return self._return_false(key.val, key.code, key.state)
if key.val >= 128:
return self._return_false(key.val, key.code, key.state)
# we ignore all hotkeys here
if (key.state
& (IBus.ModifierType.CONTROL_MASK
|IBus.ModifierType.MOD1_MASK)):
return self._return_false(key.val, key.code, key.state)
keychar = IBus.keyval_to_unicode(key.val)
if type(keychar) != type(u''):
keychar = keychar.decode('UTF-8')
if ascii_ispunct(keychar):
trans_char = self.cond_punct_translate(keychar)
else:
trans_char = self.cond_letter_translate(keychar)
if trans_char == keychar:
return self._return_false(key.val, key.code, key.state)
self.commit_string(trans_char)
return True
def _table_mode_process_key_event(self, key):
'''
Process a key event in “Table” mode, i.e. when the
table is actually used and not switched off by using
direct input.
'''
if DEBUG_LEVEL > 0:
sys.stderr.write('_table_mode_process_key_event() ')
sys.stderr.write('repr(key)=%(key)s\n' %{'key': key})
# Change pinyin mode
# (change only if the editor is empty. When the editor
# is not empty, the right shift key should commit to preëdit
# and not change the pinyin mode).
if (self._ime_py
and self._editor.is_empty()
and self._match_hotkey(
key, IBus.KEY_Shift_R,
IBus.ModifierType.SHIFT_MASK)):
self.set_pinyin_mode(not self._editor._py_mode)
return True
# process commit to preedit
if (self._match_hotkey(
key, IBus.KEY_Shift_R,
IBus.ModifierType.SHIFT_MASK)
or self._match_hotkey(
key, IBus.KEY_Shift_L,
IBus.ModifierType.SHIFT_MASK)):
res = self._editor.commit_to_preedit()
self._update_ui()
return res
# Left ALT key to cycle candidates in the current page.
if (self._match_hotkey(
key, IBus.KEY_Alt_L,
IBus.ModifierType.MOD1_MASK)):
res = self._editor.cycle_next_cand()
self._update_ui()
return res
# Match single char mode switch hotkey
if (self._match_hotkey(
key, IBus.KEY_comma,
IBus.ModifierType.CONTROL_MASK) and self.db._is_cjk):
self.set_onechar_mode(not self._editor._onechar)
return True
# Match direct commit mode switch hotkey
if (self._match_hotkey(
key, IBus.KEY_slash,
IBus.ModifierType.CONTROL_MASK)
and self.db.user_can_define_phrase and self.db.rules):
self.set_autocommit_mode(not self._auto_commit)
return True
# Match Chinese mode shift
if (self._match_hotkey(
key, IBus.KEY_semicolon,
IBus.ModifierType.CONTROL_MASK) and self.db._is_chinese):
self.set_chinese_mode((self._editor._chinese_mode+1) % 5)
return True
# Ignore key release events
# (Must be below all self._match_hotkey() callse
# because these match on a release event).
if key.state & IBus.ModifierType.RELEASE_MASK:
return self._return_false(key.val, key.code, key.state)
keychar = IBus.keyval_to_unicode(key.val)
if type(keychar) != type(u''):
keychar = keychar.decode('UTF-8')
# Section to handle leading invalid input:
#
# This is the first character typed, if it is invalid
# input, handle it immediately here, if it is valid, continue.
if (self._editor.is_empty()
and not self._editor.get_preedit_string_complete()):
if ((keychar not in (
self._valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char)
or (self.db.startchars and keychar not in self.db.startchars))
and (not key.state &
(IBus.ModifierType.MOD1_MASK |
IBus.ModifierType.CONTROL_MASK))):
if DEBUG_LEVEL > 0:
sys.stderr.write(
'_table_mode_process_key_event() '
+ 'leading invalid input: '
+ 'repr(keychar)=%(keychar)s\n'
% {'keychar': keychar})
if ascii_ispunct(keychar):
trans_char = self.cond_punct_translate(keychar)
else:
trans_char = self.cond_letter_translate(keychar)
if trans_char == keychar:
self._prev_char = trans_char
return self._return_false(key.val, key.code, key.state)
self.commit_string(trans_char)
return True
if key.val == IBus.KEY_Escape:
self.reset()
self._update_ui()
return True
if key.val in (IBus.KEY_Return, IBus.KEY_KP_Enter):
if (self._editor.is_empty()
and not self._editor.get_preedit_string_complete()):
# When IBus.KEY_Return is typed,
# IBus.keyval_to_unicode(key.val) returns a non-empty
# string. But when IBus.KEY_KP_Enter is typed it
# returns an empty string. Therefore, when typing
# IBus.KEY_KP_Enter as leading input, the key is not
# handled by the section to handle leading invalid
# input but it ends up here. If it is leading input
# (i.e. the preëdit is empty) we should always pass
# IBus.KEY_KP_Enter to the application:
return self._return_false(key.val, key.code, key.state)
if self._auto_select:
self._editor.commit_to_preedit()
commit_string = self._editor.get_preedit_string_complete()
self.commit_string(commit_string)
return self._return_false(key.val, key.code, key.state)
commit_string = self._editor.get_preedit_tabkeys_complete()
self.commit_string(commit_string)
return True
if key.val in (IBus.KEY_Tab, IBus.KEY_KP_Tab) and self._auto_select:
# Used for example for the Russian transliteration method
# “translit”, which uses “auto select”. If for example
# a file with the name “шшш” exists and one types in
# a bash shell:
#
# “ls sh”
#
# the “sh” is converted to “ш” and one sees
#
# “ls ш”
#
# in the shell where the “ш” is still in preëdit
# because “shh” would be converted to “щ”, i.e. there
# is more than one candidate and the input method is still
# waiting whether one more “h” will be typed or not. But
# if the next character typed is a Tab, the preëdit is
# committed here and “False” is returned to pass the Tab
# character through to the bash to complete the file name
# to “шшш”.
self._editor.commit_to_preedit()
self.commit_string(self._editor.get_preedit_string_complete())
return self._return_false(key.val, key.code, key.state)
if key.val in (IBus.KEY_Down, IBus.KEY_KP_Down):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
res = self._editor.cursor_down()
self._update_ui()
return res
if key.val in (IBus.KEY_Up, IBus.KEY_KP_Up):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
res = self._editor.cursor_up()
self._update_ui()
return res
if (key.val in (IBus.KEY_Left, IBus.KEY_KP_Left)
and key.state & IBus.ModifierType.CONTROL_MASK):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.control_arrow_left()
self._update_ui()
return True
if (key.val in (IBus.KEY_Right, IBus.KEY_KP_Right)
and key.state & IBus.ModifierType.CONTROL_MASK):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.control_arrow_right()
self._update_ui()
return True
if key.val in (IBus.KEY_Left, IBus.KEY_KP_Left):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.arrow_left()
self._update_ui()
return True
if key.val in (IBus.KEY_Right, IBus.KEY_KP_Right):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.arrow_right()
self._update_ui()
return True
if (key.val == IBus.KEY_BackSpace
and key.state & IBus.ModifierType.CONTROL_MASK):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.remove_preedit_before_cursor()
self._update_ui()
return True
if key.val == IBus.KEY_BackSpace:
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.remove_char()
self._update_ui()
return True
if (key.val == IBus.KEY_Delete
and key.state & IBus.ModifierType.CONTROL_MASK):
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.remove_preedit_after_cursor()
self._update_ui()
return True
if key.val == IBus.KEY_Delete:
if not self._editor.get_preedit_string_complete():
return self._return_false(key.val, key.code, key.state)
self._editor.delete()
self._update_ui()
return True
if (key.val in self._editor.get_select_keys()
and self._editor._candidates
and key.state & IBus.ModifierType.CONTROL_MASK):
res = self._editor.select_key(key.val)
self._update_ui()
return res
if (key.val in self._editor.get_select_keys()
and self._editor._candidates
and key.state & IBus.ModifierType.MOD1_MASK):
res = self._editor.remove_candidate_from_user_database(key.val)
self._update_ui()
return res
# now we ignore all other hotkeys
if (key.state
& (IBus.ModifierType.CONTROL_MASK
|IBus.ModifierType.MOD1_MASK)):
return self._return_false(key.val, key.code, key.state)
if key.state & IBus.ModifierType.MOD1_MASK:
return self._return_false(key.val, key.code, key.state)
# Section to handle valid input characters:
#
# All keys which could possibly conflict with the valid input
# characters should be checked below this section. These are
# SELECT_KEYS, PAGE_UP_KEYS, PAGE_DOWN_KEYS, and COMMIT_KEYS.
#
# For example, consider a table has
#
# SELECT_KEYS = 1,2,3,4,5,6,7,8,9,0
#
# and
#
# VALID_INPUT_CHARS = 0123456789abcdef
#
# (Currently the cns11643 table has this, for example)
#
# Then the digit “1” could be interpreted either as an input
# character or as a select key but of course not both. If the
# meaning as a select key or page down key were preferred,
# this would make some input impossible which probably makes
# the whole input method useless. If the meaning as an input
# character is preferred, this makes selection using that key
# impossible. Making selection by key impossible is not nice
# either, but it is not a complete show stopper as there are
# still other possibilities to select, for example using the
# arrow-up/arrow-down keys or click with the mouse.
#
# Of course one should maybe consider fixing the conflict
# between the keys by using different SELECT_KEYS and/or
# PAGE_UP_KEYS/PAGE_DOWN_KEYS in that table ...
if (keychar
and (keychar in (self._valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char)
or (self._editor._py_mode
and keychar in (self._pinyin_valid_input_chars
+ self._single_wildcard_char
+ self._multi_wildcard_char)))):
if DEBUG_LEVEL > 0:
sys.stderr.write(
'_table_mode_process_key_event() valid input: '
+ 'repr(keychar)=%(keychar)s\n'
% {'keychar': keychar})
if self._editor._py_mode:
if ((len(self._editor._chars_valid)
== self._max_key_length_pinyin)
or (len(self._editor._chars_valid) > 1
and self._editor._chars_valid[-1] in '!@#$%')):
if self._auto_commit:
self.commit_everything_unless_invalid()
else:
self._editor.commit_to_preedit()
else:
if ((len(self._editor._chars_valid)
== self._max_key_length)
or (len(self._editor._chars_valid)
in self.db.possible_tabkeys_lengths)):
if self._auto_commit:
self.commit_everything_unless_invalid()
else:
self._editor.commit_to_preedit()
res = self._editor.add_input(keychar)
if not res:
if self._auto_select and self._editor._candidates_previous:
# Used for example for the Russian transliteration method
# “translit”, which uses “auto select”.
# The “translit” table contains:
#
# sh ш
# shh щ
#
# so typing “sh” matches “ш” and “щ”. The
# candidate with the shortest key sequence comes
# first in the lookup table, therefore “sh ш”
# is shown in the preëdit (The other candidate,
# “shh щ” comes second in the lookup table and
# could be selected using arrow-down. But
# “translit” hides the lookup table by default).
#
# Now, when after typing “sh” one types “s”,
# the key “shs” has no match, so add_input('s')
# returns “False” and we end up here. We pop the
# last character “s” which caused the match to
# fail, commit first of the previous candidates,
# i.e. “sh ш” and feed the “s” into the
# key event handler again.
self._editor.pop_input()
self.commit_everything_unless_invalid()
return self._table_mode_process_key_event(key)
self.commit_everything_unless_invalid()
self._update_ui()
return True
else:
if (self._auto_commit and self._editor.one_candidate()
and
(self._editor._chars_valid
== self._editor._candidates[0][0])):
self.commit_everything_unless_invalid()
self._update_ui()
return True
if key.val in self._commit_keys:
if self.commit_everything_unless_invalid():
if self._editor._auto_select:
self.commit_string(u' ')
return True
if key.val in self._page_down_keys and self._editor._candidates:
res = self._editor.page_down()
self._update_ui()
return res
if key.val in self._page_up_keys and self._editor._candidates:
res = self._editor.page_up()
self._update_ui()
return res
if (key.val in self._editor.get_select_keys()
and self._editor._candidates):
if self._editor.select_key(key.val): # commits to preëdit
self.commit_string(
self._editor.get_preedit_string_complete(),
tabkeys=self._editor.get_preedit_tabkeys_complete())
return True
# Section to handle trailing invalid input:
#
# If the key has still not been handled when this point is
# reached, it cannot be a valid input character. Neither can
# it be a select key nor a page-up/page-down key. Adding this
# key to the tabkeys and search for matching candidates in the
# table would thus be pointless.
#
# So we commit all pending input immediately and then commit
# this invalid input character as well, possibly converted to
# fullwidth or halfwidth.
if keychar:
if DEBUG_LEVEL > 0:
sys.stderr.write(
'_table_mode_process_key_event() trailing invalid input: '
+ 'repr(keychar)=%(keychar)s\n'
% {'keychar': keychar})
if not self._editor._candidates:
self.commit_string(self._editor.get_preedit_tabkeys_complete())
else:
self._editor.commit_to_preedit()
self.commit_string(self._editor.get_preedit_string_complete())
if ascii_ispunct(keychar):
self.commit_string(self.cond_punct_translate(keychar))
else:
self.commit_string(self.cond_letter_translate(keychar))
return True
# What kind of key was this??
#
# keychar = IBus.keyval_to_unicode(key.val)
#
# returned no result. So whatever this was, we cannot handle it,
# just pass it through to the application by returning “False”.
return self._return_false(key.val, key.code, key.state)
def do_focus_in(self):
if DEBUG_LEVEL > 1:
sys.stderr.write("do_focus_in()")
if self._on:
self.register_properties(self.properties)
self._init_or_update_property_menu(
self.input_mode_menu,
self._input_mode)
self._update_ui()
def do_focus_out(self):
if self._has_input_purpose:
self._input_purpose = 0
self._editor.clear_all_input_and_preedit()
def do_set_content_type(self, purpose, _hints):
if self._has_input_purpose:
self._input_purpose = purpose
def do_enable(self):
self._on = True
self.do_focus_in()
def do_disable(self):
self._on = False
def do_page_up(self):
if self._editor.page_up():
self._update_ui()
return True
return False
def do_page_down(self):
if self._editor.page_down():
self._update_ui()
return True
return False
def on_gsettings_value_changed(self, _settings, key):
'''
Called when a value in the settings has been changed.
'''
value = it_util.variant_to_value(self._gsettings.get_value(key))
sys.stderr.write('Settings changed for engine “%s”: key=%s value=%s\n'
%(self._engine_name, key, value))
if key == u'inputmode':
self.set_input_mode(value)
return
if key == u'autoselect':
self.set_autoselect_mode(value, update_gsettings=False)
return
if key == u'autocommit':
self.set_autocommit_mode(value, update_gsettings=False)
return
if key == u'chinesemode':
self.set_chinese_mode(value, update_gsettings=False)
return
if key == u'endeffullwidthletter':
self.set_letter_width(value, input_mode=0, update_gsettings=False)
return
if key == u'endeffullwidthpunct':
self.set_punctuation_width(
value, input_mode=0, update_gsettings=False)
return
if key == u'lookuptableorientation':
self.set_lookup_table_orientation(value, update_gsettings=False)
return
if key == u'lookuptablepagesize':
self.set_page_size(value, update_gsettings=False)
return
if key == u'onechar':
self.set_onechar_mode(value, update_gsettings=False)
return
if key == u'tabdeffullwidthletter':
self.set_letter_width(value, input_mode=1, update_gsettings=False)
return
if key == u'tabdeffullwidthpunct':
self.set_punctuation_width(
value, input_mode=1, update_gsettings=False)
return
if key == u'alwaysshowlookup':
self.set_always_show_lookup(value, update_gsettings=False)
return
if key == u'spacekeybehavior':
self.set_space_key_behavior_mode(value, update_gsettings=False)
return
if key == u'singlewildcardchar':
self.set_single_wildcard_char(value, update_gsettings=False)
return
if key == u'multiwildcardchar':
self.set_multi_wildcard_char(value, update_gsettings=False)
return
if key == u'autowildcard':
self.set_autowildcard_mode(value, update_gsettings=False)
return
sys.stderr.write('Unknown key\n')
return
if __name__ == "__main__":
import doctest
(FAILED, ATTEMPTED) = doctest.testmod()
if FAILED:
sys.exit(1)
else:
sys.exit(0)