Current File : //snap/core18/current/usr/lib/python3/dist-packages/urwid/__pycache__/signals.cpython-36.pyc
3
��dZ�1 � @ s� d dl mZmZ d dlZd dlZG dd� de�Zdd� ZG dd� de�Z G d d
� d
e�Z
e
� Z e j Z
e jZe jZe jZe jZdS ) � )�division�print_functionNc s e Zd ZdZ� fdd�Z� ZS )� MetaSignalszl
register the list of signals in the class variable signals,
including signals in superclasses.
c sr |j dg �}x | jD ]}|jt|dg �� qW ttdd� |D ��j� �}||d< t| |� tt | �j
|||� d S )N�signalsc S s g | ] }|d f�qS )N� )�.0�xr r �//usr/lib/python3/dist-packages/urwid/signals.py�
<listcomp>% s z(MetaSignals.__init__.<locals>.<listcomp>) �get� __bases__�extend�getattr�list�dict�keys�register_signal�superr �__init__)�cls�name�bases�dr Z
superclass)� __class__r r r ! s
zMetaSignals.__init__)�__name__�
__module__� __qualname__�__doc__r �
__classcell__r r )r r r s r c C s$ t | |�rt| |�S t| ||� |S )N)�hasattrr �setattr)�objr �valuer r r �setdefaultattr* s
r# c @ s e Zd ZdZg ZdS )�KeyzX
Minimal class, whose only purpose is to produce objects with a
unique hash
N)r r r r � __slots__r r r r r$ 1 s r$ c @ sV e Zd ZdZdd� Zdd� Zddd�Zdd d
�Zdd d �Zd
d� Z dd� Z
dd� Z dS )�SignalsZ_urwid_signalsc C s
i | _ d S )N)�
_supported)�selfr r r r ; s zSignals.__init__c C s || j |< dS )a�
:param sig_class: the class of an object that will be sending signals
:type sig_class: class
:param signals: a list of signals that may be sent, typically each
signal is represented by a string
:type signals: signal names
This function must be called for a class before connecting any
signal callbacks or emitting any signals from that class' objects
N)r' )r( �sig_clsr r r r �register> s zSignals.registerNc s� |j }��jj|g �kr(td�|f ��t� � t|�ji �}|j�g �} tj |��� ���fdd�}
�j
|||
�}| j � |||f� � S )a7
:param obj: the object sending a signal
:type obj: object
:param name: the signal to listen for, typically a string
:type name: signal name
:param callback: the function to call when that signal is sent
:type callback: function
:param user_arg: deprecated additional argument to callback (appended
after the arguments passed when the signal is
emitted). If None no arguments will be added.
Don't use this argument, use user_args instead.
:param weak_args: additional arguments passed to the callback
(before any arguments passed when the signal
is emitted and before any user_args).
These arguments are stored as weak references
(but converted back into their original value
before passing them to callback) to prevent
any objects referenced (indirectly) from
weak_args from being kept alive just because
they are referenced by this signal handler.
Use this argument only as a keyword argument,
since user_arg might be removed in the future.
:type weak_args: iterable
:param user_args: additional arguments to pass to the callback,
(before any arguments passed when the signal
is emitted but after any weak_args).
Use this argument only as a keyword argument,
since user_arg might be removed in the future.
:type user_args: iterable
When a matching signal is sent, callback will be called. The
arguments it receives will be the user_args passed at connect
time (as individual arguments) followed by all the positional
parameters sent with the signal.
As an example of using weak_args, consider the following snippet:
>>> import urwid
>>> debug = urwid.Text('')
>>> def handler(widget, newtext):
... debug.set_text("Edit widget changed to %s" % newtext)
>>> edit = urwid.Edit('')
>>> key = urwid.connect_signal(edit, 'change', handler)
If you now build some interface using "edit" and "debug", the
"debug" widget will show whatever you type in the "edit" widget.
However, if you remove all references to the "debug" widget, it
will still be kept alive by the signal handler. This because the
signal handler is a closure that (implicitly) references the
"edit" widget. If you want to allow the "debug" widget to be
garbage collected, you can create a "fake" or "weak" closure
(it's not really a closure, since it doesn't reference any
outside variables, so it's just a dynamic function):
>>> debug = urwid.Text('')
>>> def handler(weak_debug, widget, newtext):
... weak_debug.set_text("Edit widget changed to %s" % newtext)
>>> edit = urwid.Edit('')
>>> key = urwid.connect_signal(edit, 'change', handler, weak_args=[debug])
Here the weak_debug parameter in print_debug is the value passed
in the weak_args list to connect_signal. Note that the
weak_debug value passed is not a weak reference anymore, the
signals code transparently dereferences the weakref parameter
before passing it to print_debug.
Returns a key associated by this signal handler, which can be
used to disconnect the signal later on using
urwid.disconnect_signal_by_key. Alternatively, the signal
handler can also be disconnected by calling
urwid.disconnect_signal, which doesn't need this key.
z No such signal %r for object %rc s< �� }|r8yt |�ji �� � = W n tk
r6 Y nX d S )N)r � _signal_attr�KeyError)�weakref�o)�keyr �obj_weakr( r r �weakref_callback� s z)Signals.connect.<locals>.weakref_callback) r r' r � NameErrorr$ r# r+ �
setdefaultr- �ref�_prepare_user_args�append) r( r! r �callback�user_arg� weak_args� user_argsr) r �handlersr1 r )r/ r r0 r( r �connectK s M
zSignals.connectc s � fdd�|pg D �|pg S )Nc s g | ]}t j|� ��qS r )r- r4 )r �a)r7 r r r
� s z.Signals._prepare_user_args.<locals>.<listcomp>r )r( r9 r: r7 r )r7 r r5 � s zSignals._prepare_user_argsc
C sh t || ji �}||krdS || }| j||�}x4|D ],} | dd� |||fkr4| j||| d �S q4W dS )aI
:param obj: the object to disconnect the signal from
:type obj: object
:param name: the signal to disconnect, typically a string
:type name: signal name
:param callback: the callback function passed to connect_signal
:type callback: function
:param user_arg: the user_arg parameter passed to connect_signal
:param weak_args: the weak_args parameter passed to connect_signal
:param user_args: the weak_args parameter passed to connect_signal
This function will remove a callback from the list connected
to a signal with connect_signal(). The arguments passed should
be exactly the same as those passed to connect_signal().
If the callback is not connected or already disconnected, this
function will simply do nothing.
N� r )r# r+ r5 �disconnect_by_key)
r( r! r r7 r8 r9 r: r r; �hr r r �
disconnect� s
zSignals.disconnectc s8 t || ji �}|j|g �}� fdd�|D �|dd�< dS )an
:param obj: the object to disconnect the signal from
:type obj: object
:param name: the signal to disconnect, typically a string
:type name: signal name
:param key: the key for this signal handler, as returned by
connect_signal().
:type key: Key
This function will remove a callback from the list connected
to a signal with connect_signal(). The key passed should be the
value returned by connect_signal().
If the callback is not connected or already disconnected, this
function will simply do nothing.
c s g | ]}|d � k r|�qS )r r )r r@ )r/ r r r
� s z-Signals.disconnect_by_key.<locals>.<listcomp>N)r# r+ r )r( r! r r/ r r; r )r/ r r? � s zSignals.disconnect_by_keyc G sL d}t || ji �}|j|g �}x(|D ] \}}} }
|| j|| |
|�O }q$W |S )a�
:param obj: the object sending a signal
:type obj: object
:param name: the signal to send, typically a string
:type name: signal name
:param \*args: zero or more positional arguments to pass to the signal
callback functions
This function calls each of the callbacks connected to this signal
with the args arguments as positional parameters.
This function returns True if any of the callbacks returned True.
F)r r+ r �_call_callback) r( r! r �args�resultr r; r/ r7 r8 r: r r r �emit� s z Signals.emitc C sp |rJg }x4|D ],}t |tj�r0|� }|d kr0dS |j|� qW |j|� n|}|d k rdtj||f�}t||� �S )NF)�
isinstancer- �
ReferenceTyper6 r
� itertools�chain�bool)r( r7 r8 r: Z emit_argsZ args_to_pass�argr r r rB s
zSignals._call_callback)NNN)N)NNN) r r r r+ r r* r< r5 rA r? rE rB r r r r r& 8 s
p
"r& )Z
__future__r r rH r- �typer r# �objectr$ r& Z_signalsrE Z emit_signalr* r r< Zconnect_signalrA Zdisconnect_signalr? Zdisconnect_signal_by_keyr r r r �<module> s r
Mini Shell