3
iR�Vd" � @ s� d Z ddlmZ dZdZddlmZ dd lmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZ dd
lmZ dd lmZ dd lmZ er�dd
lmZ G dd� de�ZG dd� de�Z G dd� de�Z G dd� de�Z dS )z9Implementation for dbus.Bus. Not to be imported directly.� )�
generators�Bus� SystemBus�
SessionBus�
StarterBusZreStructuredText)�
DBusException) �BUS_DAEMON_IFACE�BUS_DAEMON_NAME�BUS_DAEMON_PATH� BUS_SESSION� BUS_STARTER�
BUS_SYSTEM� DBUS_START_REPLY_ALREADY_RUNNING�DBUS_START_REPLY_SUCCESS�validate_bus_name�validate_interface_name�validate_member_name�validate_object_path)�
BusConnection)�
SignalMessage)�is_py2)�
UTF8Stringc s� e Zd ZdZi Zejddfdd�Z� fdd�Zdd � Z e
e ddd
�Z dd d �Z e
e �Z dd
d�Ze
e�Zddd�Ze
e�Zdd� 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_type�privater �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 �get�superr �close)�self�t)r" r r! r% m s
z Bus.closec C s | S )z�Return 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_connectionz�self._connection == self, for backwards
compatibility with earlier dbus-python versions
where Bus was not a subclass of Connection.c C s
t | d�S )z�Static 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 | d�S )z�Static 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 | d�S )z�Static 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 )NZsession�systemZstarterzunknown 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 ZdZddd�ZdS )r z The system-wide message bus.FNc C s t j| t j||d�S )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 ZdZddd�ZdS )r z(The session (current login) message bus.FNc C s t j| t j||d�S )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 ZdZddd�ZdS )r zjThe bus that activated this process (only valid if
this process was launched by DBus activation).
FNc C s t j| t j||d�S )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! �<module> s 8