3
iRVd" @ s d Z ddlmZ dZdZddlmZ dd lmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZ dd
lmZ dd lmZ dd lmZ erdd
lmZ G dd deZG dd deZ G dd deZ G dd deZ dS )z9Implementation for dbus.Bus. Not to be imported directly. )
generatorsBus SystemBus
SessionBus
StarterBusZreStructuredText)
DBusException) BUS_DAEMON_IFACEBUS_DAEMON_NAMEBUS_DAEMON_PATH BUS_SESSION BUS_STARTER
BUS_SYSTEM DBUS_START_REPLY_ALREADY_RUNNINGDBUS_START_REPLY_SUCCESSvalidate_bus_namevalidate_interface_namevalidate_member_namevalidate_object_path)
BusConnection)
SignalMessage)is_py2)
UTF8Stringc s e Zd ZdZi ZejddfddZ fddZdd Z e
e ddd
Z dd d Z e
e Z dd
dZe
eZdddZe
eZdd ZeZ ZS )r a A connection to one of three possible standard buses, the SESSION,
SYSTEM, or STARTER bus. This class manages shared connections to those
buses.
If you're trying to subclass `Bus`, you may be better off subclassing
`BusConnection`, which doesn't have all this magic.
FNc C sx | r|| j kr| j | S |tkr(t}n(|tkr6t}n|tkrDt}n td| tj |||d}||_
|st|| j |< |S )a Constructor, returning an existing instance where appropriate.
The returned instance is actually always an instance of `SessionBus`,
`SystemBus` or `StarterBus`.
:Parameters:
`bus_type` : cls.TYPE_SESSION, cls.TYPE_SYSTEM or cls.TYPE_STARTER
Connect to the appropriate bus
`private` : bool
If true, never return an existing shared instance, but instead
return a private connection.
:Deprecated: since 0.82.3. Use dbus.bus.BusConnection for
private connections.
`mainloop` : dbus.mainloop.NativeMainLoop
The main loop to use. The default is to use the default
main loop if one has been set up, or raise an exception
if none has been.
:Changed: in dbus-python 0.80:
converted from a wrapper around a Connection to a Connection
subclass.
zinvalid bus_type %s)mainloop) _shared_instancesr r r
r r r
ValueErrorr __new__ _bus_type)clsZbus_typeprivater subclassZbus r /usr/lib64/python3.6/_dbus.pyr : s
z Bus.__new__c s4 | j }| jjj|| kr"| jj|= tt| j d S )N)r __class__r getsuperr close)selft)r" r r! r% m s
z Bus.closec C s | S )zReturn self, for backwards compatibility with earlier dbus-python
versions where Bus was not a subclass of Connection.
:Deprecated: since 0.80.0
r )r& r r r! get_connections s zBus.get_connectionzself._connection == self, for backwards
compatibility with earlier dbus-python versions
where Bus was not a subclass of Connection.c C s
t | dS )zStatic method that returns a connection to the session bus.
:Parameters:
`private` : bool
If true, do not return a shared connection.
)r )r )r r r r! get_session s zBus.get_sessionc C s
t | dS )zStatic method that returns a connection to the system bus.
:Parameters:
`private` : bool
If true, do not return a shared connection.
)r )r )r r r r!
get_system s zBus.get_systemc C s
t | dS )zStatic method that returns a connection to the starter bus.
:Parameters:
`private` : bool
If true, do not return a shared connection.
)r )r )r r r r! get_starter s zBus.get_starterc C sP | j tkrd}n$| j tkr d}n| j tkr0d}nd}d| jj| jj|t| f S )NZsessionsystemZstarterzunknown bus typez<%s.%s (%s) at %#x>)r r r
r r"
__module____name__id)r& namer r r! __repr__ s
z Bus.__repr__)F)F)F)r. r- __qualname____doc__r r TYPE_SESSIONr r% r( propertyZ _connectionr) staticmethodr* r+ r1 __str__
__classcell__r r )r" r! r / s 2
c @ s e Zd ZdZdddZdS )r z The system-wide message bus.FNc C s t j| t j||dS )a Return a connection to the system bus.
:Parameters:
`private` : bool
If true, never return an existing shared instance, but instead
return a private connection.
`mainloop` : dbus.mainloop.NativeMainLoop
The main loop to use. The default is to use the default
main loop if one has been set up, or raise an exception
if none has been.
)r r )r r Z TYPE_SYSTEM)r r r r r r! r s zSystemBus.__new__)FN)r. r- r2 r3 r r r r r! r s c @ s e Zd ZdZdddZdS )r z(The session (current login) message bus.FNc C s t j| t j||dS )a Return a connection to the session bus.
:Parameters:
`private` : bool
If true, never return an existing shared instance, but instead
return a private connection.
`mainloop` : dbus.mainloop.NativeMainLoop
The main loop to use. The default is to use the default
main loop if one has been set up, or raise an exception
if none has been.
)r r )r r r4 )r r r r r r! r s zSessionBus.__new__)FN)r. r- r2 r3 r r r r r! r s c @ s e Zd ZdZdddZdS )r zjThe bus that activated this process (only valid if
this process was launched by DBus activation).
FNc C s t j| t j||dS )a Return a connection to the bus that activated this process.
:Parameters:
`private` : bool
If true, never return an existing shared instance, but instead
return a private connection.
`mainloop` : dbus.mainloop.NativeMainLoop
The main loop to use. The default is to use the default
main loop if one has been set up, or raise an exception
if none has been.
)r r )r r Z TYPE_STARTER)r r r r r r! r s zStarterBus.__new__)FN)r. r- r2 r3 r r r r r! r s N)r r r r ) r3 Z
__future__r __all__Z
__docformat__Zdbus.exceptionsr Z_dbus_bindingsr r r
r r r
r r r r r r Zdbus.busr Z
dbus.lowlevelr Z dbus._compatr r r r r r r r r r! s 8