Metadata-Version: 2.1
Name: gdbus-util
Version: 0.0.3
Summary: Easy GDBus service creation with exit-on-idle functionality
Project-URL: Documentation, https://python-gdbus-util.readthedocs.io/en/latest/
Project-URL: GitHub, https://github.com/adombeck/python-gdbus-util
Project-URL: Issues, https://github.com/adombeck/python-gdbus-util/issues
Author-email: Adrian Dombeck <adrian.dombeck@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown

Python GDBus Util
===========

A collection of utilities to create GDBus services in Python.


DBusObject
----------

This class can be used to define a D-Bus object and register it on a
D-Bus connection.

See the [`DBusObject` documentation](https://python-gdbus-util.readthedocs.io/en/latest/api/dbus_object.html) 
for more information.

ExitOnIdleService
-----------------
This class implements race-free exit-on-idle for a D-Bus service. It is
useful for services that are meant to be started on demand and exit
automatically when they are no longer needed.

See the [`ExitOnIdleService` documentation](https://python-gdbus-util.readthedocs.io/en/latest/api/exit_on_idle_service.html)
for more information.

Credits
-------
The race-free exit-on-idle implementation was inspired by 
https://github.com/cgwalters/test-exit-on-idle and systemd's 
[`bus_event_loop_with_idle`](https://github.com/systemd/systemd/blob/190ff0d0a8d1fc367ec04296f24cd1cab5b7543b/src/shared/bus-util.c#L97).
