3
<_r& @ sj d dl Z ddlmZ de j ko(dk n r6dd ZG dd d eZG d
d d eZd d
Zdd Z dS ) N )_gi c C s
t | dS )N__call__)hasattr)fn r %/usr/lib64/python3.6/_signalhelper.pycallable s r c @ sj e Zd ZdZG dd deZdddZddejdddddfdd Z dd
d Z
d d
Z dddZ dd Z
dS )Signala Object which gives a nice API for creating and binding signals.
:param name:
Name of signal or callable closure when used as a decorator.
:type name: str or callable
:param callable func:
Callable closure method.
:param GObject.SignalFlags flags:
Flags specifying when to run closure.
:param type return_type:
Return type of the Signal.
:param list arg_types:
List of argument types specifying the signals function signature
:param str doc:
Documentation of signal object.
:param callable accumulator:
Accumulator method with the signature:
func(ihint, return_accu, handler_return, accu_data) -> boolean
:param object accu_data:
User data passed to the accumulator.
:Example:
.. code-block:: python
class Spam(GObject.Object):
velocity = 0
@GObject.Signal
def pushed(self):
self.velocity += 1
@GObject.Signal(flags=GObject.SignalFlags.RUN_LAST)
def pulled(self):
self.velocity -= 1
stomped = GObject.Signal('stomped', arg_types=(int,))
@GObject.Signal
def annotated_signal(self, a:int, b:str):
"Python3 annotation support for parameter types.
def on_pushed(obj):
print(obj)
spam = Spam()
spam.pushed.connect(on_pushed)
spam.pushed.emit()
c @ sP e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z dS )zSignal.BoundSignalz
Temporary binding object which can be used for connecting signals
without specifying the signal name string to connect.
c O s t j| |S )N)str__new__)clsnameargskargsr r r
r X s zSignal.BoundSignal.__new__c C s t j| || _|| _d S )N)r
__init__signalgobj)selfr r r r r
r [ s
zSignal.BoundSignal.__init__c C s d| S )NzBoundSignal("%s")r )r r r r
__repr__` s zSignal.BoundSignal.__repr__c O s | j j| jf||S )zCall the signals closure.)r funcr )r r r r r r
r c s zSignal.BoundSignal.__call__c O s | j j| |f||S )z^Same as GObject.Object.connect except there is no need to specify
the signal name.)r connect)r callbackr r r r r
r g s zSignal.BoundSignal.connectc O s | j j| d | |f||S )a
Same as GObject.Object.connect except there is no need to specify
the signal name. In addition concats "::" to the signal name
when connecting; for use with notifications like "notify" when a property
changes.
z::)r r )r r Zdetailr r r r r
connect_detailedl s z#Signal.BoundSignal.connect_detailedc C s | j j| dS )z"Same as GObject.Object.disconnect.N)instance
disconnect)r Z
handler_idr r r
r t s z Signal.BoundSignal.disconnectc O s | j jt| f||S )z[Same as GObject.Object.emit except there is no need to specify
the signal name.)r emitr
)r r r r r r
r x s zSignal.BoundSignal.emitN) __name__
__module__ __qualname____doc__r r r r r r r r r r r r
BoundSignalS s r# c O s t |r|j}tj| |S )N)r r r
r )r r r r r r r
r } s zSignal.__new__Nc C s |r| r|j }nt|r$|}|j }|r4| r4|j}tj| |rX|pH| rXt|\}}|d krft }|| _|| _|| _ || _
|| _|| _ || _ d S )N)
r r r" r
r get_signal_annotationstupler flags return_type arg_types accumulator accu_data) r r r r' r( r) docr* r+ r r r
r s&
zSignal.__init__c C s |dkr | S | j | |S )z:Returns a BoundSignal when accessed on an object instance.N)r# )r r ownerr r r
__get__ s zSignal.__get__c
O sd t |tjr | j|f|| n@t| r2t| }n|j}t| ||| j| j| j | j
| j | j dS dS )zmAllows for instantiated Signals to be used as a decorator or calling
of the underlying signal method.)r r r' r( r) r, r* r+ N)
isinstancer ZGObjectr r
r typer' r( r) r" r* r+ )r objr r r r r r
r s
zSignal.__call__c
C s8 |dkr| j }t| || j| j| j| j| j| j| jdS )z%Returns a renamed copy of the Signal.N)r r r' r( r) r, r* r+ ) r r0 r r' r( r) r" r* r+ )r ZnewNamer r r
copy s
z Signal.copyc C s | j | j| j| j| jfS )zKReturns a tuple of: (flags, return_type, arg_types, accumulator, accu_data))r' r( r) r* r+ )r r r r
get_signal_args s zSignal.get_signal_args)r$ )N)N)r r r! r" r
r# r r ZSIGNAL_RUN_FIRSTr r. r r2 r3 r r r r
r ! s 1*
r c @ s e Zd ZdZdd ZdS )SignalOverridea& Specialized sub-class of Signal which can be used as a decorator for overriding
existing signals on GObjects.
:Example:
.. code-block:: python
class MyWidget(Gtk.Widget):
@GObject.SignalOverride
def configure_event(self):
pass
c C s dS )z Returns the string 'override'.overrider )r r r r
r3 s z SignalOverride.get_signal_argsN)r r r! r" r3 r r r r
r4 s r4 c sZ t }d}t| drRddl}|j| t fdd jD }d jkrR jd }||fS )a Attempt pulling python 3 function annotations off of 'func' for
use as a signals type information. Returns an ordered nested tuple
of (return_type, (arg_type1, arg_type2, ...)). If the given function
does not have annotations then (None, tuple()) is returned.
N__annotations__r c 3 s" | ]}| j kr j | V qd S )N) annotations).0arg)specr r
s z)get_signal_annotations..return)r& r inspectZgetfullargspecr r7 )r r) r( r= r )r: r
r% s
r% c C s | j jdi }i }xn| j j D ]`\}}t|tr t|}|sV|}|j|}t| || ||krjtd| |||< |j ||< q W || _
xF|j D ]:\}}|j dk rd|j dd }t
| |st| ||j qW dS )zAdds Signal instances on a GObject derived class into the '__gsignals__'
dictionary to be picked up and registered as real GObject signals.
__gsignals__z(Signal "%s" has already been registered.NZdo_-_)__dict__getitemsr/ r r
r2 setattr
ValueErrorr3 r> r replacer )r ZgsignalsZ
newsignalsr r Z
signalNameZfuncNamer r r
install_signals s&
rG )r r )r r )
sysr$ r version_infor r
r r4 r% rG r r r r
s "