2021-01-11 13:23:36 +00:00
|
|
|
asynctest
|
|
|
|
=========
|
|
|
|
|
|
|
|
Complements the standard [unittest][1] module in Nim to allow testing of
|
|
|
|
asynchronous code.
|
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
|
|
|
Use the [Nimble][2] package manager to add asynctest to an existing project.
|
|
|
|
Add the following to its .nimble file:
|
|
|
|
|
|
|
|
```nim
|
2023-12-15 17:51:32 +00:00
|
|
|
requires "asynctest >= 0.4.3 & < 0.5.0"
|
2021-01-11 13:23:36 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
2021-01-11 16:28:55 +00:00
|
|
|
Simply replace `import unittest` with `import asynctest`, and you can await
|
|
|
|
asynchronous calls in tests, setup and teardown.
|
2021-01-11 13:23:36 +00:00
|
|
|
|
|
|
|
Example
|
|
|
|
-------
|
|
|
|
|
|
|
|
```nim
|
|
|
|
|
|
|
|
import asynctest
|
|
|
|
import asyncdispatch # alternatively: import chronos
|
|
|
|
|
|
|
|
proc someAsyncProc {.async.} =
|
|
|
|
# perform some async operations using await
|
|
|
|
|
|
|
|
suite "test async proc":
|
|
|
|
|
2021-01-11 16:28:55 +00:00
|
|
|
setup:
|
2022-02-24 11:15:45 +00:00
|
|
|
# invoke await in each test setup:
|
2021-01-11 13:23:36 +00:00
|
|
|
await someAsyncProc()
|
|
|
|
|
2021-01-11 16:28:55 +00:00
|
|
|
teardown:
|
2022-02-24 11:15:45 +00:00
|
|
|
# invoke await in each test teardown:
|
2021-01-11 13:23:36 +00:00
|
|
|
await someAsyncProc()
|
|
|
|
|
2021-01-11 16:28:55 +00:00
|
|
|
test "async test":
|
2021-01-11 13:23:36 +00:00
|
|
|
# invoke await in tests:
|
|
|
|
await someAsyncProc()
|
|
|
|
|
|
|
|
```
|
|
|
|
|
2022-03-01 08:25:15 +00:00
|
|
|
setupAll and teardownAll
|
|
|
|
------------------------
|
|
|
|
|
|
|
|
The `setup` and `teardown` code runs before and after every test, just like the
|
|
|
|
standard [unittest][1] module. In addition we provide `setupAll` and
|
|
|
|
`teardownAll`. The `setupAll` code runs once before all tests in the suite, and
|
|
|
|
the `teardownAll` runs once after all tests in the suite. Use these only as a
|
|
|
|
last resort when setting up the test environment is very costly. Be careful that
|
|
|
|
the tests do not modify the environment that you set up, lest you introduce
|
|
|
|
dependencies between tests.
|
|
|
|
|
2022-05-19 12:35:09 +00:00
|
|
|
check eventually
|
|
|
|
----------------
|
|
|
|
|
|
|
|
When you find yourself adding calls to `sleepAsync` to your tests, you might
|
|
|
|
want to consider using `check eventually` instead. It will repeatedly check
|
|
|
|
an expression until it becomes true. It has a built-in timeout of 5 seconds that
|
|
|
|
you can override.
|
|
|
|
|
|
|
|
```nim
|
|
|
|
var x: int
|
|
|
|
|
|
|
|
proc slowProcedure {.async.} =
|
|
|
|
# perform a slow operation
|
|
|
|
x = 42
|
|
|
|
|
|
|
|
let future = slowProcedure()
|
|
|
|
check eventually x == 42
|
|
|
|
await future
|
|
|
|
```
|
|
|
|
|
2021-07-07 08:32:50 +00:00
|
|
|
Unittest2
|
|
|
|
---------
|
|
|
|
|
|
|
|
The [unittest2][3] package is supported. Make sure that you
|
|
|
|
`import asynctest/unittest2` instead of the normal import.
|
|
|
|
|
2021-01-11 13:23:36 +00:00
|
|
|
[1]: https://nim-lang.org/docs/unittest.html
|
|
|
|
[2]: https://github.com/nim-lang/nimble
|
2021-07-07 08:32:50 +00:00
|
|
|
[3]: https://github.com/status-im/nim-unittest2
|