summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorManuel Bachmann <manuel.bachmann@iot.bzh>2016-05-30 14:56:38 +0200
committerManuel Bachmann <manuel.bachmann@iot.bzh>2016-05-30 14:58:06 +0200
commitd73846c8868be1098fb75df83521ba34cfbcad16 (patch)
tree8fc525fafbab5cc566dd3166ee9c97ec8dba11c7 /doc
parentea682aac623181e6df8555c29cca52697460c22f (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.md2
-rw-r--r--doc/afb-tests-overview.md78
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.