aiounittest
Info
The aiounittest is a helper library to ease of your pain (and boilerplate), when writing a test of the asynchronous code (asyncio
). You can test:
- synchronous code (same as the
unittest.TestCase
) - asynchronous code, it supports syntax with
async
/await
(Python 3.5+) andasyncio.coroutine
/yield from
(Python 3.4)
In the Python 3.8 (release note) and newer consider to use the unittest.IsolatedAsyncioTestCase. Builtin unittest
module is now asyncio-featured.
Installation
Use pip:
pip install aiounittest
Usage
It's as simple as use of unittest.TestCase
. Full docs at http://aiounittest.readthedocs.io.
import asyncio
import aiounittest
async def add(x, y):
await asyncio.sleep(0.1)
return x + y
class MyTest(aiounittest.AsyncTestCase):
async def test_async_add(self):
ret = await add(5, 6)
self.assertEqual(ret, 11)
# or 3.4 way
@asyncio.coroutine
def test_sleep(self):
ret = yield from add(5, 6)
self.assertEqual(ret, 11)
# some regular test code
def test_something(self):
self.assertTrue(True)
Library provides some additional tooling:
- async_test,
- AsyncMockIterator mocking for async for,
- futurized mock for coroutines.
License
MIT