a
^W$ @ s@ d dl mZ G dd deZG dd deZdd Zdd Zd
S ) )_gic @ 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 | |S N)str__new__clsnameargskargs r 6/usr/lib64/python3.9/site-packages/gi/_signalhelper.pyr N s zSignal.BoundSignal.__new__c C s t | || _|| _d S r )r __init__signalgobj)selfr r r r r
r Q s
zSignal.BoundSignal.__init__c C s d| S )NzBoundSignal("%s")r r r r r
__repr__V s zSignal.BoundSignal.__repr__c O s | j j| jg|R i |S )zCall the signals closure.)r funcr r r
r r r r
__call__Y s zSignal.BoundSignal.__call__c O s | j j| |g|R i |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 ] s zSignal.BoundSignal.connectc O s$ | j j| d | |g|R i |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 Zdetailr
r r r r
connect_detailedb s z#Signal.BoundSignal.connect_detailedc C s | j | dS )z"Same as GObject.Object.disconnect.N)r
disconnect)r Z
handler_idr r r
r j s z Signal.BoundSignal.disconnectc O s | j jt| g|R i |S )z[Same as GObject.Object.emit except there is no need to specify
the signal name.)r emitr r r r r
r n s zSignal.BoundSignal.emitN) __name__
__module__ __qualname____doc__r r r r r r r r r r r r
BoundSignalI s r! c O s t |r|j}t| |S r )callabler r r r r r r
r s s zSignal.__new__Nc C s |d u rt |r|}|r"|s"|j}t| |rD|sD|sDt|\}}|d u rRt }|| _|| _|| _|| _ || _|| _
|| _ d S 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 x s
zSignal.__init__c C s |du r | S | | |S )z:Returns a BoundSignal when accessed on an object instance.N)r! )r instanceownerr r r
__get__ s zSignal.__get__c
O sj t |tjr&| j|g|R i | n@t| r8t| }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 s* t | || j| j| j| j| j| j| jdS )z%Returns a renamed copy of the Signal.r/ )r1 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 r3 r4 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
r4 s z SignalOverride.get_signal_argsN)r r r r r4 r r r r
r5 s r5 c sZ t }d}t| drRddl}|| t fdd jD }d jv rR 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__ c 3 s" | ]}| j v r j | V qd S r ) annotations).0argspecr r
s
z)get_signal_annotations..return)r% hasattrinspectZgetfullargspecr
r9 )r r( r' rA r r< r
r$ s
r$ c C s | j di }i }| j D ]`\}}t|tr t|}|sT|}||}t| || ||v rhtd| |||< | ||< q || _
| D ]:\}}|j durd| dd }t
| |st| ||j qdS )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__getitemsr0 r r r3 setattr
ValueErrorr4 rB r replacer@ )r ZgsignalsZ
newsignalsr r Z
signalNameZfuncNamer r r
install_signals s&
rK N)r" r r r r5 r$ rK r r r r
s