35 lines
787 B
Markdown
35 lines
787 B
Markdown
|
# tests
|
||
|
|
|
||
|
|
A unit test framework
|
||
|
|
|
||
|
|
## Defining tests
|
||
|
|
|
||
|
|
Tests are registered as event handlers. They will automatically run once ``on start`` is finished.
|
||
|
|
|
||
|
|
```blocks
|
||
|
|
tests.test("lgB set speed 10", () => {
|
||
|
|
motors.largeB.setSpeed(10);
|
||
|
|
loops.pause(100)
|
||
|
|
tests.assertClose("speedB", 10, motors.largeB.speed(), 2)
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
## Assertions
|
||
|
|
|
||
|
|
The library has various asserts that will register fault. Note that since exceptions are not available, assertion failure **do not** stop the program execution.
|
||
|
|
|
||
|
|
* **assert** checks a boolean condition
|
||
|
|
|
||
|
|
```blocks
|
||
|
|
tests.assert("speed positive", motors.largeB.speed() > 0)
|
||
|
|
```
|
||
|
|
|
||
|
|
* **assert close** checks that a numberical value is within a particular range
|
||
|
|
|
||
|
|
```blocks
|
||
|
|
tests.assertClose("speed", motors.largeB.speed(), 10, 2)
|
||
|
|
```
|
||
|
|
|
||
|
|
```package
|
||
|
|
tests
|
||
|
|
```
|