Javascript-DBus bridge
Project description
Cloudeebus
==========
Cloudeebus - DBus for the Cloud - is a component which enables calling DBus
methods and registering on DBus signals from Javascript.
Install
-------
### Installing Cloudeebus from the project root directory:
Cloudeebus will install itself in Python's dist-packages folder. The
cloudeebus.py wrapper shell goes in the executables path.
sudo python setup.py install
See the [Getting Started](https://github.com/01org/cloudeebus/wiki/Getting-started)
section of the [Cloudeebus wiki](https://github.com/01org/cloudeebus/wiki)
for a list of dependencies to install.
### Running Cloudeebus:
The Cloudeebus server must be run either with credentials and a whitelist to
restrict access to DBus services, or in opendoor mode.
usage: cloudeebus.py [-h] [-v] [-d] [-o] [-p PORT] [-c CREDENTIALS]
[-w WHITELIST] [-s SERVICELIST] [-n NETMASK]
Javascript DBus bridge.
optional arguments:
-h, --help show this help message and exit
-v, --version print version and exit
-d, --debug log debug info on standard output
-o, --opendoor allow anonymous access to all services
-p PORT, --port PORT port number
-c CREDENTIALS, --credentials CREDENTIALS
path to credentials file
-w WHITELIST, --whitelist WHITELIST
path to whitelist file (DBus services to use)
-s SERVICELIST, --servicelist SERVICELIST
path to servicelist file (DBus services to export)
-n NETMASK, --netmask NETMASK
netmask,IP filter (comma separated.) eg. : -n
127.0.0.1,192.168.2.0/24,10.12.16.0/255.255.255.0
Documentation
-------------
* [Cloudeebus](http://01.org/cloudeebus) project home page on [01.org](http://01.org)
* [Javascript API](https://github.com/01org/cloudeebus/wiki/API) reference.
* [Architecture](https://github.com/01org/cloudeebus/wiki/Architecture) block diagram.
Examples
--------
### dbus-tools
The /doc/dbus-tools folder contains dbus-send and dbus-register test pages.
Cloudeebus runs in opendoor mode, the dbus-tools pages have no manifest.
cloudeebus.py --debug --opendoor --port=9001 &
firefox ./doc/dbus-tools/dbus-register.html ./doc/dbus-tools/dbus-send.html &
### sample
The /doc/sample folder contains a working sample using credentials, whitelist and manifest.
Cloudeebus runs with credentials and a whitelist that are matched by the
sample page manifest.
cloudeebus.py --debug --credentials=./doc/sample/CREDENTIALS --whitelist=./doc/sample/WHITELIST &
firefox ./doc/sample/cloudeebus.html &
The sample page is also online as a [live demo](http://01org.github.com/cloudeebus/).
### agent
The /doc/agent folder contains a working client sample using credentials, whitelist and manifest and
a working service sample using credentials, servicelist and manifest.
One instance of cloudeebus runs with credentials and a whitelist that are matched by the
client page manifest.
cloudeebus.py --debug --credentials=./doc/agent/CREDENTIALS --whitelist=./doc/agent/SAMPLELIST -p 9002 &
firefox ./doc/agent/client.html &
The other instance of cloudeebus runs with credentials and a servicelist that are matched by the
server page manifest.
cloudeebus.py --debug --credentials=./doc/agent/CREDENTIALS --servicelist=./doc/agent/SAMPLELIST -p 9003 &
firefox ./doc/agent/server.html &
Acknowledgements
----------------
Cloudeebus uses code from the following open-source projects:
* [AutobahnJS](http://autobahn.ws/js) ([MIT](http://opensource.org/licenses/MIT) License)
* [AutobahnPython](http://autobahn.ws/python) ([Apache 2.0](http://opensource.org/licenses/Apache-2.0) License)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cloudeebus-0.6.0.tar.gz
(8.6 kB
view details)
Built Distribution
cloudeebus-0.6.0-py2.7.egg
(31.4 kB
view details)
File details
Details for the file cloudeebus-0.6.0.tar.gz
.
File metadata
- Download URL: cloudeebus-0.6.0.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a19662d52a4c756d1be6e5bae7134b34676695fdf9266da6509c686d831300d7 |
|
MD5 | d431ff9f9150cf7ba0f6f89980789a32 |
|
BLAKE2b-256 | 82e3388d271bdd79951a5aceb44cf05ab75c95c06a49e6e2a96b3e0562bf45f8 |
File details
Details for the file cloudeebus-0.6.0-py2.7.egg
.
File metadata
- Download URL: cloudeebus-0.6.0-py2.7.egg
- Upload date:
- Size: 31.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ade028910c9e75f1dffaa37d37b305d5fb7910781d3f7c8899ade8869bf3934d |
|
MD5 | b849ff5f3ab861abbacf04adb67046fc |
|
BLAKE2b-256 | 2d7a9cd5bee1b85c9cc12868f9d7823b056cd5265b49b71926416cd471852706 |