a
ó z]žl ã @ sÜ d Z dZddlZddlZddlZddlmZmZm Z m
Z
m Z m Z m
Z
ddlmZ ddlmZmZmZmZmZ ddlmZ ddlmZmZ eršdd lmZ n dd
lm Z e d ¡Z d d
„ Z G dd„ de ƒZ!G dd„ deƒZdS ))Ú
ConnectionÚ SignalMatchZreStructuredTexté N)r Ú LOCAL_IFACEÚ
LOCAL_PATHÚvalidate_bus_nameÚvalidate_interface_nameÚvalidate_member_nameÚvalidate_object_path)Ú
DBusException)Ú ErrorMessageÚ HANDLER_RESULT_NOT_YET_HANDLEDÚMethodCallMessageÚMethodReturnMessageÚ
SignalMessage)Ú ProxyObject)Úis_py2Úis_py3)ÚString)Ú
UTF8Stringzdbus.connectionc O s d S ©N© )ÚargsÚkwargsr r ú5/usr/lib64/python3.9/site-packages/dbus/connection.pyÚ_noop3 s r c @ sˆ e Zd Zg d¢Zer e d¡ eeƒZddd„Zdd„ Z d d
„ Z
d d „ Z e d
d„ ƒZ
dd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdS ) r )Ú_sender_name_ownerÚ_memberÚ
_interfaceÚ_senderÚ_pathÚ_handlerÚ _args_matchÚ_ruleÚ _byte_arraysÚ
_conn_weakrefÚ_destination_keywordÚ_interface_keywordÚ_message_keywordÚ_member_keywordÚ_sender_keywordÚ
_path_keywordÚ_int_args_matchÚ
_utf8_stringsFNc K sd |d urt |ƒ |d ur t|ƒ |d ur0t|ƒ |d ur@t|ƒ d | _t |¡| _|| _|| _ || _
|| _ || _ || _
trŠ| dd¡| _nd|v rštdƒ‚|| _|| _| | _| | _|
| _| | _|
| _|| _|sÖd | _nŠi | _|D ]~}| d¡sútd| ƒ‚zt |dd … ƒ}W n t y. td| ƒ‚Y n0 |dk sD|dkrPtd | ƒ‚|| | j|< qàd S )
NÚ utf8_stringsFú*unexpected keyword argument 'utf8_strings'Úargz(SignalMatch: unknown keyword argument %sé r é? z9SignalMatch: arg match index must be in range(64), not %d) r r r r r" ÚweakrefÚrefr$ r r r r r r r Úpopr, Ú TypeErrorr# r) r* r( r& r' r% r! r+ Ú
startswithÚintÚ
ValueError)ÚselfÚconnÚsenderÚ object_pathÚdbus_interfaceÚmemberÚhandlerÚ byte_arraysZsender_keywordZ path_keywordZinterface_keywordZmember_keywordZmessage_keywordZdestination_keywordr ÚkwargÚindexr r r Ú__init__C s^
ÿÿ ÿzSignalMatch.__init__c C s t t| ƒƒS ©z-SignalMatch objects are compared by identity.)ÚhashÚid©r9 r r r Ú__hash__~ s zSignalMatch.__hash__c C s | |u S rD r ©r9 Úotherr r r Ú__eq__‚ s zSignalMatch.__eq__c C s | |uS rD r rI r r r Ú__ne__† s zSignalMatch.__ne__c C s | j S r )r rG r r r ÚŠ ó zSignalMatch.c C sº | j d u r´dg}| jd ur*| d| j ¡ | jd urD| d| j ¡ | jd ur^| d| j ¡ | jd urx| d| j ¡ | jd ur¨| j ¡ D ]\}}| d||f ¡ qŒd |¡| _ | j S )Nz
type='signal'z sender='%s'z path='%s'zinterface='%s'z member='%s'z
arg%d='%s'ú,) r" r Úappendr r r r+ ÚitemsÚjoin)r9 ZrulerB Úvaluer r r Ú__str__Œ s
zSignalMatch.__str__c C s d| j t| ƒ| j| ¡ f S )Nz<%s at %x "%s" on conn %r>)Ú __class__rF r" r$ rG r r r Ú__repr__Ÿ s ÿzSignalMatch.__repr__c C s
|| _ d S r )r )r9 Únew_namer r r Úset_sender_name_owner£ s z!SignalMatch.set_sender_name_ownerc K s\ |d | j fvrdS || jkr dS || jkr.dS || jkr r? r r r r Úmatches_removal_spec¦ s
z SignalMatch.matches_removal_specc C sú d }| j d | ¡ fvrdS | jd ur–tdd}tr6tnt}trFd|d< |jf i |¤Ž}| j ¡ D ]4\}}|t
|ƒksŽt || |ƒrŽ|| |kr` dS q`| j d |
¡ fvr¬dS | jd | ¡ fvrÂdS | jd | ¡ fvrØdS zútoâ| j}|d u sø|rø| js$t| jd}tr| j|d< |jf i |¤Ž}i }| jd urB| ¡ || j< | jd ur\| ¡ || j< | jd urv| ¡ || j< | jd ur|
¡ || j< | jd urª| ¡ || j< | jd urÀ||| j< | j|i |¤Ž W n" t ¡ t j ddd Y n0 dS )NFT©r@ r- z&Exception in handler for D-Bus signal:é ©Úexc_info) r Z
get_senderr+ Údictr r r r Ú
get_args_listrQ ÚlenÚ
isinstancer Ú
get_memberr Ú
get_interfacer Úget_pathr, r# r) r% Zget_destinationr* r( r& r' r ÚloggingÚ basicConfigÚ_loggerÚerror)r9 Úmessager r Zarg_typerB rS r- r r r Úmaybe_handle_message¶ s^
ÿ
þ
z SignalMatch.maybe_handle_messagec C s8 | ¡ }|d ur4|j| | j| j| j| jfi | j¤Ž d S r )r$ Úremove_signal_receiverr r r r r! )r9 r: r r r Úremoveð s
þýzSignalMatch.remove)FNNNNNN)Ú__name__Ú
__module__Ú __qualname__Z_slotsr rP ÚtupleÚ __slots__rC rH rK rL Úpropertyr; rT rV rX rY rj rl r r r r r 7 s&
ü
; :r c s~ e Zd ZdZeZ‡ fdd„Zdd„ Zd dd „Zd d
d „Z d d
„ Z
d dd„Z dd„ Z dd„ Z
d dd„Zd dd„Zdd„ Z‡ ZS )!r zzA connection to another application. In this base class there is
assumed to be no bus daemon.
:Since: 0.81.0
c sN t t| ƒj|i |¤Ž t| dƒsJd| _g | _i | _t ¡ | _ |
| j j ¡ d S )NÚ _dbus_Connection_initializedr[ )
Úsuperr rC Úhasattrrs Ú"_Connection__call_on_disconnectionÚ!_signal_recipients_by_object_pathÚ threadingÚLockÚ
_signals_lockZadd_message_filterrU Ú _signal_func)r9 r r ©rU r r rC s
zConnection.__init__c C s |S )a Return the unique name for the given bus name, activating it
if necessary and possible.
If the name is already unique or this connection is not to a
bus daemon, just return it.
:Returns: a bus name. If the given `bus_name` exists, the returned
name identifies its current owner; otherwise the returned name
does not exist.
:Raises DBusException: if the implementation has failed
to activate the given bus name.
:Since: 0.81.0
r )r9 Úbus_namer r r Úactivate_name_owner s z Connection.activate_name_ownerNTc K sn | dd¡}|durB|dur$tdƒ‚ddlm} |dtdd |}|r\td d
| ¡ ¡ ƒ‚| j| |||d S ) aÕ Return a local proxy for the given remote object.
Method calls on the proxy are translated into method calls on the
remote object.
:Parameters:
`bus_name` : str
A bus name (either the unique name or a well-known name)
of the application owning the object. The keyword argument
named_service is a deprecated alias for this.
`object_path` : str
The object path of the desired object
`introspect` : bool
If true (default), attempt to introspect the remote
object to find out supported methods and their signatures
:Returns: a `dbus.proxies.ProxyObject`
Ú
named_serviceNú3bus_name and named_service cannot both be specifiedr ©ÚwarnziPassing the named_service parameter to get_object by name is deprecated: please use positional parametersé ©Ú
stacklevelz4get_object does not take these keyword arguments: %sz, )Ú
introspect)r4 r5 Úwarningsr‚ ÚDeprecationWarningrR ÚkeysÚProxyObjectClass)r9 r} r< r† r r r‚ r r r Ú
get_object& s þ ÿ
ÿzConnection.get_objectc
K s¾ | ¡ | dd¡}|durJ|dur,tdƒ‚|}ddlm} |dtdd t| |||||fi |¤Ž} | j ¡ z>| j
|i ¡}
|
|i ¡} |
|g ¡} | | ¡ W | j ¡ n | j ¡ 0 | S ) a Arrange for the given function to be called when a signal matching
the parameters is received.
:Parameters:
`handler_function` : callable
The function to be called. Its positional arguments will
be the arguments of the signal. By default it will receive
no keyword arguments, but see the description of
the optional keyword arguments below.
`signal_name` : str
The signal name; None (the default) matches all names
`dbus_interface` : str
The D-Bus interface name with which to qualify the signal;
None (the default) matches all interface names
`bus_name` : str
A bus name for the sender, which will be resolved to a
unique name if it is not already; None (the default) matches
any sender.
`path` : str
The object path of the object which must have emitted the
signal; None (the default) matches any object path
: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).
`named_service` : str
A deprecated alias for `bus_name`.
r Nr€ r r zrPassing the named_service parameter to add_signal_receiver by name is deprecated: please use positional parametersrƒ r„ )
Z_require_main_loopr4 r5 r‡ r‚ rˆ r rz Úacquirerw Ú
setdefaultrP Úrelease)
r9 Zhandler_functionÚ signal_namer= r} ÚpathÚkeywordsr r‚ ÚmatchÚ by_interfaceÚ by_memberÚmatchesr r r Úadd_signal_receiverK s2 G þ
ÿÿ
ÿ z Connection.add_signal_receiverc c s¶ |d urd |f}nd}|d ur(d |f}nd}|d ur>d |f}nd}|D ]j}| j |¡}|d u r`qF|D ]J}| |d ¡}|d u r~qd|D ]*}| |d ¡} | d u rœq‚| D ]
}
|
V q q‚qdqFd S )Nr )rw Úget) r9 r r= r> Z path_keysZinterface_keysZ member_keysr“ r” r• Úmr r r Ú_iter_easy_matches¯ s.
z Connection._iter_easy_matchesc K sj | dd ¡}|d urB|d ur$tdƒ‚|}ddlm} |dtdd g } g }
| j ¡ zî| j |d ¡} | d u r|W | j ¡ d S | |d ¡} | d u r W | j ¡ d S | |d ¡}
|
d u rÄW | j ¡ d S |
D ]<}||u sî|j
|||||fi |¤Žrú|
|¡ qÈ| |¡ qÈ| r| | |< n | |= | s6| |= | s6| j|= W | j ¡ n | j ¡ 0 |
D ]}| |¡ qTd S )Nr r€ r r zuPassing the named_service parameter to remove_signal_receiver by name is deprecated: please use positional parametersrƒ r„ )
r4 r5 r‡ r‚ rˆ rz rŒ rw r— rŽ rY rP Ú_clean_up_signal_match)r9 Zhandler_or_matchr r= r} r r‘ r r‚ ÚnewZ deletionsr“ r” r• r’ r r r rk Ì sj ý
ÿ
ã
æ
éüûÿ
z!Connection.remove_signal_receiverc C s d S r r )r9 r’ r r r rš s z!Connection._clean_up_signal_matchc C s¢ t |tƒstS | ¡ }| ¡ }| ¡ }| |||¡D ]}| |¡ q4|tkrž|t krž|dkrž| j
D ]:}z || ƒ W qb t yš t
¡ tjddd Y qb0 qbtS )zvD-Bus filter function. Handle signals by dispatching to Python
callbacks kept in the match-rule tree.
Z Disconnectedz-Exception in handler for Disconnected signal:r[ r\ )ra r r rc rd rb r™ rj r r rv Ú Exceptionre rf rg rh )r9 ri r= r r r’ Úcbr r r r{ s.
ÿ ÿþ
ÿzConnection._signal_funcç ð¿Fc
s |t krtdt ƒ‚|tkr(tdt ƒ‚t|
d‰trH| dd¡ˆd< nd| v rXtdƒ‚t||||d}
z|
j|d|iŽ W nB t y¾ } z*t
¡ t
d |||j|¡ ‚ W Y d
}~n
d
}~0 0 ˆd
u rވ d
u rÞ| |
¡ d
S ˆd
u rêt‰ˆ d
u röt‰ ‡ ‡‡fd d „}| j|
|| | d
S )aS Call the given method, asynchronously.
If the reply_handler is None, successful replies will be ignored.
If the error_handler is None, failures will be ignored. If both
are None, the implementation may request that no reply is sent.
:Returns: The dbus.lowlevel.PendingCall.
:Since: 0.81.0
ú1Methods may not be called on the reserved path %sú6Methods may not be called on the reserved interface %srZ r- Fr. ©Z destinationr Z interfaceÚmethodÚ signatureú.msg_reply_handler)Úrequire_main_loop)r r
r r^ r r— r5 r
rP rœ re rf rg rh rU Z send_messager Zsend_message_with_reply)r9 r} r< r= r¢ r£ r r© r§ Útimeoutr@ r« r ri Úerª r r¦ r Ú
call_async) sL
ÿÿ
ý
þ
þzConnection.call_asyncc
K s |t krtdt ƒ‚|tkr(tdt ƒ‚t|d}
trH| dd¡|
d< nd| v rXtdƒ‚t||||d} z| j|d|iŽ W nB t y¾ } z*t
¡ t
d ||| j| ¡ ‚ W Y d
} ~ n
d
} ~ 0 0 | | |¡}
|
jf i |
¤Ž}t|ƒd krìd
S t|ƒd kr|d S t|ƒS d
S )
zECall the given method, synchronously.
:Since: 0.81.0
rŸ r rZ r- Fr. r¡ r£ r¤ Nr r[ )r r
r r^ r r— r5 r
rP rœ re rf rg rh rU Z!send_message_with_reply_and_blockr_ r` rp )r9 r} r< r= r¢ r£ r r¬ r@ r r¨ ri r Z
reply_messageZ args_listr r r Ú
call_blockingi sF ÿÿ
ý
þÿ zConnection.call_blockingc C s | j |¡ dS )z©Arrange for `callable` to be called with one argument (this
Connection object) when the Connection becomes
disconnected.
:Since: 0.83.0
N)rv rP )r9 Úcallabler r r Úcall_on_disconnection– s z Connection.call_on_disconnection)NNT)NNNN)NNNN)rž FT)rž F)rm rn ro Ú__doc__r rŠ rC r~ r‹ r– r™ rk rš r{ r® r¯ r± Ú
__classcell__r r r| r r ú s2
& ü
d ü
; ý
A þ
-r )"Ú__all__Z
__docformat__re rx r2 Z_dbus_bindingsr Z _Connectionr r r r r r Zdbus.exceptionsr
Z
dbus.lowlevelr r r
r r Z dbus.proxiesr Z dbus._compatr r r r Z getLoggerrg r Úobjectr r r r r Ú s" $
D