=======================================================
Type deai.plugin.dbus:DBusConnection (dbus.session_bus)
=======================================================

.. lua:module:: deai.plugin.dbus.DBusConnection

DBus session bus

A connection to the DBus session bus.

See :lua:meth:`dbus.session_bus <dbus.session_bus>` for more information about this type

Methods
==========

.. list-table::
   :header-rows: 0

   * - :lua:meth:`get(destionation, object_path) <get>`
     - Get a DBus object
   * - :lua:meth:`send(type, bus, object_path, interface, method, signature, args) <send>`
     - Send a message to dbus

.. lua:method:: get(destionation, object_path) -> DBusObject

   :rtype: :lua:mod:`DBusObject <deai.plugin.dbus.DBusObject>`
   :type destionation: string
   :param destionation:
   :type object_path: string
   :param object_path:

   Get a DBus object 

   (Note: getting properties are not implemented yet, but you can call
   org.freedesktop.DBus.Properties.Get manually)

   Create a proxy object for a DBus object. Methods are reflected as members of this
   object. DBus signals are also converted to signals emitted from this object. Methods
   must be accessed with their fully qualified names, i.e. "interface.Method". Proxy
   objects for methods are returned, see :lua:mod:`deai.plugin.dbus.DBusMethod`.

   Calling a dbus method will not give you a reply directly, instead an object is
   returned. Listen for a "reply" signal on the object to receive the reply.

   For how DBus types map to deai type, see :lua:mod:`dbus` for more details.

.. lua:method:: send(type, bus, object_path, interface, method, signature, args) -> integer

   :rtype: integer
   :param bus: recipent of this message, not used if type is "signal"
   :type bus: string

   Send a message to dbus 

   Returns a serial number if type is 'method'.