Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/helium/ebus
An Erlang binding to libdbus
https://github.com/helium/ebus
dbus erlang
Last synced: about 2 months ago
JSON representation
An Erlang binding to libdbus
- Host: GitHub
- URL: https://github.com/helium/ebus
- Owner: helium
- License: apache-2.0
- Created: 2018-08-07T00:10:46.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-07-20T11:22:52.000Z (over 2 years ago)
- Last Synced: 2024-04-14T17:00:28.121Z (9 months ago)
- Topics: dbus, erlang
- Language: Erlang
- Size: 2.3 MB
- Stars: 11
- Watchers: 28
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[![Travis][travis badge]][travis]
[![Hex.pm Version][hex version badge]][hex]
[![License][license badge]][license]
[![Erlang Versions][erlang version badge]][erlang]
[![Build Tool][build tool]][rebar]
# ebus
The `ebus` library provides an Erlang binding for the canonical
[libdbus](https://cgit.freedesktop.org/dbus/dbus/) IPC mechanism.
* [Features](#features)
* [Install](#install)
* [Examples](#examples)
* [Building](#building)
## Features
* A native binding to libdbus
* A callback based service implemenatation scaffold to make it easy
to implement a dbus service
* A proxy object to make it easy to call a dbus service
## Install
Add `ebus` to your `deps` section in `rebar.config`:
``` shell
{deps, [ebus]}.
```
## Examples
Here's an example of talking to [connman] to get the current list of
connectivity related technologies:
```erlang
Eshell V10.1 (abort with ^G)E
1> {ok, B} = ebus:start(system).
{ok,<0.221.0>}
2> {ok, P} = ebus_proxy:start(B, "net.connman", "/", []).
{ok,<0.224.0>}
3> ebus_proxy:call(P, "net.connman.Manager.GetTechnologies").
{ok,[[{"/net/connman/technology/p2p",
#{"Connected" => false,"Name" => "P2P","Powered" => false,
"Tethering" => false,"Type" => "p2p"}},
{"/net/connman/technology/ethernet",
#{"Connected" => false,"Name" => "Wired","Powered" => true,
"Tethering" => false,"Type" => "ethernet"}},
{"/net/connman/technology/wifi",
#{"Connected" => true,"Name" => "WiFi","Powered" => true,
"Tethering" => false,"Type" => "wifi"}},
{"/net/connman/technology/bluetooth",
#{"Connected" => false,"Name" => "Bluetooth",
"Powered" => false,"Tethering" => false,
"Type" => "bluetooth"}}]]}
```
## Building
Fork the repo and simply use `make` to build the library. You will
need the `libdbus` development libraries and headers installed on your
system.
To run the tests run `make test`.
[travis]: https://travis-ci.com/helium/ebus
[travis badge]: https://img.shields.io/travis/com/helium/ebus/master.svg?style=flat-square
[hex]: https://hex.pm/packages/ebus
[license]: https://github.com/helium/ebus/blob/master/LICENSE
[license badge]: https://img.shields.io/github/license/helium/ebus.svg
[hex version badge]: https://img.shields.io/hexpm/v/ebus.svg?style=flat-square
[erlang version badge]: https://img.shields.io/badge/erlang-21.1-blue.svg?style=flat-square
[build tool]: https://img.shields.io/badge/build%20tool-rebar3-orange.svg?style=flat-square
[connman]: https://01.org/connman
[rebar]: http://rebar3.org
[erlang]: http://erlang.org