|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21573/root/usr/lib/python2.4/site-packages/dogtail/ |
Upload File : |
m
]Mc @ sM d Z d Z d k l Z e d k Z d k Z d k l Z d k l Z d k l Z d k l
Z
d k l Z d k Z d k
Z
d k l Z y
d k Z Wn e j
o e d
n Xy d k Z e Z Wn e j
o
e Z n Xe a d e f d YZ d
e f d YZ d e f d YZ d e f d YZ d f d YZ d f d YZ d e f d YZ d e f d YZ! d e f d YZ" d e f d YZ# d e# f d YZ$ y" e! e i% i& Z' d! e' _( Wn e) j
o e i* d" n Xe' i+ Z+ e+ o e i* d# n [+ d S($ s- Makes some sense of the AT-SPI API
The tree API handles various things for you:
- fixes most timing issues
- can automatically generate (hopefully) highly-readable logs of what the
script is doing
- traps various UI malfunctions, raising exceptions for them (again,
hopefully improving the logs)
The most important class is Node. Each Node is an element of the desktop UI.
There is a tree of nodes, starting at 'root', with applications as its
children, with the top-level windows and dialogs as their children. The various
widgets that make up the UI appear as descendents in this tree. All of these
elements (root, the applications, the windows, and the widgets) are represented
as instances of Node in a tree (provided that the program of interest is
correctly exporting its user-interface to the accessibility system). The Node
class is a wrapper around Accessible and the various Accessible interfaces.
The Action class represents an action that the accessibility layer exports as
performable on a specific node, such as clicking on it. It's a wrapper around
AccessibleAction.
We often want to look for a node, based on some criteria, and this is provided
by the Predicate class.
Dogtail implements a high-level searching system, for finding a node (or
nodes) satisfying whatever criteria you are interested in. It does this with
a 'backoff and retry' algorithm. This fixes most timing problems e.g. when a
dialog is in the process of opening but hasn't yet done so.
If a search fails, it waits 'config.searchBackoffDuration' seconds, and then
tries again, repeatedly. After several failed attempts (determined by
config.searchWarningThreshold) it will start sending warnings about the search
to the debug log. If it still can't succeed after 'config.searchCutoffCount'
attempts, it raises an exception containing details of the search. You can see
all of this process in the debug log by setting 'config.debugSearching' to True
We also automatically add a short delay after each action
('config.defaultDelay' gives the time in seconds). We'd hoped that the search
backoff and retry code would eliminate the need for this, but unfortunately we
still run into timing issues. For example, Evolution (and probably most
other apps) set things up on new dialogs and wizard pages as they appear, and
we can run into 'setting wars' where the app resets the widgetry to defaults
after our script has already filled out the desired values, and so we lose our
values. So we give the app time to set the widgetry up before the rest of the
script runs.
The classes trap various UI malfunctions and raise exceptions that better
describe what went wrong. For example, they detects attempts to click on an
insensitive UI element and raise a specific exception for this.
Unfortunately, some applications do not set up the 'sensitive' state
correctly on their buttons (e.g. Epiphany on form buttons in a web page). The
current workaround for this is to set config.ensureSensitivity=False, which
disables the sensitivity testing.
Authors: Zack Cerza <zcerza@redhat.com>, David Malcolm <dmalcolm@redhat.com>
sD Zack Cerza <zcerza@redhat.com>,
David Malcolm <dmalcolm@redhat.com>
( s checkForA11yN( s datetime( s sleep( s config( s doDelay( s Blinker( s debugLoggers# Error importing the AT-SPI bindingst SearchErrorc B s t Z RS( N( t __name__t
__module__( ( ( t0 /usr/lib/python2.4/site-packages/dogtail/tree.pyR _ s t
ReadOnlyErrorc B s& t Z d Z d Z d Z d Z RS( s*
This attribute is not writeable.
s Cannot set %s. It is read-only.c C s
| | _ d S( N( t attrt self( R R ( ( R t __init__g s c C s | i | i S( N( R t messageR ( R ( ( R t __str__j s ( R R t __doc__R R R ( ( ( R R b s t NotSensitiveErrorc B s& t Z d Z d Z d Z d Z RS( s&
The widget is not sensitive.
s" Cannot %s %s. It is not sensitive.c C s
| | _ d S( N( t actionR ( R R ( ( R R r s c C s# | i | i i | i i i f S( N( R R R t namet nodet getLogString( R ( ( R R u s ( R R R
R R R ( ( ( R R m s t ActionNotSupportedc B s& t Z d Z d Z d Z d Z RS( s;
The widget does not support the requested action.
s Cannot do '%s' action on %sc C s | | _ | | _ d S( N( t
actionNameR R ( R R R ( ( R R } s c C s | i | i | i i f S( N( R R R R R ( R ( ( R R s ( R R R
R R R ( ( ( R R x s t Actionc
B s8 t Z d Z d Z d Z d Z d
Z d Z RS( sO
Class representing an action that can be performed on a specific node
t clickt presst releaset activatet jumpt checkt dockt undockt opent menuc C s | | _ | | _ | | _ d S( N( R R R t _Action__actiont indext _Action__index( R R R R ( ( R R s c C s | d j o | i i | i i SnR | d j o | i i | i Sn. | d j o | i i | i Sn
t | d S( NR
t descriptiont
keyBinding( R R R t getNameR t lowert getDescriptiont
getKeyBindingt AttributeError( R R ( ( R t __getattr__ s
c C s& d | i | i | i | i f } | S( s:
Plain-text representation of the Action.
s; Action node='%s' name='%s' description='%s' keybinding='%s'N( R R R
R R! t string( R R( ( ( R R s "c C s t i d | i | i i f | i i p> t i o
t | qn t | } t i d t | n t i o | i i
n | i i | i } t | S( sV
Performs the given tree.Action, with appropriate delays and logging.
s %s on %ss Warning: N( t loggert logR R
R R t sensitivet configt ensureSensitivityR t nSEt strt blinkOnActionst blinkR t doActionR t resultt doDelay( R R. R3 ( ( R t do s #
(
s clickR R s activateR R R R s opens menu( R R R
t typesR R' R R5 ( ( ( R R s t Nodec B s: t Z d Z d$ Z d Z d Z d Z d
Z d Z d Z d
Z
d Z d d Z d Z
d Z d Z e e e e d Z e d Z d Z d d d d e e d Z e d Z e d Z e d Z e d Z e d Z e d Z e d Z d Z d! d" Z d# Z RS(% s
A node in the tree of UI elements. It wraps an Accessible and
exposes its useful members. It also has a debugName which is set
up automatically when doing searches.
Node instances have various attributes synthesized, to make it easy to
get and the underlying accessible data. Many more attributes can be
added as desired.
'name' (read-only string):
Wraps Accessible_getName on the Node's underlying Accessible
'roleName' (read-only string):
Wraps Accessible_getRoleName on the Node's underlying Accessible
'role' (read-only atspi role enum):
Wraps Accessible_getRole on the Node's underlying Accessible
'description' (read-only string):
Wraps Accessible_getDescription on the Node's underlying Accessible
'parent' (read-only Node instance):
A Node instance wrapping the parent, or None. Wraps Accessible_getParent
'children' (read-only list of Node instances):
The children of this node, wrapping getChildCount and getChildAtIndex
'text' (string):
For instances wrapping AccessibleText, the text. This is read-only,
unless the instance wraps an AccessibleEditableText. In this case, you
can write values to the attribute. This will get logged in the debug
log, and a delay will be added. After the delay, the content of the
node will be checked to ensure that it has the expected value. If it
does not, an exception will be raised. This does not work for password
dialogs (since all we get back are * characters). In this case, set
the passwordText attribute instead.
'passwordText' (write-only string):
See documentation of 'text' attribute above.
'caretOffset' (read/write int):
For instances wrapping AccessibleText, the location of the text caret,
expressed as an offset in characters.
'combovalue' (write-only string):
For comboboxes. Write to this attribute to set the combobox to the
given value, with appropriate delays and logging.
'stateSet' (read-only StateSet instance):
Wraps Accessible_getStateSet; a set of boolean state flags
'relations' (read-only list of atspi.Relation instances):
Wraps Accessible_getRelationSet
'labellee' (read-only list of Node instances):
The node(s) that this node is a label for. Generated from 'relations'.
'labeller' (read-only list of Node instances):
The node(s) that is/are a label for this node. Generated from
'relations'.
'checked' (read-only boolean):
Is this node checked? Only valid for checkboxes. Generated from stateSet
based on presence of atspi.SPI_STATE_CHECKED.
'sensitive' (read-only boolean):
Is this node sensitive (i.e. not greyed out). Generated from stateSet
based on presence of atspi.SPI_STATE_SENSITIVE
Not all applications/toolkits seem to properly set this up.
'showing' (read-only boolean):
Generated from stateSet based on presence of atspi.SPI_STATE_SHOWING
'focusable' (read-only boolean):
Generated from stateSet based on presence of atspi.SPI_STATE_FOCUSABLE
'focused' (read-only boolean):
Generated from stateSet based on presence of atspi.SPI_STATE_FOCUSED
'actions' (read-only list of Action instances):
Generated from Accessible_getAction and AccessibleAction_getNActions
For each action that is supported by a node, a method is hooked up,
this can include the following list:
'click'
'press'
'release'
'activate'
'jump'
'check'
'dock'
'undock'
'open'
'menu'
'extents' (readonly tuple):
For instances wrapping a Component, the (x,y,w,h) screen extents of the
component.
'position' (readonly tuple):
For instances wrapping a Component, the (x,y) screen position of the
component.
'size' (readonly tuple):
For instances wrapping a Component, the (w,h) screen size of the component.
'grabFocus':
For instances wrapping a Component, attempt to set the keyboard input focus
to that Node.
'toolkit' (readonly string):
For instances wrapping an application, the name of the toolkit.
'version'
For instances wrapping an application.
'ID'
For instances wrapping an application.
'pause' (function)
'resume' (function)
For instances wrapping an application; probably don't work
t __accessiblet __actiont __componentt __textt __editableTextt __selectionc
s@ t _ d _ t | t i o
| _ n< t | t
o% | i _ t | d d _ n d i i _
i
d j o d } | _ n i i _ i d j o1 d } | _ d d } | _ n i i _ i d j o@ i i _ i i _ i i _ i i _ n i i _ i d j o i i _ n i i _ i i _ i d j o. d } | _ d } | _! n i" } | o8 | i o. d } | _# d
} | _$ n d S( Nt debugNames Unknown Node initializerc s> i } | i | o | | i Sn t | d S( s
Performs the tree.Action with the given name, with appropriate delays and logging,
or raises the ActionNotSupported exception if the node doesn't support that particular
action.
N( R t actionst has_keyR
R5 R ( R
R? ( R ( R R2 I s
c s i i t d S( N( R t _Node__componentt grabFocusR4 ( ( R ( R RB Y s
i c s i } | d | d f } | d | d f } | d d | d } | d d | d } t i o6 t i d i
i t | t | f n t
i | | | d S( s
Generates a raw mouse click event whether or not the Node has a 'click' action, using the specified button.
1 is left,
2 is middle,
3 is right.
i i i i f0.5s raw click on %s %s at (%s,%s)N( R t extentst positiont sizet clickXt clickYR, t debugSearchingR) R* R
R R/ t rawinputR t button( RJ RC RF RG RD RE ( R ( R t rawClick^ s
6c s
i i S( s7
Selects all children.
N( R t _Node__selectiont selectAll( ( R ( R RM s c s
i i S( sB
Deselects all selected children.
N( R RL t clearSelection( ( R ( R t deselectAll s c s i i i i S( sM
Selects the node, relative to its siblings.
N( R t parentRL t selectChildt
indexInParent( ( R ( R t select s c sX d } i } x6 t i D]% } | i | i o | d 7} q q W| i i | S( sO
Deselects the node, relative to its siblings.
i i N(
t
selectedIndexR RP t rangeRR t it childrent
isSelectedRL t deselectSelectedChild( RT RV RP ( R ( R t deselect s (% t FalseR t _Node__hideChildrent NoneR> t
isinstancet initializert atspit
Accessiblet _Node__accessibleR7 t getattrt getActiont
_Node__actionR2 t getComponentRA RB RK t getTextt _Node__textt addSelectiont getNSelectionst removeSelectiont setSelectiont getEditableTextt _Node__editableTextt
setAttributest getHypertextt _Node__hypertextt getSelectionRL RM RO RP RS RZ (
R R_ RM RP RO R2 RB RZ RK RS ( ( R R R : sR
c C sp t o nb| d j o* t | i t i j o | i i Sn+| d j o* t | i t i j o | i i Sn| d j o* t | i t i j o | i i Sn| d j o' t | i t i j o | i i
Sn| d j o' t | i t i j o | i i SnU| d j o | i i Sn7| d j o | i i
Sn| d j o | i i Sn| d j o | i i Sn| d
j o. | i i } | o t | } | Sqln| d j o | i i Sn| d j ov| i o d Sn g } | i i }
|
t i j o8 t p$ t i d
t t i t a n t i }
n x t |
D] }
t" | t# oO y | i i$ |
} Wqt i& j
o# d k' } t i | i( qXn | i i$ |
} | d j o | i* t | qrqrW| i+ oI xF t, | i+ i- D]+ }
| i* t. | | i+ i/ |
|
q1Wn | Sn| d j o | i i0 Sn| d j o | i i1 Sn| d j oK x| i2 D]9 } | i4 t i5 j o | i6 } t8 t | SqqWnm| d j oK x\| i2 D]9 } | i4 t i9 j o | i6 } t8 t | SqqWn| d j o | i i0 i: t i; Sn| d j o | i i0 i: t i< Sn| d j o | i i0 i: t i= Sn| d j o | i i0 i: t i> Snm| d j o | i i0 i: t i? SnC| d j o^ h } | iA oF xC t | iA iB D]( }
tC | | iA |
} | | | iE <q]Wn | Sn| d j o | iF o | iF iG Sqln| d j o | iF o | iF iH Sqln| d j o9 | iF o+ | iF iG } | d | d f } | Sqln:| d j o% | iK o | iK iL d d Sqln| d j o | iK o | iK iM Sqln | d! j o8 | i } | o$ | iN o | i iN iO | iP Sqln | d" j o | i o d Sn g } | i } | oP | i iN oC x@ t | iN iR D]% }
| i* t | iN iS |
q.Wn | Sn
tT | d S(# Nt toolkitt versiont IDt pauset resumeR
t rolet roleNameR RP RR RW st Only returning %s children. You may change config.childrenLimit if you wish. This message will only be printed once.t stateSett relationst labelleet labellerR+ t showingt focusablet focusedt checkedR? RC RD RE i i t texti i t caretOffsetRX t selectedChildren(U R[ R t typeR Rb R` t Applicationt
getToolkitt
getVersiont getIDRv Rw R" t getRolet getRoleNameR$ t getParentt parentAccR7 RP t getIndexInParentR\ RW t
getChildCountt
childCountR, t
childrenLimitt haveWarnedAboutChildrenLimitR) R* R/ t Truet xrangeRV R^ t Roott getChildAtIndext at SpiExceptiont tracebackt
format_excR] t appendRq RU t getNLinkst Linkt getLinkt getStateSett getRelationSetR{ t relationt getRelationTypet SPI_RELATION_LABEL_FORt
getTargetst targetst applyt SPI_RELATION_LABELED_BYt containst SPI_STATE_SENSITIVEt SPI_STATE_SHOWINGt SPI_STATE_FOCUSABLEt SPI_STATE_FOCUSEDt SPI_STATE_CHECKEDR? Re t getNActionsR R R
RA t
getExtentst getPositionRC RE Rh Rg t getCaretOffsetRL t isChildSelectedRR R t getNSelectedChildrent getSelectedChildR& ( R R RC R R? R RW RE R R R RP R RV R R ( ( R R' s &&&&&
-
'c C sV t o nH| i d d | i j o | | i | <n| d d d g j o
t | n| d d d d d
d d d
d d d g j o
t | n| d d d d d g j o
t | n| d j o
t | nz| d d d g j o
t | nW| d j o+ | i p
t | n | i i | n | d j o] | i
p
t | n t i o! t
i d | i | f n | i
i | t n | d j oO | i
p
t | n t
i d | i | f | i
i | t nY | d j o> t
i d | i | f | i d! | i t n | | i | <d S(" Nt _Nodet Rs Rt Ru R
Rx Ry R RP RR RW Rz R{ R| R} R+ R~ R R R R? RC RD RE R R s Setting text of %s to '%s't passwordTexts Setting text %s to password '%s't
combovalues Setting combobox %s to '%s't childName( R[ R t replaceR t containedt valuet __dict__R Rh t setCaretOffsetRn R, RH R) R* R t setTextContentsR4 t
childNamedR ( R R R ( ( R t __setattr__9 sN
.
!
c C s t i d | i | f t oW t i d | i | i i | i t | i t
| 7_ t i d | i n | i oD | i p) y | i
Wq t i d q Xn t i | n$ t i d t i | 7_ t d S( sa
Type the given text into the node, with appropriate delays and
logging.
s Typing text into %s: '%s's caret offset: %ss new caret offset: %ss( Node is focusable but I can't grabFocus!s3 Node is not focusable; falling back to setting textN( R) R* R R R( R[ R Rn t
insertTextR t lenR R RB RI t typeTextR R4 ( R R( ( ( R R s"
c C s t i o! t i d t | i f n | i o7 | i p) y | i Wqh t i d qh Xqy n t i d t
i | d S( Ns Pressing keys '%s' into %ss( Node is focusable but I can't grabFocus!s. Node is not focusable; trying key combo anyway(
R, RH R) R* t comboR R R R RB RI t keyCombot comboString( R R ( ( R R s
!
c C s{ | i o d | i d Sn[ d } | d | i } | d | i | i f } | i d j o | d | i } n | Sd S( s
If debugName is set on this Node, returns debugName surrounded
in curly braces.
Otherwise, returns a plain-text representation of the most
important attributes of the underlying Accessible.
t {t }R7 s roleName='%s's name='%s' description='%s's
text='%s'N( R R> R( Ry R
R R R] ( R R( ( ( R R s
c C s& t i o | i Sn t | Sd S( sz
Get a string describing this node for the logs,
respecting the config.absoluteNodePaths boolean.
N( R, t absoluteNodePathsR t getAbsoluteSearchPathR/ ( R ( ( R R s
c C s
| i | S( s=
Does this node satisfy the given predicate?
N( t predt satisfiedByNodeR ( R R ( ( R t satisfies s t plainc C s& d k } t | | } | | d S( N( t dumpRc R t dumperR ( R R R R ( ( R R s c C s t i o t i d | n | i d j o0 t i } | i t
i | i t
| Snm | i oX | i \ } } } t i o t i d | n | i } | i | | | Sn t i Sd S( s
FIXME: this needs rewriting...
Generate a SearchPath instance giving the 'best'
way to find the Accessible wrapped by this node again, starting
at the root and applying each search in turn.
This is somewhat analagous to an absolute path in a filesystem,
except that some of searches may be recursive, rather than just
searching direct children.
Used by the recording framework for identifying nodes in a
persistent way, independent of the style of script being
written.
FIXME: try to ensure uniqueness
FIXME: need some heuristics to get 'good' searches, whatever
that means
s getAbsoluteSearchPath(%s)t applications got ancestor: %sN( R, t debugSearchPathsR) R* R Ry t patht
SearchPathR3 R t predicatet IsAnApplicationNamedR
R[ RP t getRelativeSearcht ancestorR t isRecursiveR t ancestorPath( R R R3 R R R ( ( R R s
c C s t i o t i d | n t } | i } x$ | i | p | i } t
} q1 W| i o1 | i i o | t
i | i i | f Sq n | i d j o | t
i | i | f Sn | i d j p | i d j o | t
i | i | f Sn | i d j o | t
i | i | f Sn | i d j o | t
i | i | f Sn | i d j o | t
i | i | f SnY | i d j o | t
i | i | f Sn, t
i d | i d
| i } | | | f Sd S( s
Get a (ancestorNode, predicate, isRecursive) triple that identifies the
best way to find this Node uniquely.
FIXME: or None if no such search exists?
FIXME: may need to make this more robust
FIXME: should this be private?
s getRelativeSearchPath(%s)R s menu items check menu itemR s push buttont framet dialogR
Ry N( R, R R) R* R R[ R RP R t _Node__nodeIsIdentifiableR R| R
R t IsLabelledAsRy t IsAMenuNamedt IsAMenuItemNamedt IsATextEntryNamedt IsAButtonNamedt IsAWindowNamedt IsADialogNamedt GenericPredicateR ( R R R R ( ( R R s8
$ c C s> | i o t Sn) | i o t Sn | i p t Sn t Sd S( N( R R| R R
RP R[ ( R R ( ( R t __nodeIsIdentifiable" s
c
s7 t d d } d } x | t i j o | t i j p
t i o* t i d | | | | | | f n | | | } | o+ | o
| | _
n | i | _
| Sq! | p Pn | d 7} t i p
t i o t i d t i n t t i q! W| o t | | | | | n d S( s
Search for a node satisyfing the predicate, returning a Node.
If retry is True (the default), it makes multiple attempts,
backing off and retrying on failure, and eventually raises a
descriptive exception if the search fails.
If retry is False, it gives up after one attempt.
If requireResult is True (the default), an exception is raised after all
attempts have failed. If it is false, the function simply returns None.
FIXME: make multiple attempts?
c st y
| i } Wn d Sn XxR | D]J } | i | o | Sq" | o% | | | } | o | Sql q" q" Wd S( se
Internal helper function that does a one-shot search, recursing if need be.
N( RP RW R] t childR R t recursivet findFirstChildSatisfying( RP R R R RW ( R ( R R = s
c C sK | o
d } n d } | d j o | i } n d | | i | f S( s2
Internal helper function
t
descendentR s %s of %s: %sN( R t nounR> R] R t describeSearchResultRP R ( RP R R R> R ( ( R t describeSearchQ s
i s searching for %s (attempt %i)i s sleeping for %fN( R R R t numAttemptsR, t searchCutoffCountt searchWarningThresholdRH R) R* R R R R> R3 R t retryt
debugSleept searchBackoffDurationt sleept
requireResultR (
R R R R> R R R R R R3 ( ( R R t findChild- s0 *
c C s g } y
| i } Wn d Sn Xxu | D]m } | i | o | i | n | o? | i | | } | o" x | D] } | i | qv Wq q( q( W| o | Sn d S( sI
Find all children/descendents satisfying the predicate.
N( t selfListR RW R] R R R R R t findChildrent childList( R R R R R R RW ( ( R R w s&
c C sC | i } x3 | d j o% | i | o | Sq | i } q Wd S( sz
Search up the ancestry of this node, returning the first Node
satisfying the predicate, or None.
N( R RP t candidateR] R R ( R R R ( ( R t findAncestor s
R c
C s7 | i t i d | d | d | d | d | d | S( s
Finds a child satisying the given criteria.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
R
Ry R t labelR R> N(
R R R R R
Ry R R R R> ( R R
Ry R R R R> ( ( R R s c C s | i t i d | | S( s
Search below this node for a menu with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
t menuNameN( R R R R R R ( R R R ( ( R R s c C s | i t i d | | S( s
Search below this node for a menu item with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
t menuItemNameN( R R R R R R ( R R R ( ( R t menuItem s c C s | i t i d | | S( s
Search below this node for a text entry with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
t
textEntryNameN( R R R R R R ( R R R ( ( R t textentry s c C s | i t i d | | S( s
Search below this node for a button with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
t
buttonNameN( R R R R R R ( R R R ( ( R RJ s c C s | i t i | | S( s
Search below this node for a child labelled with the given text.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
N( R R R t
IsLabelledt labelTextR ( R R R ( ( R t
childLabelled s c C s | i t i | | S( s
Search below this node for a child with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
N( R R R t IsNamedR R ( R R R ( ( R R s c C s | i t i d | | S( s
Search below this node for a tab with the given name.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
t tabNameN( R R R t IsATabNamedR R ( R R R ( ( R t tab s c C s g } | i o | i | i n | i o | i | i n y
| i } Wn | Sn Xx! | D] } | i | i qd W| S( s
Get all user-visible strings in this node and its descendents.
(Could be implemented as an attribute)
N( R3 R R
R R RW R t extendt getUserVisibleStrings( R R R3 RW ( ( R R s
i c C sG | i p t Sn2 | i \ } } } } t | | | | | } t
Sd S( s
Blink, baby!
N( R RC R[ t xt yt wt ht Blinkert countt blinkDataR ( R R R R R R R
( ( R R1 s
c C s4 | i d j o | i d Sn t d | d S( sc
If the Node supports an action called "click", do it, with appropriate delays and logging.
Otherwise, raise an ActionNotSupported exception.
Note that this is just a shortcut to doAction('click'), as it is by far the most-used
action. To do any other action such as 'activate' or 'open', you must use doAction().
R N( R Re R] R2 R ( R ( ( R R s ( R8 R9 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 RJ R R R
R R1 R ( ( ( R R7 s8 { u L
' , J
R c B s/ t Z d Z d Z d Z d Z d Z RS( s(
Class representing a hyperlink
t __hyperlinkt __nodec C sR d | _ | | _ | | _ | | _ t | i i
| i | _ t | i _
d S( N( R] R R> R RP t hyperlinkt _Link__hyperlinkR t _Link__indexR7 t getObjectt _Link__nodeR t _Link__hideChildren( R R R R ( ( R R s c C s t o ns | d j o | i i | i SnO | d j o d Sn y t | i | } | SWn t j
o t | n Xd S( Nt URIRW (
R[ R
R R t getURIR Rc R R3 R& ( R R
R3 ( ( R R' ) s
c C s | | i | <d S( N( R R R R
( R R
R ( ( R R 7 s ( R R ( R R R
R R R' R ( ( ( R R s
R c B s t Z d Z d Z d Z RS( s
FIXME:
c C s t i t i d d d t S( s'
Get all applications.
Ry R R N( t roott findAllChildrenSatisfyingR R R[ ( R ( ( R t applications> s c C s" t t i t i | d t S( s.
Gets an application by name, returning an Application instance
or raising an exception.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
R N( R R R R R t appNameR[ ( R R! ( ( R R D s ( R R R
R R ( ( ( R R : s R c B s) t Z e d Z e d Z d Z RS( Nc C s | i t i d | | S( sd
Search below this node for a dialog with the given name,
returning a Window instance.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
FIXME: should this method activate the dialog?
t
dialogNameN( R R R R R" R ( R R" R ( ( R R P s
c C s( t | i t i d | | } | S( s
Search below this node for a window with the given name,
returning a Window instance.
This is implemented using findChild, and hence will automatically retry
if no such child is found, and will eventually raise an exception. It
also logs the search.
FIXME: this bit isn't true:
The window will be automatically activated (raised and focused
by the window manager) if wnck bindings are available.
t
windowNameN( t WindowR R R R R# R R3 ( R R# R R3 ( ( R t window] s $c C s4 t d d } | o | i } | i Sn d S( s*
Get the wnck.Application instance for this application, or None
Currently implemented via a hack: requires the app to have a
window, and looks up the application of that window
wnck.Application can give you the pid, the icon, etc
FIXME: untested
Ry R N( R R% t
getWnckWindowt
wnckWindowt get_application( R R' R% ( ( R t getWnckApplicationp s
( R R R[ R R% R) ( ( ( R R O s
R$ c B s t Z d Z d Z RS( Nc C sO t i } | i x2 | i D]$ } | i | i j o | Sq# q# Wd S( sG
Get the wnck.Window instance for this window, or None
N( t wnckt screen_get_defaultt screent force_updatet get_windowsR' t get_nameR R
( R R, R' ( ( R R& s
c C s | i } | i d d S( si
Activates the wnck.Window associated with this Window.
FIXME: doesn't yet work
i N( R R& R' R ( R R' ( ( R R s ( R R R& R ( ( ( R R$ s t Wizardc B s> t Z d Z e d Z d Z d Z d Z d Z RS( sJ
Note that the buttons of a GnomeDruid were not accessible until
recent versions of libgnomeui. This is
http://bugzilla.gnome.org/show_bug.cgi?id=157936
and is fixed in gnome-2.10 and gnome-2.12 (in CVS libgnomeui);
there's a patch attached to that bug.
This bug is known to affect FC3; fixed in FC5
c C sE t i | | | o
| | _ n t i d | | i f d S( Ns %s is on '%s' page( R7 R R R R> R) R* t getPageTitle( R R R> ( ( R R s
c C sF | i d d } x# | i D] } | i o | Sq q Wd | d S( sz
Get the current page of this wizard
FIXME: this is currently a hack, supporting only GnomeDruid
Ry t panels& Unable to determine current page of %sN( R R t
pageHolderRW R~ ( R R3 R ( ( R t currentPage s
c C s= | i } | i d d i d d i d d d t i S( s
Get the string title of the current page of this wizard
FIXME: this is currently a total hack, supporting only GnomeDruid
Ry R2 R R N( R R4 R R[ R ( R R4 ( ( R R1 s c C s: | i d } | i t i d | | i f d S( s'
Click on the 'Forward' button to advance to next page of wizard.
It will log the title of the new page that is reached.
FIXME: what if it's Next rather than Forward ???
This will only work if your libgnomeui has accessible buttons;
see above.
t Forwards %s is now on '%s' pageN( R R t fwdR R) R* R1 ( R R6 ( ( R t clickForward s
c C s | i d } | i d S( s
Click on the 'Apply' button to advance to next page of wizard.
FIXME: what if it's Finish rather than Apply ???
This will only work if your libgnomeui has accessible buttons;
see above.
t ApplyN( R R R6 R ( R R6 ( ( R t
clickApply s ( R R R
R] R R4 R1 R7 R9 ( ( ( R R0 s R sJ Error: AT-SPI's desktop is not visible. Do you have accessibility enabled?sk Warning: AT-SPI's desktop is visible but it has no children. Are you running any AT-SPI-aware applications?(, R
t
__author__t utilst checkForA11yt reR t datetimet timeR R, R4 R RI R t loggingt debugLoggerR) R` t ImportErrorR* R t gotWnckR[ R t ExceptionR t TypeErrorR R R R R7 R R R R$ R0 t registryt
getDesktopR R> t AssertionErrorR* RW ( R0 R> R R R$ R RI RW R7 R R RC R* R= R R) R R: R R R` R R4 R, R< R R R ( ( R t ?: s\
6 c 3 G