U K^(F@sdZdZddlZddlZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddl m!Z!ddl"m#Z#d eeefZ$d Z%e&d Z'Gd d d e(Z)GdddeZ*dS)) BusConnectionZreStructuredTextN)BUS_DAEMON_IFACEBUS_DAEMON_NAMEBUS_DAEMON_PATH BUS_SESSION BUS_STARTER BUS_SYSTEM DBUS_START_REPLY_ALREADY_RUNNINGDBUS_START_REPLY_SUCCESSNAME_FLAG_ALLOW_REPLACEMENTNAME_FLAG_DO_NOT_QUEUENAME_FLAG_REPLACE_EXISTINGRELEASE_NAME_REPLY_NON_EXISTENTRELEASE_NAME_REPLY_NOT_OWNERRELEASE_NAME_REPLY_RELEASED REQUEST_NAME_REPLY_ALREADY_OWNERREQUEST_NAME_REPLY_EXISTSREQUEST_NAME_REPLY_IN_QUEUE REQUEST_NAME_REPLY_PRIMARY_OWNERvalidate_bus_namevalidate_error_namevalidate_interface_namevalidate_member_namevalidate_object_path) Connection) DBusException)HANDLER_RESULT_NOT_YET_HANDLED)is_py2zWtype='signal',sender='%s',interface='%s',member='NameOwnerChanged',path='%s',arg0='%%s'z)org.freedesktop.DBus.Error.NameHasNoOwnerzdbus.busc@s eZdZdZddZddZdS)NameOwnerWatch)_match _pending_callc sntfdd}fdd}|j|dtttd|_i}trJd|d<|jtttd d f|f||_dS) Ncs |dSN)ZownedZ old_owner new_owner)callbackr"*/usr/lib/python3/dist-packages/dbus/bus.py signal_cbBsz*NameOwnerWatch.__init__..signal_cbcs:|tkrdn ttjd|j|dfddS)NzGetNameOwner(%s) failed:)exc_info) get_dbus_name_NAME_HAS_NO_OWNERloggingZ basicConfig_loggerdebug __class__)ebus_namer$r"r%error_cbEs    z)NameOwnerWatch.__init__..error_cbZNameOwnerChanged)Zarg0T utf8_strings GetNameOwners) radd_signal_receiverrrrrr call_asyncr )selfZbus_connr1r$r&r2keywordsr"r0r%__init__?s0 zNameOwnerWatch.__init__cCs8|jdk r|j|jdk r(|jd|_d|_dSr!)rremover cancel)r8r"r"r%r<^s     zNameOwnerWatch.cancelN)__name__ __module__ __qualname__ __slots__r:r<r"r"r"r%r<srcseZdZdZeZeZeZ e Z e Z edfddZd*fdd ZddZd d Zd+d dZddZd,ddZd-ddZddZddZddZddZddZd d!Zd"d#Zd$d%Zd&d'Zd(d)ZZ S).rzxA connection to a D-Bus daemon that implements the ``org.freedesktop.DBus`` pseudo-service. :Since: 0.81.0 NcCs"|j||d}t|_i|_|S)N)mainloop)Z _new_for_busweakrefWeakValueDictionaryZ _bus_names_signal_sender_matches)clsZaddress_or_typerAZbusr"r"r%__new__{s zBusConnection.__new__c  s|dd}|dk rB|dk r$td|}ddlm}|dtddtt|j|||||f||dk r|tkr|ddd krfd d } nj } | || } | |j <| t S) N named_service3bus_name and named_service cannot both be specifiedrwarnzrPassing the named_service parameter to add_signal_receiver by name is deprecated: please use positional parameters stacklevel:cs|dkrdS)Nr')r;)r#matchr"r%r$sz3BusConnection.add_signal_receiver..callback)pop TypeErrorwarningsrJDeprecationWarningsuperrr6rZset_sender_name_ownerwatch_name_ownerrDadd_match_stringstr) r8Zhandler_functionZ signal_nameZdbus_interfacer1pathr9rGrJr$watchr.rPr%r6s6     z!BusConnection.add_signal_receivercCs0|t||j|d}|dk r,|dSr!) remove_match_string_non_blockingrYrDrRr<)r8rQr[r"r"r%_clean_up_signal_matchsz$BusConnection._clean_up_signal_matchc Cs|dk rx|dddkrx|tkrxz ||WStk rt}z*|tkrL||||WYSd}~XYq|Xn|SdS)NrNrO)rget_name_ownerrr)r*start_service_by_name)r8r1r/r"r"r%activate_name_owners   "z!BusConnection.activate_name_ownerTFcKs||r ||dd}|dk rN|dk r0tdddlm}|dtdd|}|rhtd d ||j|||||d S) aJReturn 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 `follow_name_owner_changes` : bool If the object path is a well-known name and this parameter is false (default), resolve the well-known name to the unique name of its current owner and bind to that instead; if the ownership of the well-known name changes in future, keep communicating with the original owner. This is necessary if the D-Bus API used is stateful. If the object path is a well-known name and this parameter is true, whenever the well-known name changes ownership in future, bind to the new owner, if any. If the given object path is a unique name, this parameter has no effect. :Returns: a `dbus.proxies.ProxyObject` :Raises `DBusException`: if resolving the well-known name to a unique name fails rGNrHrrIziPassing the named_service parameter to get_object by name is deprecated: please use positional parametersrKrLz4get_object does not take these keyword arguments: %sz, ) introspectfollow_name_owner_changes) Z_require_main_looprRrSrTrJrUjoinkeysZProxyObjectClass)r8r1Z object_pathrbrckwargsrGrJr"r"r% get_objects($    zBusConnection.get_objectcCst||tttdd|fS)zGet the numeric uid of the process owning the given bus name. :Parameters: `bus_name` : str A bus name, either unique or well-known :Returns: a `dbus.UInt32` :Since: 0.80.0 ZGetConnectionUnixUserr5r call_blockingrrrr8r1r"r"r% get_unix_users zBusConnection.get_unix_userrc Cs$t|d|tttdd||ffS)a?Start a service which will implement the given bus name on this Bus. :Parameters: `bus_name` : str The well-known bus name to be activated. `flags` : dbus.UInt32 Flags to pass to StartServiceByName (currently none are defined) :Returns: A tuple of 2 elements. The first is always True, the second is either START_REPLY_SUCCESS or START_REPLY_ALREADY_RUNNING. :Raises `DBusException`: if the service could not be started. :Since: 0.80.0 TZStartServiceByNamesurh)r8r1flagsr"r"r%r`s z#BusConnection.start_service_by_namec Cs$t|dd|tttdd||fS)aRequest a bus name. :Parameters: `name` : str The well-known name to be requested `flags` : dbus.UInt32 A bitwise-OR of 0 or more of the flags `NAME_FLAG_ALLOW_REPLACEMENT`, `NAME_FLAG_REPLACE_EXISTING` and `NAME_FLAG_DO_NOT_QUEUE` :Returns: `REQUEST_NAME_REPLY_PRIMARY_OWNER`, `REQUEST_NAME_REPLY_IN_QUEUE`, `REQUEST_NAME_REPLY_EXISTS` or `REQUEST_NAME_REPLY_ALREADY_OWNER` :Raises `DBusException`: if the bus daemon cannot be contacted or returns an error. FZ allow_uniqueZ RequestNamerlrh)r8namermr"r"r% request_names zBusConnection.request_namecCs"t|dd|tttdd|fS)asRelease a bus name. :Parameters: `name` : str The well-known name to be released :Returns: `RELEASE_NAME_REPLY_RELEASED`, `RELEASE_NAME_REPLY_NON_EXISTENT` or `RELEASE_NAME_REPLY_NOT_OWNER` :Raises `DBusException`: if the bus daemon cannot be contacted or returns an error. FrnZ ReleaseNamer5rh)r8ror"r"r% release_name3s zBusConnection.release_namecCs(i}trd|d<|jtttdddf|S)zReturn a list of all currently-owned names on the bus. :Returns: a dbus.Array of dbus.UTF8String :Since: 0.81.0 Tr3Z ListNamesr'r"rrirrrr8r9r"r"r% list_namesDszBusConnection.list_namescCs(i}trd|d<|jtttdddf|S)zReturn a list of all names that can be activated on the bus. :Returns: a dbus.Array of dbus.UTF8String :Since: 0.81.0 Tr3ZListActivatableNamesr'r"rrrsr"r"r%list_activatable_namesQsz$BusConnection.list_activatable_namescCs6i}trd|d<t|dd|jtttdd|ff|S)zReturn the unique connection name of the primary owner of the given name. :Raises `DBusException`: if the `bus_name` has no owner :Since: 0.81.0 Tr3Frnr4r5)rrrirrr)r8r1r9r"r"r%r_^s zBusConnection.get_name_ownercCs t|||S)aWatch the unique connection name of the primary owner of the given name. `callback` will be called with one argument, which is either the unique connection name, or the empty string (meaning the name is not owned). :Since: 0.81.0 )r)r8r1r$r"r"r%rWms zBusConnection.watch_name_ownerc Cst|tttdd|fS)zReturn True iff the given bus name has an owner on this bus. :Parameters: `bus_name` : str The bus name to look up :Returns: a `bool` Z NameHasOwnerr5)boolrirrrrjr"r"r%name_has_ownerys  zBusConnection.name_has_ownercCs|tttdd|fdS)Arrange for this application to receive messages on the bus that match the given rule. This version will block. :Parameters: `rule` : str The match rule :Raises `DBusException`: on error. :Since: 0.80.0 AddMatchr5Nrirrrr8Zruler"r"r%rXs zBusConnection.add_match_stringc Cs|tttdd|fdddS)=Arrange for this application to receive messages on the bus that match the given rule. This version will not block, but any errors will be ignored. :Parameters: `rule` : str The match rule :Raises `DBusException`: on error. :Since: 0.80.0 ryr5Nr7rrrr{r"r"r%add_match_string_non_blockings z+BusConnection.add_match_string_non_blockingcCs|tttdd|fdS)rx RemoveMatchr5Nrzr{r"r"r%remove_match_strings z!BusConnection.remove_match_stringc Cs|tttdd|fdddS)r|rr5Nr}r{r"r"r%r]s z.BusConnection.remove_match_string_non_blocking)NNNN)TF)r)r)!r=r>r?__doc__rZ TYPE_SESSIONrZ TYPE_SYSTEMrZ TYPE_STARTERr ZSTART_REPLY_SUCCESSr ZSTART_REPLY_ALREADY_RUNNINGrFr6r^rargrkr`rprqrtrur_rWrwrXr~rr] __classcell__r"r"r\r%rgs<   9       r)+__all__Z __docformat__r+rBZ_dbus_bindingsrrrrrrr r r r r rrrrrrrrrrrrZdbus.connectionrZdbus.exceptionsrZ dbus.lowlevelrZ dbus._compatrZ_NAME_OWNER_CHANGE_MATCHr*Z getLoggerr,objectrrr"r"r"r%s"d     +