summaryrefslogtreecommitdiffstats
path: root/docs/Reference/2_TestFrameworkFunctions.md
diff options
context:
space:
mode:
authorRomain Forlot <romain.forlot@iot.bzh>2018-10-29 18:37:26 +0100
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2018-10-31 21:03:06 +0000
commit2f3654275e44f9719818a848da9a0b576d5a1b53 (patch)
treeff75764bbb2e3037f73f95a96ac5ed2fcba93465 /docs/Reference/2_TestFrameworkFunctions.md
parent2a7b4defe300dfe5eb19f775bd819e2d300b7453 (diff)
Docs reorganization and update
Docs reorganization and update using the latest afb-test improvments and try to make it clearer. Change-Id: If022cdb46364ef250361bdcd420d45b360f10a2e Signed-off-by: Romain Forlot <romain.forlot@iot.bzh>
Diffstat (limited to 'docs/Reference/2_TestFrameworkFunctions.md')
-rw-r--r--docs/Reference/2_TestFrameworkFunctions.md59
1 files changed, 59 insertions, 0 deletions
diff --git a/docs/Reference/2_TestFrameworkFunctions.md b/docs/Reference/2_TestFrameworkFunctions.md
new file mode 100644
index 0000000..20184ec
--- /dev/null
+++ b/docs/Reference/2_TestFrameworkFunctions.md
@@ -0,0 +1,59 @@
+# Test Framework functions
+
+* **_AFT.addEventToMonitor(eventName, callback)**
+
+ Add a binding event in the test framework to be able to assert its reception
+ . You'll need to add as much as events you expect to receive. You could also
+ specify a callback to test deeper that the event is as you want to. The
+ callback will happens after the assertion that it has been received so you
+ can work on data that the event eventually carry.
+
+* **_AFT.setJunitFile(filePath)**
+
+ Set the *JUnit* file path. When *JUnit* is set as the output type for the
+ test framework.
+
+* **_AFT.setBeforeEach(function)**
+
+ Set the **_AFT.beforeEach()** function which is used to run the *function*
+ before each tests.
+
+* **_AFT.setAfterEach(function)**
+
+ Set the **_AFT.afterEach()** function which is used to run the *function*
+ after each tests.
+
+* **_AFT.setBeforeAll(function)**
+
+ Set the **_AFT.beforeAll()** function which is used to run the *function*
+ before all tests. If the given function is successful it has to return 0
+ else it will return an error.
+
+* **_AFT.setAfterAll(function)**
+
+ Set the **_AFT.afterAll()** function which is used to run the *function*
+ after all tests. If the given function is successful it has to return 0
+ else it will return an error.
+
+* **_AFT.describe(testName, testFunction, setUp, tearDown)**
+
+ Give a context to a custom test. *testFunction* will be given the name
+ provided by *testName* and will be tested.
+
+ *setUp* and *tearDown* are functions that can be added to your context,
+ it works just like **_AFT.beforeEach()** and **_AFT.afterEach()**,
+ *setUp* will be ran before your *testFunction* and **_AFT.beforeEach()**
+ (if set) functions, *tearDown* will be ran after your *testFunction* and
+ **_AFT.afterEach()** (if set) functions.
+
+* **_AFT.setBefore(testName, beforeTestFunction)**
+ Set a function to be ran at the beginning of the given *testName* function.
+
+ ```lua
+ _AFT.testVerbStatusSuccess('testPingSuccess','hello', 'ping', {})
+ _AFT.setBefore("testPingSuccess",function() print("~~~~~ Begin testPingSuccess ~~~~~") end)
+ _AFT.setAfter("testPingSuccess",function() print("~~~~~ End testPingSuccess ~~~~~") end)
+ ```
+
+* **_AFT.setBefore(testName, beforeTestFunction)**
+ Set a function to be ran at the end of the given *testName* function. \ No newline at end of file