summaryrefslogtreecommitdiffstats
path: root/docs/Reference/LuaUnitAssertionFunctions/1_ValueAssertions.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/LuaUnitAssertionFunctions/1_ValueAssertions.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/LuaUnitAssertionFunctions/1_ValueAssertions.md')
-rw-r--r--docs/Reference/LuaUnitAssertionFunctions/1_ValueAssertions.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/docs/Reference/LuaUnitAssertionFunctions/1_ValueAssertions.md b/docs/Reference/LuaUnitAssertionFunctions/1_ValueAssertions.md
new file mode 100644
index 0000000..ed927cd
--- /dev/null
+++ b/docs/Reference/LuaUnitAssertionFunctions/1_ValueAssertions.md
@@ -0,0 +1,58 @@
+# Value assertions
+
+* **_AFT.assertEvalToTrue(value)**
+
+ Assert that a given value evals to true. Lua coercion rules are applied so
+ that values like 0,"",1.17 succeed in this assertion. If provided, extra_msg
+ is a string which will be printed along with the failure message.
+
+* **_AFT.assertEvalToFalse(Value)**
+
+ Assert that a given value eval to *false*. Lua coercion rules are applied so
+ that *nil* and *false* succeed in this assertion. If provided, extra_msg is a
+ string which will be printed along with the failure message.
+
+* **_AFT.assertIsTrue(value)**
+
+ Assert that a given value compares to true. Lua coercion rules are applied so
+ that values like 0, "", 1.17 all compare to true.
+
+* **_AFT.assertIsFalse(value)**
+
+ Assert that a given value compares to false. Lua coercion rules are applied so
+ that only nil and false all compare to false.
+
+* **_AFT.assertIsNil(value)**
+
+ Assert that a given value is nil .
+
+* **_AFT.assertNotIsNil(value)**
+
+ Assert that a given value is not *nil* . Lua coercion rules are applied
+ so that values like ``0``, ``""``, ``false`` all validate the assertion.
+ If provided, *extra_msg* is a string which will be printed along with the
+ failure message.
+
+* **_AFT.assertIs(actual, expected)**
+
+ Assert that two variables are identical. For string, numbers, boolean and
+ for nil, this gives the same result as assertEquals() . For the other types,
+ identity means that the two variables refer to the same object.
+
+ Example :
+
+ ```lua
+ `s1='toto'
+ s2='to'..'to'
+ t1={1,2}
+ t2={1,2}
+ luaunit.assertIs(s1,s1) -- ok
+ luaunit.assertIs(s1,s2) -- ok
+ luaunit.assertIs(t1,t1) -- ok
+ luaunit.assertIs(t1,t2) -- fail`
+ ```
+
+* **_AFT.assertNotIs(actual, expected)**
+
+ Assert that two variables are not identical, in the sense that they do not
+ refer to the same value. See assertIs() for more details. \ No newline at end of file