1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
What? Why? Next?
================
Why Not?
--------
In the Python 3.8 (`release note <https://docs.python.org/3/whatsnew/3.8.html#unittest>`_) and newer consider to use the `unittest.IsolatedAsyncioTestCase <https://docs.python.org/3/library/unittest.html#unittest.IsolatedAsyncioTestCase>`_. Builtin :code:`unittest` module is now asyncio-featured.
What?
-----
This module is a set of helpers to write simple and clean test for asyncio-based code.
Why?
----
Actually this is not nothing new, it just wraps current test approach in the handy utils.
There are couple libraries that try to solve this problem. This one:
- integrates nicely with standard :code:`unittest` library,
- is as simple as possible, without a bunch of stuff that is straithforward with unittest (eg re-inveting :code:`assertRaises` with `assertAsyncRaises`),
- supports both Python 3.5+ syntax and Python 3.4,
- it's well-documented (I think)
Among the others similar modules the best known is an extension pytest-asyncio_. It provides
couple extra features, but it cannot be used with `unittest.TestCase` (it does not support fixture injection).
Further reading:
- https://stackoverflow.com/questions/23033939/how-to-test-python-3-4-asyncio-code
- http://jacobbridges.github.io/post/unit-testing-with-asyncio/
.. _pytest: https://docs.pytest.org
.. _pytest-asyncio: https://pypi.python.org/pypi/pytest-asyncio
Next?
-----
- introduce :code:`AsyncMock`, ... Probably not, the :code:`unitest.mock.Mock` with :code:`futurized` is pretty simple.
- it would be great if `unittest` could support async test > `python-ideas`
|
