JezK
Edit File: _signalhelper.cpython-39.opt-1.pyc
a �� ^W$ � @ s@ d dl mZ G dd� de�ZG dd� de�Zdd� Zdd � Zd S ) � )�_gic @ sj e Zd ZdZG dd� de�Zddd�Zddejdddddfdd �Z dd d �Z d d � Z ddd�Z 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__��cls�name�args�kargs� 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__�signal�gobj)�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 "::<detail>" 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_annotations�tupler �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 �instance�ownerr r r �__get__� s zSignal.__get__c O sj t |tj�r&| j|g|�R i |�� n@t| �r8t| �}n|j}t| �||| j| j| j | j | j | j d�S 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| jd�S )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| d�rRddl}|�| �� 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)�.0�arg��specr r � <genexpr>� s �z)get_signal_annotations.<locals>.<genexpr>�return)r% �hasattr�inspectZgetfullargspecr r9 )r r( r' rA r r< r r$ � s r$ c C s� | j �di �}i }| j �� D ]`\}}t|t�r t|�}|sT|}|�|�}t| ||� ||v rhtd| ��|||< |� � ||< q || _ |�� D ]:\}}|j dur�d|� dd� }t | |�s�t| ||j � q�dS )z�Adds 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__�get�itemsr0 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 �<module> s