Linux ns1.utparral.edu.mx 6.8.0-79-generic #79~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Fri Aug 15 16:54:53 UTC 2 x86_64
Apache/2.4.58 (Unix) OpenSSL/1.1.1w PHP/8.2.12 mod_perl/2.0.12 Perl/v5.34.1
: 10.10.1.9 | : 10.10.1.254
Cant Read [ /etc/named.conf ]
daemon
Terminal
AUTO ROOT
Adminer
Backdoor Destroyer
Linux Exploit
Lock Shell
Lock File
Create User
README
+ Create Folder
+ Create File
/
usr /
lib /
python3 /
dist-packages /
orca /
__pycache__ /
[ HOME SHELL ]
Name
Size
Permission
Action
acss.cpython-310.pyc
2.51
KB
-rw-r--r--
bookmarks.cpython-310.pyc
6.35
KB
-rw-r--r--
braille.cpython-310.pyc
48.14
KB
-rw-r--r--
braille_generator.cpython-310.pyc
13.65
KB
-rw-r--r--
braille_rolenames.cpython-310.pyc
3.57
KB
-rw-r--r--
brlmon.cpython-310.pyc
5.93
KB
-rw-r--r--
brltablenames.cpython-310.pyc
1.84
KB
-rw-r--r--
caret_navigation.cpython-310.pyc
8.47
KB
-rw-r--r--
chat.cpython-310.pyc
22.07
KB
-rw-r--r--
chnames.cpython-310.pyc
7.16
KB
-rw-r--r--
cmdnames.cpython-310.pyc
12.76
KB
-rw-r--r--
colornames.cpython-310.pyc
6.12
KB
-rw-r--r--
common_keyboardmap.cpython-310.pyc
2.91
KB
-rw-r--r--
debug.cpython-310.pyc
11.85
KB
-rw-r--r--
desktop_keyboardmap.cpython-310.pyc
2.36
KB
-rw-r--r--
event_manager.cpython-310.pyc
25.8
KB
-rw-r--r--
eventsynthesizer.cpython-310.pyc
14.29
KB
-rw-r--r--
find.cpython-310.pyc
6.28
KB
-rw-r--r--
flat_review.cpython-310.pyc
30.22
KB
-rw-r--r--
formatting.cpython-310.pyc
30.93
KB
-rw-r--r--
generator.cpython-310.pyc
43.17
KB
-rw-r--r--
guilabels.cpython-310.pyc
7.48
KB
-rw-r--r--
__init__.cpython-310.pyc
263
B
-rw-r--r--
input_event.cpython-310.pyc
26.72
KB
-rw-r--r--
keybindings.cpython-310.pyc
11.97
KB
-rw-r--r--
keynames.cpython-310.pyc
3.15
KB
-rw-r--r--
label_inference.cpython-310.pyc
16.36
KB
-rw-r--r--
laptop_keyboardmap.cpython-310.pyc
2.34
KB
-rw-r--r--
liveregions.cpython-310.pyc
14.59
KB
-rw-r--r--
logger.cpython-310.pyc
1.78
KB
-rw-r--r--
mathsymbols.cpython-310.pyc
41.91
KB
-rw-r--r--
messages.cpython-310.pyc
28.13
KB
-rw-r--r--
mouse_review.cpython-310.pyc
16.69
KB
-rw-r--r--
notification_messages.cpython-310.pyc
4.42
KB
-rw-r--r--
object_properties.cpython-310.pyc
6.09
KB
-rw-r--r--
orca.cpython-310.pyc
19.22
KB
-rw-r--r--
orca_gtkbuilder.cpython-310.pyc
3.54
KB
-rw-r--r--
orca_gui_commandlist.cpython-310.pyc
3.63
KB
-rw-r--r--
orca_gui_find.cpython-310.pyc
6.8
KB
-rw-r--r--
orca_gui_navlist.cpython-310.pyc
5.41
KB
-rw-r--r--
orca_gui_prefs.cpython-310.pyc
90.33
KB
-rw-r--r--
orca_gui_profile.cpython-310.pyc
3.23
KB
-rw-r--r--
orca_i18n.cpython-310.pyc
1.87
KB
-rw-r--r--
orca_platform.cpython-310.pyc
544
B
-rw-r--r--
orca_state.cpython-310.pyc
724
B
-rw-r--r--
phonnames.cpython-310.pyc
1.27
KB
-rw-r--r--
pronunciation_dict.cpython-310.pyc
1.78
KB
-rw-r--r--
punctuation_settings.cpython-310.pyc
5.77
KB
-rw-r--r--
script.cpython-310.pyc
15.64
KB
-rw-r--r--
script_manager.cpython-310.pyc
10.18
KB
-rw-r--r--
script_utilities.cpython-310.pyc
156.05
KB
-rw-r--r--
settings.cpython-310.pyc
6.89
KB
-rw-r--r--
settings_manager.cpython-310.pyc
19.1
KB
-rw-r--r--
sound.cpython-310.pyc
4.27
KB
-rw-r--r--
sound_generator.cpython-310.pyc
8.77
KB
-rw-r--r--
speech.cpython-310.pyc
7.47
KB
-rw-r--r--
speechdispatcherfactory.cpython-310.pyc
17.29
KB
-rw-r--r--
speech_generator.cpython-310.pyc
77.71
KB
-rw-r--r--
speechserver.cpython-310.pyc
8
KB
-rw-r--r--
spellcheck.cpython-310.pyc
8.53
KB
-rw-r--r--
structural_navigation.cpython-310.pyc
87.74
KB
-rw-r--r--
text_attribute_names.cpython-310.pyc
4.3
KB
-rw-r--r--
tutorialgenerator.cpython-310.pyc
17.24
KB
-rw-r--r--
Delete
Unzip
Zip
${this.title}
Close
Code Editor : script_utilities.cpython-310.pyc
o S�b& � @ s> d Z dZdZdZdZdZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZ dd lmZ d d lmZ d d lmZ d d lmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlmZ d dlm Z d dlm Z d dlm Z d dlm Z d dlm Z e �!� Z"G dd� d�Z#dS ) z�Commonly-required utility methods needed by -- and potentially customized by -- application and toolkit scripts. They have been pulled out from the scripts because certain scripts had gotten way too large as a result of including these methods.z$Id$z $Revision$z$Date$z#Copyright (c) 2010 Joanmarie Diggs.�LGPL� N)�Gdk��Gtk� )�chnames)� colornames)�debug)�keynames)� keybindings)� input_event)� mathsymbols)�messages)�orca)� orca_state)�object_properties)�pronunciation_dict)�settings)�settings_manager)�text_attribute_namesc @ s� e Zd Zej�d�Ze�� ZdZ dZ g d�Z g d�Z e jZe �de�Ze �dd�e � e�Ze �dd�e � e�Ze �d e�Zd Zd Zd Zd ZdZdZdd� Z dd� Z e dd� �Z �dYdd�Z dd� Z!e dd � �Z"�dZd d �Z#d d!� Z$d"d#� Z%d$d%� Z&d&d'� Z'd(d)� Z(d*d+� Z)d,d-� Z*d.d/� Z+�dZd0d1�Z,d2d3� Z-d4d5� Z.�d[d7d8�Z/d9d:� Z0e d;d<� �Z1d=d>� Z2d?d@� Z3dAdB� Z4dCdD� Z5�d[dEdF�Z6�d[dGdH�Z7dIdJ� Z8dKdL� Z9dMdN� Z:dOdP� Z;dQdR� Z<dSdT� Z=dUdV� Z>dWdX� Z?dYdZ� Z@d[d\� ZAd]d^� ZBd_d`� ZCdadb� ZDdcdd� ZEdedf� ZFdgdh� ZGdidj� ZHdkdl� ZIdmdn� ZJdodp� ZKdqdr� ZLdsdt� ZMdudv� ZNdwdx� ZOdydz� ZPd{d|� ZQd}d~� ZRdd�� ZSd�d�� ZTd�d�� ZUd�d�� ZVd�d�� ZWd�d�� ZXd�d�� ZYd�d�� ZZd�d�� Z[d�d�� Z\d�d�� Z]d�d�� Z^d�d�� Z_d�d�� Z`d�d�� Zad�d�� Zbd�d�� Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� Zhd�d�� Zid�d�� Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsd�d Ztd�dĄ Zud�dƄ Zvd�dȄ Zwd�dʄ Zxd�d̄ Zyd�d΄ Zzd�dЄ Z{d�d҄ Z|d�dԄ Z}d�dք Z~d�d Z�d[d�dڄZ�d�d܄ Z�d�dބ Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d��d � Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d �d � Z��d �d � Z��d �d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d[�d�d�Z��d�d � Z��d �d � Z��d �d � Z��d!�d"� Z��d#�d$� Z��d%�d&� Z��d'�d(� Z��d)�d*� Z��d[�d+�d,�Z��d[�d-�d.�Z��d/�d0� Z��d1�d2� Z��d3�d4� Z��d5�d6� Z��d7�d8� Z��d9�d:� Z��d;�d<� Z��d=�d>� Z��d?�d@� Z��dA�dB� Z��dC�dD� Z��dE�dF� Z��dG�dH� Z��dI�dJ� Z��dK�dL� Z��dM�dN� Z��dY�dO�dP�Z��dQ�dR� Z��dS�dT� Z��dU�dV� Z��dW�dX� Z��dY�dZ� Z�e �d[�d\� �Z��d]�d^� Zd_�d`� ZÐda�db� ZĐdc�dd� ZŐde�df� ZƐd\�dg�dh�Zǐdi�dj� Z�e �dk�dl� �Zɐdm�dn� Zʐdo�dp� Z�e �dq�dr� �Z�e �ds�dt� �Z͐du�dv� Zΐdw�dx� Zϐd[�dy�dz�ZАd{�d|� Zѐd}�d~� ZҐd�d�� ZӐd��d�� ZԐd��d�� ZՐd[�d��d��Z�e �d��d�� �Zאd��d�� Zؐd��d�� Zِd��d�� Zڐd��d�� Zېd��d�� Zܐd��d�� Zݐd��d�� Zސd��d�� Zߐd��d�� Z�d[�d��d��Z�e �d]�d��d���Z�e �d��d�� �Z�e �d��d�� �Z�e �d��d�� �Z�d��d�� Z�d��d�� Z�d��d�� Z�d��d�� Z�d^�d��d��Z�d_�d��d��Z�d��d�� Z�d��d�� Z�d��d�� Z�d��d�� Z�e �d��d�� �Z�d��d�� Z�d��d�� Z�d��d�� Z�e �ddÄ �Z�dĐdń Z��dƐdDŽ Z��dȐdɄ Z��dʐd˄ Z��d`�d͐d΄Z��dϐdЄ Z��dѐd҄ Z��dӐdԄ Z��dՐdք Z��d[�dאdZ��dِdڄ Z��dېd܄ �Z �dݐdބ �Z�dߐd� �Z�d�d� �Z�d�d� �Z�d[�d�d��Z�d�d� �Z�d�d� �Z�d�d� �Z�d�d� �Z �d`�d�d��Z �da�d�d��Z �d�d� �Z �d��d�� �Z �d��d�� �Z�d`�d��d���Z�d��d�� �Z�dZ�d��d���Z�d��d � �Z�d�d� �Z�d�d� �Ze �d�d� ��Ze �d�d� ��Z�d �d � �Z�d �d � �Z�d �d� �Z�d�d� �Ze �d�d� ��Ze �db�d�d���Z �d�d� �Z �d�d� �Z �d�d� �Z �d �d � �Z �d[�d �d ��Z!�d �d!� �Z"�d"�d#� �Z#e �d$�d%� ��Z$e �d&�d'� ��Z%e �d(�d)� ��Z&e �d*�d+� ��Z'�d,�d-� �Z(e �d.�d/� ��Z)�d0�d1� �Z*e �d2�d3� ��Z+�dc�d4�d5��Z,�dd�d6�d7��Z-�de�d8�d9��Z.�de�d:�d;��Z/�d<�d=� �Z0�d>�d?� �Z1�d@�dA� �Z2�dB�dC� �Z3�dD�dE� �Z4�dF�dG� �Z5�dH�dI� �Z6�dJ�dK� �Z7�dL�dM� �Z8�dN�dO� �Z9�dP�dQ� �Z:�d[�dR�dS��Z;�d[�dT�dU��Z<�dV�dW� �Z=�dX�dY� �Z>�dZ�d[� �Z?�d\�d]� �Z@�d^�d_� �ZA�d`�da� �ZB�db�dc� �ZC�dd�de� �ZD�df�dg� �ZE�dh�di� �ZF�dj�dk� �ZG�dl�dm� �ZH�dn�do� �ZI�dp�dq� �ZJ�dr�ds� �ZK�dt�du� �ZL�dv�dw� �ZM�dx�dy� �ZN�dz�d{� �ZO�d|�d}� �ZP�d~�d� �ZQ�d��d�� �ZR�d��d�� �ZS�d��d�� �ZT�d��d�� �ZU�d��d�� �ZV�d��d�� �ZW�dZ�d��d���ZX�d��d�� �ZY�dZ�d��d���ZZ�d��d�� �Z[�d��d�� �Z\�df�d��d���Z]�d��d�� �Z^�d��d�� �Z_�d��d�� �Z`�d[�d��d���Za�d[�d��d���Zb�d��d�� �Zc�d��d�� �Zd�d[�d��d���Ze�d[�d��d���Zf�d^�d��d���Zg�d��d�� �Zh�d��d�� �Zi�d��d�� �Zj�dY�d��d���Zk�dY�d��d���Zl�d��d�� �Zm�d��d�� �Zn�d��d�� �Zo�d��d�� �Zp�d��d�� �Zq�d��d �Zr�dÐdĄ �Zs�dŐdƄ �Zt�dǐdȄ �Zu�dɐdʄ �Zv�dːd̄ �Zw�dY�d͐d΄�Zx�dϐdЄ �Zy�dѐd҄ �Zze �dӐdԄ ��Z{�dՐdք �Z|�dאd �Z}�dِdڄ �Z~�dېd܄ �Z�dݐdބ �Z��dg�d�d��Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d�� �Z��d��d�� �Z��d��d�� �Z��d��d�� �Z��d��d�� �Z��d��d�� �Z��d �d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d � �Z��d �d � �Z��d �d � �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d �d � �Z��dh�d �d ��Z��d!�d"� �Z��d#�d$� �Z��d%�d&� �Z��d'�d(� �Z��d)�d*� �Z��d+�d,� �Z��d-�d.� �Z��d/�d0� �Z��d1�d2� �Z��d3�d4� �Z��d5�d6� �Z��d7�d8� �Z��d[�d9�d:��Z��d;�d<� �Z��d=�d>� �Z��d?�d@� �Z��dA�dB� �Z��dC�dD� �Z��dE�dF� �Z��dG�dH� �Z��dI�dJ� �Z��dK�dL� �Z��dZ�dM�dN��Z��dO�dP� �Z��dQ�dR� �Z��dZ�dS�dT��Z��dU�dV� �Z��dW�dX� �Z�d6S (i � Utilitiesr u u ) u ⁰� ¹� ²� ³u ⁴u ⁵u ⁶u ⁷u ⁸u ⁹) u ₀u ₁u ₂u ₃u ₄u ₅u ₆u ₇u ₈u ₉z(\W+)z[%s]+� z[^\w\s]�displayedDescription�displayedLabel� displayedText� keyBinding� nestingLevel� nodeLevelc C s || _ d| _i | _dS )z�Creates an instance of the Utilities class. Arguments: - script: the script with which this instance is associated. N)�_script�_clipboardHandlerId�_selectedMenuBarMenu)�self�script� r& �7/usr/lib/python3/dist-packages/orca/script_utilities.py�__init___ s zUtilities.__init__c C s� z|� � }W n d| }t�tj|d� Y dS |�tj�s-d| }t�tj|d� dS |�tj�rAd| }t�tj|d� dS |�tj�sUd| }t�tj|d� dS dS )N�$ERROR: Exception getting state of %sTFzINFO: %s lacks state activez INFO: %s has state iconifiedz INFO: %s lacks state showing) �getStater �println� LEVEL_INFO�contains�pyatspi� STATE_ACTIVE�STATE_ICONIFIED� STATE_SHOWING�r$ �obj�state�msgr& r& r' �"_isActiveAndShowingAndNotIconifiedp s& z,Utilities._isActiveAndShowingAndNotIconifiedc C sf | sdS z| � � }W n d| }t�tj|d� Y dS z t�d| �}W n Y dS |�dd�S )Nr z:ERROR: Exception getting process id of %s. May be defunct.Tzcat /proc/%s/cmdline� � )�get_process_idr r+ r, � subprocess� getoutput�replace)�app�pidr5 �cmdliner& r& r' �_getAppCommandLine� s z Utilities._getAppCommandLineFc C s� |sdS z|� � }W n d }Y d||| �|�f }t�tj|d� |r)|�� | �|�s<d| }t�tj|d� dS d| }t�tj|d� dS )NFz INFO: Looking at %s from %s %sTz3INFO: %s is not active and showing, or is iconifiedz INFO: %s can be active window)�getApplicationr@ r r+ r, � clearCacher6 )r$ �windowrB r= r5 r& r& r' �canBeActiveWindow� s" zUtilities.canBeActiveWindowc s g }|p� � � }|D ]!}z|�� fdd�|D �� W q d| }t�tj|d� Y q |sAdttt|�� }t�tj|d� dS t|�dkrYd|d }t�tj|d� |d S t |t � � j �d �}d ttt|�� }t�tj|d� d |d }t�tj|d� |d S ) z:Tries to locate the active window; may or may not succeed.c � g | ] }� � |�r|�qS r& �rD ��.0�child�r$ r& r' � <listcomp>� � z*Utilities.activeWindow.<locals>.<listcomp>z)ERROR: Exception examining children of %sTz+ERROR: Unable to find active window from %sNr zINFO: Active window is %sr ��keyz1WARNING: These windows all claim to be active: %sz%INFO: Active window is (hopefully) %s) �knownApplications�extendr r+ r, �list�map�str�len�sorted� functools� cmp_to_key�sizeComparison)r$ �apps� candidatesr= r5 r& rJ r' � activeWindow� s, zUtilities.activeWindowc C s� | sdS t |g j�s |g}t |g j�s|g}d}| j} | rI| | jkrIz| �� }W n Y |S ||v r8| } |S ||v r? |S | j} | rI| | jks"|S )ac Returns the object of the specified roles which contains the given object, or None if the given object is not contained within an object the specified roles. Arguments: - obj: the Accessible object - ancestorRoles: the list of roles to look for - stopRoles: the list of roles to stop the search at N)� isinstance� __class__�parent�getRole)r3 � ancestorRoles� stopRoles�ancestor�roler& r& r' �ancestorWithRole� s0 ���� zUtilities.ancestorWithRoleTc C s. zt dd� |�� D ��}W |S i }Y |S )Nc S � g | ]}|� d d��qS ��:r ��split�rH �attrr& r& r' rK � z.Utilities.objectAttributes.<locals>.<listcomp>)�dict� getAttributes)r$ r3 �useCache�rvr& r& r' �objectAttributes� s �zUtilities.objectAttributesc sD � � |�}|�d�}|rt|�S � fdd�}t�||�p |}|�� S )a Returns the index of the cell which should be used with the table interface. This is necessary because in some apps we cannot count on getIndexInParent() returning the index we need. Arguments: -obj: the table cell whose index we need. ztable-cell-indexc s | o | � � � �� v S �N)r_ � getCellRoles��xrJ r& r' �<lambda> � z%Utilities.cellIndex.<locals>.<lambda>)rq �get�intr. � findAncestor�getIndexInParent)r$ r3 �attrs�index�isCellr& rJ r' � cellIndex s zUtilities.cellIndexc C sb z|j �� }W n g Y S |�� �tj�sg S g }|�� }z.|D ])}|�� tjkrKt |� � �D ]}|� |�}|rE|� � dkrE|� |� q1| W S q"W n Y | �|�}|�|�} |�|�} | �|�} d} t | d |j�D ]>} |�| | �}|s{qp|�� }|D ]'}|�� tjkr�|� d�}| �||�r�|� |� n | �|�}|| kr�d} nq�| r� |S qp|S )z�Gets all of the children that have RELATION_NODE_CHILD_OF pointing to this expanded table cell. Arguments: -obj: the Accessible Object Returns: a list of all the child nodes ���Fr r T)r^ � queryTabler* r- r. �STATE_EXPANDED�getRelationSet�getRelationType�RELATION_NODE_PARENT_OF�range� getNTargets� getTargetr{ �appendr � getRowAtIndex�getColumnAtIndexr �nRows�getAccessibleAt�RELATION_NODE_CHILD_OF� isSameObject)r$ r3 �table�nodes� relations�relation�target�noder} �row�colr �done�i�cell�nodeOf� currentLevelr& r& r' � childNodes sd � � �� � � �zUtilities.childNodesc C s\ d||f }t �t j|d� |r|sdS ||kr|S |g}z |j}|r7|j|kr7|�|� |j}|r7|j|ks(|�� W n t �t j� Y |g}z |j}|rd|j|krd|�|� |j}|rd|j|ksU|�� W n t �t j� Y d}tt |�t |��}d} | |k r�| � || || �r�|| }| d7 } nn| |k s�d|||f }t �t j|d� |S )z�Finds the common ancestor between Accessible a and Accessible b. Arguments: - a: Accessible - b: Accessible z.INFO: Looking for common ancestor of %s and %sTNr r z(INFO: Common ancestor of %s and %s is %s) r r+ r, r^ r� �reverse�printException� LEVEL_FINEST�minrT r� ) r$ �a�br5 �aParentsr^ �bParents�commonAncestor� maxSearchr� r& r& r' r� ] sL � � �zUtilities.commonAncestorc C s� t jt jt jg}|�� �t j�s|�� |v rdS d}t|j d dd�D ].}|| �� t j kr=|| �� �t j �r=|| }n|| �� |vrL| � || �}|rQ |S q#|S )z�Returns the default button in the dialog which contains obj. Arguments: - obj: the top-level object (e.g. window, frame, dialog) for which the status bar is sought. Nr r� ) r. � ROLE_TREE�ROLE_TREE_TABLE� ROLE_TABLEr* r- �STATE_MANAGES_DESCENDANTSr_ r� � childCount�ROLE_PUSH_BUTTON�STATE_IS_DEFAULT� defaultButton)r$ r3 � skipRolesr� r� r& r& r' r� � s( � � �zUtilities.defaultButtonc C s� z | j j| j | W S | j| j jvr i | j j| j< d}Y | �|�}|D ] }| �|| �|��}q&|| j j| j |< | j j| j | S )aX If there is an object labelling the given object, return the text being displayed for the object labelling this object. Otherwise, return None. Argument: - obj: the object in question Returns the string of the object labelling this object, or None if there is nothing of interest here. N)r! �generatorCache�DISPLAYED_LABEL�labelsForObject� appendStringr )r$ r3 � labelString�labels�labelr& r& r' r � s �zUtilities.displayedLabelc C � dS �NFr& �r$ r3 r& r& r' �preferDescriptionOverName� � z#Utilities.preferDescriptionOverNamec C s` z|� � }W n ttfy d| }t�tj|d� g Y S w dd� }t||�}dd� |D �S )z(Return a list of objects describing obj.�+ERROR: Exception getting relationset for %sTc S � | � � tjkS rr )r� r. �RELATION_DESCRIBED_BYrt r& r& r' rv � � z1Utilities.descriptionsForObject.<locals>.<lambda>c S �( g | ]}t |�� �D ]}|�|��q qS r& �r� r� r� �rH �rr� r& r& r' rK � � ( z3Utilities.descriptionsForObject.<locals>.<listcomp>)r� � LookupError� RuntimeErrorr r+ r, �filter)r$ r3 r� r5 � describedByr� r& r& r' �descriptionsForObject� s � z Utilities.descriptionsForObjectc C s | � |�}tt| j|��S rr )�detailsForObjectrQ rR r )r$ r3 �detailsr& r& r' �detailsContentForObject� s z!Utilities.detailsContentForObjectc C s� z|� � }|�� }|�� }W n ttfy' d| }t�tj|d� g Y S w dd� }t||�}dd� |D �} | sL|t j krL|� t j �rLdd� |D �} |sP| S g } | D ] } | � | �| | j�� qT| S )z4Return a list of objects containing details for obj.z<ERROR: Exception getting relationset, role, and state for %sTc S r� rr )r� r. �RELATION_DETAILSrt r& r& r' rv � r� z,Utilities.detailsForObject.<locals>.<lambda>c S r� r& r� r� r& r& r' rK � r� z.Utilities.detailsForObject.<locals>.<listcomp>c S � g | ]}|�qS r& r& rG r& r& r' rK � � )r� r_ r* r� r� r r+ r, r� r. �ROLE_TOGGLE_BUTTONr- r� rP �findAllDescendants�queryNonEmptyText) r$ r3 �textOnlyr� rc r4 r5 � hasDetailsr� r� � textObjects�detailr& r& r' r� � s( � zUtilities.detailsForObjectc C sv z | j j| j | W S | j| j jvr i | j j| j< Y d�t| j| �|���}|| j j| j |< | j j| j | S )z?Returns the text being displayed for the object describing obj.r8 )r! r� �DISPLAYED_DESCRIPTION�joinrR r r� �r$ r3 �stringr& r& r' r � s �z Utilities.displayedDescriptionc C sf z | j j| j | W S d}Y z |�� }|j}W n d| }t�tj|d� d}d}Y |tj tj fv r;|r;|S dt� |�v rT|� � }|� d|j�}| j|v rTd}|so|tjtjfvroz|j}W n ttfyn Y nw |s�|tj tjfv r�| j|dd�}|s�| j|d dd �}d �t| j|��}| j| j jvr�i | j j| j< || j j| j |< | j j| j | S ) z�Returns the text being displayed for an object. Arguments: - obj: the object Returns the text being displayed for an object or None if there isn't any text being shown. Nz,ERROR: Exception getting role and name of %sTr �Textr r )� minimumWordsF)� onlyShowingr� r8 )r! r� �DISPLAYED_TEXTr_ �namer r+ r, r. r� � ROLE_LABEL�listInterfaces� queryText�getText�characterCount�EMBEDDED_OBJECT_CHARACTER�ROLE_COMBO_BOX�ROLE_SPIN_BUTTONr� r� �ROLE_LIST_ITEM�unrelatedLabelsr� rR r )r$ r3 r rc r� r5 �textr� r& r& r' r sD �zUtilities.displayedTextNc C sh |s| � � \}}tjtjtjtjtjtjg}tjtj g}| � |||�}|s2t j r2t j � � |v r2t j S |S )zyReturns the document frame which is displaying the content. Note that this is intended primarily for web content.)�getCaretContextr. �ROLE_DOCUMENT_EMAIL�ROLE_DOCUMENT_FRAME�ROLE_DOCUMENT_PRESENTATION�ROLE_DOCUMENT_SPREADSHEET�ROLE_DOCUMENT_TEXT�ROLE_DOCUMENT_WEB� ROLE_FRAME�ROLE_SCROLL_PANErd r � locusOfFocusr_ )r$ r3 �offset�docRolesra �documentr& r& r' � documentFrameC s � zUtilities.documentFramec C r� )z5Returns the URI of the document frame that is active.Nr& rJ r& r& r' �documentFrameURIW s zUtilities.documentFrameURIc C sP | sdS | � � �tj�r| S | D ]}zt�|�}|r |W S W q Y qdS )a* Returns the accessible that has focus under or including the given root. TODO: This will currently traverse all children, whether they are visible or not and/or whether they are children of parents that manage their descendants. At some point, this method should be optimized to take such things into account. Arguments: - root: the root object where to start searching Returns the object with the FOCUSED state or None if no object with the FOCUSED state can be found. N)r* r- r. � STATE_FOCUSEDr � focusedObject)�rootrI � candidater& r& r' r� \ s �zUtilities.focusedObjectc C s� ddg}|pt j}|sd}t�tj|d� |S |�� tjkr"||d< |j}|rO|j|krO|�� tjkr7||d< |�� tj tj fv rE||d< |j}|rO|j|ks,|S )z;Returns the frame and (possibly) the dialog containing obj.Nz3ERROR: frameAndDialog() called without valid objectTr r ) r r� r r+ r, r_ r. r� r^ � ROLE_DIALOG�ROLE_FILE_CHOOSER)r$ r3 �resultsr5 r^ r& r& r' �frameAndDialog} s& ��zUtilities.frameAndDialogc C s |j tjkrdS dS �NTF)�sourcer r� �r$ �eventr& r& r' � presentEventFromNonShowingObject� s z*Utilities.presentEventFromNonShowingObjectc C s( |r|� � tjkr| �|tj�sdS dS )ay Whether or not we should perform a grabFocus before routing the cursor via the braille cursor routing keys. Arguments: - obj: the accessible object where the cursor should be routed - offset: the offset to which it should be routed Returns True if we should do an explicit grabFocus on obj prior to routing the cursor. TF)r_ r. r� r� r r� �r$ r3 r� r& r& r' �grabFocusBeforeRouting� s �z Utilities.grabFocusBeforeRoutingc C sz |}|D ]6}|du r dS t |t�s|g}zt |d t�r"|�� }n|�� }W n d}Y ||vr5 dS | �|�}qdS )a� Called to determine if the given object and it's hierarchy of parent objects, each have the desired roles. Please note: You should strongly consider an alternative means for determining that a given object is the desired item. Failing that, you should include only enough of the hierarchy to make the determination. If the developer of the application you are providing access to does so much as add an Adjustment to reposition a widget, this method can fail. You have been warned. Arguments: - obj: the accessible object to check. - rolesList: the list of desired roles for the components and the hierarchy of its parents. Returns True if all roles match. NFr T)r\ rQ rS � getRoleNamer_ � validParent)r$ r3 � rolesList�currentrc � current_roler& r& r' �hasMatchingHierarchy� s" � z Utilities.hasMatchingHierarchyc C sN |st j}z|�� }W n Y dS |tjkrdS dd� }t�||�}|d uS )NFc S � | o| � � tjkS rr )r_ r. � ROLE_TOOL_BARrt r& r& r' rv � � z+Utilities.inFindContainer.<locals>.<lambda>)r r� r_ r. � ROLE_ENTRYrz )r$ r3 rc � isToolbar�toolbarr& r& r' �inFindContainer� s zUtilities.inFindContainerc C r� �Nr r& �r$ r� r& r& r' �getFindResultsCount� r� z Utilities.getFindResultsCountc C r� r� r& r� r& r& r' �isAnchor� r� zUtilities.isAnchorc C r� r� r& r� r& r& r' �isCode� r� zUtilities.isCodec C r� r� r& r� r& r& r' �isCodeDescendant� r� zUtilities.isCodeDescendantc C sX z|� � }W n d| }t�tj|d� Y dS |tjkr dS | �|�}|�d�dkS )N�#ERROR: Exception getting role of %sTFz is-desktop�true)r_ r r+ r, r. r� rq rx )r$ r3 rc r5 r| r& r& r' � isDesktop� s zUtilities.isDesktopc C r� r� r& r� r& r& r' � isComboBoxWithToggleDescendant r� z(Utilities.isComboBoxWithToggleDescendantc C r� r� r& r� r& r& r' � isToggleDescendantOfComboBox r� z&Utilities.isToggleDescendantOfComboBoxc C r� r� r& r� r& r& r' � isTypeahead r� zUtilities.isTypeaheadc s |� krdS t �|� fdd��S )NTc s | o| � kS rr r& rt �rb r& r' rv � z,Utilities.isOrDescendsFrom.<locals>.<lambda>�r. rz �r$ r3 rb r& r# r' �isOrDescendsFrom s zUtilities.isOrDescendsFromc C r� )z�Returns True if the window is a functioning as a dialog. This method should be subclassed by application scripts as needed. Fr& r� r& r& r' �isFunctionalDialog s z Utilities.isFunctionalDialogc C r� r� r& r� r& r& r' � isComment r� zUtilities.isCommentc C r� r� r& r� r& r& r' �isContentDeletion r� zUtilities.isContentDeletionc C r� r� r& r� r& r& r' �isContentError r� zUtilities.isContentErrorc C r� r� r& r� r& r& r' �isContentInsertion" r� z Utilities.isContentInsertionc C r� r� r& r� r& r& r' �isContentMarked% r� zUtilities.isContentMarkedc C r� r� r& r� r& r& r' �isContentSuggestion( r� z Utilities.isContentSuggestionc C r� r� r& r� r& r& r' �isInlineSuggestion+ r� z Utilities.isInlineSuggestionc C r� r� r& r� r& r& r' �$isFirstItemInInlineContentSuggestion. r� z.Utilities.isFirstItemInInlineContentSuggestionc C r� r� r& r� r& r& r' �#isLastItemInInlineContentSuggestion1 r� z-Utilities.isLastItemInInlineContentSuggestionc C r� r� r& r� r& r& r' �isEmpty4 r� zUtilities.isEmptyc C r� r� r& r� r& r& r' �isHidden7 r� zUtilities.isHiddenc C r� r� r& r� r& r& r' �isDPub: r� zUtilities.isDPubc C r� r� r& r� r& r& r' �isDPubAbstract= r� zUtilities.isDPubAbstractc C r� r� r& r� r& r& r' �isDPubAcknowledgments@ r� z Utilities.isDPubAcknowledgmentsc C r� r� r& r� r& r& r' �isDPubAfterwordC r� zUtilities.isDPubAfterwordc C r� r� r& r� r& r& r' �isDPubAppendixF r� zUtilities.isDPubAppendixc C r� r� r& r� r& r& r' �isDPubBibliographyI r� z Utilities.isDPubBibliographyc C r� r� r& r� r& r& r' �isDPubBacklinkL r� zUtilities.isDPubBacklinkc C r� r� r& r� r& r& r' �isDPubBibliorefO r� zUtilities.isDPubBibliorefc C r� r� r& r� r& r& r' � isDPubChapterR r� zUtilities.isDPubChapterc C r� r� r& r� r& r& r' �isDPubColophonU r� zUtilities.isDPubColophonc C r� r� r& r� r& r& r' �isDPubConclusionX r� zUtilities.isDPubConclusionc C r� r� r& r� r& r& r' � isDPubCover[ r� zUtilities.isDPubCoverc C r� r� r& r� r& r& r' � isDPubCredit^ r� zUtilities.isDPubCreditc C r� r� r& r� r& r& r' � isDPubCreditsa r� zUtilities.isDPubCreditsc C r� r� r& r� r& r& r' �isDPubDedicationd r� zUtilities.isDPubDedicationc C r� r� r& r� r& r& r' � isDPubEndnoteg r� zUtilities.isDPubEndnotec C r� r� r& r� r& r& r' �isDPubEndnotesj r� zUtilities.isDPubEndnotesc C r� r� r& r� r& r& r' �isDPubEpigraphm r� zUtilities.isDPubEpigraphc C r� r� r& r� r& r& r' �isDPubEpiloguep r� zUtilities.isDPubEpiloguec C r� r� r& r� r& r& r' � isDPubErratas r� zUtilities.isDPubErratac C r� r� r& r� r& r& r' � isDPubExamplev r� zUtilities.isDPubExamplec C r� r� r& r� r& r& r' �isDPubFootnotey r� zUtilities.isDPubFootnotec C r� r� r& r� r& r& r' �isDPubForeword| r� zUtilities.isDPubForewordc C r� r� r& r� r& r& r' �isDPubGlossary r� zUtilities.isDPubGlossaryc C r� r� r& r� r& r& r' �isDPubGlossref� r� zUtilities.isDPubGlossrefc C r� r� r& r� r& r& r' � isDPubIndex� r� zUtilities.isDPubIndexc C r� r� r& r� r& r& r' �isDPubIntroduction� r� z Utilities.isDPubIntroductionc C r� r� r& r� r& r& r' �isDPubPagelist� r� zUtilities.isDPubPagelistc C r� r� r& r� r& r& r' �isDPubPagebreak� r� zUtilities.isDPubPagebreakc C r� r� r& r� r& r& r' � isDPubPart� r� zUtilities.isDPubPartc C r� r� r& r� r& r& r' � isDPubPreface� r� zUtilities.isDPubPrefacec C r� r� r& r� r& r& r' �isDPubPrologue� r� zUtilities.isDPubProloguec C r� r� r& r� r& r& r' �isDPubPullquote� r� zUtilities.isDPubPullquotec C r� r� r& r� r& r& r' � isDPubQna� r� zUtilities.isDPubQnac C r� r� r& r� r& r& r' �isDPubSubtitle� r� zUtilities.isDPubSubtitlec C r� r� r& r� r& r& r' � isDPubToc� r� zUtilities.isDPubTocc C r� r� r& r� r& r& r' �isFeed� r� zUtilities.isFeedc C r� r� r& r� r& r& r' �isFigure� r� zUtilities.isFigurec C r� r� r& r� r& r& r' �isGrid� r� zUtilities.isGridc C r� r� r& r� r& r& r' � isGridCell� r� zUtilities.isGridCellc C r� r� r& rJ r& r& r' �supportsLandmarkRole� r� z Utilities.supportsLandmarkRolec C r� r� r& r� r& r& r' � isLandmark� r� zUtilities.isLandmarkc C r� r� r& r� r& r& r' �isLandmarkWithoutType� r� z Utilities.isLandmarkWithoutTypec C r� r� r& r� r& r& r' �isLandmarkBanner� r� zUtilities.isLandmarkBannerc C r� r� r& r� r& r& r' �isLandmarkComplementary� r� z!Utilities.isLandmarkComplementaryc C r� r� r& r� r& r& r' �isLandmarkContentInfo� r� z Utilities.isLandmarkContentInfoc C r� r� r& r� r& r& r' �isLandmarkForm� r� zUtilities.isLandmarkFormc C r� r� r& r� r& r& r' �isLandmarkMain� r� zUtilities.isLandmarkMainc C r� r� r& r� r& r& r' �isLandmarkNavigation� r� z Utilities.isLandmarkNavigationc C r� r� r& r� r& r& r' � isDPubNoteref� r� zUtilities.isDPubNoterefc C r� r� r& r� r& r& r' �isLandmarkRegion� r� zUtilities.isLandmarkRegionc C r� r� r& r� r& r& r' �isLandmarkSearch� r� zUtilities.isLandmarkSearchc C r� r� r& r� r& r& r' �speakMathSymbolNames� r� z Utilities.speakMathSymbolNamesc C r� r� r& rJ r& r& r' �isInMath� r� zUtilities.isInMathc C r� r� r& r� r& r& r' �isMath� r� zUtilities.isMathc C r� r� r& r� r& r& r' �isMathLayoutOnly� r� zUtilities.isMathLayoutOnlyc C r� r� r& r� r& r& r' �isMathMultiline� r� zUtilities.isMathMultilinec C r� r� r& r� r& r& r' �isMathEnclosed� r� zUtilities.isMathEnclosedc C r� r� r& r� r& r& r' � isMathFenced� r� zUtilities.isMathFencedc C r� r� r& r� r& r& r' �isMathFractionWithoutBar� r� z"Utilities.isMathFractionWithoutBarc C r� r� r& r� r& r& r' � isMathPhantom� r� zUtilities.isMathPhantomc C r� r� r& r� r& r& r' �isMathMultiScript� r� zUtilities.isMathMultiScriptc C r� r� r& r� r& r& r' �isMathSubOrSuperScript� r� z Utilities.isMathSubOrSuperScriptc C r� r� r& r� r& r& r' �isMathUnderOrOverScript� r� z!Utilities.isMathUnderOrOverScriptc C r� r� r& r� r& r& r' �isMathSquareRoot� r� zUtilities.isMathSquareRootc C r� r� r& r� r& r& r' � isMathTable� r� zUtilities.isMathTablec C r� r� r& r� r& r& r' �isMathTableRow r� zUtilities.isMathTableRowc C r� r� r& r� r& r& r' �isMathTableCell r� zUtilities.isMathTableCellc C r� r� r& r� r& r& r' � isMathToken r� zUtilities.isMathTokenc C r� r� r& r� r& r& r' �isMathTopLevel r� zUtilities.isMathTopLevelc C � d S rr r& r� r& r& r' �getMathDenominator r� z Utilities.getMathDenominatorc C rz rr r& r� r& r& r' �getMathNumerator r� zUtilities.getMathNumeratorc C rz rr r& r� r& r& r' �getMathRootBase r� zUtilities.getMathRootBasec C rz rr r& r� r& r& r' �getMathRootIndex r� zUtilities.getMathRootIndexc C rz rr r& r� r& r& r' �getMathScriptBase r� zUtilities.getMathScriptBasec C rz rr r& r� r& r& r' �getMathScriptSubscript r� z Utilities.getMathScriptSubscriptc C rz rr r& r� r& r& r' �getMathScriptSuperscript r� z"Utilities.getMathScriptSuperscriptc C rz rr r& r� r& r& r' �getMathScriptUnderscript! r� z"Utilities.getMathScriptUnderscriptc C rz rr r& r� r& r& r' �getMathScriptOverscript$ r� z!Utilities.getMathScriptOverscriptc C � g S rr r& r� r& r& r' �getMathPrescripts' r� zUtilities.getMathPrescriptsc C r� rr r& r� r& r& r' �getMathPostscripts* r� z Utilities.getMathPostscriptsc C r� rr r& r� r& r& r' �getMathEnclosures- r� zUtilities.getMathEnclosuresc C s dgS r r& r� r& r& r' �getMathFencedSeparators0 � z!Utilities.getMathFencedSeparatorsc C s ddgS r r& r� r& r& r' � getMathFences3 � zUtilities.getMathFencesc C r� �Nr r& )r$ r3 �testr& r& r' �getMathNestingLevel6 r� z Utilities.getMathNestingLevelc C s g d�S )N)�banner� complementary� contentinfozdoc-acknowledgmentsz doc-afterwordz doc-appendixzdoc-bibliographyz doc-chapterzdoc-conclusionz doc-creditsz doc-endnotesz doc-epiloguez doc-errataz doc-forewordz doc-glossaryz doc-indexzdoc-introductionz doc-pagelistzdoc-partz doc-prefacez doc-prologuezdoc-toc�form�main� navigation�region�searchr& rJ r& r& r' �getLandmarkTypes9 r� zUtilities.getLandmarkTypesc C s� |r |� � tjks dS z|�� }W n' ty' d| }t�tj|d� Y dS d| }t�tj|d� Y dS z|j|j krOd| }t�tj|d� W dS W dS d| }t�tj|d� Y dS )NF�&ERROR: %s doesn't implement AtspiValueT�%ERROR: Exception getting value for %szINFO: %s is busy indicatorz+INFO: %s is either busy indicator or broken) r_ r. �ROLE_PROGRESS_BAR� queryValue�NotImplementedErrorr r+ r, � maximumValue� minimumValue)r$ r3 �valuer5 r& r& r' � isProgressBarV s. � �zUtilities.isProgressBarc C s� t �d�st �d�st �d�sdS | �|�sdS | �|�r dS t �d�r0dd � }t�||�r0d S t �d �}|tjkr<d S |tjkrV| � |�}|t j krMd S dd|t j f fS |tj krw|ra|j }n|�� }|t jjkrmdS dd|t jjf fS dS )N�speakProgressBarUpdates�brailleProgressBarUpdates�beepProgressBarUpdates)FzUpdates not enabled)FzIs not progress bar)Fz Has no size�ignoreStatusBarProgressBarsc S r rr �r_ r. �ROLE_STATUS_BARrt r& r& r' rv ~ r z/Utilities.isProgressBarUpdate.<locals>.<lambda>)FzIs status bar descendant�progressBarVerbosity)TzVerbosity is all)TzVerbosity is windowFzWindow %s is not %s)TzVerbosity is appzApp %s is not %s)Tz Not handled by any other case)�_settingsManager� getSettingr� � hasNoSizer. rz r �PROGRESS_BAR_ALL�PROGRESS_BAR_WINDOW�topLevelObjectr r[ �PROGRESS_BAR_APPLICATION�host_applicationrA � activeScriptr= )r$ r3 r � isStatusBar� verbosity�topLevelr= r& r& r' �isProgressBarUpdateq s< �� z Utilities.isProgressBarUpdatec C s� z|� � }|j|j|j}}}W n' ty' d| }t�tj|d� Y d S d| }t�tj|d� Y d S |�� � t j �rUd||f }t�tj|d� |dkrUd S || kr_|krsn nd| krndkrqt |�S d S d S t ||| d �S )Nr� Tr� z0INFO: %s has state indeterminate and value of %sr r �d ) r� r� � currentValuer� r� r r+ r, r* r- r. �STATE_INDETERMINATEry )r$ r3 r� �minval�val�maxvalr5 r& r& r' �getValueAsPercent� s, �zUtilities.getValueAsPercentc C s |o|� � tjkS rr )r_ r. �ROLE_BLOCK_QUOTEr� r& r& r' � isBlockquote� s zUtilities.isBlockquotec C �R |r |� � tjks dS z t�|| j�}W |d uS d| }t�tj|� Y dS �NF�'ERROR: Exception finding ancestor of %s)r_ r. � ROLE_LISTrz � isDocumentr r+ r, �r$ r3 r� r5 r& r& r' �isDocumentList� � �zUtilities.isDocumentListc C r� r� )r_ r. � ROLE_PANELrz r� r r+ r, r� r& r& r' �isDocumentPanel� r� zUtilities.isDocumentPanelc C s, t jt jt jt jt jt jg}|o|�� |v S rr )r. r� r� r� r� r� r� r_ )r$ r3 � documentRolesr& r& r' r� � s �zUtilities.isDocumentc C s |pt j}| �|�d uS rr )r r� �getDocumentForObjectr� r& r& r' �inDocumentContent� s zUtilities.inDocumentContentc C s | � tj�S rr )� getTopLevelDocumentForObjectr r� )r$ rC r& r& r' �activeDocument� � zUtilities.activeDocumentc C s | � |�o t�|| j � S rr )r� r. rz r� r& r& r' �isTopLevelDocument� s z Utilities.isTopLevelDocumentc C s | � |�r|S t�|| j �S rr )r� r. rz r� r& r& r' r� � s z&Utilities.getTopLevelDocumentForObjectc C sP |sd S | � |�r |S z t�|| j �}W |S d| }t�tj|d� Y d S )Nr� T)r� r. rz r r+ r, )r$ r3 �docr5 r& r& r' r� � s �z Utilities.getDocumentForObjectc sh |sd S t jt jt jg� � fdd�}||�r|S z t �||�}W |S d| }t�tj|d� Y d S )Nc s | o| � � � v odt�| �v S �N�Table)r_ r. r� rt �� tableRolesr& r' rv � � z$Utilities.getTable.<locals>.<lambda>r� T)r. r� r� r� rz r r+ r, )r$ r3 �isTabler� r5 r& r� r' �getTable� s �zUtilities.getTablec C s6 |r |� � tjks dS | �|�}|sdS |� � tjkS r� )r_ r. r� r� r� )r$ r3 r� r& r& r' �isTextDocumentTable s z Utilities.isTextDocumentTablec C s$ |r |� � tjks dS | �|�d u S r� )r_ r. r� r� r� r& r& r' � isGUITable s zUtilities.isGUITablec C s� |sdS z|� � }W n d| }t�tj|d� Y dS |tjks$dS | �|�}|s-dS |� � tjkr6dS z|�� }W n' t yR d| }t�tj|d� Y dS d| }t�tj|d� Y dS |j dkS )NFr T�2ERROR: Table %s does not implement table interface�/ERROR: Exception querying table interface of %si ) r_ r r+ r, r. r� r� r� r� r� r� )r$ r3 rc r5 r� r� r& r& r' �isSpreadSheetTable s4 � �z Utilities.isSpreadSheetTablec C s t jt jt jt jt jgS rr )r. �ROLE_TABLE_CELL�ROLE_TABLE_COLUMN_HEADER�ROLE_TABLE_ROW_HEADER�ROLE_COLUMN_HEADER�ROLE_ROW_HEADERrJ r& r& r' rs ; s �zUtilities.getCellRolesc C �X |sdS z|� � }W n d| }t�tj|d� Y dS || �� vr%dS t�|| j�S �NFr T)r_ r r+ r, rs r. rz r� �r$ r3 rc r5 r& r& r' �isTextDocumentCellB � z Utilities.isTextDocumentCellc C r� r� )r_ r r+ r, rs r. rz r� r� r& r& r' �isSpreadSheetCellR r� zUtilities.isSpreadSheetCellc C s0 | � |�\}}|dkr dS | jj�d�}||kS )Nr� F� lastColumn��coordinatesForCellr! �pointOfReferencerx )r$ r� r� �columnr� r& r& r' �cellColumnChangedb � zUtilities.cellColumnChangedc C s0 | � |�\}}|dkr dS | jj�d�}||kS )Nr� F�lastRowr� )r$ r� r� r� r� r& r& r' �cellRowChangedj r� zUtilities.cellRowChangedc C s` | j �� rdS | �|�sdS | �|�}|sdS | �|�s!t�d�S | �|�r+t�d�S t�d�S )NF�readFullRowInGUITable�readFullRowInSpreadSheet�readFullRowInDocumentTable)r! �inSayAllr� r� r� r� r� r� )r$ r3 r� r& r& r' �shouldReadFullRowr s zUtilities.shouldReadFullRowc C r� r� r& r� r& r& r' �isSorted� r� zUtilities.isSortedc C r� r� r& r� r& r& r' � isAscending� r� zUtilities.isAscendingc C r� r� r& r� r& r& r' � isDescending� r� zUtilities.isDescendingc C sX |r| � |�s dS | �|�rtj}n | �|�rtj}ntj}|r*|jr*d|j|f }|S )Nr z%s. %s)r� r� r �SORT_ORDER_ASCENDINGr� �SORT_ORDER_DESCENDING�SORT_ORDER_OTHERr� )r$ r3 � includeName�resultr& r& r' �getSortOrderDescription� s z!Utilities.getSortOrderDescriptionc C sl z |� � }|�� }W n Y dS |tjkrdS |�tj�r dS |�tj�r4d| }t�tj |d� dS dS )NFT�-INFO: %s is focused but lacks state focusable) r_ r* r. r� r- �STATE_FOCUSABLEr� r r+ r, �r$ r3 rc r4 r5 r& r& r' �isFocusableLabel� � zUtilities.isFocusableLabelc C sl z |� � }|�� }W n Y dS |tjkrdS |�tj�r dS |�tj�r4d| }t�tj |d� dS dS )NFr� T) r_ r* r. r� r- r� r� r r+ r, r r& r& r' �isNonFocusableList� r z Utilities.isNonFocusableListc C s2 |r |� � tjks dS dd� }t�||�rdS dS )NFc S r rr r� rt r& r& r' rv � r z3Utilities.isStatusBarNotification.<locals>.<lambda>T)r_ r. �ROLE_NOTIFICATIONrz �r$ r3 r� r& r& r' �isStatusBarNotification� s z!Utilities.isStatusBarNotificationc C sL |sdS z|� � }W n Y dS |tjkrdS dd� }t�||�r$dS dS )NFTc S � | o | � � tjtjfv S rr )r_ r. r� r� rt r& r& r' rv � rl z,Utilities.isTreeDescendant.<locals>.<lambda>)r_ r. �ROLE_TREE_ITEMrz )r$ r3 rc �isTreer& r& r' �isTreeDescendant� s zUtilities.isTreeDescendantc C sH d}| � |�s | �|�rdS | �|�}z|�� }W n d}Y z|j�� }W n d}Y z|d }W n d}Y | �� }tjtjtj tj g}|tj kr�|� d�dkr�z|� � } W n+ tys d| } t�tj| d� d}Y �n� d| } t�tj| d� d}Y �n�| jr�| js�|�� �tj� }�n{|� d �d ks�|� d �d kr�d}�ni|js�| �|�s�| �d�p�| �d� }�nT|tjkr�|j r�|tj kr�d}�nC|�� tjkr�d}�n8|tj kr�| � |j�}�n+|tj kr�| � |� }�n |tj!kr�d}�n|tj"k�rd}�n |tj#k�rd}�n|tj$k�r!| �%| �&|��}n�|tj'k�r*d}n�|tj(tj)fv �r6d}n�|tj*tj fv �rBd}n�||v �rJd}n�|tjk�rV|tj+k}n�|tj+k�r_d}n�|tj,k�rhd}n�|tj-k�rqd}n�|tj.tj/fv �r}d}n�|tj0tj1tj2fv �r�d}n�|tj k�r�|tj*k�r�d}ny|tj3tj4fv �r�d}nm| �5|��r�|�� } | �tj6��p�| �tj7� }nT|tj8k�r�|j �r�|�r�|�� |v �r�d}n=|tj8k�r�|j|�9� jk�r�d}n+|j d k�r�|j�r�|j|jk�r�d}n| �:|��rd}n| �;|��s| �|��sd}|�r"d | } t�tj| d� |S )z�Returns True if the given object is a container which has no presentable information (label, name, displayed text, etc.).FTNr z layout-guessr r� r� z xml-rolesr� �tagr z$INFO: %s is deemed to be layout only)<�isDead�isZombierq r_ r^ �_topLevelRolesr. � ROLE_MENU�ROLE_MENU_ITEMr� r r� rx r� r� r r+ r, r� �nColumnsr* r- r� r� r �getColumnHeader� getRowHeaderr� r� r� � isLayoutOnly� ROLE_SECTIONr� r� � ROLE_FILLERr� �ROLE_LAYERED_PANEr r� �ROLE_AUTOCOMPLETE�ROLE_TEAROFF_MENU_ITEM�ROLE_SEPARATOR� ROLE_LIST_BOXr� r� � ROLE_FORMr� r� � ROLE_TEXT�ROLE_PASSWORD_TEXTr �ROLE_REDUNDANT_OBJECT� ROLE_UNKNOWN� isTableRowr� �STATE_SELECTABLEr� rA r3 r ) r$ r3 � layoutOnlyr| rc � parentRole� firstChild� topLevelRoles�ignorePanelParentr� r5 r4 r& r& r' r � s� � � � � " zUtilities.isLayoutOnlyc C s | rt jsdS t j�� | �� kS )z�Returns True if the given object is from the same application that currently has keyboard focus. Arguments: - obj: an Accessible object F)r r� rA �r3 r& r& r' � isInActiveAppT s zUtilities.isInActiveAppc C sP |sdS z|� � }W n ttfy" d| }t�tj|d� Y dS w |tjkS )z Returns True if obj is a link.F�$ERROR: Exception getting role for %sT)r_ r� r� r r+ r, r. � ROLE_LINKr� r& r& r' �isLinkb s � zUtilities.isLinkc C s4 | � |�sdS |�� }|�tj�o|�tj� }|S )z;Returns True if obj is a text entry area that is read only.F)� isTextArear* r- r. r� �STATE_EDITABLE)r$ r3 r4 �readOnlyr& r& r' �isReadOnlyTextAreaq s �z Utilities.isReadOnlyTextAreac C r� r� r& r� r& r& r' �isSwitch| r� zUtilities.isSwitchc C sB | j j}d }|D ]}|dkrqz|| }W q Y |S |}|S �Nr� )r! r= )r$ �path�startrp �pr& r& r' �getObjectFromPath s �zUtilities.getObjectFromPathc C s� t j�|�}t j�|�}t|�t|�krdS |dd � }|dd � }|�d�r.|�d�r.dS z|�d�}W n tyS z|�d�}W n tyP t|�}Y nw Y nw |d|� |d|� kS )NFr r� r )r. �utils�getPathrT �countr} � ValueError)r$ �obj1�obj2�path1�path2r} r& r& r' � _hasSamePath� s& ���zUtilities._hasSamePathc C s� ||krdS |r |s dS z[|� � |� � krW dS |j|jkr#|s#W dS |r.| �||�r.W dS |�� �tj�}|�� �tj�}||krEW dS |jdkr\|jdkr_|j dkrb|j dkreW dS W dS W dS W dS W dS Y dS )NTFr ) r_ r� r? �queryComponent� getExtentsr. �DESKTOP_COORDSru �y�width�height)r$ r; r< � comparePaths� ignoreNames�extents1�extents2r& r& r' r� � s> �� �����zUtilities.isSameObjectc C s* | � |�rdS |o|�� tjtjtjfv S )z{Returns True if obj is a GUI component that is for entering text. Arguments: - obj: an accessible F)r, r_ r. r r �ROLE_PARAGRAPHr� r& r& r' r- � s �zUtilities.isTextAreac C s dd� t jD �S )znRetrieves the list of currently running apps for the desktop as a list of Accessible objects. c S s g | ]}|d ur|�qS rr r& �rH ru r& r& r' rK � rl z/Utilities.knownApplications.<locals>.<listcomp>)r �_desktopr& r& r& r' rO � s zUtilities.knownApplicationsc s� z� � � }W n ttfy d� }t�tj|d� g Y S w dd� }tt|� � � ��}|s1g S |d �t�fdd�t �� � �D ��}� |v rYd� }t�tj|d� |� � � � fd d �}tt||��S ) z,Return a list of the labels for this object.r� Tc S r� rr )r� r. �RELATION_LABELLED_BY�r� r& r& r' rv � r� z+Utilities.labelsForObject.<locals>.<lambda>r c � g | ]}� � |��qS r& �r� �rH r� rN r& r' rK � � z-Utilities.labelsForObject.<locals>.<listcomp>z+WARNING: %s claims to be labelled by itselfc s t ��� fdd�� S )Nc � | � kS rr r& rt ��accr& r' rv � � zBUtilities.labelsForObject.<locals>.isNotAncestor.<locals>.<lambda>r% rT r( rT r' � isNotAncestor� s z0Utilities.labelsForObject.<locals>.isNotAncestor) r� r� r� r r+ r, rQ r� �setr� r� �remove)r$ r3 r� r5 �predr� rW r& )r3 r� r' r� � s& � zUtilities.labelsForObjectc C sD | � |�}|s dS t�dd|�}|�� }|D ] }|�� s dS q|S )Nr z[-_]r8 )� linkBasename�re�subri �isalpha)r$ r3 �basename�tokens�tokenr& r& r' �linkBasenameToName� s �z Utilities.linkBasenameToNamec C sN d}z| � � }W n Y |S |�d�}|r�t|�r�|�d�}t|�dkrM|D ]%}|�d�dkrL|d �� s<|dd� }|d �� sH|dd� }|} nq'|�d�d }|sX|S |d dkrm|dd� }|�d�d }|S |�d�sv|}|S |�d�d }|�d �r�|�d�d }|�d �d }|�d �d }|�d �d }|�d �d }|S )z�Returns the relevant information from the URI. The idea is to attempt to strip off all prefix and suffix, much like the basename command in a shell.Nr �,r z://r� ����/r} �.�?�#�%)�queryHyperlink�getURIrT ri �find�isalnumr9 � startswith)r3 r_ � hyperlink�uri� expression�itemr& r& r' r[ sJ / � � � � zUtilities.linkBasenamec C s� | sdS z| � � W n ty Y dS w z| �� }W n ty% Y dS w t|�� �D ]}|�|�}||jkrA||jkrA| S q,dS )a� A brute force method to see if an offset is a link. This is provided because not all Accessible Hypertext implementations properly support the getLinkIndex method. Returns an index of 0 or greater of the characterIndex is on a hyperlink. Arguments: -obj: the object with the Accessible Hypertext specialization -characterIndex: the text position to check r� )r� r� �queryHypertextr� � getNLinks�getLink� startIndex�endIndex)r3 �characterIndex� hypertextr� �linkr& r& r' � linkIndexF s& � � �zUtilities.linkIndexc s� |sdS z �j j�j | W S �j�j jvr i �j j�j< Y ��|�r-�fdd�}n|�� tjkr9dd� }n |�� � � fdd�}g }t�||�}|rZ|�|� t�||�}|sMt |�}|�j j�j |< �j j�j | S )zmDetermines the nesting level of this object. Arguments: -obj: the Accessible object r c s � � | �S rr )r� rt rJ r& r' rv x s z(Utilities.nestingLevel.<locals>.<lambda>c S s | o | j o | j �� tjkS rr )r^ r_ r. r� rt r& r& r' rv z rL c s | o| � � � kS rr �r_ rt )rc r& r' rv } r� ) r! r� � NESTING_LEVELr� r_ r. r� rz r� rT )r$ r3 rZ � ancestorsrb r r& )rc r$ r' r g s. � �zUtilities.nestingLevelc C sX | � |�sdS z | jj| j | W S | j| jjvr#i | jj| j< Y g }|}d}|s�z|�� }W n ttfyJ d| }t�tj |d� Y dS w d}|D ]}|� � t j kr_|� d�} nqO|�|�rud||f }t�tj |d� d}t|�dkr�d | }t�tj |d� d}n |r�|�|� nd}|r,t|�d | jj| j |< | jj| j | S ) z�Determines the node level of this object if it is in a tree relation, with 0 being the top level node. If this object is not in a tree relation, then -1 will be returned. Arguments: -obj: the Accessible object r� Fr� TNr z0ERROR: %s is already in the list of nodes for %sr� z&INFO: More than 100 nodes found for %sr )r r! r� � NODE_LEVELr� r� r� r r+ r, r� r. r� r� r9 rT r� )r$ r3 r� r� r� r� r5 r� r& r& r' r � sR � �� � � zUtilities.nodeLevelc C s� | � |�rdS | �|�rdS | �|�s!d| }t�tj|d� dS z |�� �tj �}W n d| }t�tj|d� Y dS d||f }t�tj|d� |j dksV|j dkrdd| }t�tj|d� dS |j dk r�|j dk r�t |�d kr�d | }t�tj|d� dS |j s�|js�|js�d | }t�tj|d� dS |�� tjkr�d | }t�tj|d� dS dS |d u s�| �|j�s�dS | �||�s�t |�d kr�d |||f }t�tj|d� dS dS )NFz#INFO: %s is not showing and visibleT�'ERROR: Exception getting extents for %sz INFO: Extents for %s are: %si' z(INFO: %s seems to have bogus coordinatesr )r� r� r� r� z!INFO: %s has negative coordinatesz$INFO: %s has no size and no childrenzINFO: %s has no sizezINFO: %s %s not in %s)r r3 �isShowingAndVisibler r+ r, r@ rA r. rB ru rC �tuplerD rE r� r_ r �_boundsIncludeChildrenr^ �containsRegion)r$ r3 � boundingboxr5 �boxr& r& r' � isOnScreen� sR zUtilities.isOnScreenc C s� z|� � }W n d| }t�tj|d� Y d S |tjkr d S dt�|�v r4| �|�}|r2|d S d S |D ].}z |�� |� � }W n d| }t�tj|d� Y q6|� tj �s`|� tj �rd| S q6d S )Nr T� Selectionr r) ) r_ r r+ r, r. � ROLE_MENU_BARr� �selectedChildrenrB r* r- r� �STATE_SELECTED)r$ �menubarrc r5 �selected�menur4 r& r& r' �selectedMenuBarMenu� s6 ��z Utilities.selectedMenuBarMenuc sz |sdS dd� }t �||�}|d u rdS | j�t|��� � d u r%| �|�� � s)dS � fdd�}||�r5dS t �||�d uS )NFc S r rr )r_ r. r� rt r& r& r' rv r z/Utilities.isInOpenMenuBarMenu.<locals>.<lambda>c rS rr r& rt �� selectedMenur& r' rv % rV T)r. rz r# rx �hashr� )r$ r3 � isMenuBarr� �inSelectedMenur& r� r' �isInOpenMenuBarMenu s z Utilities.isInOpenMenuBarMenuc C r� r� r& r� r& r& r' �isStaticTextLeaf+ r� zUtilities.isStaticTextLeafc C r� r� r& r� r& r& r' �isListItemMarker. r� zUtilities.isListItemMarkerc C s8 | � |�rdS | �|�}|sdS tt�d|�dd���S )NFz\w+r r� )r� r� �boolr\ r� r� )r$ r3 r� r& r& r' �hasPresentableText1 s z Utilities.hasPresentableTextc C sz | � ||�sg S z|�� }W n d| }t�tj|d� g Y S |tjkr)g S |tjkr1|gS |tjkr9|gS |tj krA|gS |tj krP| � |�| j t |�< |jrc|j�� tj krc| �|�sc|gS |tjkr�|js�d| }t�tj|d� |�� d||jf }t�tj|d� |d u r�z |�� }|�tj�}W n d| }t�tj|d� d}Y t�|�}d|v r�d|v r�| �|�}|r�|S g }|jp�|j} |tjtjfv r�| r�|� |� n | � |�r�|� |� |D ]} | � | �s�|� | � | |�� q�|tj k�rd | j t |�< |�r |S |tj!k�r |j�s | �"|��s g S tj#tjtjtj$tj%tj&tj'tj(tj)g } || v �r:| �s:g S |gS ) Nr Tz)INFO: %s is empty filler. Clearing cache.z INFO: %s reports %i children�&ERROR: Exception getting extents of %s�r r r r r� r� )*r� r_ r r+ r, r. � ROLE_INVALIDr� r� r� r� r� r# r� r^ r� r r� rB r@ rA rB r� �getVisibleTableCellsr� � description� ROLE_PAGE_TAB� ROLE_IMAGEr� r� r� rP �getOnScreenObjectsr� r� � ROLE_CANVASr+ r r� r r� � ROLE_VIEWPORT) r$ r� �extentsrc r5 � component� interfaces� visibleCells�objects�hasNameOrDescriptionrI � containersr& r& r' r� ; s� � � � z Utilities.getOnScreenObjectsc C s� z | r | j r | js W dS W n d| }t�tj|d� Y dS | �� }|tjkr+dS |tjkr2dS | j �� tj ks<dS dd� }t t |dd� | D ���}t |�| jkrUdS dS )z9Determines if obj is a table row -- real or functionally.Fz5ERROR: Exception getting parent and childCount for %sTc S s$ | o| � � tjtjtjtjtjfv S rr )r_ r. r� r� r� r� r� rt r& r& r' rv � s �z&Utilities.isTableRow.<locals>.<lambda>c S r� r& r& rK r& r& r' rK � r� z(Utilities.isTableRow.<locals>.<listcomp>) r^ r� r r+ r, r_ r. �ROLE_TABLE_ROWr� r� rQ r� rT )r3 r5 rc r~ � cellChildrenr& r& r' r! � s( � zUtilities.isTableRowc s` |� � �tj�r |S tjtjtjtjtjtj g� t� |� fdd��}|r.| j j � |j�s.|}|S )Nc � | o| � � � v S rr r| rt ��rolesr& r' rv � r� z.Utilities.realActiveAncestor.<locals>.<lambda>)r* r- r. r� r� r� r� r� r� r� rz r! � utilitiesr r^ r& r& r� r' �realActiveAncestor� s �z Utilities.realActiveAncestorc s\ � � |�rdS |�� tjkr|S � fdd�|D �}� fdd�|D �}t|�dkr,|d S |S )a2 Given an object that should be a child of an object that manages its descendants, return the child that is the real active descendant carrying useful information. Arguments: - obj: an object that should be a child of an object that manages its descendants. Nc s g | ] }� � |�s|�qS r& )r� rK rJ r& r' rK � rL z2Utilities.realActiveDescendant.<locals>.<listcomp>c s g | ] }� � |��� r|�qS r& )r �striprK rJ r& r' rK � r� r r )r r_ r. r� rT )r$ r3 �children� hasContentr& rJ r' �realActiveDescendant� s z Utilities.realActiveDescendantc C s |sdS dd� }t �||�d uS )NFc S r rr r� rt r& r& r' rv � r z1Utilities.isStatusBarDescendant.<locals>.<lambda>r% r r& r& r' �isStatusBarDescendant� s z Utilities.isStatusBarDescendantc C s� |r |� � tjks g S t�� }| jj�d�}|s,dd� }tt|| � |���}|| jjd< t�� }d|| }t � t j |d� |S )N�statusBarItemsc S s | o| � � tjkS rr r� rt r& r& r' rv � r z*Utilities.statusBarItems.<locals>.<lambda>z)INFO: Time getting status bar items: %.4fT) r_ r. r� �timer! r� rx rQ r� r� r r+ r, )r$ r3 r4 �items�include�endr5 r& r& r' r� � s zUtilities.statusBarItemsc C s� |� � tjkr |S tjtjtjg}|�� �tj�s |� � |v r!dS d}t |j d dd�D ])}|| � � tjkr<|| }n|| � � |vrK| � || �}|rU| � |�rU |S q,|S )z�Returns the status bar in the window which contains obj. Arguments: - obj: the top-level object (e.g. window, frame, dialog) for which the status bar is sought. Nr r� ) r_ r. r� r� r� r� r* r- r� r� r� � statusBarr� )r$ r3 r� r� r� r& r& r' r� � s( � � zUtilities.statusBarc C rz rr r& r r& r& r' �infoBar r� zUtilities.infoBarc C � t jt jt jt jgS rr )r. � ROLE_ALERTr� r� � ROLE_WINDOWrJ r& r& r' r s �zUtilities._topLevelRolesc C sn t jsdS zt j�� }W n dt j }t�tj|d� Y dS || �� v }dt j|f }t�tj|d� |S )NFr* Tz INFO: %s is top-level object: %s)r r� r_ r r+ r, r )r$ rc r5 rp r& r& r' � _locusOfFocusIsTopLevelObject s z'Utilities._locusOfFocusIsTopLevelObjectc C sz |sdS | � � }|r;|jr;||jkr;|�� |vr;|j�� tjks;|j}|r;|jr;||jkr;|�� |vr;|j�� tjkr |S )z�Returns the top-level object (frame, dialog ...) containing obj, or None if obj is not inside a top-level object. Arguments: - obj: the Accessible object N)r r^ r_ r. �ROLE_APPLICATION)r$ r3 � stopAtRolesr& r& r' r� / s � zUtilities.topLevelObjectc C s� |pt j}| �|�}|sdS |�� z|�� }W n d| }t�tj|d� Y dS |�t j �r7|�t j �r9dS | � |t j �sBdS dS )NFz-ERROR: Exception getting state of topLevel %sT)r r� r� rB r* r r+ r, r- r. r/ � STATE_DEFUNCTr� r[ )r$ r3 r� r4 r5 r& r& r' � topLevelObjectIsActiveAndCurrentC s$ �z*Utilities.topLevelObjectIsActiveAndCurrentc C sb z| � � �tj�}|� � �tj�}W n Y dS |j|jd }|j|jd }t|| �|kS )z1Determines if obj1 and obj2 are on the same line.F� )r@ rA r. rB rC rE �abs)r; r< �delta�bbox1�bbox2�center1�center2r& r& r' � onSameLine[ s zUtilities.onSameLinec C s� | |krdS t t| �t|��}| dg| d|� } |dg| d|� }ttt| �t|���D ]}| | || k r= dS | | || krH dS q0dS )zpCompares the two paths and returns -1, 0, or 1 to indicate if path1 is before, the same, or after path2.r r� Nr )�maxrT r� r� )r= r> �sizeru r& r& r' �pathComparisonj s �zUtilities.pathComparisonc C sx z| � � �tj�}|j|j}}W n d\}}Y z|� � �tj�}|j|j}}W n d\}}Y || || S �N�r r )r@ rA r. rB rD rE )r; r< �bbox�width1�height1�width2�height2r& r& r' rX ~ s zUtilities.sizeComparisonc C s� z| � � �tj�}|j|j}}W n d\}}Y z|� � �tj�}|j|j}}W n d\}}Y || p;|| }|sL| j|jkrL| �� |�� }t|d�}t |d�}|S )z�Compares the physical locations of obj1 and obj2 and returns -1, 0, or 1 to indicate if obj1 physically is before, is in the same place as, or is after obj2.r� r� r ) r@ rA r. rB ru rC r^ r{ r� r� )r; r< r� �x1�y1�x2�y2rp r& r& r' �spatialComparison� s zUtilities.spatialComparisonc C s@ z |� � �||tj�}W |S d| }t�tj|d� Y dS )Nz,ERROR: Exception getting range extents of %sT�r� r� r r )r� �getRangeExtentsr. rB r r+ r, )r$ r3 r4 r� r� r5 r& r& r' �getTextBoundingBox� s �z Utilities.getTextBoundingBoxc C sN z |� � �tj�}W n d| }t�tj|d� Y dS |j|j|j |j fS )Nr� Tr� ) r@ rA r. rB r r+ r, ru rC rD rE �r$ r3 r� r5 r& r& r' �getBoundingBox� s zUtilities.getBoundingBoxc C sb |sdS |� � tjkr dS z |�� �tj�}W n d| }t�tj|d� Y dS |j o/|j S )NFr� T) r_ r. r� r@ rA rB r r+ r, rD rE r� r& r& r' r� � s zUtilities.hasNoSizec C s� |sd S z|j }W n d| }t�tj|d� Y d S t|�D ]8}z|| }W n d||f }t�tj|d� Y d S |rE||�rEq |rP||�rP|�|� | �||||� q d S )N�*ERROR: Exception getting childCount for %sTz(ERROR: Exception getting %i child for %s)r� r r+ r, r� r� �_findAllDescendants) r$ r� � includeIf� excludeIf�matchesr� r5 r� rI r& r& r' r� � s* �z Utilities._findAllDescendantsc C s g }| � ||||� |S rr )r� )r$ r� r� r� r� r& r& r' r� � s z Utilities.findAllDescendants� c s | j jr | j j�|�r g S tjtjg� tjtjtjtj tj tj tj tj tjg �� �fdd�}��fdd�}�fdd�}| �|||�}|j}i } |D ]*} | jpR| �| �} | r^| || jjfv r^qIt| �� �|k rgqI|�| �dkroqI| | | < qIt| �� �}t|t�| j�d�S ) a� Returns a list containing all the unrelated (i.e., have no relations to anything and are not a fundamental element of a more atomic component like a combo box) labels under the given root. Note that the labels must also be showing on the display. Arguments: - root: the Accessible object to traverse - onlyShowing: if True, only return labels with STATE_SHOWING Returns a list of unrelated labels under the given root. c s< | r| � � � v s dS | �� rdS �r | �� �tj�s dS dS �NFT)r_ r� r* r- r. r1 rt )� labelRolesr� r& r' �_include s z+Utilities.unrelatedLabels.<locals>._includec s0 | r| � � �v r dS � r| �� �tj�sdS dS r )r_ r* r- r. r1 rt )r� r� r& r' �_exclude s z+Utilities.unrelatedLabels.<locals>._excludec r� rr r| rt )r� r& r' rv r� z+Utilities.unrelatedLabels.<locals>.<lambda>r rM ) r! � spellcheck� isCheckWindowr. r� � ROLE_STATICr� r r r� r� �ROLE_SPLIT_PANEr� r� r� r� r� r r^ rT ri rl rQ �valuesrU rV rW r� ) r$ r� r� r� r� r� r� r� �rootName�dr� r� r& )r� r� r� r' r� � s< � zUtilities.unrelatedLabelsc C r� )NTr& rJ r& r& r' �_treatAlertsAsDialogs/ r� z Utilities._treatAlertsAsDialogsc s� t jg���� r��t j� ��fdd�� � fdd�|�� D �}|�� fdd���|�D �� �fdd�}tt |t |���}tt �fdd�|��}t |�S )ac If the current application has one or more alert or dialog windows and the currently focused window is not an alert or a dialog, return a count of the number of alert and dialog windows, otherwise return a count of zero. Arguments: - obj: the Accessible object Returns the alert and dialog count. c s | r| � � � v p ��| �S rr )r_ r( rt )r� r$ r& r' rv B rL z8Utilities.unfocusedAlertAndDialogCount.<locals>.<lambda>c � g | ]}� |�r|�qS r& r& rK ��isDialogr& r' rK C rl z:Utilities.unfocusedAlertAndDialogCount.<locals>.<listcomp>c r� r& r& rK r� r& r' rK D rl c s � � | �o | jp | jS rr )r� r� r� rt rJ r& r' rv F rR c s � � | � S rr rF rt rJ r& r' rv I r$ ) r. r� r� r� r� rA rP r� rQ r� rX rT )r$ r3 �dialogs� isPresentable� presentable� unfocusedr& )r� r� r$ r' � unfocusedAlertAndDialogCount2 s z&Utilities.unfocusedAlertAndDialogCountc C s z|� � �d�W S Y dS )zjReturn the URI for a given link object. Arguments: - obj: the Accessible object. r N)rj rk r� r& r& r' rp L s z Utilities.uric C s |sdS |j S )z�Returns the first valid parent/ancestor of obj. We need to do this in some applications and toolkits due to bogus hierarchies. Arguments: - obj: the Accessible object N)r^ r� r& r& r' r X s zUtilities.validParentc C s� z| � � }W n Y dS |�� dkr(|j}t||�}t||�}|�||� dS |�d�\}}||k r6|}n|}|�d||� dS )z�Adjusts the end point of a text selection Arguments: - obj: the Accessible object. - offset: the new end point - can be to the left or to the right depending on the direction of selection Nr )r� �getNSelections� caretOffsetr� r� � addSelection� getSelection� setSelection)r3 r� r� r� � startOffset� endOffsetr& r& r' �adjustTextSelectionk s z Utilities.adjustTextSelectionc C s� |r| � |�r dS |�� D ]}|�� tjkr |�d� S q |�� d }|jrRd| kr5|jjd k sRn |j}|�� d }|jrRd| krP|jjd k r6n q6z|j| }W n d}Y ||krfd}|S )z!Finds the object before this one.Nr r ) r r� r� r. �RELATION_FLOWS_FROMr� r{ r^ r� )r$ r3 r� r} �prevObjr& r& r' �findPreviousObject� s$ � $ &�z Utilities.findPreviousObjectc C s� |r| � |�r dS |�� D ]}|�� tjkr |�d� S q |�� d }|jrNd| k r3|jjk sNn |j}|�� d }|jrNd| k rL|jjk r4n q4z|j| }W n d}Y ||krbd}|S )z Finds the object after this one.Nr r ) r r� r� r. �RELATION_FLOWS_TOr� r{ r^ r� )r$ r3 r� r} �nextObjr& r& r' �findNextObject� s$ � "�zUtilities.findNextObjectc C s� | � |�\}}}|r| jj�d�r|||fS | �|�r |||fS | �|�}|rD| �|�r=| � |�\}}}|s7n d||f }| �|�}|s'| �|�} | rh| �| �ra| � | �\}}}|s[n d||f }| �| �} | sK|||fS )a� Get all the text applicable text selections for the given object. including any previous or next text objects that also have selected text and add in their text contents. Arguments: - obj: the text object to start extracting the selected text from. Returns: all the selected text contents plus the start and end offsets within the text for the given object. �entireDocumentSelected�%s %s)� selectedTextr! r� rx r� r r� r ) r$ r3 � textContentsr r r � selectionr4 r� r r& r& r' �allSelectedText� s0 � � zUtilities.allSelectedTextc C s\ z| � � }W n g Y S g }z|�� }W n d}Y t|�D ] }|�|�|�� q!|S )an Get a list of text selections in the given accessible object, equivalent to getNSelections()*texti.getSelection() Arguments: - obj: An accessible. Returns list of start and end offsets for multiple selections, or an empty list if nothing is selected or if the accessible does not support the text interface. r )r� r� r� r� r� )r3 r� rp � nSelectionsr� r& r& r' �allTextSelections� s zUtilities.allTextSelectionsc C s� z|� � }W n' ty d| }t�tj|d� Y d S d| }t�tj|d� Y d S |�|�}|dkr9d S |�|�}|sPd||f }t�tj|d� d S |�d�}d|||f }t�tj|d� ||jkrxd|j|f }t�tj|d� |S ) Nz3INFO: %s does not implement the hypertext interfaceTz3INFO: Exception querying hypertext interface for %sr� z,INFO: No hyperlink object at index %i for %sr z/INFO: Hyperlink object at index %i for %s is %szBERROR: The hyperlink start index (%i) should match the offset (%i)) rs r� r r+ r, � getLinkIndexru � getObjectrv )r$ r3 r� ry r5 r} ro rI r& r& r' �getChildAtOffset� s6 �zUtilities.getChildAtOffsetc C s� d}z|� � }W n ty d| }t�tj|d� Y |S w z |j�� |j}W n d||jf }t�tj|d� Y |S d||f }t�tj|d� |S )a� Returns the character offset of the embedded object character for this object in its parent's accessible text. Arguments: - obj: an Accessible that should implement the accessible hyperlink specialization. Returns an integer representing the character offset of the embedded object character for this hyperlink in its parent's accessible text, or -1 something was amuck. r� �3INFO: %s does not implement the hyperlink interfaceTz7ERROR: Exception getting startIndex for %s in parent %sz INFO: startIndex of %s is %i)rj r� r r+ r, r^ r� rv )r$ r3 r� ro r5 r& r& r' �characterOffsetInParent s$ � �z!Utilities.characterOffsetInParentc C s: z|� � }W n Y dS t|�� �D ]}|�|� qdS )zwClears the text selection if the object supports it. Arguments: - obj: the Accessible object. N)r� r� r� �removeSelection)r$ r3 r� r� r& r& r' �clearTextSelection@ s �z Utilities.clearTextSelectionc C s4 z |� � �dd�}W n Y dS |ot�d|� S )Nr r� Fz [^\ufffc])r� r� r\ r� r� r& r& r' �containsOnlyEOCsO s zUtilities.containsOnlyEOCsr� c C s� z | � |||�}W n Y dS | j|vr|S tjtjtjtjtjtjtj tj g}t |�}t |�D ]&\}}|| jkrW| � ||| �} | �| �} | rS| �� |v rS| d7 } | ||< q1d�|�S )ar Expands the current object replacing EMBEDDED_OBJECT_CHARACTERS with their text. Arguments - obj: the object whose text should be expanded - startOffset: the offset of the first character to be included - endOffset: the offset of the last character to be included Returns the fully expanded text for the object. r r8 )� substringr� r. � ROLE_HEADINGr� r� rJ r r� r� r� rQ � enumerater � expandEOCsr_ r� ) r$ r3 r r r� � blockRoles�toBuildr� �charrI r� r& r& r' r W s2 � � zUtilities.expandEOCsc C sN | � ||d�\}}}|�d�dkrdS |�d�dkr dS |�d�dv r%dS dS ) a Identifies if the current word is flagged as misspelled by the application. Different applications and toolkits flag misspelled words differently. Thus each script will likely need to implement its own version of this method. Arguments: - obj: An accessible which implements the accessible text interface. - offset: Offset in the accessible's text for which to retrieve the attributes. Returns True if the word is flagged as misspelled. T�invalid�spellingz text-spelling� misspelled� underline)�errorr" F)�textAttributesrx )r$ r3 r� � attributesr4 r� r& r& r' �isWordMisspelled s zUtilities.isWordMisspelledc C s |� � �tj�S rr )r* r- r. �STATE_INVALID_ENTRYr� r& r& r' �getError� � zUtilities.getErrorc C r� r r& r� r& r& r' �getErrorMessage� r� zUtilities.getErrorMessagec C r� r� r& r� r& r& r' �isErrorMessage� r� zUtilities.isErrorMessagec C s0 | � |�}|r|d u r|j}|�||d �S dS )Nr r )r� r� r� )r$ r3 r� r� r& r& r' �getCharacterAtOffset� s z Utilities.getCharacterAtOffsetc C sV z |� � }|j}W n ty Y dS d| }t�tj|d� Y dS |r)|S dS )z�Get the text interface associated with an object, if it is non-empty. Arguments: - obj: an accessible object z.ERROR: Exception getting character count of %sTN)r� r� r� r r+ r, )r$ r3 r� � charCountr5 r& r& r' r� � s ��zUtilities.queryNonEmptyTextc C s |j S rr )�any_datar r& r& r' � deletedText� r� zUtilities.deletedTextc C s� |j r|j S z|j�� }W n d|j }t�tj|d� d }Y d}t�tj|d� |tjkrP| �|j�}|rP|� dd�}|rPd| }t�tj|d� |d S d}t�tj|d� dS ) Nr Tz"ERROR: Broken text insertion eventr r� z!HACK: Returning last char in '%s'z3FAIL: Unable to correct broken text insertion eventr ) r0 r r_ r r+ r, r. r r� r� )r$ r rc r5 r� r� r& r& r' � insertedText� s* zUtilities.insertedTextc C s� d}d }}z|� � }W n d}Y n|�� }td|�D ]!}|�|�\}}||kr+q | �|||�}|dkr:|d7 }||7 }q |||gS )z�Get the text selection for the given object. Arguments: - obj: the text object to extract the selected text from. Returns: the selected text contents plus the start and end offsets within the text. r r r8 )r� r� r� r� r ) r$ r3 r r r �textObjr r� r r& r& r' r � s zUtilities.selectedTextc C sJ t j}z |�� j}W ||fS ty d}Y ||fS d}Y ||fS )Nr r� )r r� r� r� r� r r& r& r' r� � s ��zUtilities.getCaretContextc C s |dfS r� r& r� r& r& r' �getFirstCaretPosition r� z Utilities.getFirstCaretPositionc C s t �d |d� | �||� d S r� )r �setLocusOfFocus�setCaretOffset)r$ r3 r� r� r& r& r' �setCaretPosition s zUtilities.setCaretPositionc C s( z|� � }W n Y dS |�|� dS )z�Set the caret offset on a given accessible. Similar to Accessible.setCaretOffset() Arguments: - obj: Given accessible object. - offset: Offset to hich to set the caret. N)r� r6 )r$ r3 r� �textir& r& r' r6 s zUtilities.setCaretOffsetc C s& z|� � }W n Y dS |�||�S )aT Returns the substring of the given object's text specialization. Arguments: - obj: an accessible supporting the accessible text specialization - startOffset: the starting character position - endOffset: the ending character position. Note that an end offset of -1 means the last character r )r� r� )r$ r3 r r r� r& r& r' r s zUtilities.substringc C s* | j j�� D ] \}}||kr| S q|S )a� Converts the given Atk attribute name into the application's equivalent. This is necessary because an application or toolkit (e.g. Gecko) might invent entirely new names for the same text attributes. Arguments: - attribName: The name of the text attribute Returns the application's equivalent name if found or attribName otherwise. )r! �attributeNamesDictr� )r$ � attribNamerN r� r& r& r' �getAppNameForAttribute- s �z Utilities.getAppNameForAttributec C s | j j�||�S )aa Converts the given attribute name into the Atk equivalent. This is necessary because an application or toolkit (e.g. Gecko) might invent entirely new names for the same attributes. Arguments: - attribName: The name of the text attribute Returns the Atk equivalent name if found or attribName otherwise. )r! r9 rx )r$ r: r& r& r' �getAtkNameForAttribute@ s z Utilities.getAtkNameForAttributec C s* z|� � }W n g Y S |dkr|j}d|||f }t�tj|d� t�� }g }|}||k r}z|�|�\} } } d|| | | f }t�tj|d� W n d| }t�tj|d� | Y S tdd� | D ��} |�t | |�| | f� t | |d �}||k s0t�� } d t |�| | f }t�tj|d� |S ) z9Returns a list of (start, end, attrsDict) tuples for obj.r� z3INFO: Getting text attributes for %s (chars: %i-%i)Tz"INFO: Attributes at %i: %s (%i-%i)z)ERROR: Exception getting attributes at %ic S re rf rh rj r& r& r' rK g rl z;Utilities.getAllTextAttributesForObject.<locals>.<listcomp>r z(INFO: %i attribute ranges found in %.4fs) r� r� r r+ r, r� �getAttributeRunrm r� r� rT )r$ r3 r r r� r5 � startTimerp r� �attrListr4 r� �attrDict�endTimer& r& r' � getAllTextAttributesForObjectM s8 �z'Utilities.getAllTextAttributesForObjectc C s� i }z|� � }W n |ddf Y S |r#| �|�� �}|�|d � |du r*|j}|�|�\}}} | �|�}|�|d � t||�}t| |d �} ||| fS )a Get the text attributes run for a given offset in a given accessible Arguments: - acc: An accessible. - offset: Offset in the accessible's text for which to retrieve the attributes. - get_defaults: Get the default attributes as well as the unique ones. Default is True Returns a dictionary of attributes, a start offset where the attributes begin, and an end offset. Returns ({}, 0, 0) if the accessible does not supprt the text attribute. r r N)r� �stringToKeysAndDict�getDefaultAttributes�updater� rn r� r� ) r$ rU r� � get_defaultsrp r� � stringAndDict� attrStringr4 r� r& r& r' r& p s zUtilities.textAttributesc C s |dkr|dkst |�dkrtjS |�d�s|dkr tjS t�|| j�}|dkr5|�d�d � � � d�}nM|r[|�d �r[|�d �d }t � � d |v rSt� t |��}n/t� t |��}n'|�d �r{| �|�\}}}tjrst�|||�}nd |||f }nt�|| j�}d ||f S )N�weight�boldi� r" z family-namerc r �"�px� decimal_point�colorz%i %i %iz%s: %s)ry r �BOLD�endswith� MISSPELLEDr �getTextAttributeNamer! ri r� �locale� localeconv� pixelCount�float� rgbFromStringr � useColorNamesr � rgbToName)r$ rN r� � localizedKey�localizedValuer� �gr� r& r& r' �localizeTextAttribute� s& z Utilities.localizeTextAttributec C sv g }| � |||�}|D ]-\}}}} ||krq ||kr |S t||�}t||�}| �|||�} |�||| || g� q |S )zAReturns a list of (start, end, string, language, dialect) tuples.)�'getLanguageAndDialectFromTextAttributesr� r� r r� ) r$ r3 r4 r� rp � allSubstringsr r �language�dialectr� r& r& r' �splitSubstringByLanguage� s � z"Utilities.splitSubstringByLanguagec C s@ | � |||�}|D ]\}}}}||kr ||kr ||f S q dS )z�Returns a (language, dialect) tuple. If multiple languages apply to the substring, language and dialect will be empty strings. Callers must do any preprocessing to avoid that condition.)r r )r^ ) r$ r3 r4 r� r_ r r r` ra r& r& r' �!getLanguageAndDialectForSubstring� s �z+Utilities.getLanguageAndDialectForSubstringc C s� g }| � |||�}d }}|D ]>\}} } | �dd�} d} d| v r(| �dd�\} } |r?|| kr?|| kr?|d d | | | f|d< n |�|| | | f� | | }}q|S )zvReturns a list of (start, end, language, dialect) tuples for obj based on what is exposed via text attributes.r r` �-r r� r )rB rx ri r� ) r$ r3 r r rp � attributeSet� lastLanguage� lastDialectr4 r� r| r` ra r& r& r' r^ � s z1Utilities.getLanguageAndDialectFromTextAttributesc C sb t jrtjsdS t|j�dks|jtj@ rdS t j}|� � }|t j kr%dS |� � � t j�r/dS dS )z�Given a keyboard event containing an alphanumeric key, determine if the script is likely to echo it as a character. Fr T)r r� r �enableEchoByCharacterrT � event_string� modifiersr �ORCA_CTRL_MODIFIER_MASKr_ r. r r* r- r. )r$ r r3 rc r& r& r' �willEchoCharacter� s � zUtilities.willEchoCharacterc C s� ddl m} tj}d}z |�|d �\}}W n d}Y t|�} | tjkrQ|d | jjvrQ|r6|rK||krKt � |d �} t � | | �} d|| f }|S ||7 }|S ||7 }|S )a� Add in the latest line segment, adjusting for repeat characters and punctuation. Arguments: - segment: the segment of repeated characters. - line: the current built-up line to characters to speak. - respectPunctuation: if False, ignore punctuation level. Returns: the current built-up line plus the new segment, after adjusting for repeat character counts and punctuation. r ��punctuation_settingsTr Fr ) r rn r �verbalizePunctuationStyle�getPunctuationInforT �repeatCharacterLimitr! � whitespacer �getCharacterNamer �repeatedCharCount) r$ �segment�line�respectPunctuationrn �style� isPunctChar�level�actionr9 � repeatChar� repeatSegmentr& r& r' �_addRepeatSegment� s, � ��zUtilities._addRepeatSegmentc C s: | � |�s | �|�s dS t�d�}|tjtjfv rdS dS )NFro T)r r r� r� r �PUNCTUATION_STYLE_ALL�PUNCTUATION_STYLE_NONE)r$ r3 rx r& r& r' � shouldVerbalizeAllPunctuation" s z'Utilities.shouldVerbalizeAllPunctuationc C s@ |}t t�| j|��D ]}dt�|� }t�d| ||�}q |S )Nz %s z\%s)rX r\ �findall� PUNCTUATIONr rs r] )r$ r� r� �symbol�charNamer& r& r' �verbalizeAllPunctuation/ s z!Utilities.verbalizeAllPunctuationc C s ddl m} |t|� }z |�� }|�� }W n d}Y t|�}t|dd�D ]a} |�| d �} | s3q'|| j k r>|krFn n| j| } n || j krQ|k ran nt|�} | j|k r`| d8 } nq'dt j } d} | t|�k rs|| } | | j j v s�|�| �s�| d7 } | || | �< q'd�|�S )a| Adjust line to include the word "link" after any hypertext links. Arguments: - obj: the accessible object that this line came from. - line: the string to adjust for links. - startOffset: the caret offset at the start of the line. Returns: a new line adjusted to add the speaking of "link" after text which is also a link. r rm r r� r8 r )r rn rT rs rt rQ r� ru rw rv r �LINKr! rr rp r� )r$ r3 rv r rn r � hyperText�nLinks� adjustedLine�nrz r} � linkString�nextCharr& r& r' �adjustForLinks7 s< � � zUtilities.adjustForLinksc C s t �dd| �S )Nz(?<=[a-z])(?=[A-Z])r8 )r\ r] )r� r& r& r' �_processMultiCaseStringl s z!Utilities._processMultiCaseStringc C s | � � s| S d�t| ��S )Nr8 )� isnumericr� rQ )�wordr& r& r' �_convertWordToDigitsp s z Utilities._convertWordToDigitsc C s� t jr| �|�}| �� rt�|�}t jr#| j�|�}d� t | j |��}t |�dkr4t �|�}||kr4|S t js9|S d}| j�|�}d� t tj|��}t jrR| �|�}|S )a@ Adjust the line to replace words in the pronunciation dictionary, with what those words actually sound like. Arguments: - line: the string to adjust for words in the pronunciation dictionary. Returns: a new line adjusted for words found in the pronunciation dictionary. r r )r � speakMultiCaseStringsAsWordsr� rh r �adjustForSpeech�speakNumbersAsDigits�WORDS_REri r� rR r� rT r rs �usePronunciationDictionaryr �getPronunciation)r$ rv �words�charname�newLiner& r& r' �adjustForPronunciationw s& z Utilities.adjustForPronunciationc C s� t |�dk s tjdk r |S d}|d }}d}tdt |��D ] }|| |kr-||| 7 }n d}| �||�}|| }|| }q | �|||�S )a� Adjust line to include repeat character counts. As some people will want this and others might not, there is a setting in settings.py that determines whether this functionality is enabled. repeatCharacterLimit = <n> If <n> is 0, then there would be no repeat characters. Otherwise <n> would be the number of same characters (or more) in a row that cause the repeat character count output. If the value is set to 1, 2 or 3 then it's treated as if it was zero. In other words, no repeat character count is given. Arguments: - line: the string to adjust for repeat character counts. Returns: a new line adjusted for repeat character counts (if enabled). � r r Fr T)rT r rq r� r~ )r$ rv r� ru �lastChar� multipleCharsr� r& r& r' �adjustForRepeats� s zUtilities.adjustForRepeatsc s� t t�� j|��}t t�� j|��}|D ]}� fdd�|D �}tjd�|� }t�|||�}q|D ]}� fdd�|D �}tj d�|� }t�|||�}q1|S )z�Adjusts the string to convert digit-like text, such as subscript and superscript numbers, into actual digits. Arguments: - string: the string to be adjusted Returns: a new string which contains actual digits. c � g | ] }t � j�|���qS r& )rS �SUPERSCRIPT_DIGITSr} �rH r� rJ r& r' rK � � z-Utilities.adjustForDigits.<locals>.<listcomp>r c r� r& )rS �SUBSCRIPT_DIGITSr} r� rJ r& r' rK � r� ) rX r\ r� � SUBSCRIPTS_RE�SUPERSCRIPTS_REr �DIGITS_SUPERSCRIPTr� r] �DIGITS_SUBSCRIPT)r$ r� � subscripted� superscripted�number�new� newStringr& rJ r' �adjustForDigits� s zUtilities.adjustForDigitsc C s� t �d�s t �d�s dS |�dd�}t�d|�}|r"|d |�� � }d}dd� t�d |�D �}d d� t�d |�D �}t|| �}|D ]!\}}||f|v rX|d t� || � 7 }qB|d t� || � 7 }qB|S ) N�onlySpeakDisplayedText�enableSpeechIndentationr � r8 z[^ ]c S � g | ]}|� � �qS r& ��span�rH �mr& r& r' rK � rw z4Utilities.indentationDescription.<locals>.<listcomp>z +c S r� r& r� r� r& r& r' rK � rw z +z%s ) r� r� r< r\ r� r4 �finditerrU r � spacesCount� tabsCount)r$ rv r� r� �spaces�tabs�spansr4 r& r& r' �indentationDescription� s" � z Utilities.indentationDescriptionc C s4 ddl m} | �� �� �� }|�� \}}}}||fS )z0Gets the absolute position of the mouse pointer.r r )� gi.repositoryr �Window� get_screen�get_root_window� get_pointer)r � rootWindowrC ru rC rj r& r& r' �absoluteMouseCoordinates� s z"Utilities.absoluteMouseCoordinatesr8 c C s |s| S | s|S | | | S )z�Appends the newText to the given text with the delimiter in between and returns the new string. Edge cases, such as no initial text or no newText, are handled gracefully.r& )r� �newText� delimiterr& r& r' r� � s zUtilities.appendStringc C sT |r|sdS ||kr dS |j |j ko)|j|jko)|j|jko)|j|jko)|j|jkS r� )r �type�detail1�detail2r0 )r$ �event1�event2r& r& r' �treatAsDuplicateEvent s � � � �z Utilities.treatAsDuplicateEventc C sH |j �d�r�|jr |jsdS |j�� }|�tj�sdS |�tj�s#dS |�tj �r;|j� � |j�� }|�tj �s;dS | � � \}}|dkrL|jdkrLdS |dkrW|jdkrWdS |dv ra| � |j�S | �� sgdS |j�� �d d �}|�|j�r�| �|j�\}}}||jkr�dS ||jkr�|�|�r�|d |�|�� } | �� �|�� �S dS ) z�Returns True if event is associated with text being autocompleted or autoinserted or autocorrected or autosomethingelsed. Arguments: - event: the accessible event being examined �object:text-changed:insertF�Tab� T�Return� )�Up�Down�Page_Up� Page_Downr r� N)r� rn r0 r r* r- r. r. r1 r� rB r� �lastKeyAndModifiers� isEditableDescendantOfComboBox� lastInputEventWasPrintableKeyr� r� rP r rl �lower) r$ r r4 �lastKey�modsr� r r4 r� � beginningr& r& r' �isAutoTextEvent s> zUtilities.isAutoTextEventc C s( |dks|dkr dS || j jv o|dv S )a� Returns True if we are positioned at the end of a sentence. This is determined by checking if the current character is a white space character and the previous character is one of the normal end-of-sentence punctuation characters. Arguments: - currentChar: the current character - previousChar: the previous character Returns True if the given character is a sentence delimiter. � r� Tz!.?:;)r! rr )r$ � currentChar� previousCharr& r& r' �isSentenceDelimiterC s �z Utilities.isSentenceDelimiterc C s || j jv p|dv p|| j jkS )z�Returns True if the given character is a word delimiter. Arguments: - character: the character in question Returns True if the given character is a word delimiter. z!*+,-./:;<=>?@[\]^_{|})r! rr �NO_BREAK_SPACE_CHARACTER)r$ � characterr& r& r' �isWordDelimiterV s � �zUtilities.isWordDelimiterc C sH |du rt j}z|�� �|�}|�� �|�}W n Y dS | �||�S )z9Returns the extents of the intersection of obj1 and obj2.Nr� )r. rB r@ rA � intersection)r$ r; r< � coordTyperH rI r& r& r' �intersectingRegionc s z Utilities.intersectingRegionc C s� |\}}}}|\}}} } t ||| d �} t ||| d �} tt| ��t| ���} t ||| d �}t ||| d �}tt|��t|���}| rJ|sLdS | d }|d }| d | }|d | }||||fS )Nr r� r r� )r� rU rX r� )r$ rH rI r� r� r� r� r� r� r� r� �xPoints1�xPoints2� xIntersection�yPoints1�yPoints2� yIntersectionru rC rD rE r& r& r' r� q s zUtilities.intersectionc C s | � ||�dkS )Nr� )r� )r$ rH rI r& r& r' r� � r+ zUtilities.containsRegionc C s, t j�� }|�| �d }ttt jt|���S r2 )r �Keymap� get_default�get_entries_for_keycoderQ rR � keyval_namerX )�keycode�keymap�entriesr& r& r' �_allNamesForKeyCode� s z Utilities._allNamesForKeyCodec C s, t tjtj�s dS tj} | r| j| jfS dS r� )r\ r �lastInputEventr � KeyboardEvent�lastNonModifierKeyEvent�hw_coderj )r r& r& r' �_lastKeyCodeAndModifiers� s z"Utilities._lastKeyCodeAndModifiersc C sR t tjtj�r!tjr!tj} | jdv r| j}n| j}tjj}||fS d}d}||fS )z�Convenience method which returns a tuple containing the event string and modifiers of the last non-modifier key event or ("", 0) if there is no such event.)� BackSpace�Deleter r ) r\ r r� r r� r� r� ri rj )r �eventStrr� r& r& r' r� � s � �z Utilities.lastKeyAndModifiersc C s� z#ddl m} |�| �\}}|�||�}|r"|�d�r |�d�r"|} W n | �d�r3| t�d�7 } | �dd�} | �dd��� } Y t � | �S ) z3Turns a key sequence into a user-presentable label.r r �+z++r8 �<r �>) r� r �accelerator_parse�accelerator_get_labelrP r rs r< r� r �localizeKeySequence)�sequencer rN r� � newSequencer& r& r' �labelFromKeySequence� s" ��� z Utilities.labelFromKeySequencec C s� z | j j| j | W S | j| j jvr i | j j| j< Y z|�� }W n ty@ g d�| j j| j |< | j j| j | Y S w z |�d��d�}W n g d�| j j| j |< | j j| j | Y S t|�dkrx|d }|d }|d }n t|�dkr�d}|d }z|d }W n d}Y nd}d}d}|�dd �� � }| � |�}| � |�}| � |�}| j| j jvr�i | j j| j< |||g| j j| j |< | j j| j | S ) a2 Gets the mnemonic, accelerator string and possibly shortcut for the given object. These are based upon the first accessible action for the object. Arguments: - obj: the Accessible object Returns: list containing strings: [mnemonic, shortcut, accelerator] )r r r r �;r� r r� r rg r8 ) r! r� � KEY_BINDING� queryActionr� � getKeyBindingri rT r< r� r )r$ r3 r{ �bindingStrings�mnemonic� fullShortcut� acceleratorr& r& r' �mnemonicShortcutAccelerator� sP � � �z%Utilities.mnemonicShortcutAcceleratorc C s` z&dd� | � d�D �}dd� |D �}dd� |D �}tdd� |D ��}W ||gS g i f Y S )a� Converts a string made up of a series of <key>:<value>; pairs into a dictionary of keys and values. Text before the colon is the key and text afterwards is the value. The final semi-colon, if found, is ignored. Arguments: - string: the string of tokens containing <key>:<value>; pairs. Returns a list containing two items: A list of the keys in the order they were extracted from the string and a dictionary of key/value items. c S r� r& �r� )rH �sr& r& r' rK rw z1Utilities.stringToKeysAndDict.<locals>.<listcomp>r c S s" g | ] }t |�d ��dkr|�qS )rg r� )rT ri �rH rr r& r& r' rK s " c S s g | ] }|� d �d �� �qS )rg r )ri r� r r& r& r' rK r� c S s g | ]}|� d ��qS )rg rh r r& r& r' rK rR )ri rm )r� r� �keys� dictionaryr& r& r' rC s � z Utilities.stringToKeysAndDictc C s� | � |d�}|�d�}|r|S z|�� }W n ty Y dS w |j}z|j}W n ttfyA d}d| }t� tj |d� Y nw z|j }W n ttfy` d}d| }t� tj |d� Y nw z|j } W n ttfy� || d } d | }t� tj |d� Y nw | dkr�zt �td t �| � ��} W n! ty� d | }t� tj |d� Y dS w t|�d k r�d } nd } d | } | | S )z�Returns the text to be displayed for the object's current value. Arguments: - obj: the Accessible object that may or may not have a value. Returns a string representing the value. F� valuetextr � z,ERROR: Exception getting maximumValue for %sTz,ERROR: Exception getting minimumValue for %sg Y@z0ERROR: Exception getting minimumIncrement for %sr z2ERROR: Exception calculating decimal places for %sr z%%.%df)rq rx r� r� r� r� r� r� r r+ r, r� �minimumIncrement�math�ceilr� �log10r: r� ) r$ r3 r| r r� r� �maxValuer5 �minValue� minIncrement� decimalPlaces� formatterr& r& r' � textForValue sX � � � � � zUtilities.textForValuec C s( zdt | � W S t�tj� Y dS )z� Returns a four hex digit representation of the given character Arguments: - The character to return representation Returns a string representaition of the given character unicode vlue z%04xr )�ordr r� � LEVEL_WARNING)r� r& r& r' �unicodeValueStringR s z Utilities.unicodeValueStringc C r� rr r& )r$ r3 r� � layoutModero r& r& r' �getLineContentsAtOffsetb r� z!Utilities.getLineContentsAtOffsetc C r� rr r& )r$ r3 r� ro r& r& r' �getObjectContentsAtOffsete r� z#Utilities.getObjectContentsAtOffsetc C s |s| � � \}}||d fS �Nr �r� �r$ r3 r� � skipSpacer& r& r' �previousContexth � zUtilities.previousContextc C s |s| � � \}}||d fS r( r) r* r& r& r' � nextContextn r- zUtilities.nextContextc C s$ d}| � |�}|r|jd }||fS �Nr r )r� r� )r$ r� r� r� r& r& r' � lastContextt s zUtilities.lastContextc C sp z|� � }|j|j}}W ||fS ty& d| }t�tj|d� Y dS d| }t�tj|d� Y dS )z5Returns the text range in parent associated with obj.r T�r� r� z0INFO: Exception getting hyperlink indices for %s)rj rv rw r� r r+ r, )r$ r3 ro r4 r� r5 r& r& r' �getHyperlinkRange| s �zUtilities.getHyperlinkRangec sh z � � � }|j}W n) ty d� }t�tj|d� g Y S d� }t�tj|d� g Y S d� |f }t�tj|d� g }t|�D ] }|�|�}d||f }t�tj|d� | �|�sf|� |� qG|ru|sud}t�tj|d� � � � }|t j kr�|s�dd� } | � � | �}|t jkr�|r�|d � � t j kr�| �|d �}|s�� jr�� fd d�} | � � | �}|S ) N�3INFO: %s does not implement the selection interfaceT�4ERROR: Exception querying selection interface for %sz'INFO: %s reports %i selected child(ren)zINFO: Child %i: %sz>INFO: Selected children not retrieved via selection interface.c S � | o | � � �tj�S rr )r* r- r. r� rt r& r& r' rv � rw z,Utilities.selectedChildren.<locals>.<lambda>r c s | o| j � j kS rr )r� rt r( r& r' rv � r� )�querySelection�nSelectedChildrenr� r r+ r, r� �getSelectedChildr r� r_ r. r r� r� r� r� ) r$ r3 r r9 r5 r� ru rI rc rZ r& r( r' r� � sJ � � zUtilities.selectedChildrenc s� |sd S dd� � � |�r|S t jt jgt jt jgt jt jgt jt jt jgt j t j t jgt j t j t jgi�|� � �� ��fdd�}t � ||�S )Nc S � | odt �| �v S )Nr� �r. r� rt r& r& r' rv � r z1Utilities.getSelectionContainer.<locals>.<lambda>c s � | �o | � � ����v S rr �r_ rx rt �� isSelectionrc �rolemapr& r' rv � rL )r. r� r � ROLE_ICONr� r r r� r� r� r� r� r_ rz )r$ r3 �isMatchr& r< r' �getSelectionContainer� s � z Utilities.getSelectionContainerc s� |r dt �|�v s dS dt �|�v r | �|�\}}td|�S t jt jgt jt jgi�|�� � � �vr5|j S � �fdd�}t | � ||��S )Nr� r r� c s | � � ��� �v S rr r; rt �rc r> r& r' rv � r z0Utilities.selectableChildCount.<locals>.<lambda>) r. r� �rowAndColumnCountr� r r� r� r r_ r� rT r� )r$ r3 �rows�colsr@ r& rB r' �selectableChildCount� s �z Utilities.selectableChildCountc C s� dt �|�v r|�� }|jr|jS z |�� }|j}W n' ty0 d| }t�tj |d� Y dS d| }t�tj |d� Y dS d||f }t�tj |d� |S )Nr� r3 Tr r4 z%INFO: %s reports %i selected children) r. r� r� � nSelectedRowsr6 r7 r� r r+ r, )r$ r3 r� r r9 r5 r& r& r' �selectedChildCount� s$ z Utilities.selectedChildCountc C sz z |� � }|j}W n' ty d| }t�tj|d� Y dS d| }t�tj|d� Y dS |�d�|�|d �fS )Nr3 T�NNr4 r r )r6 r7 r� r r+ r, r8 )r$ r3 r r9 r5 r& r& r' � firstAndLastSelectedChildren� s z&Utilities.firstAndLastSelectedChildrenc C s@ dd� }t �||�}||kr d||f }t�tj|d� d S |S )Nc S r5 rr )r* r- r. r� rt r& r& r' rv rw z(Utilities.focusedChild.<locals>.<lambda>z ERROR: focused child of %s is %sT)r. �findDescendantr r+ r, )r$ r3 � isFocusedrI r5 r& r& r' � focusedChild s zUtilities.focusedChildc C s� |sd S z|j }W n d| }t�tj|d� Y d S dd� |D �}|D ]$}z|�� }W n d| }t�tj|d� Y q%|�tj�rI| S q%d S )Nr� Tc S s g | ] }|� � tjkr|�qS r& )r_ r. r rG r& r& r' rK r� z*Utilities.popupMenuFor.<locals>.<listcomp>�%ERROR: Exception getting state for %s)r� r r+ r, r* r- r. � STATE_ENABLED)r$ r3 r� r5 �menusr� r4 r& r& r' � popupMenuFor s( �zUtilities.popupMenuForc C sX |sdS z |� � }|�� }W n d| }t�tj|d� Y dS |tjko+|�tj�S )NF�.ERROR: Exception getting role and state for %sT) r_ r* r r+ r, r. r� r- �STATE_HAS_POPUPr r& r& r' �isButtonWithPopup' s zUtilities.isButtonWithPopupc C s\ |sdS z|� � }W n d| }t�tj|d� Y dS |tjtjfvr'dS | �|�d uS �NFr* T)r_ r r+ r, r. r� r� rQ r� r& r& r' � isMenuButton5 s zUtilities.isMenuButtonc C s� |pt j}|s dS z|�� }W n d| }t�tj|d� Y dS tjtjtj tj tj g}||v r4dS |tj tj fv rF|joE|j�� |v S dS rU )r r� r_ r r+ r, r. r r �ROLE_CHECK_MENU_ITEM�ROLE_RADIO_MENU_ITEMr r� r r^ )r$ r3 rc r5 � menuRolesr& r& r' �inMenuE s( �zUtilities.inMenuc C s* |pt j}| �|�s dS t�|| j�d uS r� )r r� rZ r. rz � isContextMenur� r& r& r' � inContextMenu^ s zUtilities.inContextMenuc C s t jt jfS rr )r. r� r� rJ r& r& r' �_contextMenuParentRolese r� z!Utilities._contextMenuParentRolesc C s. |r |� � tjks dS |jo|j� � | �� v S r� )r_ r. r r^ r] r� r& r& r' r[ h s zUtilities.isContextMenuc C s" |� � tjkr|j| �|�kS dS r� )r_ r. r r^ r� r� r& r& r' �isTopLevelMenun s zUtilities.isTopLevelMenuc C s` z |� � }|�� }W n d| }t�tj|d� Y dS |tjkr$dS |�tj�o/|�tj �S )NrR TF) r_ r* r r+ r, r. r r- � STATE_SUPPORTS_AUTOCOMPLETION�STATE_SINGLE_LINEr r& r& r' � isSingleLineAutocompleteEntryt s �z'Utilities.isSingleLineAutocompleteEntryc C r� r� r& r� r& r& r' �isEntryCompletionPopupItem� r� z$Utilities.isEntryCompletionPopupItemc sr |sd S z|� � }W n d| }t�tj|d� Y d S |tjkr$d S � fdd�|D �}t|�dkr7|d S d S )Nr* Tc rE r& )�isEditableTextArearK rJ r& r' rK � rL z9Utilities.getEntryForEditableComboBox.<locals>.<listcomp>r r )r_ r r+ r, r. r� rT )r$ r3 rc r5 r� r& rJ r' �getEntryForEditableComboBox� s z%Utilities.getEntryForEditableComboBoxc C s | � |�d uS rr )rd r� r& r& r' �isEditableComboBox� � z Utilities.isEditableComboBoxc C sb |sdS z|� � }W n d| }t�tj|d� Y dS |�tj�s%dS dd� }t�||�d uS )NFrN Tc S r rr )r_ r. r� rt r& r& r' rv � r z:Utilities.isEditableDescendantOfComboBox.<locals>.<lambda>)r* r r+ r, r- r. r. rz )r$ r3 r4 r5 � isComboBoxr& r& r' r� � s z(Utilities.isEditableDescendantOfComboBoxc C sz |j s| �|�S | �|�}|r| �|�S | jj�|�}|p%| jj�|d �}t|�dkr8|d jp7| �|d �S | �|�S r/ )r� r rd r! r� r� rT r� )r$ r3 �entryr� r& r& r' �getComboBoxValue� s zUtilities.getComboBoxValuec C r� r� r& r� r& r& r' � isPopOver� r� zUtilities.isPopOverc C sN | � |�sdS z|�� }W n d| }t�tj|d� Y dS |�tj� S )NFrN T)rj r* r r+ r, r- r. � STATE_MODALr2 r& r& r' �isNonModalPopOver� s zUtilities.isNonModalPopOverc C r� r� r& r� r& r& r' �isUselessPanel� r� zUtilities.isUselessPanelc C sB t �dt j�}t �|d|�}|�d�\}}}t|�t|�t|�fS )Nz rgb|[^\w,]r rc )r\ �compile� IGNORECASEr] ri ry )r$ �attributeValue�regexr� �red�green�bluer& r& r' rW � s zUtilities.rgbFromStringc C r� r� r& r� r& r& r' �isClickableElement� r� z Utilities.isClickableElementc C r� r� r& r� r& r& r' � hasLongDesc� r� zUtilities.hasLongDescc C r� r� r& r� r& r& r' r� � r� zUtilities.hasDetailsc C r� r� r& r� r& r& r' � isDetails� r� zUtilities.isDetailsc C r� rr r& r� r& r& r' � detailsFor� r� zUtilities.detailsForc C r� r� r& r� r& r& r' �hasVisibleCaption� r� zUtilities.hasVisibleCaptionc C r� r r& r� r& r& r' � popupType� r� zUtilities.popupTypec C sh |r |� � tjks dS | �|�}z t|�dd��}W |S ty3 d||f }t�tj |d� Y dS w )Nr rz �0z*ERROR: Exception getting value for %s (%s)T) r_ r. r rq ry rx r: r r+ r, )r$ r3 r| r� r5 r& r& r' � headingLevel� s � �zUtilities.headingLevelc C sT z|� � }W n ty Y dS w dtjg}t|j�D ] }|�|�|v r' dS qdS )NF�toggleT)r r� r � ACTION_TOGGLEr� �nActions�getName)r$ r3 r{ �toggleActionNamesr� r& r& r' �hasMeaningfulToggleAction� s � �z#Utilities.hasMeaningfulToggleActionc s@ |sd S t jt jt jt jg� � fdd�}||�r|S t �||�S )Nc r� rr r| rt r� r& r' rv r� z1Utilities.containingTableHeader.<locals>.<lambda>)r. r� r� r� r� rz )r$ r3 �isHeaderr& r� r' �containingTableHeader s � z Utilities.containingTableHeaderc C s� |r |� � tjks g S dd� }t�||�}z|�� }W n g Y S | �|�}|�|�|�|�}}|�||�}g } t ||| �D ] } | � |� | �� qB| S )Nc S r9 r� r: rt r& r& r' rv r z0Utilities.columnHeadersForCell.<locals>.<lambda>) r_ r. r� rz r� r r� r� �getColumnExtentAtr� r� r ) r$ r3 r� r^ r� r} r� r� �colspan�headers�cr& r& r' �columnHeadersForCell � z Utilities.columnHeadersForCellc C s� |r |� � tjks g S dd� }t�||�}z|�� }W n g Y S | �|�}|�|�|�|�}}|�||�}g } t ||| �D ] } | � |� | �� qB| S )Nc S r9 r� r: rt r& r& r' rv / r z-Utilities.rowHeadersForCell.<locals>.<lambda>) r_ r. r� rz r� r r� r� �getRowExtentAtr� r� r ) r$ r3 r� r^ r� r} r� r� �rowspanr� r� r& r& r' �rowHeadersForCell+ r� zUtilities.rowHeadersForCellc C �b |r |� � tjks d S dd� }t�||�}z|�� }W n Y d S | �|�}|�|�}|�|�S )Nc S r9 r� r: rt r& r& r' rv D r z/Utilities.columnHeaderForCell.<locals>.<lambda>)r_ r. r� rz r� r r� r )r$ r3 r� r^ r� r} � columnIndexr& r& r' �columnHeaderForCell@ � z Utilities.columnHeaderForCellc C r� )Nc S r9 r� r: rt r& r& r' rv S r z,Utilities.rowHeaderForCell.<locals>.<lambda>)r_ r. r� rz r� r r� r )r$ r3 r� r^ r� r} �rowIndexr& r& r' �rowHeaderForCellO r� zUtilities.rowHeaderForCellc C sx t jt jt jt jt jg}|r|�� |v sdS dd� }t �||�}z|�� }W n Y dS | � |�}|� |�|� |�fS )Nr1 c S r9 r� r: rt r& r& r' rv g r z.Utilities.coordinatesForCell.<locals>.<lambda>) r. r� r� r� r� r� r_ rz r� r r� r� )r$ r3 �preferAttributer� r� r^ r� r} r& r& r' r� ^ s � z Utilities.coordinatesForCellc C s| |r |� � tjks dS dd� }t�||�}z|�� }W n Y dS | �|�}|�|�|�|�}}|�||�|� ||�fS )Nr1 c S r9 r� r: rt r& r& r' rv u r z,Utilities.rowAndColumnSpan.<locals>.<lambda>) r_ r. r� rz r� r r� r� r� r� )r$ r3 r� r^ r� r} r� r� r& r& r' �rowAndColumnSpanq s zUtilities.rowAndColumnSpanc C s& z|� � }W n Y dS |j|jfS )Nr1 )r� r� r )r$ r3 r� r� r& r& r' rC � s zUtilities.rowAndColumnCountc C r� r� r& r� r& r& r' �_objectBoundsMightBeBogus� r� z#Utilities._objectBoundsMightBeBogusc C r� r� r& r� r& r& r' �_objectMightBeBogus� r� z Utilities._objectMightBeBogusr� c C s� | � |�r| �||||�dkrdS | �|�rdS z|�� }W n Y dS |d u r,tj}|�|||�r5dS || || }}|�|||�rXd|||||f } t�tj | d� dS dS )N�r r r FTz&INFO: %s contains (%i,%i); not (%i,%i)) r� � textAtPointr� r@ r. rB r- r r+ r, ) r$ r3 ru rC r� �marginr� r� r� r5 r& r& r' � containsPoint� s& zUtilities.containsPointc C s. |sdS | � |�r dS tjtjg}|�� |vS r� )r� r. r r� r_ )r$ r3 r� r& r& r' r� � s � z Utilities._boundsIncludeChildrenc C r� r� r& r� r& r& r' � treatAsEntry� r� zUtilities.treatAsEntryc C s� |r| � |�r dS |jsdS |�� }tjtjg}||v r dS |tjkr/t�|dd� �}|d u S |tjkr9|j r9dS |� � }|� tj �rJ|� tj � S tjtjg}||v S )NFTc S r rr )r_ r. r rt r& r& r' rv � r z,Utilities._treatAsLeafNode.<locals>.<lambda>)r r� r_ r. r r� r� rK r+ r� r* r- �STATE_EXPANDABLEr� r� r� )r$ r3 rc r� rh r4 r& r& r' �_treatAsLeafNode� s, � �zUtilities._treatAsLeafNodec C sr | � |�rd S z|�� }W n d| }t�tj|d� Y d S |�|||�}d||||f }t�tj|d� |S )Nz(INFO: Exception querying component of %sTz(INFO: %s is descendant of %s at (%i, %i))r3 r@ r r+ r, �getAccessibleAtPoint)r$ r� ru rC r� r� r5 r� r& r& r' �accessibleAtPoint� s zUtilities.accessibleAtPointc C sb |sd S | � |�s d S |d u rtj}| �||||�r'| �|�s$| �|�s&|S n | �|�s1| �|�r3d S dt�|�v rV| �||||�}|rV||krV| �||||�}|rT|S |S g }g }|D ]>}| �||||�} | rl| S | �||||�suq\| � |�r�|� � � dd�} t � d| �r�|�|� |�� �tj�r�|�|� q\t|�dkr�|d S t|�dkr�|d S d S )Nr� r r� u [^\s]r )r� r. rB r� r� r� r� r� �descendantAtPointr� r� r� r\ r� r� r* r- r1 rT ) r$ r� ru rC r� rI r� �candidates_showingrZ r3 r� r& r& r' r� � sN � � zUtilities.descendantAtPointc C s ||fS rr r& )r$ r3 ru rC r� r& r& r' �_adjustPointForObj r� z Utilities._adjustPointForObjc C sR |sdS dt �|�vr dS |�� }|�dd�}ttdd� |�d���}t|�dkS ) NFr� r r� c S s | � � S rr r rt r& r& r' rv rV z2Utilities.isMultiParagraphObject.<locals>.<lambda>z r )r. r� r� r� rQ r� ri rT )r$ r3 r� r� �chunksr& r& r' �isMultiParagraphObject s z Utilities.isMultiParagraphObjectc C s� z |� � }|d u r |j}W n Y dS | �||�\}}}| jj�dd�\}}||kr0|||fS | �||�\} } } | jj�d�dkrr| �� rK|}|}n| �� rS|}|}|�||�}d||� dd�||f } t � t j | d � |||fS | �� r�|}|d � � s�|d �� s�|d 8 }n,| �� r�|}|| kr�| | k r�| kr�n n| }|�|d |�} | � � s�| �� s�|d }|�||�}d|v r�|| kr�|�d�r�|d 7 }n |�d�r�|d 8 }|�||�}|�||�}d ||� dd�||f } t � t j | d � |||fS ) Nr� �penultimateCursorPositionr2 �lastTextUnitSpokenr� zEINFO: Adjusted word at offset %i for ongoing word nav is '%s' (%i-%i)r� �\nTr� r zAINFO: Adjusted word at offset %i for new word nav is '%s' (%i-%i))r� r� �getWordAtOffsetr! r� rx � lastInputEventWasPrevWordNav� lastInputEventWasNextWordNavr� r< r r+ r, �isspacerm rn rP )r$ r3 r� r� r� r4 r� r � prevOffset�prevWord� prevStart�prevEndr5 r� r& r& r' �$getWordAtOffsetAdjustedForNavigation# sd � � � � z.Utilities.getWordAtOffsetAdjustedForNavigationc C sn z |� � }|d u r |j}W n Y dS |�|tj�\}}}d||�dd�||f }t�tj|d� |||fS )Nr� z INFO: Word at %i is '%s' (%i-%i)r� r� T) r� r� �getTextAtOffsetr. �TEXT_BOUNDARY_WORD_STARTr< r r+ r, )r$ r3 r� r� r� r4 r� r5 r& r& r' r� o s � zUtilities.getWordAtOffsetc C sD | � |�}|s dS |d u rtj}|d u rtj}| �||||�\}}|�|||�}d| kr4|jk s7dS dS |�||�\}} } |sGd| | fS |tjkrR|� � sRdS |� | | |�} | � | ||ddf�si|dkridS |� d�rr|dkrw|| | fS |tj kr�|| | fS | �||||tj �} | d dkr�| d | d dkr�| S || | fS )Nr� r r r r� r� )r� r. rB �TEXT_BOUNDARY_LINE_STARTr� �getOffsetAtPointr� r� r� r� r� r� rP �TEXT_BOUNDARY_CHARr� ) r$ r3 ru rC r� �boundaryr� r� r� r4 r� r� r r& r& r' r� | s: � zUtilities.textAtPointc C sv z |� � }|j}W n g Y S d||f }t�tj|d� |\}}}} | �|||d �} | �| �\} } td| �} d| | f }t�tj|d� z | �� � t j �}W n | }Y n&| �||||j d �} | �| �\} } t| | �}d| | f }t�tj|d� | �|||| d �} | �| �\} } d| | f }t�tj|d� | dkr�|} | }t t||��}| |vr�|�d| � |S ) NzINFO: %s has %i rowsTr r z INFO: First cell: %s (row: %i)z INFO: Next cell: %s (row: %i)z INFO: Last cell: %s (row: %i)r� )r� r� r r+ r, r� r� r� r@ rA r. rB rE rQ r� �insert)r$ r3 r� r� r� r5 ru rC rD rE r� r� r� rv r� � nextIndexrw rD r& r& r' � visibleRows� sB zUtilities.visibleRowsc C s� z|� � }W n g Y S z |�� }|�tj�}W n d| }t�tj|d� g Y S | �||�}|s8g S | � |�\}}||krEg S g } t ||�D ]-} |� | �} | rZ| � | � |D ] } z|� | | �} W n Y q\| rx| �| �rx| � | � q\qL| S )Nr� T)r� r@ rA r. rB r r+ r, r� �_getTableRowRanger� r r� r� r� )r$ r3 r� r� r� r5 rD � colStartIndex� colEndIndex�cellsr� � colHeaderr� r� r& r& r' r� � s@ ��z Utilities.getVisibleTableCellsc C s� | � |�\}}d|}}| �|�s||fS | �|�}z|�� }W n d| }t�tj|d� ||f Y S |�tj �\} } } } |� | d | tj �} | rU| � | �\}}|}|� | | d | tj �} | rn| � | �\}}|d }||fS )Nr z3ERROR: Exception querying component interface of %sTr ) rC r� r� r@ r r+ r, rA r. rB r� r� )r$ r3 �rowCount� columnCountrv rw r^ r� r5 ru rC rD rE r� r� r� r& r& r' r� � s* zUtilities._getTableRowRangec C s� | � |�}z|�� }W n d| }t�tj|d� g Y S | �|d�\}}|dkr-g S |r6d|j}} n| �|�\}} || krCg S g } t|| �D ] } |� || �} z | � � � t j �} W n Y qJ| ri| �| � qJ| S )Nr� TFr� r )r� r� r r+ r, r� r r� r� r� r* r- r. r1 r� )r$ r3 � forceFullRowr^ r� r5 r� r� rv rw r� r� r� �showingr& r& r' �getShowingCellsInSameRow s4 �z"Utilities.getShowingCellsInSameRowc C sv z|� � }W n Y d S |�||�}|s|S z|�� }W n d| }t�tj|d� Y d S |� �tj�s9d S |S )Nr) T) r� r� r* r r+ r, r- r. r1 ) r$ r3 r� r� � showingOnlyr� r� r4 r5 r& r& r' �cellForCoordinates/ s z Utilities.cellForCoordinatesc C s� z|� � }W n d| }t�tj|d� Y dS |tjks dS dd� }t�||�}z|�� }W n Y dS | �|�}|� |�|� |�}} |d |j koT| d |j kS )Nr TFc S r9 r� r: rt r& r& r' rv P r z&Utilities.isLastCell.<locals>.<lambda>r ) r_ r r+ r, r. r� rz r� r r� r� r� r ) r$ r3 rc r5 r� r^ r� r} r� r� r& r& r' � isLastCellE s" zUtilities.isLastCellc C sf z|� � }W n Y dS t|j�D ] }t|j�D ]}|�||�dks+|�||�dkr/ dS qqdS )NFr T)r� r� r� r r� r� )r$ r3 r� r� r� r& r& r' �isNonUniformTable[ s ��zUtilities.isNonUniformTablec C sj z|� � }W n d| }t�tj|d� Y dS |�tj�s%|�tj�r'dS d| }t�tj|d� dS )Nr) TFz'INFO: %s is neither showing nor visible)r* r r+ r, r- r. r1 � STATE_VISIBLEr2 r& r& r' �isShowingOrVisiblei s �z Utilities.isShowingOrVisiblec C s� z |� � }|�� }W n d| }t�tj|d� Y dS |�tj�r+|�tj�r+dS tj tj tj tj tj g}||v rN| �|�rNd| }t�tj|d� dS dS )Nz-ERROR: Exception getting state and role of %sTFz(HACK: Treating %s as showing and visible)r* r_ r r+ r, r- r. r1 r� r r rW rX r r� )r$ r3 r4 rc r5 rY r& r& r' r� y s, ��z Utilities.isShowingAndVisiblec C s. z|j }W dS t�tjd| d� Y dS )NzDEAD: %sTF)r� r r+ r, )r$ r3 r� r& r& r' r � s �zUtilities.isDeadc C s� z|� � }|�� }|�� }W n t�tjd| d� Y dS tjtjtj tj tj tj tj tjg}|dkrE||vrEt�tjd| d� dS |�tj�rWt�tjd| d� dS |�tj�rit�tjd| d� dS dS )NzZOMBIE: %s is null or deadTr� zZOMBIE: %s's index is -1zZOMBIE: %s is defunctzZOMBIE: %s is invalidF)r{ r* r_ r r+ r, r. r� r� r� r� r� � ROLE_PAGEr� r� r- r� � STATE_INVALID)r$ r3 r} r4 rc r& r& r& r' r � s4 � zUtilities.isZombiec s� d� |f }t �t j|d� |r� sd S |�� tjtjfv r d S � �fdd�}||�r.|}nzt�||�}W n d| }t �t j|d� d }Y d|� f }t �t j|d� |S )Nz*INFO: Searching for replicant for %s in %sTc s | o �j | � ddd�S )NT)rF rG )r� rt �r3 r$ r& r' rv � s �z)Utilities.findReplicant.<locals>.<lambda>z*INFO: Exception from findDescendant for %sz-HACK: Returning %s as replicant for Zombie %s)r r+ r, r_ r. r� � ROLE_EMBEDDEDrK )r$ r� r3 r5 �isSame� replicantr& r� r' � findReplicant� s$ zUtilities.findReplicantc C s< |sd S g }dd� }t t||�� ��}|r|d �� S |jS )Nc S r� rr �r� r. r� rN r& r& r' rv � r� z3Utilities.getFunctionalChildCount.<locals>.<lambda>r )rQ r� r� r� r� �r$ r3 r� rZ r� r& r& r' �getFunctionalChildCount� s z!Utilities.getFunctionalChildCountc s^ |sd S g }dd� }t t||�� ��}|r&|d � � fdd�t� �� �D �}|p.dd� |D �S )Nc S r� rr r� rN r& r& r' rv � r� z1Utilities.getFunctionalChildren.<locals>.<lambda>r c rO r& rP rQ rN r& r' rK � rR z3Utilities.getFunctionalChildren.<locals>.<listcomp>c S r� r& r& rG r& r& r' rK � r� )rQ r� r� r� r� r� r& rN r' �getFunctionalChildren� s z Utilities.getFunctionalChildrenc C sB |sd S d }dd� }t t||�� ��}|r |d �d�}|p |jS )Nc S r� rr )r� r. r� rN r& r& r' rv � r� z/Utilities.getFunctionalParent.<locals>.<lambda>r )rQ r� r� r� r^ r� r& r& r' �getFunctionalParent� s z Utilities.getFunctionalParentc sr |sdS |� � tjkr%|�d�r%��|�\}}����|��\}}||fS |� � tjk}|rP��|�}|r:|d }ndd� } ��t� || ��}|rN|d }ndS �� |�} �� | �} | dkri| |j kri|� � | fS ��| �} t| �dk r�tj�||�s�tjtjg� � �fdd�} tt| | ��} | r�|| v s�dS ��|�r�tt�j| ��} t| �dkr�dS | �|�}t| �}||fS ) Nr1 � readingRowr c S r rr )r_ r. r r rt r& r& r' rv rl z1Utilities.getPositionAndSetSize.<locals>.<lambda>r� c s �� | �p | �� � v S rr )r r_ rt �� layoutRolesr$ r& r' rv rl r )r_ r. r� rx r� rC r� r� r� rK r� r� r^ r{ r� rT r7 rz r r rQ r� r r} )r$ r3 �argsr� r� �rowcount�colcountrg r� �isMenur^ r� �siblings�isNotLayoutOnly�position�setSizer& r� r' �getPositionAndSetSize� sD z Utilities.getPositionAndSetSizec C r� r r& )r$ r3 � isBrailler& r& r' �getRoleDescription+ r� z Utilities.getRoleDescriptionc C sP | j j�di �}|�t|�d�\}}}d||||f }t�tj|d� |||fS )N�textSelections�r r r z.INFO: Cached selection for %s is '%s' (%i, %i)T)r! r� rx r� r r+ r, )r$ r3 r� r4 r� r� r5 r& r& r' �getCachedTextSelection. s z Utilities.getCachedTextSelectionc s� z|� � }W n( ty d| }t�tj|d� d }Y n d| }t�tj|d� d }Y | jj�d�rL| �|�\}}}|sLd| jjd< i | jjd< | jj�di �� t |�� v ru� � t |���� �fdd�� � � D �D ]}� � |� qmd \}} } |r�z |� d �\}} W n d | }t�tj|d� d }} Y || kr�|� || �} d || || f }t�tj|d� || | f� t |�< � | jjd< d S ) Nz%ERROR: %s doesn't implement AtspiTextTz/ERROR: Exception querying text interface for %sr Fr� c s g | ] }� � |��kr|�qS r& )rx )rH �k�r� r� r& r' rK M r� z7Utilities.updateCachedTextSelection.<locals>.<listcomp>r� r z-ERROR: Exception getting selected text for %sz+INFO: New selection for %s is '%s' (%i, %i))r� r� r r+ r, r! r� rx r r� �popr r� r� ) r$ r3 r� r5 r � selectedStart� selectedEndru r4 r� r� r& r� r' �updateCachedTextSelection5 sD z#Utilities.updateCachedTextSelectionc G sP t j}|sd S t�� tj dk r d}t�tj|d� d S t�� t_|j| � d S )Ng�������?zEINFO: Clipboard contents change notification believed to be duplicateT) r r� r� r �_last_clipboard_updater r+ r, �onClipboardContentsChanged)r� r% r5 r& r& r' r� b s z$Utilities.onClipboardContentsChangedc C s8 | j d urd S tj�tj�dd��}|�d| j�| _ d S )N� CLIPBOARDFz owner-change) r" r � Clipboardrx r �Atom�intern�connectr� �r$ � clipboardr& r& r' �connectToClipboardp s �z Utilities.connectToClipboardc C s4 | j d u rd S tj�tj�dd��}|�| j � d S �Nr� F)r" r r� rx r r� r� � disconnectr� r& r& r' �disconnectFromClipboardx s z!Utilities.disconnectFromClipboardc C s t j�tj�dd��}|�� S r� )r r� rx r r� r� � wait_for_textr� r& r& r' �getClipboardContents s z Utilities.getClipboardContentsc C s& t j�tj�dd��}|�|d� d S )Nr� Fr� )r r� rx r r� r� �set_text�r$ r� r� r& r& r' �setClipboardText� s zUtilities.setClipboardTextc C s( t j�tj�dd��}|�| j|� d S r� )r r� rx r r� r� � request_text� _appendTextToClipboardCallbackr� r& r& r' �appendTextToClipboard� s z Utilities.appendTextToClipboardr� c C s( |� d�}d|||f }|�|d� d S )Nr� z%s%s%sr� )�rstripr� )r$ r� r� r� � separatorr& r& r' r � s z(Utilities._appendTextToClipboardCallbackc C s* t tjtj�s dS tj}|o|�| jj�S r� ) r\ r r� r r� r� �isFromApplicationr! r= r r& r& r' � lastInputEventCameFromThisApp� s z'Utilities.lastInputEventCameFromThisAppc C s t j}t|tj�s dS |�� S r� )r r� r\ r r� �isPrintableKeyr r& r& r' r� � s z'Utilities.lastInputEventWasPrintableKeyc C s | � � \}}|tj@ S rr �r� r �CTRL_MODIFIER_MASK�r$ � keyStringr� r& r& r' �lastInputEventWasCommand� s z"Utilities.lastInputEventWasCommandc C s4 | � � \}}|�� r|tj@ S |dv r|tj@ S dS �N)r� r� F)r� r� r �ALT_MODIFIER_MASKr r r& r& r' �lastInputEventWasPageSwitch� s z%Utilities.lastInputEventWasPageSwitchc C sH | � � \}}|dvr dS |tj@ s |tj@ s |tj@ s |tj@ r"dS dS )N)�Left�Rightr� r� FT)r� r r �SHIFT_MODIFIER_MASKr �ORCA_MODIFIER_MASKr r& r& r' � lastInputEventWasUnmodifiedArrow� s ���z*Utilities.lastInputEventWasUnmodifiedArrowc C s | � � p| �� p| �� p| �� S rr )�lastInputEventWasCharNav�lastInputEventWasWordNav�lastInputEventWasLineNav� lastInputEventWasLineBoundaryNavrJ r& r& r' �lastInputEventWasCaretNav� s ���z#Utilities.lastInputEventWasCaretNavc C �$ | � � \}}|dvr dS |tj@ S �N)r r Fr r r& r& r' r � � z"Utilities.lastInputEventWasCharNavc C �" | � � \}}|dvr dS |tj@ S r r r r& r& r' r � � z"Utilities.lastInputEventWasWordNavc C �" | � � \}}|dks dS |tj@ S )Nr Fr r r& r& r' r� � r z&Utilities.lastInputEventWasPrevWordNavc C r )Nr Fr r r& r& r' r� � r z&Utilities.lastInputEventWasNextWordNavc C �4 | � � \}}|dvr dS | �tj�rdS |tj@ S )N)r� r� F�r� r� r r� r r r r& r& r' r � � z"Utilities.lastInputEventWasLineNavc C r �N)�Home�EndFr r r& r& r' r � r z*Utilities.lastInputEventWasLineBoundaryNavc C r r r! r r& r& r' �lastInputEventWasPageNav� r" z"Utilities.lastInputEventWasPageNavc C r r# r r r& r& r' � lastInputEventWasFileBoundaryNav� r z*Utilities.lastInputEventWasFileBoundaryNavc C s" | � � \}}|tj@ r|dv S dS )N)r$ r% r� r� r r F)r� r r r r& r& r' �&lastInputEventWasCaretNavWithSelection� s z0Utilities.lastInputEventWasCaretNavWithSelectionc C �< | � � \}}| �|�}d|vrdS |tj@ r |tj@ S dS �N�zF�r� r� r r r �r$ r� r� r r& r& r' �lastInputEventWasUndo � z Utilities.lastInputEventWasUndoc C s: | � � \}}| �|�}d|vrdS |tj@ r|tj@ S dS r* r, r- r& r& r' �lastInputEventWasRedo s z Utilities.lastInputEventWasRedoc C r) )Nru Fr, r- r& r& r' �lastInputEventWasCut r/ z Utilities.lastInputEventWasCutc C r) )Nr� Fr, r- r& r& r' �lastInputEventWasCopy% r/ z Utilities.lastInputEventWasCopyc C r) )N�vFr, r- r& r& r' �lastInputEventWasPaste0 r/ z Utilities.lastInputEventWasPastec C r) )Nr� Fr, r- r& r& r' �lastInputEventWasSelectAll; r/ z$Utilities.lastInputEventWasSelectAllc C sD | � � \}}|dkr dS | �� \}}| �|�}d|vr dS |tj@ S )Nr� Tr� F)r� r� r� r r )r$ r r� r� r r& r& r' �lastInputEventWasDeleteF s z!Utilities.lastInputEventWasDeletec C s> | � � \}}|dvr dS |tj@ s|tj@ s|tj@ r dS dS )N)r� � ISO_Left_TabFT)r� r r r r r r& r& r' �lastInputEventWasTabR s ��z Utilities.lastInputEventWasTabc C s t tjtj�S rr )r\ r r� r �MouseButtonEventrJ r& r& r' � lastInputEventWasMouseButton^ rf z&Utilities.lastInputEventWasMouseButtonc C �& t j}t|tj�r|jdko|jS dS �N�1F�r r� r\ r r9 �button�pressedr r& r& r' �"lastInputEventWasPrimaryMouseClicka � z,Utilities.lastInputEventWasPrimaryMouseClickc C r; �N�2Fr> r r& r& r' �!lastInputEventWasMiddleMouseClickh rB z+Utilities.lastInputEventWasMiddleMouseClickc C r; �N�3Fr> r r& r& r' �$lastInputEventWasSecondaryMouseClicko rB z.Utilities.lastInputEventWasSecondaryMouseClickc C �( t j}t|tj�r|jdko|j S dS r< r> r r& r& r' �$lastInputEventWasPrimaryMouseReleasev � z.Utilities.lastInputEventWasPrimaryMouseReleasec C rI rC r> r r& r& r' �#lastInputEventWasMiddleMouseRelease} rK z-Utilities.lastInputEventWasMiddleMouseReleasec C rI rF r> r r& r& r' �&lastInputEventWasSecondaryMouseRelease� rK z0Utilities.lastInputEventWasSecondaryMouseRelease� �?c C s� t j}|sdS t�� }||j |krdS | jj�dd�}|| |k r$dS t|tj�r1| � � s0dS nt|tj �rJ|� | jj �sJ| � � \}}|dvrJdS zt j�� }W n dt j }t�tj|d� Y dS tjtjtjtjg} || v S )NFzlast-table-sort-timer )r� �spacer8 r* T)r r� r� r! r� rx r\ r r9 rJ r� � isHandledBy�leftClickReviewItemr� r� r_ r r+ r, r. r� r� r� r� ) r$ r� r �now� lastSortTimer r� rc r5 r� r& r& r' �lastInputEventWasTableSort� s< � �z$Utilities.lastInputEventWasTableSortc C s� | � |jtj�r dS z |j�� }|j�� }W n d|j }t�tj|d� Y dS |t j t j fv r4dS |t j kr?|� t j�S |t jkrJ|� t j�S dS )NT�-ERROR: Exception getting role and state of %sF)r� r r r� r_ r* r r+ r, r. r� r r� r- r� r� �r$ r rc r4 r5 r& r& r' �!isPresentableExpandedChangedEvent� s z+Utilities.isPresentableExpandedChangedEventc C s@ |j �d�s|j �d�sdS z |j�� }|j�� }W n d|j }t�tj|d� Y dS tj tj tj tj tj g}||v rJd}t�tj|d� dS |tjkrg|�tj�sg|�tj�sgd}t�tj|d� dS | �|j�rs|�tj�S |tjkr�|�tj�r�dS tj|j|jjfv r�dS | �tj�r�dS d}t�tj|d� dS ) Nzobject:text-changed:z object:text-attributes-changedFrU Tz.INFO: Event is not being presented due to rolez9INFO: Event is not being presented due to role and statesz7INFO: Event is not being presented due to lack of cause)r� rn r r_ r* r r+ r, r. r� r r � ROLE_SLIDERr� r� r- r� r� r" r r r� r^ r )r$ r rc r4 r5 � ignoreRolesr& r& r' �,isPresentableTextChangedEventForLocusOfFocus� sP � � � � z6Utilities.isPresentableTextChangedEventForLocusOfFocusc C s< |j �d�sdS | �|j�rdS | �� \}}|dkr dS dS )N�object:text-changed:deleteFr� T)r� rn r3 r r� )r$ r r r� r& r& r' �#isBackSpaceCommandTextDeletionEvent� s z-Utilities.isBackSpaceCommandTextDeletionEventc C � |j �d�sdS | �� S �Nr[ F)r� rn r6 r r& r& r' � isDeleteCommandTextDeletionEvent � z*Utilities.isDeleteCommandTextDeletionEventc C s4 |j �d�sdS | �� sdS | �|j�\}}}| S r^ )r� rn r. r� r �r$ r r4 r� r� r& r& r' � isUndoCommandTextDeletionEvent s z(Utilities.isUndoCommandTextDeletionEventc C sD |j �d�sdS | �� rdS | �|j�\}}}|o!|�� |j�� kS r^ )r� rn r4 r� r r� r0 ra r& r& r' �isSelectedTextDeletionEvent s z%Utilities.isSelectedTextDeletionEventc C sF |j �d�sdS | �|j� | �|j�\}}}|o"||jko"||jkS �Nr� F)r� rn r� r r� r0 r� ra r& r& r' � isSelectedTextInsertionEvent s z&Utilities.isSelectedTextInsertionEventc C s | � � sdS | �|�r dS dS r� )r. re r r& r& r' �isSelectedTextRestoredEvent# s z%Utilities.isSelectedTextRestoredEventc C r] rd )r� rn rE r r& r& r' �%isMiddleMouseButtonTextInsertionEvent, r` z/Utilities.isMiddleMouseButtonTextInsertionEventc C s� |j �d�sdS z |j�� }|j�� }W n d|j }t�tj|d� Y dS |�t j �rF|�t j �sF|jt j krFd}t�tj|d� dS |t jkrPt�d�S t|j�� �dkr^t�d�S dS ) Nr� FrU TzHINFO: Not echoable text insertion event: focusable source is not focused� enableKeyEchor rh )r� rn r r_ r* r r+ r, r- r. r� r� r r� r r� r� rT r0 r� rV r& r& r' � isEchoableTextInsertionEvent2 s& z&Utilities.isEchoableTextInsertionEventc C sL | � |�sdS z|�� }W n d| }t�tj|d� Y dS |�tj�S )NFr) T)r- r* r r+ r, r- r. r. r2 r& r& r' rc L s z Utilities.isEditableTextAreac C s� |j �d�sdS | �� r| �� rdS | �|�rdS d|j v r$| �� r$dS | �|j�s,dS | �� }|s4dS |j |kr;dS t t � d|j ��t t � d|��krNdS d|v r[|j � � |v r[dS dS )Nzobject:text-changedF�deleteTz\wr� )r� rn r r. r\ r4 rc r r� r0 r� r\ r� r )r$ r �contentsr& r& r' �isClipboardTextChangedEventY s( "z%Utilities.isClipboardTextChangedEventc C sv |pt j}|r | �|�rdS | �� }|sdS | �|�\}}}|r&||v r&dS | �|�p,|}| �|�r4dS |o:|j|v S r� )r r� r r� r r� r� )r$ r3 rk r� r4 r� r& r& r' � objectContentsAreInClipboardy s z&Utilities.objectContentsAreInClipboardc C s4 d| j jd< d| j jd< d| j jd< d| j jd< d S )NF�undo�redo�paster �last-selection-message)r! r� rJ r& r& r' �clearCachedCommandState� s z!Utilities.clearCachedCommandStatec C s� | � � r | jj�d�s| j�tj� d| jjd< | �|j� dS | � � r@| jj�d�s8| j�tj � d| jjd< | �|j� dS dS )Nrn Tro F) r. r! r� rx �presentMessager �UNDOr� r r0 �REDOr r& r& r' �handleUndoTextEvent� s z Utilities.handleUndoTextEventc C sx | � � rdS | �� r | jj�d�s | j�tj� d| jjd< dS | �� r:| jj�d�s8| j�tj � d| jjd< dS dS )NFrn Tro ) r� r. r! r� rx rs r rt r0 ru rJ r& r& r' � handleUndoLocusOfFocusChange� s z&Utilities.handleUndoLocusOfFocusChangec C sH | � � rdS | �� r"| jj�d�s | j�tjtj� d| jjd< dS dS )NFrp T) r� r4 r! r� rx rs r �CLIPBOARD_PASTED_FULL�CLIPBOARD_PASTED_BRIEFrJ r& r& r' � handlePasteLocusOfFocusChange� s � z'Utilities.handlePasteLocusOfFocusChangec C sx t jsd}t�tj|d� dS t�� t jj }|dkr)d| }t�tj|d� dS | �|�r:d}t�tj|d� dS dS )Nz.INFO: Not user triggered: No last input event.TFr z5INFO: Not user triggered: Last input event %.2fs ago.zCINFO: Last key was consumed. Probably a bogus event from a key grab)r r� r r+ r, r� �isKeyGrabEvent)r$ r r5 r� r& r& r' �eventIsUserTriggered� s z Utilities.eventIsUserTriggeredc C s$ t tjtj�s dS tj�� otj S )zT Returns True if this event appears to be a side-effect of an X11 key grab. F)r\ r r� r r� � didConsume� openingDialogr r& r& r' r{ � s zUtilities.isKeyGrabEventc C s | � � rdS | �� r dS dS r )rw rz rJ r& r& r' �presentFocusChangeReason� s z"Utilities.presentFocusChangeReasonc C s t �|�}d|vr dS |�� }|�t j�r |�t j�s dS |�� }|t jt jfv r+dS |� � }|j s4dS | � |�|j krV|� d�}||vrGdS d|j }t�tj|d� dS d|vr\dS |�� }|j|jkrud|j }t�tj|d� dS |j|jkr�d|j }t�tj|d� dS dS ) Nr� Fr z-INFO: All %i children believed to be selectedTr� z)INFO: All %i rows believed to be selectedz,INFO: All %i columns believed to be selected)r. r� r* r- r� r� r_ r� r r6 r7 rH r� r8 r r+ r, r� rG r� �nSelectedColumnsr ) r$ r3 r� r4 rc r rI r5 r� r& r& r' �allItemsSelected� sB � zUtilities.allItemsSelectedc C s` | j j�d�}| �|�}|r|rdS || j jd< | �� r.|r.| j �tj� t� d |d� dS dS )Nr� TF) r! r� rx r� r5 rs r �CONTAINER_SELECTED_ALLr r5 )r$ r3 �allAlreadySelected�allCurrentlySelectedr& r& r' � handleContainerSelectionChange s z(Utilities.handleContainerSelectionChangec C s� z |� � }|j}W n d| }t�tj|d� Y d S |�� s"d S |�d�\}}|�||�}|s3d S |r=|�| j �s=|S |sG|� | j �sG|S t t |��} |sS| � � | D ]} | �|| |�} | re| S qUd S )Nz<ERROR: Exception querying text and getting childCount for %sTr )r� r� r r+ r, r� r� r� rn r� rP rQ r� r� � _findSelectionBoundaryObject) r$ r� � findStartr� r� r5 r4 r� r� �indicesr� r� r& r& r' r� s4 �z&Utilities._findSelectionBoundaryObjectc C s | � |d�}| � |d�}||fS r )r� )r$ r� r; r< r& r& r' �_getSelectionAnchorAndFocus@ s z%Utilities._getSelectionAnchorAndFocusc C s |r|sg S dd� }| j }g }t|�� |jj�D ]"}|j| }| � |�r%q|�|� |�| �|||�� ||v r: nq||krA|S ||vrT|�|� |�| �|||�� z |j|�� d }W n |}Y z|�|�} W n t yw Y |S w ||kr�| d7 } |d | � }|S )Nc S s | S rr r& rt r& r& r' rv K s z'Utilities._getSubtree.<locals>.<lambda>r ) r� r� r{ r^ r� r� rP r� r} r: ) r$ �startObj�endObjr� r� �subtreer� rI �lastObjrw r& r& r' � _getSubtreeG sB � � zUtilities._getSubtreec C s" |r dt �|�v s dS | �|�\}}}| �|� | �|�\}}}| �t|��r)dS | �� s:|r:|s:| j�t j � dS g } t t ||��} t t ||��} | � | �sQdS | rm| rm| �| �sm| �||t jg� | �||t jg� nYt| �| ��} | sxdS | d | d d } }| | k r�| �| |t jg� |�| j�r�|| kr�| �||d �}| �|d� n | �| |t jg� |�| j�r�| �||d �}| �|d� |o�t�d� }|�� }| D ]:\}}}|�||�}|�| j�}|r�|d8 }| j� |||� |r�|s�| jj|dd� |�r| �||�}| �||� q�dS ) Nr� FTr r� r r� )� interrupt) r. r� r� r� �_speakTextSelectionStaterT r( r! � speakMessager �SELECTION_REMOVEDrX r� �unionr� r� �TEXT_UNSELECTED� TEXT_SELECTEDrU �symmetric_differencerP r� r �handleTextSelectionChanger� r� r� r� � sayPhrase)r$ r3 r� �oldStart�oldEnd� oldString�newStart�newEndr� �changes�oldChars�newChars�change� changeStart� changeEndrI r� r4 r� �messager� � endsWithChildr& r& r' r� o s^ � �z#Utilities.handleTextSelectionChangec C r� )�!Hacky and to-be-obsoleted method.)r �PARAGRAPH_SELECTED_DOWN�PARAGRAPH_UNSELECTED_DOWN�PARAGRAPH_SELECTED_UP�PARAGRAPH_UNSELECTED_UPrJ r& r& r' � _getCtrlShiftSelectionsStrings� s �z(Utilities._getCtrlShiftSelectionsStringsc C s� t �d�rdS | �� \}}|tj@ }|tj@ }|dk}d}|dkr)|r)|r)tj}n�|dkr5|r5|r5tj}n�|dkrG|rG|sG|rCtj }n�tj }n|dkrY|rY|sY|rUtj }nqtj }nm|dkrq|rq|rq| � � }|rl|d }nZ|d }nU|d kr�|r�|r�| � � }|r�|d }nB|d }n=|d kr�|r�|r�|r�tj}n/tj}n+|d kr�|r�|r�|r�tj}n tj}n| �� r�|r�| jj�d�s�d| jjd< tj}ndS |s�dS || jj�d�kr�|| jjd< | j�|� dS )r� r� Fr Nr� r� r� r r� r� r� r$ r% r Trq )r� r� r� r r r r �LINE_SELECTED_RIGHT�LINE_SELECTED_LEFT�PAGE_SELECTED_DOWN�PAGE_UNSELECTED_DOWN�PAGE_SELECTED_UP�PAGE_UNSELECTED_UPr� �DOCUMENT_SELECTED_UP�DOCUMENT_UNSELECTED_UP�DOCUMENT_SELECTED_DOWNr5 r! r� rx �DOCUMENT_SELECTED_ALLr� ) r$ r r� r� � isControlKey� isShiftKeyr rv �stringsr& r& r' r� � s` z"Utilities._speakTextSelectionState)F)Trr )FF)r rI )Tr� )r r� r� )r8 )TT)r T)Nr� F)r� )r� )rN (� �__name__� __module__� __qualname__r. �Registry� getDesktoprL r� r� r� �ZERO_WIDTH_NO_BREAK_SPACEr� r� r\ �UNICODE�flagsrn r� r� r� r� r� r� r� r� r r} r r( r6 � staticmethodr@ rD r[ rd rq r r� r� r� r r� r� r� r� r r r� r� r� r r r r r r r r r r r r! r" r' r( r) r* r+ r, r- r. r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU rV rW rX rY rZ r[ r\ r] r^ r_ r` ra rb rc rd re rf rg rh ri rj rk rl rm rn ro rp rq rr rs rt ru rv rw rx ry r{ r| r} r~ r r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� rs r� r� r� r� r� r� r� r� r� r r r r r r) r, r0 r1 r6 r? r� r- rO r� rb r[ r{ r r r� r� r� r� r� r� r� r! r� r� r� r� r� r� r r� r� r� r� r� rX r� r� r� r� r� r� r� r� r� rp r r r r r r r r r r r r( r* r, r- r. r� r1 r2 r r� r4 r7 r6 r r; r< rB r& r] rb rc r^ rl r~ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r rC r! r$ r& r' r, r. r0 r2 r� rA rF rH rJ rM rQ rT rV rZ r\ r] r[ r^ ra rb rd re r� ri rj rl rm rW ru rv r� rw rx ry rz r| r� r� r� r� r� r� r� r� rC r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r� r r r r r r r� r� r r r& r' r( r. r0 r1 r2 r4 r5 r6 r8 r: rA rE rH rJ rL rM rT rW rZ r\ r_ rb rc re rf rg ri rc rl rm rr rv rw rz r| r{ r r� r� r� r� r� r� r� r� r& r& r& r' r B s� �� # &E6! 7 ) & " r & ; "6 6 V # ? ' ! # ( #% $ 5&& , @7* / L ',% -- $. -"(Fr )$�__doc__�__id__� __version__�__date__� __copyright__� __license__rV �girS r r. r\ r: r� r� r r r r r r r r r r r r r r r r r r � getManagerr� r r& r& r& r' �<module> sB
Close