a
z]" @ s d Z ddlmZ dZdZddlmZ ddlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZ ddlmZ ddlmZ dd lmZ erdd
lmZ G d d d eZG d
d deZ G dd deZ G dd deZ dS )z9Implementation for dbus.Bus. Not to be imported directly. )
generators)Bus 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 sv |s|| j v r| j | S |tkr&t}n(|tkr4t}n|tkrBt}n td| tj |||d}||_
|sr|| 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 0/usr/lib64/python3.9/site-packages/dbus/_dbus.pyr < s
z Bus.__new__c s4 | j }| jj|| u r"| jj|= tt| d S )N)r __class__r getsuperr close)selftr" r r! r% o 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_connectionu 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)r0 r/ __qualname____doc__r r TYPE_SESSIONr r% r) propertyZ _connectionr+ staticmethodr, r- r3 __str__
__classcell__r r r( r! r 1 s$
3
r 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_SYSTEMr r r r r r! r s zSystemBus.__new__)FNr0 r/ r4 r5 r r r r r! r s r 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 r6 r; r r r! r s zSessionBus.__new__)FNr< r r r r! r s r 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 Z TYPE_STARTERr; r r r! r s zStarterBus.__new__)FNr< r r r r! r s r N) r5 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