1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
Python DBus-Fast Documentation
==============================
.. module:: dbus_fast
.. toctree::
:maxdepth: 3
:caption: Reference:
type-system/index.rst
high-level-client/index.rst
high-level-service/index.rst
low-level-interface/index.rst
message-bus/index.rst
introspection
validators
constants
errors
authentication
Overview
++++++++
Python DBus-Fast is a library for the `DBus message bus system
<https://www.freedesktop.org/wiki/Software/dbus/>`_ for interprocess
communication in a Linux desktop or mobile environment.
Desktop application developers can use this library for integrating
their applications into desktop environments by implementing common DBus
standard interfaces or creating custom plugin interfaces.
Desktop users can use this library to create their own scripts and
utilities to interact with those interfaces for customization of their
desktop environment.
While other libraries for DBus exist for Python, this library offers the
following improvements:
- Zero dependencies and pure Python 3.
- Support for multiple main loop backends including asyncio and the
GLib main loop.
- Nonblocking IO suitable for GUI development.
- Target the latest language features of Python for beautiful services
and clients.
- Complete implementation of the DBus type system without ever guessing
types.
- Integration tests for all features of the library.
- Completely documented public API.
The library offers three core interfaces:
- `The High Level Client <high-level-client/index.html>`_ - Communicate
with an existing interface exported on the bus by another client
through a proxy object.
- `The High Level Service <high-level-service/index.html>`_ - Export a
service interface for your application other clients can connect to
for interaction with your application at runtime.
- `The Low Level Interface <low-level-interface/index.html>`_ - Work
with DBus messages directly for applications that work with the DBus
daemon directly or to build your own high level abstractions.
Installation
++++++++++++
This library is available on PyPi as `dbus-fast
<https://pypi.org/project/dbus-fast/>`_.
.. code-block:: bash
pip3 install dbus-fast
Contributing
++++++++++++
Development for this library happens on `Github
<https://github.com/Bluetooth-Devices/dbus-fast>`_. Report bugs or
request features there. Contributions are welcome.
License
++++++++
This library is available under an `MIT License
<https://github.com/Bluetooth-Devices/dbus-fast/blob/main/LICENSE>`_.
© 2022, Bluetooth Devices authors
© 2019, Tony Crisci
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
|
