9 unstable releases
0.5.2 | Jan 6, 2023 |
---|---|
0.5.1 | Jul 10, 2022 |
0.5.0 | Sep 19, 2021 |
0.4.0 | Jun 14, 2021 |
0.1.0 | Jun 19, 2020 |
#334 in Unix APIs
70,674 downloads per month
Used in 37 crates
(24 directly)
575KB
11K
SLoC
dbus-crossroads is a library that helps you implement interfaces on object paths, i e "server side" method handler code.
It is not as mature as dbus::tree
yet, but the API should be fairly stable and easier
to use than dbus::tree
. Go ahead and use it, and report any issues you find!
To get started, you can jump into the commented examples, one for sync one for async (dbus-tokio), and one slightly more advanced, or familiarize yourself using the API reference.
Design decisions (compared to dbus::tree
):
- First class support for both sync and async methods
- Detect method arguments automatically through generics
- ...but less generics in structs you use, which means less cluttered API
- The tree/crossroads instance is
Send
(but notSync
). - You can now modify the instance from within a method handler
- It is objects (paths) that can contain custom data, and they can contain different data for different objects
- Interface descriptions are kept in a registry, which means less reference counting
Dependencies
~4.5MB
~106K SLoC