CasperSecurity
o
�t3b�` � @ s� d dl Z zd dlmZ W n ey d dlmZ Y nw d dlZd dlmZ d dlm Z m
Z
m Z m Z dZ
e �d�Zd dlmZmZmZmZmZ d dlmZ G d d
� d
�ZG d d � d �ZG d
d� de�ZG dd� de�ZdS )� N)�RLock)�process_introspection_data)�
DBusException� IntrospectionParserException� MissingErrorHandlerException� MissingReplyHandlerException�restructuredtextz dbus.proxies)�BUS_DAEMON_IFACE�BUS_DAEMON_NAME�BUS_DAEMON_PATH�INTROSPECTABLE_IFACE�
LOCAL_PATH)�is_py2c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) �_DeferredMethodzXA proxy method which will only get called once we have its
introspection reply.
c C s || _ |j| _|| _|| _d S �N)�
_proxy_method� _method_name�_append�_block)�self� proxy_method�append�block� r �./usr/lib/python3/dist-packages/dbus/proxies.py�__init__8 s
z_DeferredMethod.__init__c O s@ d|v s
|� dd�r| �| j||� d S | �� | j|i |��S )N�
reply_handler� ignore_replyF)�getr r r �r �args�keywordsr r r �__call__? s
�z_DeferredMethod.__call__c O s | � | j||� d S r )r r r r r r �
call_asyncJ s z_DeferredMethod.call_asyncN��__name__�
__module__� __qualname__�__doc__r r# r$ r r r r r 4 s
r c @ r ) � _ProxyMethodz�A proxy method.
Typically a member of a ProxyObject. Calls to the
method produce messages that travel over the Bus and are routed
to a specific named Service.
c C sX |t kr
tdt ��|| _|| _|| _|| _t�|� || _|d ur't� |� || _
d S )Nz1Methods may not be called on the reserved path %s) r
r �_proxy� _connection�_named_service� _object_path�_dbus_bindings�validate_member_namer �validate_interface_name�_dbus_interface)r �proxy�
connection�bus_name� object_path� method_name�ifacer r r r U s �
z_ProxyMethod.__init__c O s |� dd �}|� dd �}|� dd�}|� dd �}|d us |d ur4|d u r't� �|d u r.t� �|r4td��|� d| j�}|d u rV|d u rG| j}n|d | j }| jj�|d �}|s\|d urr| j j
| j | j || j||||fi |�� d S | j j
| j | j || j||fi |��S ) Nr �
error_handlerr F� signaturez6ignore_reply and reply_handler cannot be used together�dbus_interface�.)�popr r � TypeErrorr2 r r+ �_introspect_method_mapr r, r$ r- r. �
call_blocking) r r! r" r r9 r r: r; �keyr r r r# i sL
�
�
��z_ProxyMethod.__call__c O s� |� dd �}|� dd �}|� dd �}|� d| j�}|d u r2|r'|d | j }n| j}| jj�|d �}| jj| j| j || j||||fi |�� d S )Nr r9 r: r; r< )
r= r2 r r+ r? r r, r$ r- r. )r r! r" r r9 r: r; rA r r r r$ � s(
�
�z_ProxyMethod.call_asyncNr% r r r r r* N s
,r* c @ s� e Zd ZdZeZeZdZdZ dZ
d%dd �Z e d
d � ddd �Z
e d
d � ddd�Ze dd � ddd�Zd&dd�Zdd� Zdd� Zdd� Zdd� Zdd � Zd d � Zd d � Zd&d!d"�Zd#d$� ZeZdS )'� ProxyObjectz�A proxy to the remote Object.
A ProxyObject is provided by the Bus. ProxyObjects
have member functions, and can be called like normal Python objects.
r � � NTFc
K s8 |� dd�}|dur!|durtd��|}ddlm} |dtdd� |� d d�} | durB|dur3td
��| }ddlm} |d tdd� |rOtd d
�|�� � ��|rU|�� || _|durat �
|� | | _ | _ t �
|� || _|sw|�|�| _ d| _g | _i | _t� | _|r�| jtkr�| j| _dS | j| _| �� | _dS )a� Initialize the proxy object.
:Parameters:
`conn` : `dbus.connection.Connection`
The bus or connection on which to find this object.
The keyword argument `bus` is a deprecated alias for this.
`bus_name` : str
A bus name for the application owning the object, to be used
as the destination for method calls and the sender for
signal matches. The keyword argument ``named_service`` is a
deprecated alias for this.
`object_path` : str
The object path at which the application exports the object
`introspect` : bool
If true (default), attempt to introspect the remote
object to find out supported methods and their signatures
`follow_name_owner_changes` : bool
If true (default is false) and the `bus_name` is a
well-known name, follow ownership changes for that name
�busNz%conn and bus cannot both be specifiedr )�warnz`Passing the bus parameter to ProxyObject by name is deprecated: please use positional parametersrD )�
stacklevel�
named_servicez3bus_name and named_service cannot both be specifiedzjPassing the named_service parameter to ProxyObject by name is deprecated: please use positional parametersz>ProxyObject.__init__ does not take these keyword arguments: %sz, )r= r> �warningsrF �DeprecationWarning�join�keys�_require_main_loop�_busr/ �validate_bus_namer- �_requested_bus_name�validate_object_path�__dbus_object_path__�activate_name_owner�_pending_introspect�_pending_introspect_queuer? r �_introspect_lockr
� INTROSPECT_STATE_DONT_INTROSPECT�_introspect_state�'INTROSPECT_STATE_INTROSPECT_IN_PROGRESS� _Introspect)
r �connr5 r6 �
introspect�follow_name_owner_changes�kwargsrE rF rH r r r r � sP � � �
zProxyObject.__init__c C � | j S r )r- �r r r r �<lambda> � zProxyObject.<lambda>a� The bus name to which this proxy is bound. (Read-only,
may change.)
If the proxy was instantiated using a unique name, this property
is that unique name.
If the proxy was instantiated with a well-known name and with
``follow_name_owner_changes`` set false (the default), this
property is the unique name of the connection that owned that
well-known name when the proxy was instantiated, which might
not actually own the requested well-known name any more.
If the proxy was instantiated with a well-known name and with
``follow_name_owner_changes`` set true, this property is that
well-known name.
c C r_ r )rP r` r r r ra rb z[The bus name which was requested when this proxy was
instantiated.
c C r_ r )rR r` r r r ra & rb z The object-path of this proxy.c K s" | j j|f||| j| jd�|��S )ax Arrange for the given function to be called when the given signal
is received.
:Parameters:
`signal_name` : str
The name of the signal
`handler_function` : callable
A function to be called when the signal is emitted by
the remote object. Its positional arguments will be the
arguments of the signal; optionally, it may be given
keyword arguments as described below.
`dbus_interface` : str
Optional interface with which to qualify the signal name.
If None (the default) the handler will be called whenever a
signal of the given member name is received, whatever
its interface.
:Keywords:
`utf8_strings` : bool
If True, the handler function will receive any string
arguments as dbus.UTF8String objects (a subclass of str
guaranteed to be UTF-8). If False (default) it will receive
any string arguments as dbus.String objects (a subclass of
unicode).
`byte_arrays` : bool
If True, the handler function will receive any byte-array
arguments as dbus.ByteArray objects (a subclass of str).
If False (default) it will receive any byte-array
arguments as a dbus.Array of dbus.Byte (subclasses of:
a list of ints).
`sender_keyword` : str
If not None (the default), the handler function will receive
the unique name of the sending endpoint as a keyword
argument with this name
`destination_keyword` : str
If not None (the default), the handler function will receive
the bus name of the destination (or None if the signal is a
broadcast, as is usual) as a keyword argument with this name.
`interface_keyword` : str
If not None (the default), the handler function will receive
the signal interface as a keyword argument with this name.
`member_keyword` : str
If not None (the default), the handler function will receive
the signal name as a keyword argument with this name.
`path_keyword` : str
If not None (the default), the handler function will receive
the object-path of the sending object as a keyword argument
with this name
`message_keyword` : str
If not None (the default), the handler function will receive
the `dbus.lowlevel.SignalMessage` as a keyword argument with
this name.
`arg...` : unicode or UTF-8 str
If there are additional keyword parameters of the form
``arg``\ *n*, match only signals where the *n*\ th argument
is the value given for that keyword parameter. As of this time
only string arguments can be matched (in particular,
object paths and signatures can't).
)� signal_namer; r5 �path)rN �add_signal_receiverr- rR �r rc �handler_functionr; r" r r r �connect_to_signal2 s
<���z ProxyObject.connect_to_signalc C s> i }t rd|d< | jj| j| jtddd| j| jfddi|��S )NT� utf8_strings�
Introspect� r �require_main_loopF)r rN r$ r- rR r �_introspect_reply_handler�_introspect_error_handler)r r^ r r r rZ u s
���zProxyObject._Introspectc C s* | j D ] \}}}||i |�� qg | _ d S r )rU )r r r! r" r r r �_introspect_execute_queue� s
z%ProxyObject._introspect_execute_queuec
C s� | j �� z9zt|�| _W n ty+ } z| �|� W Y d }~W | j �� d S d }~ww | j| _d | _ | �
� W | j �� d S | j �� w r ) rV �acquirer r? r rn �release� INTROSPECT_STATE_INTROSPECT_DONErX rT ro )r �data�er r r rm � s
��
z%ProxyObject._introspect_reply_handlerc C sp t �� t�d| j| j|jj|jj|� | j �
� zt� d� | j | _
d | _| �� W | j �� d S | j �� w )Nz$Introspect error on %s:%s: %s.%s: %sz'Executing introspect queue due to error)�logging� basicConfig�_logger�errorr- rR � __class__r' r& rV rp �debugrW rX rT ro rq )r rx r r r rn � s �
z%ProxyObject._introspect_error_handlerc C sL | j �� z| jd ur| j�� W | j �� d S W | j �� d S | j �� w r )rV rp rT r rq r` r r r �_introspect_block� s
�z ProxyObject._introspect_blockc C sf | j �� z'| j| jkr| j�|||f� n||i |�� W | j �� d S W | j �� d S | j �� w r )rV rp rX rY rU r rq )r �callbackr! r^ r r r �_introspect_add_to_queue� s
�z$ProxyObject._introspect_add_to_queuec C s& |� d�r|�d�rt|��| �|�S �N�__)�
startswith�endswith�AttributeError�get_dbus_method�r �memberr r r � __getattr__� s
zProxyObject.__getattr__c C s< | � | | j| j| j||�}| j| jkr | �|| j| j�}|S )a, Return a proxy method representing the given D-Bus method. The
returned proxy method can be called in the usual way. For instance, ::
proxy.get_dbus_method("Foo", dbus_interface='com.example.Bar')(123)
is equivalent to::
proxy.Foo(123, dbus_interface='com.example.Bar')
or even::
getattr(proxy, "Foo")(123, dbus_interface='com.example.Bar')
However, using `get_dbus_method` is the only way to call D-Bus
methods with certain awkward names - if the author of a service
implements a method called ``connect_to_signal`` or even
``__getattr__``, you'll need to use `get_dbus_method` to call them.
For services which follow the D-Bus convention of CamelCaseMethodNames
this won't be a problem.
) �ProxyMethodClassrN r- rR rX rY �DeferredMethodClassr} r{ )r r� r; �retr r r r� � s
�
�zProxyObject.get_dbus_methodc C s d| j | j| jt| �f S )Nz&<ProxyObject wrapping %s %s %s at %#x>)rN r- rR �idr` r r r �__repr__� s �zProxyObject.__repr__)NNNTFr )r& r' r( r) r* r� r r� rW rY rr r �propertyr5 �requested_bus_namer6 rh rZ ro rm rn r{ r} r� r� r� �__str__r r r r rB � s@
� S���
C
&rB c @ s� e Zd ZdZdd� Zedd� ddd�ZeZedd� ddd �Zed
d� ddd �Z ed d� ddd
�Z
edd� ddd�Z ddd�Z dd� Z
ddd�Zdd� ZeZdS )� Interfacez�An interface into a remote object.
An Interface can be used to wrap ProxyObjects
so that calls can be routed to their correct
D-Bus interface.
c C s$ t |t�r
|j| _n|| _|| _dS )a: Construct a proxy for the given interface on the given object.
:Parameters:
`object` : `dbus.proxies.ProxyObject` or `dbus.Interface`
The remote object or another of its interfaces
`dbus_interface` : str
An interface the `object` implements
N)�
isinstancer� � proxy_object�_objr2 )r �objectr; r r r r � s
zInterface.__init__c C � | j jS r )r� r6 r` r r r ra � zInterface.<lambda>Nz.The D-Bus object path of the underlying objectc C r� r )r� r5 r` r r r ra r� z:The bus name to which the underlying proxy object is boundc C r� r )r� r� r` r r r ra r� zGThe bus name which was requested when the underlying object was createdc C r_ r )r� r` r r r ra rb zThe underlying proxy objectc C r_ r )r2 r` r r r ra rb z The D-Bus interface representedc K s" |s| j }| jj|||fi |��S )aa Arrange for a function to be called when the given signal is
emitted.
The parameters and keyword arguments are the same as for
`dbus.proxies.ProxyObject.connect_to_signal`, except that if
`dbus_interface` is None (the default), the D-Bus interface that
was passed to the `Interface` constructor is used.
)r2 r� rh rf r r r rh s
��zInterface.connect_to_signalc C s, |� d�r|�d�rt|��| j�|| j�S r~ )r� r� r� r� r� r2 r� r r r r� $ s zInterface.__getattr__c C s |du r| j }| j�||�S )a& Return a proxy method representing the given D-Bus method.
This is the same as `dbus.proxies.ProxyObject.get_dbus_method`
except that if `dbus_interface` is None (the default),
the D-Bus interface that was passed to the `Interface` constructor
is used.
N)r2 r� r� )r r� r; r r r r� * s zInterface.get_dbus_methodc C s d| j | jt| �f S )Nz%<Interface %r implementing %r at %#x>)r� r2 r� r` r r r r� 6 s �zInterface.__repr__r )r& r' r( r) r r� r6 rR r5 r� r� r; rh r� r� r� r� r r r r r� � s4 � �� � �
�
r� ) ru � threadingr � ImportError�dummy_threadingr/ � dbus._expat_introspect_parserr �dbus.exceptionsr r r r �
__docformat__� getLoggerrw r r
r r r
� dbus._compatr r r* r� rB r� r r r r �<module> s& �
` B