3 WY2G@s^ddddgZddlZddlmZddlmZddlZdZd Zd Z Gd dde Z d d dZ dS)RegistryMAIN_LOOP_GLIBMAIN_LOOP_NONEset_default_registryN)Atspi)GLibrZQtNonec@seZdZdZiZddZddZd,ddZd d Zd-d dZ ddZ ddZ ddZ ddZ ddZddZdZdZddZdd Zgd!eefd d d fd"d#Zgd!eeffd$d%Zd&d'Zd(d)Zd*d+ZdS).ra Wraps the Accessibility.Registry to provide more Pythonic registration for events. This object should be treated as a singleton, but such treatment is not enforced. You can construct another instance of this object and give it a reference to the Accessibility.Registry singleton. Doing so is harmless and has no point. @@ivar async: Should event dispatch to local listeners be decoupled from event receiving from the registry? @@type async: boolean @@ivar reg: Reference to the real, wrapped registry object @@type reg: Accessibility.Registry @@ivar dev: Reference to the device controller @@type dev: Accessibility.DeviceEventController @@ivar clients: Map of event names to client listeners @@type clients: dictionary @@ivar observers: Map of event names to AT-SPI L{_Observer} objects @@type observers: dictionary c CsR|j|_y|jrdSWntk r*YnXd|_d|_d|_d|_tj|_ dS)NF) _Registry__shared_state__dict__has_implementationsAttributeErrorZdevice_event_registerZapp_event_registerZdesktoprZMainLoop main_loop)selfr2/usr/lib/python3/dist-packages/pyatspi/registry.py__init__CszRegistry.__init__cCs|S)zn @@return: This instance of the registry @@rtype: L{Registry} r)rrrr__call__TszRegistry.__call__NcCsd|_d|_d|_t|_dS)a Creates a new 'Registry' object and sets this object as the default returned by pyatspi.Registry. The default registry (without calling this function) uses the GLib main loop with caching. It connects to a registry daemon. This function should be called before pyatspi is used if you wish to change these defaults. @@param main_loop_type: 'GLib', 'None' or 'Qt'. If 'None' is selected then caching is disabled. @@param use_registry: Whether to connect to a registry daemon for device events. Without this the application to connect to must be declared in the app_name parameter. @@param app_name: D-Bus name of the application to connect to when not using the registry daemon. TFN)r asyncstarteddictevent_listeners)rZmain_loop_typeapp_namerrr _set_registry[szRegistry._set_registrycCs|jtdS)N)rr)rrrr_set_default_registryvszRegistry._set_default_registryFTcsljsjd_|rZfddd_tj}tjtj|jdk rbjntjd_dS)a3 Enter the main loop to start receiving and dispatching events. @@param async: Should event dispatch be asynchronous (decoupled) from event receiving from the AT-SPI registry? @@type async: boolean @@param gil: Add an idle callback which releases the Python GIL for a few milliseconds to allow other threads to run? Necessary if other threads will be used in this process. @@type gil: boolean TcsDytjdWn0tk r>}z|_jWYdd}~XnXdS)Ng{Gz?T)timeZsleepKeyboardInterruptkeyboard_exceptionstop)e) releaseGILrrrrs z"Registry.start..releaseGILNF) r rrrrZidle_addrZ event_mainZ source_remove)rrZgilir)rrrstartys     zRegistry.startcGs|js|jtjdS)z6 Quits the main loop. N)r rrZ event_quit)rargsrrrrsz Registry.stopcCsdS)z Gets the number of available desktops. @@return: Number of desktops @@rtype: integer r)rrrrgetDesktopCountszRegistry.getDesktopCountcCs|js|jtj|S)z Gets a reference to the i-th desktop. @@param i: Which desktop to get @@type i: integer @@return: Desktop reference @@rtype: Accessibility.Desktop )r rrZ get_desktop)rr rrr getDesktops zRegistry.getDesktopcCs||S)Nr)rZeventcallbackrrr eventWrapperszRegistry.eventWrapperc Gsd|js|jy|j|}Wn&tjj|j|}|j|<YnXx|D]}tjj||qJWdS)a Registers a new client callback for the given event names. Supports registration for all subevents if only partial event name is specified. Do not include a trailing colon. For example, 'object' will register for all object events, 'object:property-change' will register for all property change events, and 'object:property-change:accessible-parent' will register only for the parent property change event. Registered clients will not be automatically removed when the client dies. To ensure the client is properly garbage collected, call L{deregisterEventListener}. @@param client: Callable to be invoked when the event occurs @@type client: callable @@param names: List of full or partial event names @@type names: list of string N)r rrr EventListenernewr'register)rclientnameslistenernamerrrregisterEventListeners  zRegistry.registerEventListenerc GsH|js|jy|j|}Wn dSx|D]}tjj||q.WdS)a Unregisters an existing client callback for the given event names. Supports unregistration for all subevents if only partial event name is specified. Do not include a trailing colon. This method must be called to ensure a client registered by L{registerEventListener} is properly garbage collected. @@param client: Client callback to remove @@type client: callable @@param names: List of full or partial event names @@type names: list of string @@return: Were event names specified for which the given client was not registered? @@rtype: boolean N)r rrrr(Z deregister)rr+r,r-r.rrrderegisterEventListeners z Registry.deregisterEventListenerr#cCs<tjj}|r|tjjO}|r(|tjjO}|r8|tjjO}|S)N)rZKeyListenerSyncTypeZNOSYNCZ SYNCHRONOUSZ CANCONSUMEZ ALL_WINDOWS)r synchronous preemptiveglobal_resultrrr makeSyncTypes   zRegistry.makeSyncTypecCs"d}x|D]}|d|>O}q W|S)Nrr#r)rkindr5r rrrmakeKinds zRegistry.makeKindrc Cs|js|jy|j|}Wn&tjj|j|}|j|<YnX|j|||} t|drb|} n|g} x$| D]} tj ||| |j || qnWdS)a Registers a listener for key stroke events. @@param client: Callable to be invoked when the event occurs @@type client: callable @@param key_set: Set of hardware key codes to stop monitoring. Leave empty to indicate all keys. @@type key_set: list of integer @@param mask: When the mask is None, the codes in the key_set will be monitored only when no modifier is held. When the mask is an integer, keys in the key_set will be monitored only when the modifiers in the mask are held. When the mask is an iterable over more than one integer, keys in the key_set will be monitored when any of the modifier combinations in the set are held. @@type mask: integer, iterable, None @@param kind: Kind of events to watch, KEY_PRESSED_EVENT or KEY_RELEASED_EVENT. @@type kind: list @@param synchronous: Should the callback notification be synchronous, giving the client the chance to consume the event? @@type synchronous: boolean @@param preemptive: Should the callback be allowed to preempt / consume the event? @@type preemptive: boolean @@param global_: Should callback occur even if an application not supporting AT-SPI is in the foreground? (requires xevie) @@type global_: boolean __iter__N) r rrrZDeviceListenerr)r'r6hasattrZregister_keystroke_listenerr8) rr+key_setmaskr7r2r3r4r-ZsyncFlagmasksmrrrregisterKeystrokeListener s $   z"Registry.registerKeystrokeListenerc Csf|js|jy|j|}Wn dSt|dr8|}n|g}x"|D]}tj||||j|qDWdS)a Deregisters a listener for key stroke events. @@param client: Callable to be invoked when the event occurs @@type client: callable @@param key_set: Set of hardware key codes to stop monitoring. Leave empty to indicate all keys. @@type key_set: list of integer @@param mask: When the mask is None, the codes in the key_set will be monitored only when no modifier is held. When the mask is an integer, keys in the key_set will be monitored only when the modifiers in the mask are held. When the mask is an iterable over more than one integer, keys in the key_set will be monitored when any of the modifier combinations in the set are held. @@type mask: integer, iterable, None @@param kind: Kind of events to stop watching, KEY_PRESSED_EVENT or KEY_RELEASED_EVENT. @@type kind: list @@raise KeyError: When the client isn't already registered for events Nr9)r rrr:rZderegister_keystroke_listenerr8)rr+r;r<r7r-r=r>rrrderegisterKeystrokeListenerCs  z$Registry.deregisterKeystrokeListenercCs,|js|j|dkrd}tj|||dS)aj Generates a keyboard event. One of the keycode or the keysym parameters should be specified and the other should be None. The kind parameter is required and should be one of the KEY_PRESS, KEY_RELEASE, KEY_PRESSRELEASE, KEY_SYM, or KEY_STRING. @@param keycode: Hardware keycode or None @@type keycode: integer @@param keysym: Symbolic key string or None @@type keysym: string @@param kind: Kind of event to synthesize @@type kind: integer N)r rrZgenerate_keyboard_event)rZkeycodeZkeysymr7rrrgenerateKeyboardEventms zRegistry.generateKeyboardEventcCs |js|jtj|||dS)aq Generates a mouse event at the given absolute x and y coordinate. The kind of event generated is specified by the name. For example, MOUSE_B1P (button 1 press), MOUSE_REL (relative motion), MOUSE_B3D (butten 3 double-click). @@param x: Horizontal coordinate, usually left-hand oriented @@type x: integer @@param y: Vertical coordinate, usually left-hand oriented @@type y: integer @@param name: Name of the event to generate @@type name: string N)r rrZgenerate_mouse_event)rxyr.rrrgenerateMouseEventszRegistry.generateMouseEventcCsdS)zH Dispatch events that have been queued. Nr)rrrrpumpQueuedEventsszRegistry.pumpQueuedEvents)N)FT)__name__ __module__ __qualname____doc__r rrrrr!rr$r%r'r/r0Z_KEY_PRESSED_EVENTZ_KEY_RELEASED_EVENTr6r8r?r@rBrErFrrrrr+s:  &    1&cCst}|j||dS)N)rr)r rregistryrrrrs)N) __all__os_osZ gi.repositoryrrrrZ MAIN_LOOP_QTrobjectrrrrrrs  q