diff options
author | Manuel Bachmann <manuel.bachmann@iot.bzh> | 2016-05-30 14:56:38 +0200 |
---|---|---|
committer | Manuel Bachmann <manuel.bachmann@iot.bzh> | 2016-05-30 14:58:06 +0200 |
commit | d73846c8868be1098fb75df83521ba34cfbcad16 (patch) | |
tree | 8fc525fafbab5cc566dd3166ee9c97ec8dba11c7 /doc | |
parent | ea682aac623181e6df8555c29cca52697460c22f (diff) |
Add tests documentation, fix typo
Document the tests in "test/".
Fix typo in plugins documentation.
Signed-off-by: Manuel Bachmann <manuel.bachmann@iot.bzh>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/afb-plugins-overview.md | 2 | ||||
-rw-r--r-- | doc/afb-tests-overview.md | 78 |
2 files changed, 79 insertions, 1 deletions
diff --git a/doc/afb-plugins-overview.md b/doc/afb-plugins-overview.md index 7e351b6a..18b67b17 100644 --- a/doc/afb-plugins-overview.md +++ b/doc/afb-plugins-overview.md @@ -1,6 +1,6 @@ # Overview of plugins shipped with AFB-Daemon Version: 1 - Date: 30 mai 2016 + Date: 30 May 2016 Author: Manuel Bachmann diff --git a/doc/afb-tests-overview.md b/doc/afb-tests-overview.md new file mode 100644 index 00000000..a4632d49 --- /dev/null +++ b/doc/afb-tests-overview.md @@ -0,0 +1,78 @@ +# Overview of tests shipped with AFB-Daemon + Version: 1 + Date: 30 May 2016 + Author: Manuel Bachmann + + +## List of tests + Here are the tests shipped in the source tree: + * **afb-client-demo** (command-line WebSockets) + * **token-websock.qml** (Qt/QML WebSockets) + * ***.html** (HTML5/JS HTTP-REST & WebSockets) + + +## Detail of tests + +### afb-client-demo (command-line WebSockets) + +This clients interactively calls plugins APIs from the command line, using the binder [WebSockets](https://en.wikipedia.org/wiki/WebSocket) facility. + +If _afb-daemon_ has been launched with the following parameters: +``` +$ afb-daemon --port=1234 --token=123456 [...] +``` + +Then run the client with : +``` +afb-client-demo ws://localhost:1234/api?token=123456 <plugin> <verb> +``` + +For instance, to initialize the Audio plugin from the command line : +``` +afb-client-demo ws://localhost:1234/api?token=123456 auth connect +(copy-paste the "token" field from the response) +afb-client-demo ws://localhost:1234/api?token=123456 audio init <TOKEN> +``` + +<br /> + + + +### token-websock.qml (Qt/QML WebSockets) + +If _afb-daemon_ has been launched with the following parameters: +``` +$ afb-daemon --port=1234 --token=123456 [...] +``` +and Qt5 is installed, on **Ubuntu 16.04**: +``` +$ apt-get install qmlscene qml-module-qtwebsockets qml-module-qtquick-controls +``` +or on **Fedora 23** : +``` +$ dnf install qt5-qtdeclarative-devel qt5-qtwebsockets-devel qt5-qtquickcontrols +``` + +Then run the client with : +``` +qmlscene test/token-websock.qml +``` +and interactively press the buttons, "Connect", "Refresh", "Logout". + +<br /> + + +### *.html (HTML5/JS HTTP-REST & WebSockets) + +If _afb-daemon_ has been launched with the following parameters: +``` +$ afb-daemon --port=1234 --rootdir=$PWD/test [...] +``` +_("$PWD/test_" being the "test" subdirectory of the source tree)_ + + +Then open your preferred Web browser, connect to the following URL: +``` +http://localhost:1234 +``` +and interactively run the various tests. |