Mini Shell
3
�p5[C� � @ s� d Z dZdZdZdZdZddlZddlZddlZddl Z ddl
Z
ddl m Z m
Z
d d
lmZ d d lmZ d d lmZ d d
lmZ d dlmZ d dlmZ ddd�ZdZej� ZG dd� d�ZdS )zASuperclass of classes used to generate presentations for objects.z$Id:$z $Revision:$z$Date:$zLCopyright (c) 2009 Sun Microsystems Inc.Copyright (c) 2015-2016 Igalia, S.L.ZLGPL� N)�Atspi�Atk� )�braille)�debug)�messages)�object_properties)�settings)�settings_manager� c C sN t j� \}}}|j}y
|j}W n tk
r6 d}Y nX tj|| �}|||fS )Nz <no args>)�sys�exc_info�__name__�args�KeyError� traceback� format_tb)Z
maxTBlevelZcla�excZtrbkZexcNameZexcArgsZexcTb� r � /usr/lib/python3.6/generator.py�_formatExceptionInfo, s
r Z _generatec @ s* e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!d>d?� Z"d@dA� Z#dBdC� Z$dDdE� Z%dFdG� Z&dHdI� Z'dJdK� Z(dLdM� Z)dNdO� Z*dPdQ� Z+dRdS� Z,dTdU� Z-dVdW� Z.dXdY� Z/dZd[� Z0d\d]� Z1d^d_� Z2d`da� Z3dbdc� Z4ddde� Z5dfdg� Z6dhdi� Z7djdk� Z8dldm� Z9dndo� Z:dpdq� Z;drds� Z<dtdu� Z=dvdw� Z>dxdy� Z?dzd{� Z@d|d}� ZAd�dd��ZBd�d�� ZCd�d�� ZDd�d�� ZEd�d�� ZFd~S )�� Generatorz�Takes accessible objects and generates a presentation for those
objects. See the generate method, which is the primary entry
point.c s� |� _ |� _i � _i � _xfdd� � fdd�dd� t� �D �D �D �D ]8}|jtt�d � }|d j� |dd � }|� j|< qDW � j � d S )Nc S s g | ]}t |tj�r|�qS r )�
isinstance� collections�Callable)�.0�zr r r �
<listcomp>Q s z&Generator.__init__.<locals>.<listcomp>c s g | ]}t � |�j� � j��qS r )�getattr�__get__� __class__)r �y)�selfr r r Q s c S s g | ]}|j t�r|�qS r )�
startswith�
METHOD_PREFIX)r �xr r r r Q s r r )
�_mode�_script�_activeProgressBars� _methodsDict�dirr �lenr$ �lower�_verifyFormatting)r" Zscript�mode�method�namer )r" r �__init__H s .zGenerator.__init__c C s d|d< d|d< t |d< dS )zCOther things to make available from the formatting string.
N�obj�role�pyatspi)r4 )r" � globalsDictr r r � _addGlobalsW s zGenerator._addGlobalsc C s i }x| j j� D ] }g ||< qW | j|� x�| jj| j D ]�}x�dD ]�}y| jj| j | | }W n wDY qDX |sxqDx�yt||� P W qz tk
r� t� }|d d }|j dd�}|j dd�}|| j kr�t
j t
j � g ||< Y qz t
j t
j � P Y qzX qzW qDW q:W d S ) N�focused� unfocusedr r zname '� z' is not defined)r7 r8 )
r) �keysr6 r' �
formattingr& �eval� NameErrorr �replacer �printException� LEVEL_SEVERE)r" r5 �keyZroleKeyZ
evalString�info�argr r r r- ^ s6
zGenerator._verifyFormattingc C s |j dd�}||d< |S )z�Convenience method to allow you to temporarily override the role in
the args dictionary. This changes the role in args ags
returns the old role so you can pass it back to _restoreRole.
r3 N)�get)r" ZnewRoler �oldRoler r r �
_overrideRole� s zGenerator._overrideRolec C s |r||d< n|d= dS )z�Convenience method to restore the old role back in the args
dictionary. The oldRole should have been obtained from
_overrideRole. If oldRole is None, then the 'role' key/value
pair will be deleted from args.
r3 Nr )r" rE r r r r � _restoreRole� s
zGenerator._restoreRolec K s g S )Nr )r" �contentsr r r r �generateContents� s zGenerator.generateContentsc K s g S )Nr )r" r2 r r r r �generateContext� s zGenerator.generateContextc K s� | j jj|�r&d}tjtj|d� g S tj� }g }i }| j|� ||d< y|jd|j � �|d< W n" d| }tjtj|d� |S �y�|d |d< | j
|d< |jdd�s�|jd d
�r�d |d< nd |d< | j j j f |�}|jd
d
��s0|jdd��r"| j j j
f |�}| j j jf |�} d||| f }d|d
< d}
nd
}
d| j
j� |f }tjtj|d� |�s`t�x�tj� } yt||�}P W n� tk
�r g }t� } | d d }
|
jdd�}
|
jdd�}
|
| jk�r�tjtj� P | j|
|f|�||
< dtj� | }tjtjd||
t||
�f � Y nX �qbW W n tjtj� g }Y nX dtj� | }tjtjd| � tjtjd| j
j� d� x |D ]}tjtjd| � �q�W |jd��r�|�r�| j|� |S ) a4 Returns an array of strings (and possibly voice and audio
specifications) that represent the complete presentation for the
object. The presentation to be generated depends highly upon the
formatting strings in formatting.py.
args is a dictionary that may contain any of the following:
- alreadyFocused: if True, we're getting an object
that previously had focus
- priorObj: if set, represents the object that had focus before
this object
- includeContext: boolean (default=True) which says whether
the context for an object should be included as a prefix
and suffix
- role: a role to override the object's role
- formatType: the type of formatting, such as
'focused', 'basicWhereAmI', etc.
- forceMnemonic: boolean (default=False) which says if we
should ignore the settings.enableMnemonicSpeaking setting
- forceTutorial: boolean (default=False) which says if we
should force a tutorial to be spoken or not
z,ERROR: Cannot generate presentation dead objTr2 r3 z5ERROR: Cannot generate presentation for: %s. Abortingr. �
formatTypeN�alreadyFocusedFr7 r8 Z recursing�includeContextz %s + %s + %sz(%s GENERATOR: Starting generation for %sr r zname 'r9 z' is not definedz%.4fz, GENERATION TIME: %s ----> %s=%sz COMPLETION TIME: %sz%s GENERATOR: Results:z
%sZisProgressBarUpdate)r' � utilities�isDeadr ZprintlnZ
LEVEL_INFO�timer6 rD �getRoler& r; Z getFormatZ getPrefixZ getSuffix�upper�AssertionErrorr< r= r r> r) r? r@ Z LEVEL_ALL�repr� setProgressBarUpdateTimeAndValue)r" r2 r �msgZ startTime�resultr5 r; �prefix�suffixZfirstTimeCalledZ currentTimerB rC Zduration�elementr r r �generate� s�
&
zGenerator.generatec K s g S )a Returns the role name for the object in an array of strings, with
the exception that the pyatspi.ROLE_UNKNOWN role will yield an
empty array. Note that a 'role' attribute in args will
override the accessible role of the obj.
r )r" r2 r r r r �_generateRoleName s zGenerator._generateRoleNamec K s� g }d| j jd< | j jj|�}|j� tjkr�| j jj|�}| rX|jrX| j jj|d �}|phdd� |D �}t | j jj|�}t
t dd� |��}t |�dkr�|d j
� }n8t |�dkr�|d jr�|d jj
� }n| r�|jr�|j}|r�|j|� n�y
|j}W n ttfk
�r |S X |�r2|j|� d | j jd< n^d
}|j� tjk�rL|}n |j�rl|jj� tjk�rl|j}|�r�| j jj|�} | �r�|j| � y|jd |j� �}
W n ttfk
�r� |S X | �r�|j� tjk�r�|jj� tjk�r�| j|j�S |S ) a Returns an array of strings for use by speech and braille that
represent the name of the object. If the object is directly
displaying any text, that text will be treated as the name.
Otherwise, the accessible name of the object will be used. If
there is no accessible name, then the description of the
object will be used. This method will return an empty array
if nothing can be found. [[[WDW - I wonder if we should just
have _generateName, _generateDescription,
_generateDisplayedText, etc., that don't do any fallback.
Then, we can allow the formatting to do the fallback (e.g.,
'displayedText or name or description'). [[[JD to WDW - I
needed a _generateDescription for whereAmI. :-) See below.
F�usedDescriptionForNamer c S s g | ]}|�qS r r )r �childr r r r 7 s z+Generator._generateName.<locals>.<listcomp>c S s | S )Nr )r% r r r �<lambda>9 s z)Generator._generateName.<locals>.<lambda>r TNr3 )r' �pointOfReferencerN �
displayedTextrQ r4 �ROLE_COMBO_BOXZselectedChildren�
childCount�map�list�filterr+ �stripr0 �append� description� LookupError� RuntimeErrorZ ROLE_LINK�parentZ linkBasenamerD � ROLE_ICON�
ROLE_PANEL�
_generateName) r" r2 r rW r0 Zchildren�namesri �link�basenamer3 r r r ro " sT
zGenerator._generateNamec K s dd� |j � D �}dd� |D �S )a� Returns an array of strings for use by speech and braille that
represent the 'placeholder' text. This is typically text that
serves as a functional label and is found in a text widget until
that widget is given focus at which point the text is removed,
the assumption being that the user was able to see the text prior
to giving the widget focus.
c S s g | ]}|j d �r|�qS )zplaceholder-text:)r# )r r% r r r r g s z6Generator._generatePlaceholderText.<locals>.<listcomp>c S s g | ]}|j d d��qS )zplaceholder-text:r9 )r> )r r% r r r r h s )Z
getAttributes)r" r2 r rW r r r �_generatePlaceholderText_ s z"Generator._generatePlaceholderTextc K sl g }| j |f|�}| j|f|�}|j|� t|�s>|j|� n*t|�rh|d j� |d j� krh|j|� |S )z�Returns the label and the name as an array of strings for speech
and braille. The name will only be present if the name is
different from the label.
r )�_generateLabelro �extendr+ �split)r" r2 r rW �labelr0 r r r �_generateLabelAndNamej s
z Generator._generateLabelAndNamec K s< g }|j | j|f|�� |s8|jr8t|j�r8|j|j� |S )z�Returns the label as an array of strings for speech and braille.
If the label cannot be found, the name will be used instead.
If the name cannot be found, an empty array will be returned.
)ru rt r0 r+ rh )r" r2 r rW r r r �_generateLabelOrNamey s z Generator._generateLabelOrNamec K s� | j jjd�rg S |jd|j� �}|tjkr0g S |tjkrN| j jj|�pJd}n
|j pVd}g }|j
r�| j jj |�prd}|j
j � }||j � kp�||j � ks�|j
|j
� |S )z�Returns an array of strings fo use by speech and braille that
represent the description of the object, if that description
is different from that of the name and label.
r] r3 r9 )r' r` rD rQ r4 Z
ROLE_LABELrm rN ra r0 ri �displayedLabelr, rh )r" r2 r r3 r0 rW rw Zdescr r r �_generateDescription� s
z Generator._generateDescriptionc K s$ g }| j jj|�}|r |j|� |S )a Returns the label for an object as an array of strings for use by
speech and braille. The label is determined by the displayedLabel
method of the script utility, and an empty array will be returned if
no label can be found.
)r' rN rz rh )r" r2 r rW rw r r r rt � s
zGenerator._generateLabelc K sF g }y |j � }W n tk
r$ Y n X |j}|rBt|�rB|j|� |S )z�Returns an array of strings for use by speech and braille that
represent the description of the image on the object, if it
exists. Otherwise, an empty array is returned.
)Z
queryImage�NotImplementedErrorZimageDescriptionr+ rh )r" r2 r rW Zimageri r r r �_generateImageDescription� s
z#Generator._generateImageDescriptionc K s g S )Nr )r" r2 r r r r �_generateClickable� s z Generator._generateClickablec K s g S )Nr )r" r2 r r r r �_generateHasLongDesc� s z Generator._generateHasLongDescc K sL g }|j dd�s| j|d< d|d< |j� jtj�sH|j| jjj f |�� |S )a Returns an array of strings for use by speech and braille that
represent the grayed/sensitivity/availability state of the
object, but only if it is insensitive (i.e., grayed out and
inactive). Otherwise, and empty array will be returned.
r. NZ insensitive�
stringType)
rD r& �getState�containsr4 ZSTATE_SENSITIVErh r' r; � getString)r" r2 r rW r r r �_generateAvailability� s
z Generator._generateAvailabilityc K s� | j jj|�}|sg S g }|jdd �s0| j|d< d|d< | j jjf |�}|dkrZ|d }n|dkrl|d }n|d }| j jj|�}|r�|jd ||f � n
|j|� |S )
Nr. Zinvalidr� Zspellingr Zgrammar� r z%s: %s) r' rN ZgetErrorrD r& r; r� ZgetErrorMessagerh )r" r2 r �errorrW �
indicatorsZ indicatorZ errorMessager r r �_generateInvalid� s$
zGenerator._generateInvalidc K sl g }|j dd�s| j|d< d|d< |j� jtj�sR|j� tjkrh|jj� jtj�rh|j | j
j j f |�� |S )a* Returns an array of strings for use by speech and braille that
represent the required state of the object, but only if it is
required (i.e., it is in a dialog requesting input and the
user must give it a value). Otherwise, and empty array will
be returned.
r. NZrequiredr� )
rD r& r� r� r4 ZSTATE_REQUIREDrQ �ROLE_RADIO_BUTTONrl rh r' r; r� )r" r2 r rW r r r �_generateRequired� s
zGenerator._generateRequiredc K sJ g }|j dd�s| j|d< d|d< | jjj|�rF|j| jjjf |�� |S )z�Returns an array of strings for use by speech and braille that
represent the read only state of this object, but only if it
is read only (i.e., it is a text area that cannot be edited).
r. N�readonlyr� )rD r& r' rN ZisReadOnlyTextArearh r; r� )r" r2 r rW r r r �_generateReadOnly
s
zGenerator._generateReadOnlyc K sD g }| j jj|�r@| jtj|�}|j| j|f|�� | j||� |S )a Returns an array of strings for use by speech and braille that
represent the checked state of the object. This is typically
for check boxes that are in a table. An empty array will be
returned if this is not a checkable cell.
) r' rN �hasMeaningfulToggleActionrF r4 �ROLE_CHECK_BOXru r[ rG )r" r2 r rW rE r r r �_generateCellCheckedState s z#Generator._generateCellCheckedStatec K s� g }|j dd�s| j|d< d|d< | jjjf |�}|j� }|jtj�rV|j |d � n*|jtj
�rr|j |d � n|j |d � |S )a Returns an array of strings for use by speech and braille that
represent the checked state of the object. This is typically
for check boxes. [[[WDW - should we return an empty array if
we can guarantee we know this thing is not checkable?]]]
r. N�checkboxr� r r� r ) rD r& r' r; r� r� r� r4 �
STATE_CHECKEDrh ZSTATE_INDETERMINATE)r" r2 r rW r� �stater r r �_generateCheckedState% s
z Generator._generateCheckedStatec K sh g }|j dd�s| j|d< d|d< | jjjf |�}|j� }|jtj�rV|j |d � n|j |d � |S )a Returns an array of strings for use by speech and braille that
represent the checked state of the object. This is typically
for check boxes. [[[WDW - should we return an empty array if
we can guarantee we know this thing is not checkable?]]]
r. NZ radiobuttonr� r r )
rD r& r' r; r� r� r� r4 r� rh )r" r2 r rW r� r� r r r �_generateRadioState9 s
z Generator._generateRadioStatec s` t jt jt jt jt jt jg� � fdd�}|jr\|jj� t j kr\t j
||�}|r\| j |dd�S g S )Nc s | o| j � � kS )N)rQ )r% )� widgetRolesr r r_ R s z0Generator._generateChildWidget.<locals>.<lambda>F)rM ) r4 r� rb ZROLE_PUSH_BUTTONr� � ROLE_SLIDER�ROLE_TOGGLE_BUTTONrl rQ Z
ROLE_LIST_BOXZfindDescendantr[ )r" r2 r ZisWidgetZwidgetr )r� r �_generateChildWidgetK s z Generator._generateChildWidgetc K st g }|j dd �s| j|d< d|d< | jjjf |�}|j� }|jtj�sR|jtj �rb|j
|d � n|j
|d � |S )Nr. Zswitchr� r r ) rD r& r' r; r� r� r� r4 r� �
STATE_PRESSEDrh )r" r2 r rW r� r� r r r �_generateSwitchState\ s
z Generator._generateSwitchStatec K st g }|j dd�s| j|d< d|d< | jjjf |�}|j� }|jtj�sR|jtj �rb|j
|d � n|j
|d � |S )a Returns an array of strings for use by speech and braille that
represent the checked state of the object. This is typically
for check boxes. [[[WDW - should we return an empty array if
we can guarantee we know this thing is not checkable?]]]
r. NZ togglebuttonr� r r ) rD r& r' r; r� r� r� r4 r� r� rh )r" r2 r rW r� r� r r r �_generateToggleStatej s
z Generator._generateToggleStatec K sT g }|j dd�s| j|d< d|d< | jjjf |�}|j� jtj�rP|j |d � |S )z�Returns an array of strings for use by speech and braille that
represent the checked state of the menu item, only if it is
checked. Otherwise, and empty array will be returned.
r. Nr� r� r )
rD r& r' r; r� r� r� r4 r� rh )r" r2 r rW r� r r r � _generateMenuItemCheckedState} s
z'Generator._generateMenuItemCheckedStatec K st g }|j dd�s| j|d< d|d< | jjjf |�}|j� }|jtj�rp|jtj �rb|j
|d � n|j
|d � |S )z�Returns an array of strings for use by speech and braille that
represent the expanded/collapsed state of an object, such as a
tree node. If the object is not expandable, an empty array
will be returned.
r. NZ expansionr� r r ) rD r& r' r; r� r� r� r4 ZSTATE_EXPANDABLEZSTATE_EXPANDEDrh )r" r2 r rW r� r� r r r �_generateExpandableState� s
z"Generator._generateExpandableStatec K sR g }|j dd�s| j|d< d|d< |j� jtj�rN|jrN|j| jj j
f |�� |S )a Returns an array of strings (and possibly voice and audio
specifications) that represent the multiselectable state of
the object. This is typically for list boxes. If the object
is not multiselectable, an empty array will be returned.
r. NZ multiselectr� ) rD r& r� r� r4 ZSTATE_MULTISELECTABLErc rh r' r; r� )r" r2 r rW r r r � _generateMultiselectableState� s
z'Generator._generateMultiselectableStatec K s� g }| j jj|�}|s|S | j jj|�}|s0|S | j|tjd�}|jd�dkrvtj tj
kr�|jd�d kr�d||f }n|jd�dkr�d||f }|j |� |S )
z�Returns an array of strings to be used in speech and braille that
represent the row header for an object that is in a table, if
it exists. Otherwise, an empty array is returned.
)r3 r. �speechrK �
basicWhereAmI�detailedWhereAmIz%s %sr )r� r� ) r' rN ZrowHeaderForCellra �getLocalizedRoleNamer4 ZROLE_ROW_HEADERrD r �speechVerbosityLevel�VERBOSITY_LEVEL_VERBOSErh )r" r2 r rW �header�text�
roleStringr r r �_generateRowHeader� s
z Generator._generateRowHeaderc K s� g }| j jj|�}|s|S | j jj|�}|s0|S | j|tjd�}|jd�dkrvtj tj
kr�|jd�d kr�d||f }n|jd�dkr�d||f }|j |� |S )
z�Returns an array of strings (and possibly voice and audio
specifications) that represent the column header for an object
that is in a table, if it exists. Otherwise, an empty array
is returned.
)r3 r. r� rK r� r� z%s %sr )r� r� ) r' rN �columnHeaderForCellra r� r4 ZROLE_COLUMN_HEADERrD r r� r� rh )r" r2 r rW r� r� r� r r r �_generateColumnHeader� s
z Generator._generateColumnHeaderc K s� g }|j dkr�g }ddg}x,t|�D ] \}}| jjj|�r$d||< P q$W |d rd|d rdddg}n|d r~|d r~ddg}|r�x,|D ]$}|| s�|j| j|| f|�� q�W |S )z�Returns an array of strings for use by speech and braille for the
label of a toggle in a table cell that has a special 2 child
pattern that we run into. Otherwise, an empty array is
returned.
r� FTr r )rc � enumerater' rN r� ru r[ )r" r2 r rW � cellOrder� hasToggle�ir^ r r r � _generateTableCell2ChildLabel� s"
z'Generator._generateTableCell2ChildLabelc K s� g }|j dkr�g }ddg}x,t|�D ] \}}| jjj|�r$d||< P q$W |d rd|d rdddg}n|d r~|d r~ddg}|r�x,|D ]$}|| r�|j| j|| f|�� q�W |S )z�Returns an array of strings for use by speech and braille for the
toggle value of a toggle in a table cell that has a special 2
child pattern that we run into. Otherwise, an empty array is
returned.
r� FTr r )rc r� r' rN r� ru r[ )r" r2 r rW r� r� r� r^ r r r � _generateTableCell2ChildToggle s"
z(Generator._generateTableCell2ChildTogglec K sp |d dkr |j dd� r g S g }| jjj|�}| jjj|�}| rl| jjj|�rl| jjj|�}|j|j� |S )z�If this table cell has a "toggle" action, and doesn't have any
label associated with it then also speak the table column
header. See Orca bug #455230 for more details.
r. r� �
readingRowF) rD r' rN �realActiveDescendantra r� r� rh r0 )r" r2 r rW Z
descendantrw Z accHeaderr r r �&_generateColumnHeaderIfToggleAndNoText' s z0Generator._generateColumnHeaderIfToggleAndNoTextc K s4 g }| j d|�}|j| j|f|�� | j||� |S )a` Orca has a feature to automatically read an entire row of a table
as the user arrows up/down the roles. This leads to
complexity in the code. This method is used to return an
array of strings for use by speech and braille for a single
table cell itself. The string, 'blank', is added for empty
cells.
ZREAL_ROLE_TABLE_CELL)rF ru r[ rG )r" r2 r rW rE r r r �_generateRealTableCell: s
z Generator._generateRealTableCellc K s< | j jj|�rg S y |j� }W n
g S tj|j|j�gS )zaReturns an array of strings for use by speech and braille to present
the size of a table.)r' rN � isLayoutOnly�
queryTabler Z tableSize�nRows�nColumns)r" r2 r �tabler r r �_generateTableH s zGenerator._generateTablec
s� g }y|j j� � W n d� Y nX |jdd�dk}| jjj|�}|sJ|o^� o^| jjj|j � �r�|j }| jjj|�}� j|��� j |�}d} |r�� j
dkr�|S nXd| jj kr�d| jj kr�| jj }
| j dkp�|
d �kp��d ks�� j
d ko�|
d |k} | �r�d|d
< | jjj|��r(d d � |D �} n� �fd
d �t� j
�D �} x�| D ]l} | �sV�qH| j� }
|
jtj�}|�rH| j| f|�}|�r�|�r�| j dk�r�|jtjtj�� |j|� �qHW n|j| j|f|�� n|j| j|f|�� |S )a� Orca has a feature to automatically read an entire row of a table
as the user arrows up/down the roles. This leads to complexity in
the code. This method is used to return an array of strings
(and possibly voice and audio specifications) for an entire row
in a table if that's what the user has requested and if the row
has changed. Otherwise, it will return an array for just the
current cell.
NrK r� Tr ZlastRowZ
lastColumnr r r� c S s g | ]}|�qS r r )r r% r r r r � s z3Generator._generateTableCellRow.<locals>.<listcomp>c s g | ]}� j �|��qS r )ZgetAccessibleAt)r r� )� parentTable�rowr r r � s )rl r� rD r' rN ZshouldReadFullRowr� Z cellIndexZ
getRowAtIndexZgetColumnAtIndexr� r` r& r� Z
isTableRow�ranger� r� r4 Z
STATE_SHOWINGr� rh r ZRegionr Z TABLE_CELL_DELIMITER_BRAILLEru )r" r2 r rW ZisDetailedWhereAmIZ readFullRowrl �index�columnZ
presentAllr` ZcellsZcellr� ZshowingZ
cellResultr )r� r� r �_generateTableCellRowV sX
z Generator._generateTableCellRowc K s g S )z>Returns the expanded embedded object characters for an object.r )r" r2 r r r r �_generateExpandedEOCs� s z Generator._generateExpandedEOCsc K s\ |j d�}|j d�}|d ks$|d kr(g S |j d| jjj|||��}|rX| jj|krX|gS g S )N� startOffset� endOffset�string)rD r' rN � substring�EMBEDDED_OBJECT_CHARACTER)r" r2 r �start�endr� r r r �_generateSubstring� s
z Generator._generateSubstringc K s
|j d�S )Nr� )rD )r" r2 r r r r �_generateStartOffset� s z Generator._generateStartOffsetc K s
|j d�S )Nr� )rD )r" r2 r r r r �_generateEndOffset� s z Generator._generateEndOffsetc K sB | j |f|�}|r|S | jj|�\}}}|r>| jj|kr>|gS g S )z�Returns an array of strings for use by speech and braille
that represents the current line of text, if
this is a text object. [[[WDW - consider returning an empty
array if this is not a text object.]]]
)r� r' ZgetTextLineAtCaretr� )r" r2 r rW r� Z caretOffsetr� r r r �_generateCurrentLineText� s z"Generator._generateCurrentLineTextc K s2 | j |f|�}|r|S | jjj|�}|s,g S |gS )z�Returns an array of strings for use by speech and braille that
represents all the text being displayed by the object.
)r� r' rN ra )r" r2 r rW ra r r r �_generateDisplayedText� s z Generator._generateDisplayedTextc K sZ g }|j dd�s| j|d< d|d< | jjj|�}|dkrV|j| jjjf |�|d � |S )z�Returns an array of strings for use by speech and braille that
represents the tree node level of the object, or an empty
array if the object is not a tree node.
r. NZ nodelevelr� r r )rD r& r' rN Z nodeLevelrh r; r� )r" r2 r rW �levelr r r �_generateNodeLevel� s
z Generator._generateNodeLevelc K s | j jj|�gS )aM Returns an array of strings for use by speech and braille that
represents the value of the object. This is typically the
numerical value, but may also be the text of the 'value'
attribute if it exists on the object. [[[WDW - we should
consider returning an empty array if there is no value.
)r' rN Z textForValue)r" r2 r r r r �_generateValue� s zGenerator._generateValuec K s* g }y|j |j� j� W n Y nX |S )z�Returns an array of strings for use by speech and braille that
represents the name of the application for the object.
)rh ZgetApplicationr0 )r" r2 r rW r r r �_generateApplicationName� s z"Generator._generateApplicationNamec K sz |j d�}|j d�}|dk r(|dk r(g S g }|j dd�sB| j|d< d|d< | jjj|�}|rv|j| jjjf |�| � |S )z�Returns an array of strings for use by speech and braille that
represent the nesting level of an object in a list.
r� r� Nr. Z nestinglevelr� )rD r& r' rN � nestingLevelrh r; r� )r" r2 r r� r� rW r� r r r �_generateNestingLevel s
z Generator._generateNestingLevelc
K s� g }y |j � }W n d}Y nX |tjkr�d}|j� }x,|D ]$}| r>|j� tjkr>|jd�}P q>W |r�|j| jj j
|�� nN|j }xF|r�|j |kr�|j � tj tj
gkr�| j|�} | r�|j| � P |j }q�W |S )z�Returns an array of strings for use by speech and braille that
represents the radio button group label for the object, or an
empty array if the object has no such label.
Nr )rQ r4 r� ZgetRelationSetZgetRelationTypeZRELATION_LABELLED_BYZ getTargetrh r' rN ra rl rn Z ROLE_FILLERrx ru )
r" r2 r rW r3 ZradioGroupLabelZ relationsZrelationrl rw r r r �_generateRadioButtonGroup s6
z#Generator._generateRadioButtonGroupc s\ g }� j jj|�}|j� tjko$|js4� j|f|�S � fdd�|D �}djt dd� |��gS )aN Objects, such as tables and trees, can represent individual cells
via a complicated nested hierarchy. This method returns an
array of strings for use by speech and braille that represents
the text actually being painted in the cell, if it can be
found. Otherwise, an empty array is returned.
c s g | ]}� j jj|�j� �qS r )r' rN ra rg )r r% )r" r r r J s zHGenerator._generateRealActiveDescendantDisplayedText.<locals>.<listcomp>� c S s | S )Nr )r% r r r r_ K s zFGenerator._generateRealActiveDescendantDisplayedText.<locals>.<lambda>)
r' rN r� rQ r4 �ROLE_TABLE_CELLrc r� �joinrf )r" r2 r rW �radZcontentr )r" r �*_generateRealActiveDescendantDisplayedText= s z4Generator._generateRealActiveDescendantDisplayedTextc K s( | j jj|�}|j� |d< | j|f|�S )a Objects, such as tables and trees, can represent individual cells
via a complicated nested hierarchy. This method returns an
array of strings for use by speech and braille that represents
the role of the object actually being painted in the cell.
r3 )r' rN r� rQ r\ )r" r2 r r� r r r �%_generateRealActiveDescendantRoleNameM s z/Generator._generateRealActiveDescendantRoleNamec K sP g }|j }x@|rJ|j |krJ|j� tjkrB| j|�}|rB|j|� P |j }q W |S )z�Returns an array of strings for use by speech and braille that
represents the nearest ancestor of an object which is a named panel.
)rl rQ r4 rn rx ru )r" r2 r rW rl rw r r r � _generateNamedContainingPanelW s
z'Generator._generateNamedContainingPanelc K s g S )Nr )r" r2 r r r r �_generatePageSummaryf s z Generator._generatePageSummaryc K s g S )Nr )r" r2 r r r r �_generateProgressBarIndexi s z#Generator._generateProgressBarIndexc K s g S )Nr )r" r2 r r r r �_generateProgressBarValuel s z#Generator._generateProgressBarValuec C s t tjd��S )NZprogressBarUpdateInterval)�int�_settingsManagerZ
getSetting)r" r r r � _getProgressBarUpdateIntervalo s z'Generator._getProgressBarUpdateIntervalc K sT | j jj|�}| j|| d�\}}||kr,dS |dkr8dS ttj� | �}|| j� kS )N)�typeF�d T)r' rN �getValueAsPercent� getProgressBarUpdateTimeAndValuer� rP r� )r" r2 r Zpercent�lastTime� lastValueZintervalr r r � _shouldPresentProgressBarUpdater s z)Generator._shouldPresentProgressBarUpdatec s4 � fdd�}t t|� j��}� fdd�|D �� _d S )Nc s � j jj| �p� j jj| � S )N)r' rN ZisZombierO )r% )r" r r r_ s z6Generator._cleanUpCachedProgressBars.<locals>.<lambda>c s i | ]}� j j|�|�qS r )r( rD )r r% )r" r r �
<dictcomp>� s z8Generator._cleanUpCachedProgressBars.<locals>.<dictcomp>)re rf r( )r" ZisValidZbarsr )r" r �_cleanUpCachedProgressBars~ s z$Generator._cleanUpCachedProgressBarsc C sP | j � | jj� sdS t| jj� dd� d�}|d \}}t| jj� �d ||fS ) N� c S s | d S )Nr r )r% r r r r_ � s z;Generator._getMostRecentProgressBarUpdate.<locals>.<lambda>)rA r )Nr� N���r� )r� r( �values�sortedre r: )r" Z sortedValuesZprevTimeZ prevValuer r r � _getMostRecentProgressBarUpdate� s
z)Generator._getMostRecentProgressBarUpdatec C sL | j � || jkr d| j|< | j|�}t| jj� �j|�}|d t| j�fS )N� r )r� N)r� r( r� re r� r� r+ )r" r2 Z thisValuer� r r r � getProgressBarNumberAndCount� s
z&Generator.getProgressBarNumberAndCountc K s || j krd| j |< | j j|�S )N� )r� N)r( rD )r" r2 r r r r r� � s
z*Generator.getProgressBarUpdateTimeAndValueNc C s0 |p
t j � }|p | jjj|�}||f| j|< d S )N)rP r' rN r� r( )r" r2 r� r� r r r rU � s z*Generator.setProgressBarUpdateTimeAndValuec K sH | j jj|�r�| j jj|�r dS | j jj|�r2dS | j jj|�rDdS | j jj|�rVdS | j jj|�rhdS | j jj|�rzdS | j jj |�r�dS | j jj
|�r�| j jj |�r�dS | j jj |�r�d S |j
� tjkr�d
S | j jj|�r�d S | j jj|�r�tjS | j jj|��r tjS | j jj |��r"tjS | j jj|��r8tjS |jd |j
� �S )
NZROLE_MATH_SCRIPT_SUBSUPERZROLE_MATH_SCRIPT_UNDEROVERZROLE_MATH_MULTISCRIPTZROLE_MATH_ENCLOSEDZROLE_MATH_FENCEDZROLE_MATH_TABLEZROLE_MATH_TABLE_ROW�
ROLE_FOOTNOTEZROLE_DPUB_LANDMARK�ROLE_DPUB_SECTION� ROLE_SWITCHr3 )r' rN ZisMathZisMathSubOrSuperScriptZisMathUnderOrOverScriptZisMathMultiScriptZ
isMathEncloseZ isMathFencedZ isMathTableZisMathTableRow�isDPub�isDPubFootnote�
isLandmarkrQ r4 Z ROLE_SECTION�isSwitchZisAnchorZ ROLE_STATICZ isBlockquoteZROLE_BLOCK_QUOTEZ
ROLE_LANDMARKZisFocusableLabel�ROLE_LIST_ITEMrD )r" r2 r r r r �_getAlternativeRole� sB z Generator._getAlternativeRolec
K sl |j d|j� �}dtj|�kr�|j� }|jtj�}|jtj�}|jtj�pT|j dd�}|tj krv|rjt
j S |r�t
j S nb|tj
kr�|r�t
jS |r�t
jS nB|tjkr�|r�t
jS |r�t
jS n"|tjkr�|r�|r�t
jS |r�t
jS | jjj|�r�t
jS | jjj|��rt
jS | jjj|��rt
jS | jjj |��r.t
j S | jjj |��rB| jjj |��r�| jjj |��rdt
j!S | jjj"|��rzt
j#S | jjj$|��r�t
j%S | jjj&|��r�t
j'S | jjj(|��r�t
j)S | jjj*|��r�t
j+S | jjj,|��r�t
j-S | jjj.|��r�t
j/S | jjj0|��rt
j1S | jjj2|��r*t
j3S | jjj4|��r@t
j5S | jjj6|��rVt
j7S | jjj8|��rlt
j9S | jjj:|��r�t
j;S | jjj<|��r�t
j=S | jjj>|��r�t
j?S | jjj@|��r�t
jAS | jjjB|��r�t
jCS | jjjD|��rBt
jES �nN|dk�r�| jjjF|��rt
jGS | jjjH|��r*t
jIS | jjjJ|��r@t
jKS | jjjL|��rVt
jMS | jjjN|��rlt
jOS | jjjP|��r�t
jQS | jjjR|��r�t
jSS | jjjT|��rBt
jUS n�|tjVk�r�| jjjW|��r�t
jXS | jjjY|��rBt
jZS nX| jjj[|��r t
j\S | jjj]|��rt
j^S | jjj_|��r,t
j`S | jjja|��rBt
jbS | jjj |��r| jjjc|��rht
jdS | jjje|��r~t
jfS | jjjg|��r�t
jhS | jjji|��r�t
jjS | jjjk|��r�t
jlS | jjjm|��r�t
jnS | jjjo|��r�t
jpS | jjjq|��rtjr}ts|tjttujtf��s*y|jv� S dS tujw|�}txjy|�} | txjtjzk�rb|tj{k�rbtxjyd�} txj|| �S )Nr3 ZValuerL Fr� r9 Z statusbar)}rD rQ r4 ZlistInterfacesr� r� ZSTATE_VERTICALZSTATE_HORIZONTALZ
STATE_FOCUSEDr� r ZROLE_SLIDER_HORIZONTALZROLE_SLIDER_VERTICAL�ROLE_SCROLL_BARZROLE_SCROLL_BAR_HORIZONTALZROLE_SCROLL_BAR_VERTICALZROLE_SEPARATORZROLE_SPLITTER_HORIZONTALZROLE_SPLITTER_VERTICALZROLE_SPLIT_PANEr' rN ZisFeedZ ROLE_FEEDZisFigureZ ROLE_FIGUREZ isMenuButtonZROLE_MENU_BUTTONr� r� r� r� ZisDPubAcknowledgmentsZROLE_ACKNOWLEDGMENTSZisDPubAfterwordZROLE_AFTERWORDZisDPubAppendixZ
ROLE_APPENDIXZisDPubBibliographyZROLE_BIBLIOGRAPHYZ
isDPubChapterZ ROLE_CHAPTERZisDPubConclusionZROLE_CONCLUSIONZ
isDPubCreditsZ ROLE_CREDITSZisDPubEndnotesZ
ROLE_ENDNOTESZisDPubEpilogueZ
ROLE_EPILOGUEZ isDPubErrataZ ROLE_ERRATAZisDPubForewordZ
ROLE_FOREWORDZisDPubGlossaryZ
ROLE_GLOSSARYZ isDPubIndexZ
ROLE_INDEXZisDPubIntroductionZROLE_INTRODUCTIONZisDPubPagelistZ
ROLE_PAGELISTZ
isDPubPartZ ROLE_PARTZ
isDPubPrefaceZ ROLE_PREFACEZisDPubPrologueZ
ROLE_PROLOGUEZ isDPubTocZROLE_TOCZisDPubAbstractZ
ROLE_ABSTRACTZisDPubColophonZ
ROLE_COLOPHONZ isDPubCreditZ ROLE_CREDITZisDPubDedicationZROLE_DEDICATIONZisDPubEpigraphZ
ROLE_EPIGRAPHZ
isDPubExampleZ ROLE_EXAMPLEZisDPubPullquoteZROLE_PULLQUOTEZ isDPubQnaZROLE_QNAr� ZisDPubBiblioentryZROLE_BIBLIOENTRYZ
isDPubEndnoteZ ROLE_ENDNOTEZ isDPubCoverZ
ROLE_COVERr� r� ZisDPubPagebreakZROLE_PAGEBREAKZisDPubSubtitleZ
ROLE_SUBTITLEZisLandmarkBannerZROLE_LANDMARK_BANNERZisLandmarkComplementaryZROLE_LANDMARK_COMPLEMENTARYZisLandmarkContentInfoZROLE_LANDMARK_CONTENTINFOZisLandmarkMainZROLE_LANDMARK_MAINZisLandmarkNavigationZROLE_LANDMARK_NAVIGATIONZisLandmarkRegionZROLE_LANDMARK_REGIONZisLandmarkSearchZROLE_LANDMARK_SEARCHZisLandmarkFormZ ROLE_FORMr ZRoler r� Z
role_get_namer Z
role_for_nameZINVALIDZROLE_STATUS_BARZrole_get_localized_name)
r" r2 r r3 r� Z
isVerticalZ isHorizontalZ isFocusedZ nonlocalizedZatkRoler r r r� � s
z Generator.getLocalizedRoleNamec K s� | j jj|�r | j|f|�S |jd|j� �}|tjkrD| j|f|�S |tj tj
gkrb| j |f|�S |tj tj
gkr�| j|f|�S |tjkr�| j|f|�S |tjkr�| j|f|�S g S )Nr3 )r' rN r� r� rD rQ r4 ZROLE_MENU_ITEMr� r� ZROLE_RADIO_MENU_ITEMr� r� ZROLE_CHECK_MENU_ITEMr� r� r� r� r� )r" r2 r r3 r r r �getStateIndicatorW s
zGenerator.getStateIndicatorc K sJ |j d|j� �}|tjkr(| j|f|�S |tjtjgkrF| j|f|�S g S )Nr3 )rD rQ r4 ZROLE_PROGRESS_BARr� r� r� Z_generatePercentage)r" r2 r r3 r r r �getValuen s
zGenerator.getValue)NN)Gr �
__module__� __qualname__�__doc__r1 r6 r- rF rG rI rJ r[ r\ ro rs rx ry r{ rt 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� rU r� r� r� r� r r r r r A s� * w =
I "
$ r )r )r Z__id__� __version__Z__date__Z
__copyright__Z __license__r r4 r rP r Z
gi.repositoryr r r9 r r r r r r
r r$ Z
getManagerr� r r r r r �<module> s*