| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/pyatspi/ |
Upload File : |
Ñò
1¡ÜJc @ s× d Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z e i ƒ Z
e i ƒ a e a
d f d „ ƒ YZ d f d „ ƒ YZ d „ Z d „ Z d „ Z d
d „ Z d „ Z d
„ Z d „ Z d „ Z d „ Z d „ Z g d „ Z d e f d „ ƒ YZ d e f d „ ƒ YZ d e f d „ ƒ YZ e e e i ƒ e e e i! g ƒ e e i" e d d d g ƒ e e i" e i ƒ e e i# e ƒ e d „ e i! e i# f ƒ d S( s¢
Creates functions at import time that are mixed into the
Accessibility.Accessible base class to make it more Pythonic.
Based on public domain code originally posted at
U{http://wwwx.cs.unc.edu/~parente/cgi-bin/RuntimeClassMixins}.
@var _ACCESSIBLE_CACHE: Pairs hash values for accessible objects to
L{_PropertyCache} bags. We do not store actual accessibles in the dictionary
because that would +1 their ref counts and cause __del__ to never be called
which is the method we rely on to properly invalidate cache entries.
@type _ACCESSIBLE_CACHE: dictionary
@var _CACHE_LEVEL: Current level of caching enabled. Checked dynamically by
L{_AccessibleMixin}
@type _CACHE_LEVEL: integer
@author: Peter Parente
@organization: IBM Corporation
@copyright: Copyright (c) 2005, 2007 IBM Corporation
@license: LGPL
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
Portions of this code originally licensed and copyright (c) 2005, 2007
IBM Corporation under the BSD license, available at
U{http://www.opensource.org/licenses/bsd-license.php}
iÿÿÿÿNt _PropertyCachec B s e Z d „ Z RS( c C s
h | _ d S( N( t __dict__( t self( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt wipe7 s ( t __name__t
__module__R ( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR 6 s t _UserDatac B s e Z d Z RS( N( R R t Nonet value( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR : s c C s t S( s$
Gets the current level of caching.
@return: None indicating no caching is in effect.
L{constants.CACHE_INTERFACES} indicating all interface query results are
cached. L{constants.CACHE_PROPERTIES} indicating all basic accessible
properties are cached.
@rtype: integer
( t _CACHE_LEVEL( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt
getCacheLevel= s
c C sw t | j o` t i ƒ | t i j o# t i ƒ } | i t t i Œ qm t i ƒ } | i
t t i Œ n | a d S( s³
Sets the desired level of caching for all accessible objects created after
this function is invoked. Immediately clears the current accessible cache.
@param val: None indicating no caching is in effect.
L{constants.CACHE_INTERFACES} indicating all interface query results are
cached. L{constants.CACHE_PROPERTIES} indicating all basic accessible
properties are cached plus all interfaces.
@type val: integer
N( R t _ACCESSIBLE_CACHEt cleart constantst CACHE_PROPERTIESt registryt Registryt registerEventListenert _updateCachet CACHE_EVENTSt deregisterEventListener( t valt r( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt
setCacheLevelI s
c C s t i ƒ d S( s# Forces a clear of the entire cache.N( R R ( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt
clearCachea s s %sc C s
| t GHd S( sy
Prints the contents of the cache.
@param template: Format string to use when printing
@type template: string
N( R ( t template( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt
printCachee s c C s6 y t t | i ƒ i ƒ Wn t j
o d SXd S( sÖ
Invalidates an entry in the cache when the hash value of a source of an event
matches an entry in the cache.
@param event: One of the L{constants.CACHE_EVENTS} event types
@type event: L{event.Event}
N( R t hasht sourceR t KeyError( t event( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR n s c C sÓ t t i j o | ƒ St } t | ƒ } y
| i } WnS t j
oG y | | } Wn& t j
o t ƒ } | | | <n X| | _ n Xy t | | ƒ } Wn, t j
o | ƒ } t
| | | ƒ n X| S( s»
If property caching is enabled, use the cached proprty, or get the
property and cache it. If property caching is disabled, simply get the
property.
@param value_name: The name of the value, like 'role' or 'description'.
@type value_name: string
@param get_method: Method used to get the property, should not have any
arguments.
@type get_method: callable
@return: Value of property we are retrieving.
@rtype: object
( R R
R R R t _property_cachet AttributeErrorR R t getattrt setattr( t acct
value_namet
get_methodt cachet ht pcR ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _getAndCache{ s&
c s ‡ f d † } | S( sæ
Builds a function querying to a specific interface and returns it.
@param interface: Class representing an AT-SPI interface
@type interface: class
@return: Function querying to the given interface
@rtype: function
c s+ t i ˆ ƒ } y | i | } WnK t j
o
t } nO t j
o' t d j } | o
h | _ q‰ n X| d j o
t ‚ n | Sy3 | i | ƒ } | d j o | i
ˆ ƒ } n Wn! t j
o } t | ƒ ‚ n X| d j o" | o d | i | <n t ‚ n | o | | i | <n | S( sÊ
Queries an object for another interface.
@return: An object with the desired interface
@rtype: object
@raise NotImplementedError: When the desired interface is not supported
N(
t utilst getInterfaceIIDt _icacheR t TrueR R R t NotImplementedErrort queryInterfacet _narrowt Exceptiont LookupError( R t iidt it cachingt e( t interface( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _inner s2
( ( R7 R8 ( ( R7 s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt
_makeQuery¤ s .c s ‡ f d † } | S( s±
Builds a function calling the one it wraps in try/except statements catching
CORBA exceptions.
@return: Function calling the method being wrapped
@rtype: function
c sh y ˆ | | | Ž SWnM t i i j
o } t | ƒ ‚ n( t i i j
o } t | ƒ ‚ n Xd S( N( t ORBitt CORBAt NO_IMPLEMENTR. R1 R2 ( R t argst kwargsR6 ( t func( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR8 å s ( ( R? R8 ( ( R? s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _makeExceptionHandlerÝ s
c C sk xd | D]\ } d t i | ƒ } t | ƒ } t i | i | i | | i | i ƒ } t | | | ƒ q Wd S( s
Add methods for querying to interfaces other than the base accessible to
the given class.
@param cls: Class to mix interface methods into
@type cls: class
@param interfaces: Classes representing AT-SPI interfaces
@type interfaces: list of class
s query%sN(
R* t getInterfaceNameR9 t newt functiont func_codet func_globalst
func_defaultst func_closureR" ( t clst
interfacesR7 t nameR? t method( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _mixInterfacesñ s c C s t i i i } x| i i ƒ D]ñ } | i | } | i d ƒ o q q t | | ƒ o t | ƒ } t | | | ƒ q t | t
ƒ o‡ | i o% t | | i i
ƒ } t | ƒ } n d } | i o% t | | i i
ƒ } t | ƒ } n d } t | | t
| | ƒ ƒ q q Wd S( s
Wraps all methods and properties in a class with handlers for CORBA
exceptions.
@param cls: Class to mix interface methods into
@type cls: class
t _N( t
Accessibilityt
Accessiblet getRolet __class__R t keyst
startswitht
isinstanceR@ R" t propertyt fgetR! R R t fset( RH t method_typeRJ t objRK R? t gettert setter( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _mixExceptions s&
c C s… x~| i i ƒ D]m\ } } | | j o q n t | t i ƒ ox t i | i | i | | i | i
ƒ } y t | | ƒ } Wn t j
o n Xt
| d | | ƒ t
| | | ƒ q t | t ƒ oQ y t | | ƒ } Wn t j
o n Xt
| d | | ƒ t
| | | ƒ q t | t ƒ oQ y t | | ƒ } Wn t j
o n Xt
| d | | ƒ t
| | | ƒ q q Wd S( sœ
Adds the methods in new_cls to cls. After mixing, all instances of cls will
have the new methods. If there is a method name clash, the method already in
cls will be prefixed with '_mix_' before the new method of the same name is
mixed in.
@note: _ is not the prefix because if you wind up with __ in front of a
variable, it becomes private and mangled when an instance is created.
Difficult to invoke from the mixin class.
@param cls: Existing class to mix features into
@type cls: class
@param new_cls: Class containing features to add
@type new_cls: class
@param ignore: Ignore these methods from the mixin
@type ignore: iterable
t _mix_N( R t itemsRT t typest FunctionTypeRB RC RD RE RF RG R! R R" t staticmethodRU ( RH t new_clst ignoreRJ R? RK t
old_methodt old_prop( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _mixClass, s6
t _AccessibleMixinc B sï e Z d Z h Z d Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z
d
„ Z d „ Z d „ Z
e e e
ƒ Z d
„ Z e e e i i ƒ Z d „ Z e e ƒ Z d „ Z d „ Z d „ Z e e e i i ƒ Z d „ Z d „ Z RS( s
Defines methods to be added to the Accessibility.Accessible class. The
features defined here will be added to the Accessible class at run time so
that all instances of Accessible have them (i.e. there is no need to
explicitly wrap an Accessible in this class or derive a new class from it.)
@cvar SLOTTED_CLASSES: Mapping from raw Accessibility class to a new class
having the slots defined by L{SLOTS}
@type SLOTTED_CLASSES: dictionary
@cvar SLOTS: All slots to create
@type SLOTS: tuple
R, R t
_user_datac C ss y t i | } WnL t j
o@ t | i | f h | i d 6t i d 6ƒ } | t i | <n X| i | ƒ } | S( s:
Creates a new class mimicking the one requested, but with extra named
defined in __slots__. The _cache attribute is used internally for interface
caching. The user_data field may be populated with whatever data structure
a client wishes to use. Neither is set to a default value by default.
Note that we can't simply mix __slots__ into this class because __slots__
has an effect only at class creation time.
We also do not completely obliterate __slots__ to allow __dict__ to be
instantiated as normal as reducing the initialization and memory overhead
of the millions of accessible objects that are created is a good thing for
many clients.
@param cls: Accessibility object class
@type cls: class
@return: Instance of the new class
@rtype: object
R t __slots__( Rg t SLOTTED_CLASSESR t typeR R t SLOTSt _mix___new__( RH Rb RY ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __new__z s
c C s( y | i ƒ Wn t j
o n Xd S( s
Decrements the reference count on the accessible object when there are no
Python references to this object. This provides automatic reference
counting for AT-SPI objects. Also removes this object from the cache if
we're caching properties.
N( t unrefR1 ( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __del__š s c c sK xD t | i ƒ D]3 } y | i | ƒ VWq t j
o d Vq Xq Wd S( sÉ
Iterator that yields one accessible child per iteration. If an exception is
encountered, None is yielded instead.
@return: A child accessible
@rtype: Accessibility.Accessible
N( t xranget
childCountt getChildAtIndexR2 R ( R R4 ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __iter__¦ s c C s6 y d | i ƒ | i f SWn t j
o d SXd S( s“
Gets a human readable representation of the accessible.
@return: Role and name information for the accessible
@rtype: string
s [%s | %s]s [DEAD]N( t getRoleNameRJ R1 ( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __str__´ s c C s t S( s3
@return: True, always
@rtype: boolean
( R- ( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __nonzero__À s c C s` | i } | | j o
t ‚ n4 | | j o
t ‚ n | d j o | | 7} n | i | ƒ S( s¸
Thin wrapper around getChildAtIndex.
@param index: Index of desired child
@type index: integer
@return: Accessible child
@rtype: Accessibility.Accessible
i ( Rr t
IndexErrorRs ( R t indext n( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __getitem__Ç s
c C s | i S( sk
Thin wrapper around childCount.
@return: Number of child accessibles
@rtype: integer
( Rr ( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt __len__Ù s c C sv t | ƒ } y
| i } WnJ t j
o> y t | } Wqf t j
o t ƒ } | t | <qf Xn X| | _ | i S( s‡
Get user_data from global dictionay fo this accessible.
@return: Any data the user assigned, or None.
@rtype: object
( R Rh R t _ACCESSIBLE_USER_DATAR R R ( R R' t ud( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _get_user_dataâ s
c C s| t | ƒ } y
| i } WnJ t j
o> y t | } Wqf t j
o t ƒ } | t | <qf Xn X| | _ | | _ d S( so
Set arbitrary data to user_data.
@param value: Value to set in user_data
@type value: object
N( R Rh R R} R R R ( R R R' R~ ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt _set_user_dataù s
c C s t | d | i ƒ S( s
Gets the name of the accessible from the cache if it is available,
otherwise, fetches it remotely.
@return: Name of the accessible
@rtype: string
RJ ( R) t _get_name( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR s c C s t | d | i ƒ S( sÃ
Gets the parent of the accessible from the cache if it is available,
otherwise, fetches it remotely.
@return: Parent of the accessible
@rtype: Accessibility.Accessible
t parent( R) t _get_parent( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyRƒ s c C s t | d | i ƒ S( sÃ
Gets the unlocalized role name of the accessible from the cache if it is
available, otherwise, fetches it remotely.
@return: Role name of the accessible
@rtype: string
t rolename( R) t _mix_getRoleName( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyRu * s c C s t | d | i ƒ S( s¹
Gets the role of the accessible from the cache if it is
available, otherwise, fetches it remotely.
@return: Role of the accessible
@rtype: Accessibility.Role
t role( R) t _mix_getRole( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyRP 4 s c C s t | d | i ƒ S( s¾
Gets the description of the accessible from the cache if it is available,
otherwise, fetches it remotely.
@return: Description of the accessible
@rtype: string
t description( R) t _get_description( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR‰ > s c C sB | i ƒ } y t | i i d | ƒ SWn t j
o d SXd S( sh
Gets the index of this accessible in its parent. Uses the implementation of
this method provided by the Accessibility.Accessible object, but checks the
bound of the value to ensure it is not outside the range of childCount
reported by this accessible's parent.
@return: Index of this accessible in its parent
@rtype: integer
i iÿÿÿÿN( t _mix_getIndexInParentt minR‚ Rr R ( R R4 ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt getIndexInParentK s
c C s y | i ƒ } Wn t j
o
d } n X| o | S| } yP x/ | i d j o | i | j o
| i } qD W| i ƒ | i t i ƒ SWn d SXd S( s‰
Gets the most-parent accessible (the application) of this
accessible. Tries using the getApplication method introduced in
AT-SPI 1.7.0 first before resorting to traversing parent links.
@warning: Cycles involving more than the previously traversed accessible
are not detected by this code.
@return: Application object
@rtype: Accessibility.Application
N( t _mix_getApplicationR R R‚ t refR0 RN t Application( R t appt curr( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt getApplication] s !
( s _icaches _property_caches
_user_data( R R t __doc__Rj Rl Rn Rp Rt Rv Rw R{ R| R R€ RU t user_dataR RN RO t _set_nameRJ Rƒ R‚ Ru RP R‰ t _set_descriptionRˆ RŒ R’ ( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyRg j s0
t _RelationMixinc B s e Z d Z d „ Z RS( sq
Defines methods to be added to the Relation class. At this time it only
overrides L{_RelationMixin.getTarget} which by the IDL's standard is
supposed to return CORBA.Objects but we expect LAccessibility.Accessible
objects (see http://bugzilla.gnome.org/show_bug.cgi?id=435833).
This seems to be a problem especially with the Java implementation of CORBA.
c C sF | i | ƒ } t | t i ƒ p | i t i ƒ } n | i ƒ | S( s¯
Overrides the regular getTarget to return Accessibility.Accessible
objects.
@return: The 'nth' target of this Relation.
@rtype: Accessibility.Accessible
( t _mix_getTargetRT RN RO R0 RŽ ( R Ry t target( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt getTarget‡ s
( R R R“ Rš ( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR— s t _UnrefMixinc B s e Z d Z d „ Z RS( sO
This mixin addresses the issue we have with unreferencing non-primitives.
c C s( y | i ƒ Wn t j
o n Xd S( sO
Unrefence the instance when Python GCs it. Why do we need this twice?
N( Ro R1 ( R ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyRp ™ s ( R R R“ Rp ( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyR› • s R R‰ Rƒ c C s
t | t ƒ S( ( Rf R› ( RH ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt <lambda>® s ($ R“ RB R_ R: RN R
R* R t weakreft WeakValueDictionaryR R} R R R R R
R R R R R) R9 R@ RL R\ Rf t objectRg R— R› t mapt ALL_INTERFACESt StateSetRO t Relation( ( ( s6 /usr/lib/python2.6/site-packages/pyatspi/accessible.pyt <module>( sH
) 9 % >ÿ