WWWWWW

Current Directory: /usr/lib64/python2.7/site-packages/dbus
Viewing File: /usr/lib64/python2.7/site-packages/dbus/proxies.pyo
�
毖Sc@s%ddlZyddlmZWn!ek
rCddlmZnXddlZddlmZddlm	Z	m
Z
mZmZdZ
ejd�ZddlmZmZmZmZmZddlmZd	fd
��YZdfd��YZd
efd��YZdefd��YZdS(i����N(tRLock(tprocess_introspection_data(t
DBusExceptiontIntrospectionParserExceptiontMissingErrorHandlerExceptiontMissingReplyHandlerExceptiontrestructuredtextsdbus.proxies(tBUS_DAEMON_IFACEtBUS_DAEMON_NAMEtBUS_DAEMON_PATHtINTROSPECTABLE_IFACEt
LOCAL_PATH(tis_py2t_DeferredMethodcBs)eZdZd�Zd�Zd�ZRS(sXA proxy method which will only get called once we have its
    introspection reply.
    cCs+||_|j|_||_||_dS(N(t
_proxy_methodt_method_namet_appendt_block(tselftproxy_methodtappendtblock((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt__init__6s		cOsVd|ks|jdt�r8|j|j||�dS|j�|j||�SdS(Nt
reply_handlertignore_reply(tgettFalseRRtNoneR(Rtargstkeywords((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt__call__=s
cOs|j|j||�dS(N(RR(RRR((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt
call_asyncHs(t__name__t
__module__t__doc__RRR(((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR
2s		t_ProxyMethodcBs)eZdZd�Zd�Zd�ZRS(s�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Cs�|tkrtdt��n||_||_||_||_tj|�||_|dk	rutj
|�n||_dS(Ns1Methods may not be called on the reserved path %s(RRt_proxyt_connectiont_named_servicet_object_patht_dbus_bindingstvalidate_member_nameRRtvalidate_interface_namet_dbus_interface(Rtproxyt
connectiontbus_nametobject_pathtmethod_nametiface((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRSs
				
	c	Os�|jdd�}|jdd�}|jdt�}|jdd�}|dk	s`|dk	r�|dkrxt��q�|dkr�t��q�|r�td��q�n|jd|j�}|dkr
|dkr�|j}n|d|j}|jj	j
|d�}n|s|dk	rS|jj|j
|j||j|||||�n+|jj|j
|j||j|||�SdS(NRt
error_handlerRt	signatures6ignore_reply and reply_handler cannot be used togethertdbus_interfacet.(tpopRRRRt	TypeErrorR+RR$t_introspect_method_mapRR%RR&R't
call_blocking(	RRRRR2RR3R4tkey((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRgsD
c
Os�|jdd�}|jdd�}|jdd�}|jd|j�}|dkr�|rq|d|j}n	|j}|jjj|d�}n|jj|j	|j
||j|||||�dS(NRR2R3R4R5(R6RR+RR$R8RR%RR&R'(RRRRR2R3R4R:((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR�s$	(R R!R"RRR(((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR#Ls		,tProxyObjectcBs�eZdZeZeZdZdZdZ	dddeed�Z
ed�ddd�Zed�ddd�Zed	�ddd
�Zdd�Zd�Zd
�Zd�Zd�Zd�Zd�Zd�Zdd�Zd�ZeZRS(s�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.
    iiic
Ks�|jdd
�}|d
k	re|d
k	r9td��n|}ddlm}|dtdd�n|jdd
�}	|	d
k	r�|d
k	r�td	��n|	}ddlm}|d
tdd�n|r�tddj|j����n|r|j�n||_	|d
k	r*t
j|�n||_|_
t
j|�||_|sk|j|�|_nd
|_g|_i|_t�|_|s�|jtkr�|j|_n|j|_|j�|_d
S(s�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
        tbuss%conn and bus cannot both be specifiedi����(twarns`Passing the bus parameter to ProxyObject by name is deprecated: please use positional parameterst
stacklevelit
named_services3bus_name and named_service cannot both be specifiedsjPassing the named_service parameter to ProxyObject by name is deprecated: please use positional parameterss>ProxyObject.__init__ does not take these keyword arguments: %ss, N(R6RR7twarningsR=tDeprecationWarningtjointkeyst_require_main_loopt_busR(tvalidate_bus_nameR&t_requested_bus_nametvalidate_object_patht__dbus_object_path__tactivate_name_ownert_pending_introspectt_pending_introspect_queueR8Rt_introspect_lockRt INTROSPECT_STATE_DONT_INTROSPECTt_introspect_statet'INTROSPECT_STATE_INTROSPECT_IN_PROGRESSt_Introspect(
RtconnR.R/t
introspecttfollow_name_owner_changestkwargsR<R=R?((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR�sJ
	
				cCs|jS(N(R&(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt<lambda>ss�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.
            cCs|jS(N(RG(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRVss[The bus name which was requested when this proxy was
            instantiated.
            cCs|jS(N(RI(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRV$ssThe object-path of this proxy.cKs1|jj|d|d|d|jd|j|�S(sx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).
        tsignal_nameR4R.tpath(REtadd_signal_receiverR&RI(RRWthandler_functionR4R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pytconnect_to_signal0s<	cCsSi}trt|d<n|jj|j|jtddd|j|jdt	|�S(Ntutf8_stringst
Introspectttrequire_main_loop((
RtTrueRERR&RIR
t_introspect_reply_handlert_introspect_error_handlerR(RRU((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRQss
	cCs7x'|jD]\}}}|||�q
Wg|_dS(N(RL(RRRR((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt_introspect_execute_queue~scCs||jj�zZyt|�|_Wn!tk
rF}|j|�dSX|j|_d|_	|j
�Wd|jj�XdS(N(RMtacquireRR8RRbt INTROSPECT_STATE_INTROSPECT_DONERORRKRctrelease(Rtdatate((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRa�s

	cCs�tj�tjd|j|j|jj|jj|�|j	j
�z0tjd�|j|_
d|_|j�Wd|j	j�XdS(Ns$Introspect error on %s:%s: %s.%s: %ss'Executing introspect queue due to error(tloggingtbasicConfigt_loggerterrorR&RIt	__class__R!R RMRdtdebugRNRORRKRcRf(RRl((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRb�s
	

	cCsE|jj�z#|jdk	r/|jj�nWd|jj�XdS(N(RMRdRKRRRf(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt_introspect_block�s

cCsa|jj�z?|j|jkr>|jj|||f�n
|||�Wd|jj�XdS(N(RMRdRORPRLRRf(RtcallbackRRU((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt_introspect_add_to_queue�s
cCs>|jd�r-|jd�r-t|��n
|j|�SdS(Nt__(t
startswithtendswithtAttributeErrortget_dbus_method(Rtmember((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt__getattr__�scCs[|j||j|j|j||�}|j|jkrW|j||j|j�}n|S(s,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.
        (	tProxyMethodClassRER&RIRORPtDeferredMethodClassRqRo(RRwR4tret((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRv�s		cCs#d|j|j|jt|�fS(Ns&<ProxyObject wrapping %s %s %s at %#x>(RER&RItid(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt__repr__�sN(R R!R"R#RyR
RzRNRPReRR`RRtpropertyR.trequested_bus_nameR/R[RQRcRaRbRoRqRxRvR}t__str__(((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR;�s6	R					
C					
		&	t	InterfacecBs�eZdZd�Zed�ddd�ZeZed�ddd�Zed�ddd�Z	ed�ddd	�Z
ed
�ddd�Zdd�Zd
�Z
dd�Zd�ZeZRS(s�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.
    cCs4t|t�r|j|_n	||_||_dS(s: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(t
isinstanceR�tproxy_objectt_objR+(RtobjectR4((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR�s		cCs
|jjS(N(R�R/(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRVss.The D-Bus object path of the underlying objectcCs
|jjS(N(R�R.(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRVss:The bus name to which the underlying proxy object is boundcCs
|jjS(N(R�R(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRV	ssGThe bus name which was requested when the underlying object was createdcCs|jS(N(R�(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRV
ssThe underlying proxy objectcCs|jS(N(R+(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRVssThe D-Bus interface representedcKs+|s|j}n|jj||||�S(saArrange 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.
        (R+R�R[(RRWRZR4R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR[s
cCsG|jd�r-|jd�r-t|��n|jj||j�SdS(NRr(RsRtRuR�RvR+(RRw((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRx"scCs+|dkr|j}n|jj||�S(s&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(RR+R�Rv(RRwR4((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyRv(scCsd|j|jt|�fS(Ns%<Interface %r implementing %r at %#x>(R�R+R|(R((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR}4sN(R R!R"RR~RR/RIR.RR�R4R[RxRvR}R�(((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyR��s&									(Rit	threadingRtImportErrortdummy_threadingR(tdbus._expat_introspect_parserRtdbus.exceptionsRRRRt
__docformat__t	getLoggerRkRRR	R
Rtdbus._compatRR
R#R�R;R�(((s2/usr/lib64/python2.7/site-packages/dbus/proxies.pyt<module>s 
"(`�A
F1l3 Manager
